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.

Base URL

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

The shape of it

  1. POST /collections — you send an amount and a customer, we return a bank account and a checkout page.
  2. Your customer transfers in. The credit is matched to your collection automatically and you get a payment.success webhook.
  3. The money is yours, less the fee. Check GET /balances to see what you have.
  4. POST /transfers pays 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.