Send Internet Top-Up
Internet Top-Ups
Send Internet Top-Up
Purchase and send ADSL or 4G LTE internet recharge card
POST
Send Internet Top-Up
Overview
Purchase internet recharge cards for ADSL or 4G LTE services with instant digital delivery.Always validate phone numbers
before submitting to reduce errors.
Request Body
string
required
Service type:
ADSL or 4Gstring
required
Phone number - ADSL:
0[0-9]{8} (e.g., 036362608) - 4G: 213[0-9] {9} (e.g., 213472731602)number
required
Card denomination from
/internet/products (e.g., 500, 1000, 2000)string
Your unique order reference (optional, auto-generated if not provided)
Examples
Success Response
Status Lifecycle
1
HANDLING
Processing with operator (3-45 seconds typical)
2
Final States
- FULFILLED: Card delivered ✅ - REFUNDED: Failed and refunded ❌ - QUEUED: Scheduled for later (12-48h) ⏰
Sandbox
With a sandbox key no card is consumed and your balance is never debited. The number you send decides the outcome, and the status advances on its own — poll exactly as you would in production:
A fulfilled sandbox order returns
card_code: "TESTCARD" and num_trans: "TESTTRANS"; everything else matches the production response exactly.
Error Responses
ERR_VALIDATION
ERR_VALIDATION
Invalid request parameters
ERR_PHONE
ERR_PHONE
Invalid phone number format or type mismatch
ERR_STOCK
ERR_STOCK
Card value out of stock
INSUFFICIENT_BALANCE
INSUFFICIENT_BALANCE
Not enough balance
DUPLICATED_REF
DUPLICATED_REF
Reference already used
Best Practices
Validate First
Use
/check-number before submittingCheck Stock
Verify product availability
Unique References
Provide unique
ref for trackingPoll Status
Check status after submission
Related
Validate Number
Check phone validity
Check Status
Track order
List Products
Available cards

