Post bank transfer

curl --location --request POST 'https://api.xente.co/api/transactions/payouts/banktransfers' \
--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": 500,
  "type": "DEBIT",
  "message": "Testing",
  "product": {
    "productItemId": "producItemId" //These can be fetched from the products endpoint
  },
  "beneficiary": {
    "name": "recipient  name",
    "emailAddress": "recipient email address",
    "phoneNumber": "recipient  phone number",
    "data": {
      "bankAccount": "Bank account number where funds are to be deposited", 
      "bankName": "bank name" //The Code of the bank where account is held
    }
  }
}'

{
  "message": "Transaction Has Been Successfully Received. Notification Will Be Sent Shortly",
  "data": {
    "requestId": "req1234",
    "batchId": "123123123123",
    "transactionId": "0f9182ad-bf5e-4854-799e-08dc2bc9741e",
    "status": "PROCESSING",
    "message": "Processing Debit Transaction. Instant Payment Notification will be sent shortly",
    "createdOn": "2/12/2024 12:52:21 PM"
  },
  "code": 0,
  "status": "success"
}

POST

api

transactions

payouts

banktransfers

curl --location --request POST 'https://api.xente.co/api/transactions/payouts/banktransfers' \
--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": 500,
  "type": "DEBIT",
  "message": "Testing",
  "product": {
    "productItemId": "producItemId" //These can be fetched from the products endpoint
  },
  "beneficiary": {
    "name": "recipient  name",
    "emailAddress": "recipient email address",
    "phoneNumber": "recipient  phone number",
    "data": {
      "bankAccount": "Bank account number where funds are to be deposited", 
      "bankName": "bank name" //The Code of the bank where account is held
    }
  }
}'

{
  "message": "Transaction Has Been Successfully Received. Notification Will Be Sent Shortly",
  "data": {
    "requestId": "req1234",
    "batchId": "123123123123",
    "transactionId": "0f9182ad-bf5e-4854-799e-08dc2bc9741e",
    "status": "PROCESSING",
    "message": "Processing Debit Transaction. Instant Payment Notification will be sent shortly",
    "createdOn": "2/12/2024 12:52:21 PM"
  },
  "code": 0,
  "status": "success"
}

Body

string

A unique identifier for the request.

string

A unique identifier for the batch.

string

The account number associated with the request.

number

The monetary amount involved in the request.

string

The type of request, initially not set.

string

An optional message associated with the request.

string

Additional metadata as a string.

string

The product’s unique identifier.

string

A specific item identifier within the product.

string

The beneficiary’s unique identifier.

string

The beneficiary’s name.

string

The beneficiary’s email address.

string

The beneficiary’s phone number.

string

The bank account number of the beneficiary

string

The ode of the bank where account is held (This can be gotten from the get products and get product items APIs)

Response

number

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

string

Status message on outcome of the API call.

string

General message about the transaction status.

object

The contents of the transaction data.

Show Toggle object

string

Unique identifier for the request.

string

Batch ID associated with the request.

string

Unique identifier of the transaction.

string

Current status of the transaction.

string

Detailed message regarding the transaction’s current status.

string

Timestamp indicating when the transaction was created.

curl --location --request POST 'https://api.xente.co/api/transactions/payouts/banktransfers' \
--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": 500,
  "type": "DEBIT",
  "message": "Testing",
  "product": {
    "productItemId": "producItemId" //These can be fetched from the products endpoint
  },
  "beneficiary": {
    "name": "recipient  name",
    "emailAddress": "recipient email address",
    "phoneNumber": "recipient  phone number",
    "data": {
      "bankAccount": "Bank account number where funds are to be deposited", 
      "bankName": "bank name" //The Code of the bank where account is held
    }
  }
}'

{
  "message": "Transaction Has Been Successfully Received. Notification Will Be Sent Shortly",
  "data": {
    "requestId": "req1234",
    "batchId": "123123123123",
    "transactionId": "0f9182ad-bf5e-4854-799e-08dc2bc9741e",
    "status": "PROCESSING",
    "message": "Processing Debit Transaction. Instant Payment Notification will be sent shortly",
    "createdOn": "2/12/2024 12:52:21 PM"
  },
  "code": 0,
  "status": "success"
}

Accounts

Transactions

Mobile Money

Bank Transfers

Airtime

Internet

Bills

Collections

Products

Beneficiary & Product Validation

Body

Response