Appearance
List banks for a currency​
GET
/v1/wallet/fiat/{currency}/banks
Requires WITHDRAWALS_READ, granted by TREASURY_READ or TREASURY_WRITE or WITHDRAWALS_WRITE or BANK_ACCOUNTS_WRITE (bundles)
Lists the banks you can link a bank account at for this currency, with each bank's default branch code and whether it takes real-time (RTC) and RTGS payments. Use a bank's code as bank when you link a bank account.
Parameters​
Path Parameters
currency*
Fiat currency, e.g. ZAR.
Type
Requiredstring
Example
"ZAR"Responses​
OK
application/json
JSON
[
{
"code": "ABSA",
"displayName": "ABSA Bank",
"defaultBranchCode": "632005",
"rtcParticipant": true,
"rtgsParticipant": true,
"countryCode": "ZA"
},
{
"code": "CAPITEC",
"displayName": "Capitec Bank",
"defaultBranchCode": "470010",
"rtcParticipant": true,
"rtgsParticipant": false,
"countryCode": "ZA"
},
{
"code": "FNB",
"displayName": "FNB/RMB",
"defaultBranchCode": "250655",
"rtcParticipant": true,
"rtgsParticipant": true,
"countryCode": "ZA"
}
]
Samples​
Errors
| HTTP | Error | When |
|---|---|---|
| 400 | -11INVALID_REQUEST | The currency isn't recognised. |
| 400 | -112CURRENCY_NOT_SUPPORTED | Bank accounts can't be linked in this currency. |
| 451 | -15320FIAT_WITHDRAWALS_NOT_ALLOWED_FOR_CURRENCY | Your business's region doesn't allow withdrawals in this currency. |
| 500 | -15317BANK_REMOTE_FETCH_FAILURE | The bank list couldn't be loaded. Try again later. |
Plus the errors common to all signed endpoints.