Developer docs

Environments

Same base URL, same endpoints. The key decides which world you are in.

Two environments, one API

There is no staging host. A sandbox key (hpay_test_…) and a live key (hpay_live_…) talk to the same endpoints — the key decides.

Sandbox

  • Free, from Settings → API sandbox. Up to 3 active keys.
  • Collections return a fake account number. No money moves, and a simulated collection never touches a ledger — so it can never trigger a real payout.
  • Complete a test payment with POST /escrow/{reference}/simulate-fund using the same test key.
  • Transfers are blocked (403 wrong_environment) — a test key can never move real money.

Live

  • Needs the Business plan and an approved merchant application (KYB). Both gates are real: a plan alone does not unlock live money.
  • Creates real collection accounts, real payouts and real webhooks.
  • Managed delivery (attaching a rate, booking a shipment) needs a live key.

Switching

Nothing to switch — use a different key. Keep the live key on your server only: it is shown once at creation, hashed at rest, and revocable from the console.

cURL
curl https://www.harrenapay.com/api/public/v1/collections \
  -H "Authorization: Bearer hpay_test_…"   # sandbox

curl https://www.harrenapay.com/api/public/v1/collections \
  -H "Authorization: Bearer hpay_live_…"   # live

Limits differ by plan

  • Starter — ₦200,000 per transaction
  • Growth — ₦1,000,000
  • Business — ₦5,000,000
  • Merchant Growth — ₦50,000,000
  • Merchant Enterprise — agreed in your contract

See Amounts & currency and pricing.