Skip to main content

Get Banks

Description: Endpoint to get eligible banks in a country

Request Parameters

ParameterTypeDescriptionRequired
idIntegerUnique IdentifierYes
terminalIdstringTerminal IdentifierYes
terminalCardbooleanTerminal Card parameterYes
directionstringParameter to identify of message is a request or response. Value “request” is to be passed for requestsYes
transactionobjectAn object holding the transaction information as follows:Yes
destinationCountrystringCountry code for the destination country e.g. USYes
referencestringReference numberYes
senderNamestringSender NameYes
endPointstringEndpoint to call. FX for foreign exchange transaction.Yes
actionstringAction to be performed e.g. BL. The transaction type to be performed. Refer to section 1.2 for possible actions.Yes
accountstringAccount objectNo
beneficiaryobjectBeneficiary object. This is applicable when action is CP= cash pickupNo
senderobjectSender object. This is applicable when action is CP= cash pickupNo

Request Parameters

POST {base_url}/banks
curl `${base_url}/banks`
-H "Content-type: application/json"
-X POST
-d '{
"id":"2233",
"terminalId":"7000000004",
"terminalCard":false,
"direction":"request",
"transaction":{
"reference":"reference{{random_number}}",
"destinationCountry":"NG",
"senderName":"Tester sent",
"endPoint":"FX"
},
"action":"BL",
"account": null,
"beneficiary": null,
"sender": null
}
'