Get bank list

Description

This endpoint allows you to retrieve a list of banks. This is the first call required to get the list of all banks integrated to the USSD service. List of banks will be displayed to your customer and your customer is expected to choose their bank which will be used to invoke a USSD payment.

Request

Method: GET

URL: [API Base URL]/payments/ussd/getBankList

Headers: x-api-key: [API Key]

TEST BASE URL: https://ent-test.loosechange.cloud

Response

Success: 200 OK

Example Response Body:

{
    "status": true,
    "message": "bank list fetched successfully",
    "data": [
        {
            "BankName": "First Bank of Nigeria",
            "BankCode": "894",
        },
        {
            "BankName": "Guaranted Trust Bank",
            "BankCode": "737",
        },
        {
            "BankName": "Access Bank",
            "BankCode": "901",
        },
        {
            "BankName": "Zenith Bank",
            "BankCode": "966",
        }
    ]
}