Sandbox Environment

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

Create a Monei account at monei.cc

Access Dashboard

Navigate to API Keys

Go to Settings → API Keys → Sandbox

Copy Test Key

Copy your sandbox API key (starts with sk_test_)

2. Configure SDK

import MoneiSDK from 'monei-sdk';

// Sandbox configuration
const monei = new MoneiSDK({
  apiKey: process.env.MONEI_SANDBOX_API_KEY, // sk_test_...
  baseUrl: 'https://api.dev.monei.cc',
});

// Verify sandbox mode
console.log('base url:', monei.baseUrl); // 'sandbox'

from monei import MoneiClient

# Sandbox configuration
monei = MoneiClient(
    api_key=os.getenv('MONEI_SANDBOX_API_KEY'),  # sk_test_...
    base_url='https://api.dev.monei.cc'
)

# Verify sandbox mode
print(f'Environment: {monei.environment}')  # 'sandbox'

# .env.sandbox
MONEI_API_KEY=sk_test_abc123xyz456...
MONEI_ENVIRONMENT=sandbox
MONEI_BASE_URL=https://api.dev.monei.cc

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 card deposit
const deposit = await monei.wallet.depositWithCard({
  amount: 10000,
  reference: 'TEST-DEP-' + Date.now(),
  currency: 'NGN',
  card: {
    cardNumber: '5531886652142950',
    cvv: '564',
    expiryMonth: '09',
    expiryYear: '32',
    cardHolderName: 'TEST USER'
  },
  narration: 'Test deposit'
});

console.log('Deposit Reference:', deposit.reference);
console.log('Status:', deposit.status);

// Handle next action if needed
if (deposit.nextAction) {
  console.log('Action required:', deposit.nextAction.type);
  // In sandbox, you can use test PIN: 1234
}

# Test card deposit
deposit = monei.wallet.deposit_with_card(
    amount=10000,
    reference=f'TEST-DEP-{int(time.time())}',
    currency='NGN',
    card={
        'card_number': '5531886652142950',
        'cvv': '564',
        'expiry_month': '09',
        'expiry_year': '32',
        'card_holder_name': 'TEST USER'
    },
    narration='Test deposit'
)

print(f'Reference: {deposit.reference}')
print(f'Status: {deposit.status}')

Test Bill Payment

// Test MTN airtime purchase
const payment = await monei.bills.pay({
  billerId: 'mtn-ng',
  customerId: '08012345678', // Test number
  amount: 100,
  type: 'PREPAID',
  reference: 'TEST-BILL-' + Date.now()
});

console.log('Payment Reference:', payment.reference);
console.log('Status:', payment.status);
// In sandbox, status will be 'successful' immediately

# Test airtime
payment = monei.bills.pay(
    biller_id='mtn-ng',
    customer_id='08012345678',  # Test number
    amount=100,
    type='PREPAID',
    reference=f'TEST-BILL-{int(time.time())}'
)

print(f'Reference: {payment.reference}')
print(f'Status: {payment.status}')

Test Offramp

// Test crypto to fiat
const offramp = await monei.offramp.initiateSwap({
  amount: 100,
  token: 'USDT',
  network: 'base',
  fiatCurrency: 'NGN',
  bankCode: '058',
  accountNumber: '0123456789', // Test account
  accountName: 'TEST ACCOUNT'
});

console.log('Order Reference:', offramp.reference);
console.log('Deposit Address:', offramp.onChain.depositAddress);
console.log('Expected Amount:', offramp.onChain.expectedAmount);

// In sandbox, you can simulate crypto deposit
// The address will be a test address on testnet

# Test offramp
offramp = monei.offramp.initiate_swap(
    amount=100,
    token='USDT',
    network='base',
    fiat_currency='NGN',
    bank_code='058',
    account_number='0123456789',  # Test account
    account_name='TEST ACCOUNT'
)

print(f'Reference: {offramp.reference}')
print(f'Deposit Address: {offramp.on_chain.deposit_address}')

Test EVM Transaction

// Test sending on EVM testnet
const tx = await monei.evm.sendNativeToken({
  to: '0x742d35Cc6634C0532925a3b844Bc454e4438f44e',
  amount: '0.01',
  chainId: 84532 // Base Sepolia testnet
});

console.log('Transaction Hash:', tx.txHash);
console.log('View on Explorer:', `https://sepolia.basescan.org/tx/${tx.txHash}`);

# Test EVM transaction
tx = monei.evm.send_native_token(
    to='0x742d35Cc6634C0532925a3b844Bc454e4438f44e',
    amount='0.01',
    chain_id=84532  # Base Sepolia testnet
)

print(f'TX Hash: {tx.tx_hash}')

Sandbox Limitations

No Real Money

Limitation: Sandbox uses test money, not real currencyImpact:

No actual bank transfers
No real bill payments
Crypto uses testnets

Testing:

Use test credentials
Simulate all scenarios
Verify integration logic

Data Persistence

Limitation: Sandbox data may be reset periodicallyImpact:

Test data cleared monthly
Transaction history temporary
Don’t rely on long-term storage

Best Practice:

Export important test data
Document test scenarios
Use production for real data

Processing Times

Limitation: Instant processing in sandboxImpact:

No real delays
Instant confirmations
Can’t test timeout handling

Testing:

Manually simulate delays
Test timeout logic separately
Use production for real timing

Blockchain Networks

Limitation: Uses testnets onlyNetworks:

Base Sepolia (not Base mainnet)
Polygon Mumbai (not Polygon mainnet)
Solana Devnet (not mainnet-beta)

Testing:

Get testnet tokens from faucets
Use testnet explorers
Verify on testnet first

Webhooks

Limitation: Webhook behavior may differImpact:

Faster delivery
May skip some retries
Different timing

Testing:

Test webhook handling
Verify signature validation
Check idempotency

Test Scenarios

Successful Flow

// Complete successful deposit flow
async function testSuccessfulDeposit() {
  console.log('Testing successful deposit...\n');
  
  // 1. Get wallet balance before
  const walletBefore = await monei.wallet.me();
  const balanceBefore = parseFloat(walletBefore.nairaBalance);
  console.log('Balance before:', balanceBefore);
  
  // 2. Make deposit
  const deposit = await monei.wallet.depositWithCard({
    amount: 5000,
    reference: 'TEST-SUCCESS-' + Date.now(),
    card: {
      cardNumber: '5531886652142950',
      cvv: '564',
      expiryMonth: '09',
      expiryYear: '32',
      cardHolderName: 'TEST USER'
    }
  });
  
  console.log('Deposit initiated:', deposit.reference);
  
  // 3. Wait a bit (in sandbox, instant)
  await new Promise(resolve => setTimeout(resolve, 1000));
  
  // 4. Check balance after
  const walletAfter = await monei.wallet.me();
  const balanceAfter = parseFloat(walletAfter.nairaBalance);
  console.log('Balance after:', balanceAfter);
  console.log('Difference:', balanceAfter - balanceBefore);
  
  // 5. Verify
  if (balanceAfter === balanceBefore + 5000) {
    console.log('✓ Test passed!');
  } else {
    console.log('✗ Test failed!');
  }
}

await testSuccessfulDeposit();

# Test successful deposit
async def test_successful_deposit():
    print('Testing successful deposit...\n')
    
    # Before
    wallet_before = monei.wallet.me()
    balance_before = float(wallet_before.naira_balance)
    print(f'Before: ₦{balance_before}')
    
    # Deposit
    deposit = monei.wallet.deposit_with_card(
        amount=5000,
        reference=f'TEST-SUCCESS-{int(time.time())}',
        card={
            'card_number': '5531886652142950',
            'cvv': '564',
            'expiry_month': '09',
            'expiry_year': '32',
            'card_holder_name': 'TEST USER'
        }
    )
    
    print(f'Initiated: {deposit.reference}')
    
    # Wait
    await asyncio.sleep(1)
    
    # After
    wallet_after = monei.wallet.me()
    balance_after = float(wallet_after.naira_balance)
    print(f'After: ₦{balance_after}')
    print(f'Difference: ₦{balance_after - balance_before}')
    
    # Verify
    if balance_after == balance_before + 5000:
        print('✓ Test passed!')
    else:
        print('✗ Test failed!')

await test_successful_deposit()

Failed Flow

// Test failed payment
async function testFailedPayment() {
  console.log('Testing failed payment...\n');
  
  try {
    // Use test account that fails
    const payment = await monei.bills.pay({
      billerId: 'mtn-ng',
      customerId: '08011111111', // Test number that fails
      amount: 100,
      type: 'PREPAID'
    });
    
    console.log('✗ Should have failed!');
  } catch (error) {
    console.log('✓ Failed as expected');
    console.log('Error:', error.message);
  }
}

await testFailedPayment();

# Test failed payment
async def test_failed_payment():
    print('Testing failed payment...\n')
    
    try:
        # Fails
        payment = monei.bills.pay(
            biller_id='mtn-ng',
            customer_id='08011111111',  # Fails
            amount=100,
            type='PREPAID'
        )
        
        print('✗ Should have failed!')
    except Exception as error:
        print('✓ Failed as expected')
        print(f'Error: {error}')

await test_failed_payment()

Testing Checklist

Deposits

Card deposit success
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

Bill Payments

Airtime success
Data bundle
Cable TV
Electricity
Payment failed
Invalid customer

Offramp

Initiate swap
Crypto deposit
Fiat transfer
Order tracking
Failed conversion

Crypto

EVM transactions
Solana transactions
Token swaps
Portfolio tracking
Balance checks

Webhooks

Signature verification
Event handling
Retry logic
Idempotency
Error handling

Moving to Production

When ready to go live:

Complete Testing

Test all workflows
Verify error handling
Check edge cases
Document test results

Get Production API Key

Generate live API key (sk_live_…)
Store securely
Never commit to git

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

Monitoring Setup

Configure alerts
Set up logging
Enable error tracking
Monitor transactions

Start Small

Test with small amounts
Monitor closely
Gradually increase
Keep sandbox for testing

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

​Overview

​Sandbox vs Production

​Getting Started

​1. Get Sandbox API Key

​2. Configure SDK

​Test Credentials

​Test Bank Accounts

​Test Cards

​Test Phone Numbers

​Test Meter Numbers

​Testing Workflows

​Test Naira Deposit

​Test Bill Payment

​Test Offramp

​Test EVM Transaction

​Sandbox Limitations

​Test Scenarios

​Successful Flow

​Failed Flow

​Testing Checklist

Deposits

Payouts

Bill Payments

Offramp

Crypto

Webhooks

​Moving to Production

​Best Practices

Test Thoroughly

Use Test Data

Document Tests

Automate Testing

Keep Sandbox

Monitor Both

​Next Steps

Testing Tools

Security

Error Handling

Webhooks

Overview

Sandbox vs Production

Getting Started

1. Get Sandbox API Key

2. Configure SDK

Test Credentials

Test Bank Accounts

Test Cards

Test Phone Numbers

Test Meter Numbers

Testing Workflows

Test Naira Deposit

Test Bill Payment

Test Offramp

Test EVM Transaction

Sandbox Limitations

Test Scenarios

Successful Flow

Failed Flow

Testing Checklist

Moving to Production

Best Practices

Next Steps