Interbank Transfer

This API performs an interbank transfer between accounts. It debits funds from a source account and credits a destination account at a different institution. The request requires detailed account and transaction information.

Request Body

Field Name	Type	Required	Description
sourceAccountNUBAN	string	TRUE	The NUBAN (account number) of the source account from which funds are debited.
clientBVN	string	TRUE	The Bank Verification Number (BVN) of the client initiating the transfer.
destinationInstitutionCode	string	TRUE	The unique code identifying the destination institution.
destinationAccountNUBAN	string	TRUE	The NUBAN (account number) of the destination account to receive funds.
amount	decimal	TRUE	The amount to be transferred between the accounts.
narration	string	TRUE	A note or description associated with the transfer.
transactionReference	string	TRUE	A unique reference identifier for the transfer transaction.
callback	string	FALSE	An optional URL for asynchronous notifications about the transfer.

Response Body

Field Name	Type	Description
id	integer	Unique identifier for the transfer transaction.
destinationInstitutionCode	string	The code identifying the destination institution.
destinationBankName	string	The name of the destination bank.
destinationAccountName	string	The name associated with the destination account.
destinationAccountNUBAN	string	The NUBAN (account number) of the destination account.
amount	integer	The amount that was transferred.
currency	string	The currency in which the transfer was executed (e.g., NGN).
narration	string	A brief description or note regarding the transfer.
transactionDate	string	The timestamp indicating when the transaction was processed.
transactionReference	string	The unique reference assigned to the transfer transaction.
tpTransactionID	string	A unique identifier provided by the third-party processor (if applicable).
sessionID	string	An identifier for tracking the transfer session.
transactionStatus	string	The current status of the transaction (e.g., AUTHORIZED, FAILED).
clientID	integer	The identifier of the client who initiated the transfer.
createdDate	string	The timestamp indicating when the transfer record was created.

Request

Body Params application/json

Example

{
    "sourceAccountNUBAN":"0000000127",
    "destinationInstitutionCode": "000001",
    "destinationAccountNUBAN":"0000000771",
    "clientBVN":"9898989811",
    "amount":1,
    "narration":"Test Transfer",
    "transactionReference":"NG-3434343t4892",
    "callback":"https://www.google.com"
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200Interbank Transfer

application/json

Body