Internet top up
Send an internet top-up
POST
Starts an Idoom ADSL or 4G top-up and returns at once. Poll check-id or check-ref until the status is final (COMPLETED, REFUNDED, MANUAL_REDEEM or UNKNOWN_ERROR).
AccessTokenheader
X-Access-Token<token>Your API key. Sandbox keys start with flx_test_, production keys with flx_live_.
application/json- body
type*stringValue in
"ADSL""4G"number*stringADSL: fixed line like 030000009. 4G: 2134XXXXXXXX (no +).
Match
^(0[1-9]\d{7}|2134\d{8})$value*integerCard value from GET /v3/internet/products.
Range
0 < valueref?stringYour 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}$Top-up accepted
application/json- response
success*trueValue in
truedata*meta*requestId*stringcurl -X POST 'https://api.flexyliktelecom.com/v3/internet/send' \ -H 'Content-Type: application/json' \ -d '{ "type": "ADSL", "number": "030000009", "value": 1000}'Example Response
{ "success": true, "data": { "topupId": "F00012345", "topupRef": "order-10293" }, "meta": { "timestamp": "2026-11-15T10:30:00.000Z" }, "requestId": "req_8fK2mQx7Lp0aZ3nV1cWb"}