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/banksOptional 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| Field | Type | Notes |
|---|---|---|
| bank_code | string | Bank code from GET /banks. |
| account_number | string | 10-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.