Upgraded docs version is here ✨

Your documentation experience is getting an upgrade. Check it out now!

Go To Beta

Docs upgrade is here. Check it out!

Go To Beta
API ReferenceIntegrationsKnowledge Base


All successful responses return the HTTP status code 200. In case of failures, Razorpay APIs return JSON error responses with parameters that explain the failure reasons.

Handy Tips
If you are using an official Razorpay Language-wise SDK Integration, the error responses result in exceptions that should be handled in your integration.

Error Response🔗

The error response contains code, description, field, source, step, reason and metadata parameters that help you diagnose and solve the error.

Response Parameters🔗


object The error object.


string Type of the error.


string Description of the error.


string Name of the parameter in the API request that caused the error.


string The point of failure in the specific operation (payment in this case). For example, customer or business.


string The stage where the transaction failure occurred. The stages can vary depending on the payment method used to complete the transaction.


string The exact error reason. It can be handled programmatically.


object Contains additional information about the request.

string Unique identifier of the payment.
string Unique identifier of the order associated with the payment.

Know more about Error Codes.