Skip to content

Test Phone Numbers & Payment Simulation

This page describes the test phone numbers, test bank accounts, and rules available in the sandbox environment for both Mobile Money and Bank channels.

These mechanisms allow developers to simulate different transaction outcomes (success, pending, failure) without processing real payments.


Test Numbers

Channel: mobile_money

Use the test phone numbers below to simulate Mobile Money payments based on the operator, transaction type, and expected final status.

OperatorPayeeTransaction TypeFinal Status
ORANGE_CI+2250707000200One StepSuccess
ORANGE_CI+2250707000201Two StepSuccess
ORANGE_CI+2250707000205One StepFailed (generic error)
ORANGE_CI+2250707000202Two StepFailed (specific error)
ORANGE_CI+2250707000203Two StepFailed (specific error)
ORANGE_CI+2250707000204Two StepFailed (generic error)
ORANGE_CI+2250707000206One StepFailed (specific error)
ORANGE_CI+2250707000206One StepFailed (specific error)
MTN_CI+2250505000200One StepSuccess
MTN_CI+2250505000201One StepFailed (generic error)
MOOV_CI+2250101000200One StepSuccess
MOOV_CI+2250101000201One StepFailed (generic error)
ORANGE_SN+221777000200One StepSuccess
ORANGE_SN+221777000201One StepFailed (generic error)
FREE_SN+221788000200One StepSuccess
FREE_SN+221788000201One StepFailed (generic error)
EXPRESSO_SN+221705000200One StepSuccess
EXPRESSO_SN+221705000201One StepFailed (generic error)
ORANGE_CM+237670000200One StepSuccess
ORANGE_CM+237670000205One StepFailed (generic error)
MTN_CM+237680000200One StepSuccess
MTN_CM+237680000205One StepFailed (generic error)
MTN_GH+233550000200One StepSuccess
MTN_GH+233550000205One StepFailed (generic error)
VODAFONE_GH+233200000200One StepSuccess
VODAFONE_GH+233200000205One StepFailed (generic error)
AIRTEL_GH+233260000200One StepSuccess
AIRTEL_GH+233260000205One StepFailed (generic error)

Channel: Wave

OperatorPayeeTransaction TypeFinal Status
WAVE_CI+2250101000203One StepSuccess
WAVE_CI+2250101000204One StepFailed (generic error)
WAVE_SN+221777000202One StepSuccess
WAVE_SN+221777000203One StepFailed (generic error)

Test Accounts

Channel: bank_account

For bank payments, transaction simulation is based on the receiver bank account number (receiver_account_number).

No real banks or accounts are charged when running transactions in the sandbox environment.


Payment Simulation Rules

Transaction results are determined using the last two digits of:

  • the phone number for Mobile Money transactions
  • the bank account number for Bank transactions

Simulation Logic

Ends WithResultDescription
00SuccessTransaction completed
01PendingTransaction pending
02FailedTransaction failed

Example Test Values

Mobile Money

  • +23350000000000 → ends with 00Success
  • +23350000000001 → ends with 01Pending
  • +23350000000002 → ends with 02Failed

Bank

  • 12345678900 → ends with 00Success
  • 12345678901 → ends with 01Pending
  • 12345678902 → ends with 02Failed

⚠️ Important Notes

  • These simulation rules are only active in sandbox environments
  • Real phone numbers and real bank accounts in production are not affected by this logic
  • These test scenarios are designed to validate:
    • transaction workflows
    • webhook handling
    • error management
    • payment status lifecycle
    • system integrations