Before Going Live
1
Secure your API key
Store your API key in an environment variable, not hardcoded in source code. Confirm it is not in any public repository.
2
Test a real purchase
Make at least one live purchase call and confirm the response contains a valid
reference.3
Implement idempotency
Every
POST /purchase call includes a unique idempotency_key.4
Add two-step verification
For all Cable TV and Electricity purchases,
GET /services/verify is called first and the customer name is displayed to the user for confirmation.5
Set up webhooks
A webhook URL is configured in the Developer Dashboard. Your endpoint verifies the
X-RapidTopup-Signature header and returns 200 OK.6
Implement /requery fallback
If a webhook is missed or a purchase returns
pending, your system calls POST /requery to sync the status.7
Handle retry logic
Your app implements exponential backoff for
429 Too Many Requests and 503 responses.8
Handle the pending status
Your UI gracefully shows a “processing” state when a transaction returns
pending instead of failing silently.Quick Reference
Need help?
Open a support ticket with your transaction
reference or error_id and our team will respond within 24 hours.
