Moneyone uses conventional HTTP response codes to indicate the success or failure of an API request. In general: Codes in the 2xx range indicate success. Codes in the 4xx range indicate an error that failed given the information provided (e.g., a required parameter was omitted, a transaction failed, etc.). Codes in the 5xx range indicate an error with Moneyone servers (these are rare). Some 4xx errors that could be handled programmatically (e.g., account linking failed etc) include an error code that briefly explains the error reported.
The error codes summary is given below:
- 200 - OK – Working as expected
- 400 – Bad request – Unacceptable request mainly due to missing of a required parameter
- 404 – Not Found – The requested resource doesn’t exist
- 500 – Internal error – Error due to something wrong at onemoney’s end. E.g. Network down
Error Types
- Api connection error – Failure to connect to Moneyone’s APIs
- Invalid request error – Invalid request errors happen when request has invalid parameters or doesn’t include required parameters.
- Validation error – Errors which are triggered when validation of parameters fail. E.g. Invalid purpose code, Consent start date cannot be a past date etc.
Error Handling
Our API libraries raise exceptions for many reasons, such as invalid parameters, network unavailability and so on. We recommend writing code that gracefully handles all possible API exceptions.