Skip to main content

Understand transaction response codes

The `response_code` is a five-digit numeric code that indicates the status of the payment request. Additional information may be found in the `response_summary` and `status` fields of the response.

The statuses fall within one of four categories:

  • APPROVED (10000 codes) - the request was successful
  • SOFT DECLINE (20000 codes) - the request was declined, though subsequent attempts may be successful
  • HARD DECLINE (30000 codes) - the request was declined (most hard declines require the issuer or cardholder to fix any outstanding issues before trying again)
  • RISK RESPONSE (40000 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.

Was this article helpful?
Copy Link Share via email

Articles in this section