Skip to main content

Overview

RapidTopup provides a fully isolated Sandbox (Test Mode) environment. You can test your API endpoints, payload inspector, error handling, and webhook signature verification without spending real funds or invoking live upstream carrier transactions.

1. Test API Keys (rtu_test_sk_...)

Every reseller account automatically has access to both Live Keys (rtu_live_sk_...) and Test Keys (rtu_test_sk_...). In your Developer Dashboard (/developer-api), use the Live / Test Mode Toggle at the top to switch between environments and copy your test secret key.

2. Interactive Test Balance & Refills

  • Starting Balance: Your sandbox test wallet starts with a simulated balance of ₦500,000.00.
  • Test Deductions: Test purchases deduct from your sandbox test balance. When your test balance drops too low, test purchases return 400 Insufficient Sandbox Balance so you can test insufficient balance error handling in your code.
  • 1-Click Refill: You can instantly reset and refill your sandbox balance back to ₦500,000.00 anytime by clicking “Top Up Test Balance” in your Developer Dashboard.

3. Test Scenarios & Phone Numbers

To simulate successful, pending, or failed transaction outcomes during testing, use these native test phone numbers in your POST /purchase request body:

4. Sandbox Webhooks

Test purchases made with your rtu_test_sk_... key will automatically trigger test webhook callbacks to your configured webhook URL, signed with your HMAC-SHA512 secret, allowing you to test your webhook listener end-to-end.