Instant top-up
Send airtime to subscribers on supported mobile networks programmatically.
Async delivery
Receive a callback with the final recharge status once processing completes.
Sending airtime flow
1
Submit request
Your application sends an airtime recharge request to the Beem API.
2
Validation
The API accepts and validates the request, returning an immediate acknowledgement or an error if the request is invalid.
3
Operator processing
Beem forwards the request to the mobile network operator and receives the operator response.
4
Callback
If a callback URL is configured on your profile, Beem sends the final recharge status to your server.
Base URLs
What’s in this section
- Prerequisites — account setup and API credentials
- Authentication — Basic Auth or access token
- Sending airtime — transfer request, parameters, and sample code
- Callbacks — receive final transaction status
- Transaction status — poll status by transaction ID
- Check balance — retrieve your available credit balance
- Response codes — API status and error codes
