Overview
The Monei sandbox environment allows you to test your integration without using real money or affecting production data. Test all features in a safe, isolated environment. What you’ll learn:- Accessing the sandbox
- Test credentials
- Simulating transactions
- Test data
- Limitations
- Moving to production
Sandbox vs Production
| Feature | Sandbox | Production |
|---|---|---|
| API Base URL | https://api.dev.monei.cc | https://api.monei.cc |
| API Key Prefix | sk_test_... | sk_live_... |
| Real Money | No | Yes |
| Real Bank Transfers | No | Yes |
| Real Bill Payments | No | Yes |
| Blockchain | Testnet | Mainnet |
| Data Persistence | Temporary | Permanent |
Getting Started
1. Get Sandbox API Key
Sign Up
Create a Monei account at monei.cc
2. Configure SDK
Test Credentials
Test Bank Accounts
Use these test bank accounts for payouts and verification:| Bank | Account Number | Account Name | Status |
|---|---|---|---|
| Access Bank | 0690000031 | TEST USER | Success |
| Zenith Bank | 1111111111 | FAILED ACCOUNT | Fails |
Test Cards
Use these test cards for deposits:| Card Number | Expiry | CVV | Outcome |
|---|---|---|---|
| 5531886652142950 | 09/32 | 564 | Success |
| 5438898014560229 | 10/32 | 123 | Requires PIN |
| 4187427415564246 | 09/32 | 828 | Requires OTP |
| 4242424242424242 | 12/25 | 100 | Declined |
Test Phone Numbers
Use these for airtime/data testing:| Phone Number | Network | Outcome |
|---|---|---|
| 08012345678 | MTN | Success |
| 08098765432 | Airtel | Success |
| 08011111111 | Glo | Failed |
| 08022222222 | 9mobile | Pending |
Test Meter Numbers
For electricity testing:| Meter Number | Disco | Outcome |
|---|---|---|
| 12345678901 | IKEDC | Success (returns token) |
| 98765432109 | EKEDC | Success (returns token) |
| 11111111111 | AEDC | Failed |
| 22222222222 | PHED | Invalid meter |
Testing Workflows
Test Naira Deposit
Test Bill Payment
Test Offramp
Test EVM Transaction
Sandbox Limitations
No Real Money
No Real Money
Limitation: Sandbox uses test money, not real currencyImpact:
- No actual bank transfers
- No real bill payments
- Crypto uses testnets
- Use test credentials
- Simulate all scenarios
- Verify integration logic
Data Persistence
Data Persistence
Limitation: Sandbox data may be reset periodicallyImpact:
- Test data cleared monthly
- Transaction history temporary
- Don’t rely on long-term storage
- Export important test data
- Document test scenarios
- Use production for real data
Processing Times
Processing Times
Limitation: Instant processing in sandboxImpact:
- No real delays
- Instant confirmations
- Can’t test timeout handling
- Manually simulate delays
- Test timeout logic separately
- Use production for real timing
Blockchain Networks
Blockchain Networks
Limitation: Uses testnets onlyNetworks:
- Base Sepolia (not Base mainnet)
- Polygon Mumbai (not Polygon mainnet)
- Solana Devnet (not mainnet-beta)
- Get testnet tokens from faucets
- Use testnet explorers
- Verify on testnet first
Webhooks
Webhooks
Limitation: Webhook behavior may differImpact:
- Faster delivery
- May skip some retries
- Different timing
- Test webhook handling
- Verify signature validation
- Check idempotency
Test Scenarios
Successful Flow
Failed Flow
Testing Checklist
Deposits
Card deposit success
Card deposit with PIN
Card deposit with OTP
Card declined
Bank transfer
USSD deposit
Card deposit with PIN
Card deposit with OTP
Card declined
Bank transfer
USSD deposit
Payouts
Bank transfer success
Bank transfer failed
P2P transfer
Insufficient balance
Invalid account
Bank transfer failed
P2P transfer
Insufficient balance
Invalid account
Bill Payments
Airtime success
Data bundle
Cable TV
Electricity
Payment failed
Invalid customer
Data bundle
Cable TV
Electricity
Payment failed
Invalid customer
Offramp
Initiate swap
Crypto deposit
Fiat transfer
Order tracking
Failed conversion
Crypto deposit
Fiat transfer
Order tracking
Failed conversion
Crypto
EVM transactions
Solana transactions
Token swaps
Portfolio tracking
Balance checks
Solana transactions
Token swaps
Portfolio tracking
Balance checks
Webhooks
Signature verification
Event handling
Retry logic
Idempotency
Error handling
Event handling
Retry logic
Idempotency
Error handling
Moving to Production
When ready to go live:Update Configuration
- Change base URL to production
- Use production API key
- Update environment variables
Security Review
- Enable HTTPS
- Verify webhook signatures
- Implement rate limiting
- Review access controls
Best Practices
Test Thoroughly
Test all scenarios before production
Use Test Data
Always use provided test credentials
Document Tests
Keep record of test scenarios and results
Automate Testing
Create automated test suites
Keep Sandbox
Use sandbox for ongoing development
Monitor Both
Monitor sandbox and production separately
Next Steps
Testing Tools
Tools for testing your integration
Security
Security best practices
Error Handling
Handle errors properly
Webhooks
Test webhook integration

