Banks

List valid bank codes, and resolve an account before an offramp.

Resolve a beneficiary's bank account before you create an offramp order.

List banks

Retrieve the codes accepted by bank_account.bank_code.

curl https://engine-api.pilot.pulseshiga.io/v1/banks \
  -H "X-API-Key: <your key>"
{
  "status": true,
  "data": [
    { "name": "Access Bank", "code": "044" },
    { "name": "GTBank",      "code": "058" }
  ]
}

Resolve an account

Resolve the selected account before you create an offramp order. Show the returned account_name to the customer for confirmation.

curl https://engine-api.pilot.pulseshiga.io/v1/banks/resolve \
  -H "X-API-Key: <your key>" \
  -H "Content-Type: application/json" \
  -d '{ "bank_code": "058", "account_number": "0123456789" }'
{
  "status": true,
  "data": {
    "account_number": "0123456789",
    "account_name": "ADA OBI",
    "bank_code": "058",
    "bank_name": "GTBank"
  }
}

Account numbers contain 10 digits. An unconfirmed account returns account_verification_failed. Order creation repeats this check and rejects an invalid account.

See the List banks and Resolve a bank account references.

On this page