List bank directories

GET

/api/v1/kyc/banks

const url = 'https://connect.payhero.africa/api/v1/kyc/banks';
const options = {method: 'GET', headers: {Authorization: 'Basic <credentials>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://connect.payhero.africa/api/v1/kyc/banks \
  --header 'Authorization: Basic <credentials>'

Every country whose bank account check takes a bank from a fixed list, with that list. Render it as a select rather than asking anyone to type a bank code.

Authorizations

basicAuth

Responses

200

One entry per supported country.

application/json

Array<object>

The banks one country’s bank account check accepts.

object

country

string

label

string

field

The request field the chosen bank value belongs in.

string

Allowed values: bank_code bank_id

check

string

banks

Array<object>

object

value

string

label

string

Example

[
  {
    "country": "NG",
    "label": "Nigeria",
    "field": "bank_code",
    "check": "bank_account_ng",
    "banks": [
      {
        "value": "058",
        "label": "Guaranty Trust Bank Plc"
      }
    ]
  }
]

401

Missing or invalid Basic auth credentials.

application/json

object

error_code

string

error_message

string

status_code

integer

Example

{
  "error_code": "invalid_argument",
  "error_message": "the transaction amount is insufficient as it wont cater for cost: (4.62)",
  "status_code": 400
}