DevelopersVirtual AccountTesting
Testing
Use the Staging platform to validate your integration before going live.
ℹ️
Staging credentials are separate from Production — register at staging-business.kongapay.com/signup and contact support for your Staging API keys.
Staging Base URL
Base URL
https://staging-api.kongapay.comTest Scenarios
1
Create a nonstatic VA with an amount
→Returns active account number and reference.
2
Send the exact amount to the nonstatic VA
→Callback fires with status: success.
3
Send the wrong amount to a nonstatic VA
→Payment rejected. No success callback.
4
Create a static-flex VA and send any amount
→All amounts accepted. Callback fires.
5
Submit duplicate reference
→Returns 409 Conflict error.
6
Cancel nonstatic VA before payment
→VA status changes to cancelled.
7
GET /virtual/transactions with pagination
→Returns a paginated list of transactions.
8
Simulate callback fallback URL
→Callback delivered to fallback URL when primary is unreachable.
Test Data
Sample nonstatic request (staging)
{
"reference": "TEST-${Date.now()}",
"account_name": "Test Order",
"merchant_id": "M-001",
"amount": 5000,
"expiers_in": 60,
"type": "nonstatic",
"callback_url": "https://your-ngrok-url.ngrok.io/webhook",
"merchant": "others"
}💡
Use a tool like ngrok or localtunnel during development to expose your local webhook endpoint to the internet so KongaPay can reach it.
Pre-Launch Checklist
| Scenario | Tested? |
|---|---|
| Nonstatic VA creation and exact amount payment | ☐ TODO |
| Amount mismatch rejection | ☐ TODO |
| Static-flex with varying amounts | ☐ TODO |
| Duplicate reference 409 handling | ☐ TODO |
| Nonstatic cancellation | ☐ TODO |
| Webhook callback receipt and validation | ☐ TODO |
| Fallback callback URL delivery | ☐ TODO |
| Paginated transaction listing | ☐ TODO |