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-fundusing 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_…" # liveLimits 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.