Paystack Miscellaneous

Supporting APIs for bank lists, countries, and address verification.

Depends on: paystack-setup for the paystackRequest helper.

Endpoints

List Banks

// 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)

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" }