Skip to main content
POST
/
v3
/
internet
/
send
Send Internet Top-Up
curl --request POST \
  --url https://api.oneclickdz.com/v3/internet/send \
  --header 'Content-Type: application/json' \
  --header 'X-Access-Token: <api-key>' \
  --data '{
  "type": "<string>",
  "number": "<string>",
  "value": 123,
  "ref": "<string>"
}'

​
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

​
type
string
required
Service type: ADSL or 4G
​
number
string
required
Phone number - ADSL: 0[0-9]{8} (e.g., 036362608) - 4G: 213[0-9] {9} (e.g., 213472731602)
​
value
number
required
Card denomination from /internet/products (e.g., 500, 1000, 2000)
​
ref
string
Your unique order reference (optional, auto-generated if not provided)

​
Examples

curl https://api.oneclickdz.com/v3/internet/send \
  -X POST \
  -H "Content-Type: application/json" \
  -H "X-Access-Token: YOUR_API_KEY" \
  -d '{
    "type": "ADSL",
    "number": "036362608",
    "value": 1000,
    "ref": "internet-order-001"
  }'

​
Success Response

{
  "success": true,
  "data": {
    "topupId": "690161a3e9e88196b4eb6545",
    "topupRef": "API-+213665983439-test-internet-1761698210633"
  },
  "meta": {
    "timestamp": "2025-10-29T00:36:52.065Z"
  }
}

​
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 →

​
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