Skip to main content
With the new error codes, Razorpay helps you build your own logic and take remedial action at your end, wherever possible. Deriving these insights can help your business to:
  • Map and analyze top failure reasons
  • Identify the source of failure. Narrow down and understand if cause of the failure. Can be due to customer action or external factors (Razorpay, Gateway, Bank, Network)
  • Identify the payment step
  • Identify the exact reason of the failure
  • Handle actionable error codes
  • Avoid possible integration errors
  • Display valid responses to your customers

​
Understanding the Error Response

Let us take an example where a payment failed because the customer entered a wrong OTP while making a payment using card on the Checkout.
Sample Error Response
Looking at the source, step and reason provided in the error description, you can understand that the payment failed at the authentication step due to the incorrect OTP entered by the customer. An elegant way to handle this error would be to notify your customer and bring them back to the checkout window and ask them to retry the payment with the correct OTP. For the list of reasons, refer to the Error Reasons section. To understand error codes specific for each payment method supported by Razorpay, refer to the payment flows described in the Payment Method Error Parameters section.