POST
/
api
/
airtime
/
transactions
curl --location --request POST 'https://api.xente.co/v2/accounts' \
--header 'Content-Type: application/json' \
--header 'Authorization: Token <token>' \

```json
{
  "requestId": "92399933543589",//Id from your system to uniquely identify the transaction
  "batchId": "batch5678",
  "amount": 1000,
  "type": "PAYOUT", //use DEPOSIT to fund your account, PAYOUT to fund other accounts
  "message": "Send airtime facilitation",
  "metadata": "Expense code 1000023",
  "product": {
    "id": "MTNAIRTIMEUG",
    "productItemId": "MTNAIRTIMEUG_MTNAIRTIMEUG" 
  },
  "beneficiary": {
    "id": "ben003", //Id from your system to identify beneficiary
    "name": "John Doe",
    "emailAddress": "johndoe@example.com",
    "phoneNumber": "+1234567890", 
    "data": {
      "phoneNumber": "+1234567890" //The mobile money number to deposit or remove funds from
    }
  }
}

{
    "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"
}

​
Body

requestId
string

A unique identifier for the request.

batchId
string

A unique identifier for the batch.

accountNumber
string

The account number associated with the request.

amount
number

The monetary amount involved in the request.

type
string

The type of request, initially not set.

message
string

An optional message associated with the request.

metadata
string

Additional metadata as a string.

product.id
string

The product’s unique identifier.

product.productItemId
string

A specific item identifier within the product.

beneficiary.id
string

The beneficiary’s unique identifier.

beneficiary.name
string

The beneficiary’s name.

beneficiary.emailAddress
string

The beneficiary’s email address.

beneficiary.phoneNumber
string

The beneficiary’s phone number.

beneficiary.data.phoneNumber
string

Another phone number associated with the beneficiary, potentially for different purposes.

​
Response

code
number

Indicates whether the call was successful. 0 if successful, error code if not.

status
string

Status message on outcome of the API call.

message
string

General message about the transaction status.

data
object

The contents of the transaction data.

Post bank transferPost mobile internet