Skip to main content

Documentation

Error Simulation

When you are experimenting in the Payment API sandbox, you can use specific transaction amounts to evoke error responses from the Rapyd platform. Any amount in the given range produces the error. Amounts outside these ranges behave normally. The errors are simulated only with the amount parameter, and the values of other parameters behave normally.

All Payment Types

Amount

Error Response

4000-4009

The gateway is not responding.

Online Payments

Amount

Error Response

2000-2009

The sandbox detected a simulated error, where the payment could not be processed because settlement was declined.

2020-2029

Settlement is pending on the gateway.

2080-2089

The processor is unavailable.

Redirect Payments

Amount

Error Response

2120-2129

Insufficient funds in the account.

2180-2189

Payment expired.

When the API is triggered, it sends a notification message with payment details to the configured URL. Payments with an amount that matches one of the ranges listed above will have the associated error in the failure_code parameter.