Initiate an airtime request

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.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
required

Your PentrraWallet public API key.

string
required

Your PentrraWallet secret key. Keep this confidential.

string
required

Recipient's phone number. Do not include + or spaces. Submit the number in local format without the country calling code prefix.

string
required
length between 2 and 2

Recipient's country in ISO 3166-1 alpha-2 format (2 uppercase letters).

float
required

Airtime amount in USD. Must be within the operator's allowed minimum and maximum range. A descriptive error is returned if out of range.

string
enum
required

live sends real airtime and debits your balance. IP whitelist enforced. sandbox simulates the flow at no cost with no IP restriction.

Allowed:
Responses

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json