List Banks for Country

Returns the banks available for bank-account payouts in a given country, scoped to a processor configuration. Use this to populate bank selection UIs and to look up bankCode values for BankAccountRecipient.

Authentication

AuthorizationBearer

OAuth 2.0 access token issued by the CrissCross authorisation server.

Query parameters

countrystringRequired=3 characters

3-letter ISO country code (e.g. NGA).

processorConfigurationIdstringRequiredformat: "uuid"

Processor configuration UUID.

Response

Banks retrieved successfully.

bankslist of objects

Banks available in the requested country for the supplied processor configuration.

Errors

422

Unprocessable Entity Error

500

Internal Server Error

$	curl -G https://api.crisscross.money/v1/payout/banks \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d country=country \
>	-d processorConfigurationId=processorConfigurationId

1	{
2	"banks": [
3	{
4	"code": "044",
5	"name": "Access Bank Nigeria"
6	},
7	{
8	"code": "011",
9	"name": "First Bank of Nigeria"
10	},
11	{
12	"code": "058",
13	"name": "Guaranty Trust Bank"
14	},
15	{
16	"code": "232",
17	"name": "Sterling Bank"
18	},
19	{
20	"code": "035",
21	"name": "Wema Bank"
22	}
23	]
24	}