Banks

Overview

Retrieve the list of banks available for bank transfer in a given country. Use the returned code value as bank_code in both the Lookup Bank Account and PayOut bank_transfer endpoints.

Currently supported for Nigeria (NG).

GET Get Banks 

https://genesyspay.com/api/v2/banks
Request Body Parameters
Parameter Type Required Description
country string Required 2-letter country code. Currently only NG (Nigeria) is supported.
Example Request
curl -X GET https://genesyspay.com/api/v2/banks \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_PRIVATE_KEY" \
  -d '{"country": "NG"}'
Success Response
{
  "status": "success",
  "data": [
    { "name": "Access Bank",            "code": "044" },
    { "name": "First Bank of Nigeria",  "code": "011" },
    { "name": "Guaranty Trust Bank",    "code": "058" },
    { "name": "United Bank for Africa", "code": "033" },
    { "name": "Zenith Bank",            "code": "057" }
  ]
}
💡 Tip: Store the code value — it is required as bank_code in the Lookup Bank Account and PayOut bank_transfer requests.
Error Responses
Error Code HTTP Status Description
VALIDATION_ERROR 422 Missing or invalid country code
INVALID_COUNTRY 422 Country not recognized
INVALID_ARGUMENT 400 Bank list not supported for this country
INTERNAL_ERROR 500 Failed to fetch banks from provider
Previous: Lookup Next: PayIns