🏦Bank Codes

This document serves as a reference guide to the Bank codes covered by Yogupay. Bank codes, Bank Names and SWIFT codes, are crucial for international financial transactions.

Get List of Banks

This endpoint is used to fetch bank codes for a specific country. The request should include the country parameter in the query string.

Request Parameters

• country (string, required) : The name of the country for which the banks are to be retrieved

Request & Responses example

The response will include a list of banks based on the specific country

Example Request

curl --location 'https://api.tumapay.com/api/get-banks?country=NIGERIA'

Example Success Response

{
    "success": true,
    "message": "API Request was successful",
    "status_code": 100,
    "country": "kenya",
    "banks": [
    
        {
            "BankName": "ABC Bank",
            "BankCode": "35"
        },
        {
            "BankName": "Absa Bank Kenya Plc",
            "BankCode": "03"
        },
        {
            "BankName": "Bank of Africa",
            "BankCode": "19"
        },

        ]
}

Example Failed Response

{
 "success": false,
 "message": "No banks found ",
 "status_code": 404,
 "country": country

}