Overview

Sell top-ups from your own app, website or back office, paid from your account balance.

Mobile top-up

Mobilis, Djezzy and Ooredoo: prepaid credit, postpaid bills, offers and internet packages.

Internet top-up

Algérie Télécom Idoom cards for ADSL, fibre and 4G LTE lines.

Every request goes to https://api.flexyliktelecom.com with your API key in the X-Access-Token header. Responses are JSON, with the same envelope on every endpoint.

How a top-up works

Pick what to send. List mobile plans with GET /v3/mobile/plans, or Idoom card values with GET /v3/internet/products.

Send it with your own reference. POST /v3/mobile/send or POST /v3/internet/send returns at once with a topupId. Give every order a unique ref so retries never charge twice.

Poll until it is final. Call check-id or check-ref every few seconds. Most top-ups finish in 5 to 30 seconds.

Act on the final status. COMPLETED means delivered and charged. REFUNDED means it failed and nothing was charged.

Start here

Quickstart

Make your first sandbox top-up in five minutes.

Authentication

Sandbox and production keys, scopes and IP allowlists.

References and retries

Send every top-up exactly once, even when the network fails.

Sandbox

Test numbers for every outcome, without spending money.

API reference

Every endpoint, field and response, with a playground.

Conventions

Versioned paths: everything lives under /v3.
Amounts are in Algerian dinars (DZD).
Dates are ISO 8601 in UTC, for example 2026-11-15T10:30:00.000Z.
Phone numbers are sent as strings with the leading 0, without spaces or +213.
Every response carries a requestId. Include it when you contact support.