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.

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