Run in Apidog
Bulk Interbank Transfer# Submits several interbank transfers in one request. Each item is validated and queued on its own, in order. A 200 only means the transfers were accepted for processing; use GET /core/transfer/query/{transactionReference} or the item callback for the outcome. Request Body# A JSON array. Each item has these fields: Field Name Type Required Description sourceAccountNUBAN string TRUE Account to debit destinationAccountBVN string TRUE BVN of the beneficiary, from the name enquiry destinationInstitutionCode string TRUE Beneficiary institution code destinationAccountNUBAN string TRUE Beneficiary account number destinationBankName string TRUE Beneficiary bank name destinationAccountName string TRUE Beneficiary account name nameInquiryReference string TRUE Reference returned by the name enquiry amount number TRUE Amount, 0.01 or greater narration string TRUE Transfer narration transactionReference string TRUE Your unique reference for the item callback string FALSE URL notified when the transfer completes
Response# A JSON array with one entry per accepted item. Field Name Type Description id integer Transfer ID type string INTERBANK_TRANSFERdestinationInstitutionCode string Beneficiary institution code destinationBankName string Beneficiary bank destinationAccountName string Beneficiary name destinationAccountNUBAN string Beneficiary account amount number Amount narration string Narration transactionReference string Your reference transactionStatus string Status at acceptance, normally PENDING
The request is not atomic: if one item is rejected, items before it may already have been accepted. Query each reference before re-sending. Request Add the parameter Authorization
to Headers ，whose value is to concatenate the Token after the Bearer. Example: Authorization: Bearer ********************
Token URL: {{tpGatewayHostUrl}}/security/authenticate
or
Body Params application/json
[
{
"sourceAccountNUBAN" : "0123456789" ,
"destinationAccountBVN" : "22222222222" ,
"destinationInstitutionCode" : "000013" ,
"destinationAccountNUBAN" : "0987654321" ,
"destinationBankName" : "Sample Bank" ,
"destinationAccountName" : "Sample Beneficiary" ,
"nameInquiryReference" : "NIR-0001" ,
"amount" : 2500.0 ,
"narration" : "Vendor payment" ,
"transactionReference" : "BULK-REF-0001" ,
"callback" : "https://example.com/callback"
}
] Request Code Samples
curl --location '/core/transfer/bulk' \
--header 'Content-Type: application/json' \
--data '[
{
"sourceAccountNUBAN": "0123456789",
"destinationAccountBVN": "22222222222",
"destinationInstitutionCode": "000013",
"destinationAccountNUBAN": "0987654321",
"destinationBankName": "Sample Bank",
"destinationAccountName": "Sample Beneficiary",
"nameInquiryReference": "NIR-0001",
"amount": 2500.0,
"narration": "Vendor payment",
"transactionReference": "BULK-REF-0001",
"callback": "https://example.com/callback"
}
]' Responses
[
{
"id" : 501 ,
"type" : "INTERBANK_TRANSFER" ,
"destinationInstitutionCode" : "000013" ,
"destinationBankName" : "Sample Bank" ,
"destinationAccountName" : "Sample Beneficiary" ,
"destinationAccountNUBAN" : "0987654321" ,
"amount" : 2500.0 ,
"narration" : "Vendor payment" ,
"transactionReference" : "BULK-REF-0001" ,
"transactionStatus" : "PENDING"
}
]
Modified at 2026-11-02 05:51:05
