Test Data

Simulate payouts to test your integration

By default, any payout made with a valid account number and a complete valid payload will be successful. You can simulate various scenarios other than success by using the test data provided below.

Failure simulation test data

Use the test data below to simulate a payout that ends in the FAILED state with a given state context. Payouts to any other valid account are successful.

  • Mobile money and bank account: use any phone number or bank account number that ends with the digits listed for the state context, for any country that supports the account type.
  • Alias: use the exact alias identifier listed for the state context.
  • A state context not listed for an account type can't be simulated with it.
  • The ENTITY_*_SANCTIONS_HIT and ENTITY_KYC_SANCTIONS_HIT_EXPIRED contexts are screening outcomes, so the payout first goes through compliance review (PENDING with COMPLIANCE_REVIEW) and fails a few minutes later. Poll the payout until it reaches FAILED.

State FAILED

State contextPhone number suffix
UNKNOWN_FAILURE000100
PAYMENT_ACCOUNT_INVALID_ACCOUNT_NUMBER000101
PAYMENT_ACCOUNT_BALANCE_MAXED_OUT000102
PAYMENT_ACCOUNT_PER_TRANSACTION_LIMIT_REACHED000103
PAYMENT_ACCOUNT_DAILY_LIMIT_REACHED000104
PAYMENT_ACCOUNT_MONTHLY_LIMIT_REACHED000105
PAYMENT_ACCOUNT_LIMIT_REACHED000106
PAYMENT_ACCOUNT_WEEKLY_LIMIT_REACHED000110
ENTITY_SENDER_KYC_SANCTIONS_HIT000113
ENTITY_PAYMENT_ACCOUNT_KYC_SANCTIONS_HIT000114
ENTITY_KYC_SANCTIONS_HIT_EXPIRED000115
PROVIDER_NETWORK_ISSUE000116
PAYMENT_ACCOUNT_NOT_SUPPORTED_FOR_REMITTANCE000117
PAYMENT_ACCOUNT_INACTIVE000118
PAYMENT_ACCOUNT_CURRENCY_MISMATCH000119
PAYMENT_ACCOUNT_TRANSACTION_COUNT_LIMIT_REACHED000120
MANUAL_RECONCILIATION_ADJUSTMENT000121

State PENDING

A screening hit holds the payout for compliance review, so it is PENDING with COMPLIANCE_REVIEW. In the sandbox the review is simulated: the hits in the FAILED section are confirmed by the review within moments, and the payout then fails with the sanction context. The test data below is never reviewed, so COMPLIANCE_REVIEW is observable the longest: the payout stays PENDING until the review expires and then fails with ENTITY_KYC_SANCTIONS_HIT_EXPIRED.

State contextPhone number suffix
COMPLIANCE_REVIEW000115

Did this page help you?