Detects the mobile operator for the provided phone number and country,
calculates the estimated amount the recipient will receive, and creates
a pending transaction.
No funds are charged at this step.
Store the idtrx from the response and pass it to POST /confirm-airtime
to execute the airtime.
Operator Detection
The operator is detected automatically from the phone number and country code.
You do not need to specify an operator.
Amount Validation
Each operator defines a minimum and maximum airtime amount in USD.
If the submitted amount falls outside this range, the request is rejected
with a descriptive error message.
Estimated Amount
The amount.estimatedReceived field shows the approximate amount the recipient
will receive in local currency. This is calculated using the current exchange rate
at the time of initiation. The actual delivered amount may differ slightly
and is returned in the Confirm step response.
IP Restriction
In live mode, requests must originate from a whitelisted IP address.
sandbox mode has no IP restriction.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
