Skip to main content

Internet Top-Up

ADSL and 4G internet recharge services.

1. Get Cards​

Get available internet recharge cards.

Endpoint: GET /api/internet/cards/{type}

Types: ADSL or 4G

Response:

{
    "status": "success",
    "message": "Cards retrieved",
    "data": [
        {
            "value": 1000,
            "available": true,
            "price": 1050.00
        },
        {
            "value": 2000,
            "available": true,
            "price": 2100.00
        }
    ]
}

2. Check Number​

Verify a phone/ADSL number before placing an order.

Endpoint: GET /api/internet/check-number/{type}/{number}

Number Format:

  • 4G: 213[0-9]{9} (e.g., 213551234567)
  • ADSL: 0[0-9]{8} (e.g., 055123456)

Response:

{
    "success": true,
    "data": {
        "ncli": "1234567890",
        "type": "4G",
        "offre": "4G_LTE_Premium"
    }
}

3. Place Order​

Place an internet recharge order.

Endpoint: POST /api/internet/order

Request:

{
    "type": "4G",
    "number": "213551234567",
    "value": 1000
}

Response:

{
    "success": true,
    "message": "Top-up request sent successfully",
    "data": {
        "ref": "INT67890abcdef1234567890",
        "status": "PENDING"
    }
}

4. Check Order Status​

Check the status of a placed order.

Endpoint: GET /api/internet/status/{by}/{search}

Search Types: ref, id, or topup_id

Examples:

  • By reference: /api/internet/status/ref/INT67890abcdef1234567890
  • By order ID: /api/internet/status/id/123

Response:

{
    "status": "success",
    "message": "Order status retrieved",
    "data": {
        "id": 123,
        "ref": "INT67890abcdef1234567890",
        "number": "213551234567",
        "type": "4G",
        "value": 1000,
        "status": "FULFILLED",
        "final_price": 1050.00,
        "created_at": "2024-01-15T10:30:00.000000Z"
    }
}

Status Values:

  • PENDING: Order received, waiting for processing
  • HANDLING: Order is being processed
  • FULFILLED: Recharge completed successfully
  • FAILED: Recharge failed
  • REJECTED: Order rejected by provider
  • REFUNDED: Order refunded
  • UNKNOWN_ERROR: Unknown error occurred

5. Get Order History​

Get your internet top-up order history.

Endpoint: GET /api/internet/history

Example Workflow​

# 1. Get available 4G cards
curl -X GET "https://gateway.wasmou.net/api/internet/cards/4G" \
  -H "X-Api-Key: your_api_key"

# 2. Check number validity
curl -X GET "https://gateway.wasmou.net/api/internet/check-number/4G/213551234567" \
  -H "X-Api-Key: your_api_key"

# 3. Place order
curl -X POST "https://gateway.wasmou.net/api/internet/order" \
  -H "X-Api-Key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "4G",
    "number": "213551234567",
    "value": 1000
  }'

# 4. Check status by reference
curl -X GET "https://gateway.wasmou.net/api/internet/status/ref/INT67890abcdef1234567890" \
  -H "X-Api-Key: your_api_key"

Number Format Rules​

4G Numbers​

  • Must start with 213
  • Followed by 9 digits
  • Example: 213551234567

ADSL Numbers​

  • Must start with 0
  • Followed by 8 digits
  • Example: 055123456

Best Practices​

  • Always check number validity before ordering
  • Verify card availability and pricing
  • Save the ref for tracking
  • Poll status endpoint until status is final (FULFILLED, FAILED, REJECTED, or REFUNDED)
  • Use appropriate number format for type (4G vs ADSL)