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

Successful transactions are coded as 1000.

Code	Detail
1000	Approved

Soft Declines

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

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

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