List All Supported Banks — GET /banks?country_code=NG

Returns all banks supported by Paylink in a given country. Each bank record includes a human-readable name and a machine-readable code. Use these codes when initializing transfers (destination_bank_code), issuing refunds (bank_code), or resolving account details.

Cache the bank list in your application and refresh it periodically rather than calling this endpoint on every transaction. The list changes infrequently.

GET https://sandbox.lyseis-pay.com/banks

This endpoint does not require authentication headers. It is publicly accessible.

Query parameters

string

default:"NG"

Uppercase ISO 3166-1 alpha-2 country code specifying which country’s banks to return. Defaults to NG (Nigeria).

Example request

GET https://sandbox.lyseis-pay.com/banks?country_code=NG

Example response

{
  "status": "success",
  "data": [
    {
      "bank_name": "Access Bank",
      "bank_code": "044"
    },
    {
      "bank_name": "Example Bank",
      "bank_code": "058"
    },
    {
      "bank_name": "First Bank of Nigeria",
      "bank_code": "011"
    },
    {
      "bank_name": "Guaranty Trust Bank",
      "bank_code": "058"
    },
    {
      "bank_name": "Zenith Bank",
      "bank_code": "057"
    }
  ]
}

Response fields

string

Request outcome. success indicates the list was returned successfully.

array

Array of bank objects supported in the requested country.

Show Bank object fields

string

The full display name of the bank.

string

The bank code to use in transfer and refund requests.

Where to use bank codes

Endpoint	Field
`POST /disbursements/initialize`	`destination_bank_code`
`POST /refunds/initialize`	`bank_code`
`POST /banks/resolve`	`bank`
`POST /direct-debits/mandates`	`bank_code`

Payments

Virtual Accounts

Direct Debits

Refunds

Transfers

Banks

List All Supported Banks — GET /banks?country_code=NG

Query parameters

Example request

Example response

Response fields

Where to use bank codes

​Query parameters

​Example request

​Example response

​Response fields

​Where to use bank codes

Query parameters

Example request

Example response

Response fields

Where to use bank codes