A response code (found in the response_code _field) is a five-digit numeric code that indicates the status of the payment request. Additional details are provided in the _response_summary and status fields of the response.
Payment response codes fall into four categories:
-
APPROVED (10xxx codes) - the request was successful
-
SOFT DECLINE (20xxx codes) - the request was declined, though subsequent attempts may be successful
-
HARD DECLINE (30xxx codes) - the request was declined (most hard declines require the issuer or cardholder to fix any outstanding issues before trying again)
-
RISK RESPONSE (40xxx codes) - the request triggered a risk response, in which case, the status of the response (response_code and status) will depend on the action specified in your risk settings
To learn about specific codes, see our API response code guide.