Body
A unique identifier for the request.
A unique identifier for the batch.
The account number associated with the request.
The monetary amount involved in the request.
The type of request, initially not set.
An optional message associated with the request.
Additional metadata as a string.
The product’s unique identifier.
A specific item identifier within the product.
The beneficiary’s unique identifier.
The beneficiary’s email address.
The beneficiary’s phone number.
beneficiary.data.phoneNumber
The phone number to be topped up.
Response
Indicates whether the call was successful. 0 if successful, error code if not.
Status message on outcome of the API call.
General message about the transaction status.
The contents of the transaction data.
Unique identifier for the request.
Batch ID associated with the request.
Unique identifier of the transaction.
Current status of the transaction.
Detailed message regarding the transaction’s current status.
Timestamp indicating when the transaction was created.
curl --location --request POST 'https://api.xente.co/api/transactions/payouts/airtime' \
--header 'Content-Type: application/json' \
--header 'Authorization: Token <token>' \
--data-raw '{
"requestId": "92399933543589", //Id from your system to uniquely identify the transaction
"batchId": "batch5678", //Identifier og the batch from your system.
"amount": 1000,
"type": "DEBIT",
"message": "Send airtime facilitation",
"metadata": "Expense code 1000023",
"product": {
"id": "MTNAIRTIMEUG",
"productItemId": "MTNAIRTIMEUG_MTNAIRTIMEUG"
},
"beneficiary": {
"name": "John Doe",
"emailAddress": "johndoe@example.com",
"phoneNumber": "+1234567890",
"data": {
"phoneNumber": "+1234567890" //The phone number to be topped up
}
}
}'
{
"code": 0,
"message": "Transaction Has Been Successfully Received. Notification Will Be Sent Shortly",
"data": {
"requestId": "92399933543589",
"batchId": "batch5678",
"transactionId": "0f595604-2c80-4d32-d3e4-08dc37af5a91",
"status": "PROCESSING",
"message": "Processing Debit Transaction. Instant Payment Notification will be sent shortly",
"createdOn": "2/27/2024 4:15:45 PM"
}
},
"code": 0,
"status": "success"
}