Skip to Content
Flexylik Télécomv3
Dashboard
GuidesAPI reference
Mobile top up

Send a mobile top-up

POST
/v3/mobile/send

Starts a top-up and returns at once with topupId and topupRef. The result comes later: poll check-id or check-ref until the status is final (COMPLETED, REFUNDED or UNKNOWN_ERROR). DEBT_PENDING means the line has an unpaid debt: answer with POST /v3/mobile/resolve-debt. Always send your own ref; if the call fails or times out, check that ref before sending again.

Authorization

AccessToken
headerX-Access-Token<token>

Your API key. Sandbox keys start with flx_test_, production keys with flx_live_.

Request Body

application/json
  1. body
plan_code*string

Plan code from GET /v3/mobile/plans.

Value in"PREPAID_MOBILIS""PREPAID_DJEZZY""PREPAID_OOREDOO""FACTURE_MOBILIS""FACTURE_DJEZZY""FACTURE_OOREDOO""OFFER_MOBILIS""OFFER_DJEZZY""OFFER_OOREDOO""INTERNATIONAL_MOBILIS"
MSSIDN*string

Algerian mobile number with leading 0, no spaces, no +213. 05 Ooredoo, 06 Mobilis, 07 Djezzy, 01 Ooredoo Enterprise (OOREDOO plans only).

Match^0[1567]\d{8}$
amount?integer

Amount in DZD. Required for PREPAID_, FACTURE_ and INTERNATIONAL_MOBILIS; ignored for OFFER_*.

Range0 < value
offer_id?string

Required for OFFER_* plans: an offer_id from GET /v3/mobile/offers.

Lengthlength <= 4096
ref?string

Your unique reference for this top-up (1-64 chars). Sending the same ref twice is refused with DUPLICATED_REF, so it is safe to retry with the same ref. Auto-generated when omitted.

Match^[A-Za-z0-9_.:-]{1,64}$
on_debt?string

What to do if the operator reports an unpaid line debt (SABBAQLI). WAIT (default): the top-up becomes DEBT_PENDING until you call resolve-debt. CANCEL: it is cancelled at once and ends REFUNDED.

Value in"WAIT""CANCEL"

Response Body

Top-up accepted

application/json
  1. response
success*true
Value intrue
data*
meta*
requestId*string
Example Request
curl -X POST 'https://api.flexyliktelecom.com/v3/mobile/send' \  -H 'Content-Type: application/json' \  -d '{  "plan_code": "PREPAID_DJEZZY",  "MSSIDN": "0600000009"}'
Example Response
{  "success": true,  "data": {    "topupId": "F00012345",    "topupRef": "order-10293"  },  "meta": {    "timestamp": "2026-11-15T10:30:00.000Z"  },  "requestId": "req_8fK2mQx7Lp0aZ3nV1cWb"}

Answer a line-debt question POST

When a top-up is DEBT_PENDING the operator reported an unpaid line debt (SABBAQLI) and waits for a decision. Choose PAY_ALL, PAY_OPERATION_ONLY, PAY_DEBT_ONLY or CANCEL; debt_options on the top-up shows what each costs. The top-up then continues (PENDING → … → COMPLETED) or ends REFUNDED for CANCEL. Unanswered top-ups are cancelled at debt_expires_at.

Check a top-up by id GET

Status of one internet top-up by its `topupId`. Poll every 5 seconds while HANDLING.