Get Banks

Tuition payment is dependent on banks processing forex. To get a list of supported banks, you will need to send a request to this endpoint:

Endpoint

{{baseurl}}/misc/banks/{currency}

This is a GET request, and it requires the following parameter.

FieldData TypeDescription
currencyStringThe target currency intended for tuition payment.

This is how your request should look:

{
  "customerId": "string",
  "reference": "string"
}

If your request is successful, the response will look like this:

{
  "success": true,
  "statusCode": 200,
  "message": "Fetched list of bank accounts",
  "data": {
    "payload": [
      {
        "id": "d88343f6-f1c2-4e04-8762-39c7add0c1f8",
        "name": "Shiga Technologies LTD / test testing",
        "number": "",
        "bank": "Testing Bank",
        "bankCode": "000017",
        "currency": "NGN",
        "isVirtual": true,
        "createdAt": "2024-05-01T22:37:54.322Z",
        "updatedAt": "2024-05-01T22:37:54.322Z",
        "businessId": "0bb1dfc6-a74c-4e53-b41a-4a0c1eab188e",
        "reference": "shsi29wns02j9whdhnw012bd9dh2w",
        "customerId": ""
      }
    ],
    "meta": {
      "total": 1
    }
  }
}