SKILL.md
Paystack Miscellaneous
Supporting APIs for bank lists, countries, and address verification.
Depends on: paystack-setup for the
paystackRequesthelper.
Endpoints
| Method | Endpoint | Description |
|---|---|---|
| GET | /bank |
List banks |
| GET | /country |
List supported countries |
| GET | /address_verification/states |
List states for AVS |
List Banks
| Param | Type | Required | Description |
|---|---|---|---|
country |
string | No | ghana, kenya, nigeria, south africa |
use_cursor |
boolean | No | Enable cursor pagination |
perPage |
integer | No | Records per page (default: 50, max: 100) |
paywithbank_transfer |
boolean | No | Filter banks supporting transfers |
paywithbank |
boolean | No | Filter banks supporting direct pay |
enabledforverification |
boolean | No | Filter banks supporting verification (SA) |
currency |
string | No | Filter by currency |
type |
string | No | mobile_money or ghipss (Ghana only) |
gateway |
string | No | emandate or digitalbankmandate |
next / previous |
string | No | Cursor pagination tokens |
includenipsort_code |
boolean | No | Include NIP institution code (Nigeria) |
// All Nigerian banks
const banks = await paystackRequest("/bank?country=nigeria");
// banks.data[0]: { name, slug, code, longcode, gateway, pay_with_bank, active, country, currency, type }
// Banks that support bank transfer payment
const transferBanks = await paystackRequest(
"/bank?country=nigeria&pay_with_bank_transfer=true"
);
// Ghana mobile money providers
const mobileMoney = await paystackRequest(
"/bank?country=ghana&type=mobile_money"
);
// South African banks with verification support
const saBanks = await paystackRequest(
"/bank?country=south%20africa&enabled_for_verification=true"
);Common Bank Codes (Nigeria)
| Bank | Code | Slug |
|---|---|---|
| Access Bank | 044 | access-bank |
| GTBank | 058 | guaranty-trust-bank |
| First Bank | 011 | first-bank-of-nigeria |
| UBA | 033 | united-bank-for-africa |
| Zenith Bank | 057 | zenith-bank |
| Wema Bank | 035 | wema-bank |
List Countries
const countries = await paystackRequest("/country");
// countries.data[0]:
// {
// id: 1,
// name: "Nigeria",
// iso_code: "NG",
// default_currency_code: "NGN",
// relationships: { currency: { data: ["NGN", "USD"] } }
// }List States (AVS)
Get states for address verification. The country param is the country code returned from the charge response (used during Address Verification challenges).
const states = await paystackRequest(
"/address_verification/states?country=CA"
);
// states.data[0]: { name: "Alberta", slug: "alberta", abbreviation: "AB" }