Utils

Reference data

Helper endpoints that make merchant creation reliable: the canonical list of bank names per country, and which corridors are live. Call these before you create merchants and payments to avoid avoidable 400s. These are public endpoints — no authentication required.

GET /utils/banks/:country

List banks

Returns the valid bank names for a country as a string array — use the exact name when creating a merchant. Add ?showDetails=true to get full objects instead. The country path parameter is case-insensitive.

⚠️

The code is not the same as the name — e.g. CAPITEC BANK has code CAPITEC. branchCode is South-Africa specific; Kenya and Nigeria return their own numeric / NIP codes and no branchCode.

Path parameter

country*

string

SouthAfrica · Nigeria · Kenya (case-insensitive)

GET /utils/banks/SouthAfrica

[
  "ABSA",
  "ACCESS BANK",
  "AFRICAN BANK",
  "CAPITEC BANK",
  "DISCOVERY BANK",
  "FNB",
  "INVESTEC BANK LIMITED",
  "NEDBANK",
  "GOTYME BANK"
]

GET /utils/countries

Supported countries

The supported country values, returned as a plain string array. Add ?showIsoCodes=true to get ISO-style codes instead. The corridor grid below shows how each is used as a country / fromCountry.

GET /utils/countries

[
  "BTC",
  "Bitcoin",
  "SouthAfrica",
  "Nigeria",
  "Kenya",
  "Europe",
  "UnitedKingdom",
  "USDT",
  "Tether"
]

🇿🇦South Africa

SouthAfrica · ZAR

Payout & source

🇳🇬Nigeria

Nigeria · NGN

Payout & source

🇰🇪Kenya

Kenya · KES

M-Pesa & PesaLink

🇬🇧United Kingdom

UnitedKingdom · GBP

Source only

🇪🇺Europe

Europe · EUR

Source only

⚡Bitcoin

BTC · Lightning

Payout & source

₮Tether

USDT · ERC-20

Source only