When testing or developing against the Sandbox environment, it is often helpful to generate payment errors to ensure your code handles these properly.
By entering an amount in the $9999.XX range as specified for each payment processor below, you can generate the error code specified. Refer to Payment Failure Codes for a list of possible errors.
📘
Most merchants are set up for credit card processing using TSYS and Forte for ACH. If you are unsure which processor you use, contact your PaySimple support representative.
| Amount | Error Code | Description |
|---|
| 9999.01 | 4005 | Do Not Honor |
| 9999.02 | 4007 | Pick up card, special condition (fraud account) |
| 9999.03 | 4014 | Invalid card number |
| 9999.04 | 4054 | Invalid Expiration Date |
| 9999.05 | 4041 | Lost card, pick up (fraud account) |
| 9999.30 | | Unpaid / Failed - An unknown error has occurred |
| Amount | Error Code | Description |
|---|
| 9999.01 | 4005 | Do Not Honor |
| 9999.02 | 4004 | Pick up Card (no Fraud) |
| 9999.04 | 4003 | Invalid Merchant ID |
| 9999.05 | 4226 | There is an error with your account configuration. |
| 9999.08 | 4220 | CVV2 Value supplied is invalid |
| Amount | Error Code | Description |
|---|
| 1.05 | 4058 | Transaction not permitted-Terminal |
| 0.24 | 4004 | Pick up Card (no Fraud) |
| 0.21 | 4054 | Invalid Expiration Date |
| 0.20 | 4007 | Pick up card, special condition (fraud account) |
| 9999.06 | | Unknown - Payment: Payment encountered a communication/technical issue |
| 9999.07 | | Unknown - Refund: An unknown error occurred while processing your request |
| Amount | Error Code | Description |
|---|
| 9999.01 | 4504 | Merchant's daily limit exceeded |
| 9999.02 | 4507 | Customer account is in the "known bad" account list. |
| 9999.03 | 4503 | Merchant monthly limit exceeded (EFT only). |
| 9999.04 | 4506 | Duplicate transaction |
| 9999.05 | 4502 | Merchant's maximum transaction amount exceeded |
| 9999.06 | 4510 | Invalid Merchant ID or Password - Contact customer service |
| 9999.07 | 4501 | Account ABA number is invalid. |
| 9999.12 | | Unpaid / Failed - An unknown error has occurred |
| Amount | Error Code | Description |
|---|
| 9999.01 | 4506 | Duplicate transaction |
| 9999.02 | 4523 | Previously open account has been closed |
| 9999.03 | 4524 | No Account/unable to locate account |
| 9999.04 | 4525 | Account holder has stopped payment on this single transaction |
| 9999.07 | 4526 | Account number structure is invalid |
