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 context
Phone number suffix
UNKNOWN_FAILURE
000100
PAYMENT_ACCOUNT_INVALID_ACCOUNT_NUMBER
000101
PAYMENT_ACCOUNT_BALANCE_MAXED_OUT
000102
PAYMENT_ACCOUNT_PER_TRANSACTION_LIMIT_REACHED
000103
PAYMENT_ACCOUNT_DAILY_LIMIT_REACHED
000104
PAYMENT_ACCOUNT_MONTHLY_LIMIT_REACHED
000105
PAYMENT_ACCOUNT_LIMIT_REACHED
000106
PAYMENT_ACCOUNT_WEEKLY_LIMIT_REACHED
000110
ENTITY_SENDER_KYC_SANCTIONS_HIT
000113
ENTITY_PAYMENT_ACCOUNT_KYC_SANCTIONS_HIT
000114
ENTITY_KYC_SANCTIONS_HIT_EXPIRED
000115
PROVIDER_NETWORK_ISSUE
000116
PAYMENT_ACCOUNT_NOT_SUPPORTED_FOR_REMITTANCE
000117
PAYMENT_ACCOUNT_INACTIVE
000118
PAYMENT_ACCOUNT_CURRENCY_MISMATCH
000119
PAYMENT_ACCOUNT_TRANSACTION_COUNT_LIMIT_REACHED
000120
MANUAL_RECONCILIATION_ADJUSTMENT
000121
State context
Account number suffix
UNKNOWN_FAILURE
000100
PAYMENT_ACCOUNT_INVALID_ACCOUNT_NUMBER
000101
PAYMENT_ACCOUNT_BALANCE_MAXED_OUT
000102
PAYMENT_ACCOUNT_PER_TRANSACTION_LIMIT_REACHED
000103
PAYMENT_ACCOUNT_DAILY_LIMIT_REACHED
000104
PAYMENT_ACCOUNT_MONTHLY_LIMIT_REACHED
000105
PAYMENT_ACCOUNT_LIMIT_REACHED
000106
PAYMENT_ACCOUNT_WEEKLY_LIMIT_REACHED
000110
ENTITY_SENDER_KYC_SANCTIONS_HIT
000113
ENTITY_PAYMENT_ACCOUNT_KYC_SANCTIONS_HIT
000114
ENTITY_KYC_SANCTIONS_HIT_EXPIRED
000115
PROVIDER_NETWORK_ISSUE
000116
PAYMENT_ACCOUNT_NOT_SUPPORTED_FOR_REMITTANCE
000117
PAYMENT_ACCOUNT_INACTIVE
000118
PAYMENT_ACCOUNT_CURRENCY_MISMATCH
000119
PAYMENT_ACCOUNT_TRANSACTION_COUNT_LIMIT_REACHED
000120
MANUAL_RECONCILIATION_ADJUSTMENT
000121
State context
Alias identifier (🇮🇳 IN, UPI)
UNKNOWN_FAILURE
generic.failure@upi
PAYMENT_ACCOUNT_INVALID_ACCOUNT_NUMBER
invalid.account.number@upi
PAYMENT_ACCOUNT_BALANCE_MAXED_OUT
balance.maxed.out@upi
PAYMENT_ACCOUNT_PER_TRANSACTION_LIMIT_REACHED
per.transaction.limit@upi
PAYMENT_ACCOUNT_DAILY_LIMIT_REACHED
daily.limit@upi
PAYMENT_ACCOUNT_MONTHLY_LIMIT_REACHED
monthly.limit@upi
PAYMENT_ACCOUNT_LIMIT_REACHED
account.limit@upi
PAYMENT_ACCOUNT_WEEKLY_LIMIT_REACHED
weekly.limit@upi
ENTITY_SENDER_KYC_SANCTIONS_HIT
sender.sanctions.hit@upi
ENTITY_PAYMENT_ACCOUNT_KYC_SANCTIONS_HIT
beneficiary.sanctions.hit@upi
ENTITY_KYC_SANCTIONS_HIT_EXPIRED
compliance.review.until.expiry@upi
PROVIDER_NETWORK_ISSUE
provider.network.issue@upi
PAYMENT_ACCOUNT_NOT_SUPPORTED_FOR_REMITTANCE
not.supported.for.remittance@upi
PAYMENT_ACCOUNT_INACTIVE
account.inactive@upi
PAYMENT_ACCOUNT_CURRENCY_MISMATCH
currency.mismatch@upi
PAYMENT_ACCOUNT_TRANSACTION_COUNT_LIMIT_REACHED
transaction.count.limit@upi
MANUAL_RECONCILIATION_ADJUSTMENT
manual.reconciliation.adjustment@upi
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.