Skip to main content
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 4G
string
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) ⏰
Track status →

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

Invalid request parameters
Invalid phone number format or type mismatch
Card value out of stock
Not enough balance
Reference already used

Best Practices

Validate First

Use /check-number before submitting

Check Stock

Verify product availability

Unique References

Provide unique ref for tracking

Poll Status

Check status after submission

Validate Number

Check phone validity

Check Status

Track order

List Products

Available cards