Going live
There is no sandbox yet: every call moves real money. Start with a small top-up and a few low-value payments to your own numbers.
Checklist
- The API key is kept on your servers only, in a secret store.
- Your servers' IP addresses are on the IP allowlist.
- Your team in the dashboard is only the people who need it, with the lowest role that works.
- Every
POST /billssends anIdempotency-Keythat is unique per payment and reused on retries. - Timeouts and 5xx responses are retried with the same key, never a new one.
-
PENDINGpayments are followed to the end by webhook orGET /bills/{reference}, and never paid again. - Your webhook checks the signature and the timestamp, answers 2xx quickly, and ignores repeated
ids. - Prepaid electricity tokens reach your customer when the payment succeeds.
- You watch your wallet balance (
GET /wallet) and top up before it runs low. - Amounts are handled as strings or big integers, never floats.
- Biller and product lists are cached, not fetched on every payment.