Send Airtime / Top-up

Send airtime to a customer number on a supported mobile network. The API accepts the request and processes it asynchronously; final status is delivered to your callback URL.

Endpoint

POST https://api.bridgeagw.com/send_airtime

Request Headers

Authorization: Basic <base64_encoded_credentials>
Content-Type: application/json

Request Body

{
  "service_id": 55,
  "reference": "Test payment",
  "transaction_id": "ksnyew2kei4a-alnlapk-uou",
  "trans_type": "ATP",
  "amount": 5,
  "customer_number": "0540010000",
  "nw": "MTN",
  "callback_url": "https://webhook.site/0b429e73-ce5c-420b-af82-a346fb577c43",
  "request_time": "2025-10-03 23:50"
}

Parameters

Parameter	Type	Required	Description
`service_id`	integer	Yes	Your service identifier
`reference`	string	Yes	Transaction reference or description
`transaction_id`	string	Yes	Unique transaction identifier
`trans_type`	string	Yes	Must be `ATP` for airtime / top-up
`amount`	number	Yes	Airtime amount
`customer_number`	string	Yes	Recipient phone number (MSISDN)
`nw`	string	Yes	Mobile network code (e.g. `MTN`, `VOD`, `AIR`)
`callback_url`	string	Yes	URL for asynchronous status notifications
`request_time`	string	Yes	Request timestamp

Supported Networks (`nw`)

Use the same network codes as mobile money collections:

Network	Code
MTN Mobile Money	`MTN`
Telecel Cash	`VOD`
AirtelTigo Money	`AIR`

Response

Accepted (202)

{
  "response_message": "Request successfully received for processing",
  "response_code": "202"
}

Example (cURL)

curl -X POST "https://api.bridgeagw.com/send_airtime" \
  -H "Authorization: Basic <your_credentials>" \
  -H "Content-Type: application/json" \
  -d '{
    "service_id": 55,
    "reference": "Test payment",
    "transaction_id": "ksnyew2kei4a-alnlapk-uou",
    "trans_type": "ATP",
    "amount": 5,
    "customer_number": "0540010000",
    "nw": "MTN",
    "callback_url": "https://your-site.com/webhook/airtime-status",
    "request_time": "2025-10-03 23:50"
  }'

Callbacks

After you receive 202, rely on your callback_url for final status. See Callbacks.

Send Airtime / Top-up

On this page