Generic API Errors

List of errors encountered while using Partners API with solutions.


Given below are the error codes and descriptions that are common to all Onboarding APIs.

Given below are sample error objects for bad request errors.

This error occurs when the value sent for a particular field exceeds the specified limit. For example, if you had sent a phone number with more than 10 digits.

Error DescriptionSolution
The field_name must be x digits.Check the length mentioned in the documentation and resend.

This error occurs when you the send an invalid URL.

Error DescriptionSolution
The url is not a valid URL.Check the URL and resend.

This error occurs when the value sent for a particular field is incorrect. For example, if you sent an invalid webhook event name.

Error DescriptionSolution
Invalid event name/names: payment.authorizedCheck the mentioned field (here, webhook event name) and resend.

This error occurs when a field is sent without any values. For example, if the Account entity parameter customer_facing_business_name is sent without any value.

Error DescriptionSolution
The business dba field is required.Ensure all mandatory fields and values are present. (Here, the business name).

This error occurs when the Razorpay team has evaluated the details, changed the activation status to needs_clarification and has sought more details. Therefore, only those fields which are present in the requirements array in the

response should be resent. You cannot send any additional fields.

Error DescriptionSolution
Only fields requested for needs clarification are allowed for update.Send only the highlighted fields.

This error occurs when the Razorpay team is evaluating the submitted details and changed the activation status to under_review. Therefore, you cannot send any fields.

Error DescriptionSolution
Merchant activation form has been locked for editing by adminDo not send any requests. Wait for Razorpay team to revert.

This error occurs when the activation is complete. At this point, you cannot send any fields.

Error DescriptionSolution
Merchant activation form has been locked for editing by adminDo not send any requests.

This error occurs when you use incorrect API keys while making the requests.

Error DescriptionSolution
The api secret provided is invalid.The API credentials passed in the API call differ from the ones generated on the Dashboard. Possible reasons:
  • Different keys for test mode and live modes.
  • Expired API key.

This error occurs when emojis are sent in the API request.

Error DescriptionSolution
We are facing some trouble completing your request at the moment. Please try again shortly.Ensure that the API request does not have emojis and resend.

Was this page helpful?