Developer docs

Banks

Every Nigerian bank we can send money to, with the code you pass when you register a payout destination.

List banks

HTTP
GET https://www.harrenapay.com/api/public/v1/banks

Optional query parameters: q (search by name or code) and limit(default 200, max 700).

cURL
curl "https://www.harrenapay.com/api/public/v1/banks?q=zenith" \
  -H "Authorization: Bearer hpay_live_…"
JSON
{
  "banks": [
    { "code": "057", "name": "Zenith bank PLC" },
    { "code": "035", "name": "Wema Bank PLC" }
  ],
  "total": 703
}

Confirm an account

Run a name enquiry before you register a revenue account, so you can show the merchant the exact name the bank holds.

HTTP
GET https://www.harrenapay.com/api/public/v1/banks/resolve?bank_code=057&account_number=0123456789
FieldTypeNotes
bank_codestringBank code from GET /banks.
account_numberstring10-digit account number.
JSON
{
  "account_number": "0123456789",
  "bank_code": "057",
  "bank_name": "Zenith bank PLC",
  "account_name": "ADA OBI"
}

Next: register it as your revenue account, then pay out.