Developer docs
Build with HarrenaPay
A payments API for Nigeria: collect money into a virtual account, pay it out to a bank, and get webhooks for everything that happens in between.
Quickstart
Collect a payment in under five minutes.
Create a collection
POST /collections — account number + hosted checkout.
Pay out
POST /transfers — pay out to your revenue account.
Quick reference
Every endpoint on one page.
Base URL
HTTP
https: //www.harrenapay.com/api/public/v1The shape of it
POST /collections— you send an amount and a customer, we return a bank account and a checkout page.- Your customer transfers in. The credit is matched to your collection automatically and you get a
payment.successwebhook. - The money is yours, less the fee. Check
GET /balancesto see what you have. POST /transferspays it out to the bank account you registered.
Two integration models
- Merchant API key —
hpay_live_…/hpay_test_…. For your own integration: collections, transfers, balances, webhooks. This docs site focuses here. - Connect (OAuth) — act on a user's real HarrenaPay wallet via
/me/*, after they consent.
Escrow is one product on the platform
If you are selling something that needs to be delivered before the buyer pays, use escrow: the money is held until you release it, the seller accepts the terms and binds their own payout account, and you can take a commission with split.
Getting access
Sandbox keys (hpay_test_…) are free from Settings → API sandbox. Live keys and the Merchant console need the Business plan and an approved merchant application — merchant onboarding.
Pricing are quoted per merchant.