Post bank transfer - Developer Documentation

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

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.bankAccount

string

The bank account number of the beneficiary

beneficiary.data.bankCode

string

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

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.

Show Toggle object

requestId

string

Unique identifier for the request.

batchId

string

Batch ID associated with the request.

transactionId

string

Unique identifier of the transaction.

status

string

Current status of the transaction.

message

string

Detailed message regarding the transaction’s current status.

createdOn

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

Post mobile money Post airtime

​Body

​Response

Body

Response