Comment on page
Transaction Response Codes
Reference for all payment transaction response codes
Payment Transaction requests have many potential outcomes, with each gateway and processor having unique response codes. 29 Next codes and categorizes these into common response buckets, according to the following codes.
Successful transactions are coded as 1000.
Code | Detail |
1000 | Approved |
Soft declines are coded in the 2000 range and are the result of an issuer-level transaction failure. Soft declined transactions may potentially be successful if retried in the future.
Code | Detail | Decline Type |
2000 | Do Not Honor | Soft |
2001 | Insufficient Funds | Soft |
2002 | Limit Exceeded | Soft |
2003 | Processor Declined | Soft |
2004 | Authorization Required | Soft |
2005 | Processing Error | Soft |
Hard declines are coded in the 3000 and 4000 ranges and are the result of an error, or an issuer rejection of a transaction that cannot be resolved without modifying the payment request. Hard declined transactions are not recommended to reattempt.
For codes relating to invalid inputs by the customer, such as an invalid address, CVV, or card expiry date, the customer should correct the payment details before reattempting purchase.
Code | Detail | Decline Type |
3000 | Additional Authorization Required | Hard |
3001 | Address Verification Failed | Hard |
3002 | Invalid Card | Hard |
3003 | CVC Invalid | Hard |
3004 | Expiry Date Invalid | Hard |
3005 | Card Number Invalid | Hard |
3006 | Expired Card | Hard |
3007 | Invalid Transaction | Hard |
3008 | Lost or Stolen Card / Pick Up Card | Hard |
3009 | Fraudulent Transaction | Hard |
3010 | Hard Decline | Hard |
3011 | Merchant Error | Hard |
3012 | Duplicate Transaction / Velocity Filter | Hard |
3013 | Issuer Error | Hard |
3014 | Refund Error | Hard |
3015 | Pick Up Card | Hard |
3016 | 3DS Authentication Failed | Hard |
3017 | Blocked by Block List | Hard |
4000 | Bank Account Declined | Hard |
4001 | Bank Account Requires Additional Verification | Hard |
4002 | Bank Account Routing Number Invalid | Hard |
4003 | Bank Account Does Not Support SEPA | Hard |
Errors are coded in the 5000 range and indicate there is a problem with the payment method or with the payment provider.
Code | Detail | Decline Type |
5000 | Payment Method Unsupported | Error |
5001 | Payment Method Failed | Error |
5003 | Payment Method Failed - Timeout | Error |
5004 | Payment Method Invalid Parameter | Error |
5005 | Error Invalid Country Code | Error |
5006 | Invalid Cardholder Name | Error |
Last modified 16d ago