4.Test Papi in the sandbox environment
The sandbox environment is a testing space where you can explore and simulate all payment features without processing real transactions. It is designed to help developers interact with Papi, verify their integration, and ensure everything works smoothly before transitioning to the production environment.
Use the sandbox to play with Papi, test various scenarios, and get familiar with the entire payment flow, from generating payment links to handling callbacks.
Testing payment methods
Visa
Use the single test card below and vary the transaction amount to trigger each authorization outcome — the card number, expiry and CVV stay the same, only the amount changes the result. These are Cybersource amount-based triggers; the trigger value is the total amount sent for authorization, fees included.
Any outcome other than a successful authorization is reported by Papi as failed.
| Card Number | Expiry Date | CVV | Amount (trigger · fees incl.) | Scenario | Final Status | Description |
|---|---|---|---|---|---|---|
4242 4242 4242 4242 | Any future date | Any 3 digits | 1000.00 | Payment Authorized | success | Transaction authorized and completed successfully. |
4242 4242 4242 4242 | Any future date | Any 3 digits | 4051.00 | Insufficient funds | failed | The card does not have enough funds to cover the amount. The issuer declines the authorization, so Papi marks the payment as failed. |
4242 4242 4242 4242 | Any future date | Any 3 digits | 4012.00 | Unauthorized card | failed | The card is not authorized for this transaction. The issuer declines the authorization, so Papi marks the payment as failed. |
Orange Money
| Phone Number | Scenario | Final Status | Description |
|---|---|---|---|
0321230001 | Success | success | Transaction completed successfully |
0321230002 | Insufficient Balance | failed | Insufficient funds in account |
0321230003 | Invalid Phone Number | failed | Phone number format or validity issue |
0321230004 | Account Blocked | failed | Account is blocked or restricted |
MVola
| Phone Number | Scenario | Final Status | Description |
|---|---|---|---|
0341230001 | Success | success | Transaction completed successfully |
0341230002 | Insufficient Balance | failed | Insufficient funds in account |
0341230003 | Invalid Phone Number | failed | Phone number format or validity issue |
0341230004 | Account Blocked | failed | Account is blocked or restricted |
Airtel
| Phone Number | Scenario | Final Status | Description |
|---|---|---|---|
331230001 | Success | success | Transaction completed successfully |
331230002 | Insufficient Balance | failed | Insufficient funds in account |
331230003 | Invalid Phone Number | failed | Phone number format or validity issue |
331230004 | Account Blocked | failed | Account is blocked or restricted |
Key points to remember
- The sandbox environment is purely for testing purposes, so no real money is involved.
- Always validate your API integration thoroughly in the sandbox before switching to production.
- Use the phone numbers, and the test card with the trigger amounts listed above, to simulate specific scenarios (success, insufficient funds, unauthorized card, etc.).
By using the provided test credentials and simulating different payment scenarios, you can confidently prepare your system for real-world use in the production environment.