Error Codes and Details
All successful responses are returned with HTTP Status code 200. In case of failure, Onemoney API returns a JSON error response with the parameters that detail the reason for the failure.
The error response contains errorcode and timestamp parameters that help you diagnose and solve the error.
To understand more about error codes, refer to the Error Codes section.
Please find the one sample error response below:
Onemoney aims to make every data transaction successful for its customers. However, in the financial ecosystem errors might still occur because of intermittent communication and technical issues at multiple hops. Hence, it becomes critical for businesses to identify the status of API response and the reason that caused the error. In short, you can identify the reason why any error occurred. This enables you to minimize or fix errors.
Understanding the Error codes
Onemoney AA uses conventional HTTP response codes to indicate the success or failure of
an API request.
- Codes in the 2xx range indicate success.
- Codes in the 4xx range indicate an error that failed because of the information provided (e.g., a required parameter was omitted, a transaction failed, etc.).
- Codes in the 5xx range indicate an error with Onemoney AA servers (these are rare).
Note: Some 4xx errors that could be handled programmatically (e.g., account linking failed etc) are explained along with an error code that briefly reports the error details.
Understanding the Error Response
Let us take an example where error occurred when raising a consent.
Sample error response:
By looking at the errorcode of the api response, it can be understood that the response is a failure(some error occured) because of using an invalid request. So, this clearly tells the user to go and enter the required request parameters mentioned against the APIs.
For the list of common error codes and a quick resolution, you can refer to Common Error Codes.
For API specific error codes and their quick resolution, refer to the API specific Error Codes section.
Common Error Codes
All the possible values for the errorcode parameter in the error response which are common for all the APIs along with their explanation and the next best action to be taken are shown below.
The above error codes are common errors which you might come across all of the APIs and in case the error occurred is specific to API, please refer to API specific Error Codes.
In case you didn’t find a resolution with the above APIs, please reach out to us at [email protected]
API Specific Error Codes