Errors
The error object
The error object contains both a high level error code and an array of detailed error codes and messages. The root object has the following members:
status
: The HTTP error status codecode
: The error codeerrors
: An array containing one or more error codes and messages
In case the error comes from the provider, the returned error code is provider_error
and the provider's error is parsed into the errors
array.
Error codes
The below table is a non-comprehensive list of error codes:
Status | Code | Error | Description |
---|---|---|---|
400 | provider_error | bad_request | a provider specific message is included |
400 | bad_request | bad_request | Invalid parameters or malformed syntax |
400 | bad_request | customer_unknown | Invalid customer_id. Use a valid customer_id or authenticate to a bank to continue |
400 | bad_request | account_unknown | Invalid account_id. You must specify an account_id as defined by the /accounts API |
400 | bad_request | session_id_invalid_or_expired | The session ID used is either expired or invalid |
400 | bad_request | invalid_field | The value or format of field [field] is incorrect |
400 | bad_request | mandatory_field_missing | The mandatory field is missing: [field] has not been defined |
400 | bad_request | invalid_debited_account` | Invalid debited_account_id. The debited_account_type is set to internal, please use an id provider by the accounts API |
401 | unauthorized | invalid_token | The token is either invalid or expired |
401 | unauthorized | invalid_scopes | Your app does not have the necessary scopes to access this API |
401 | unauthorized | invalid_code | The authorization code is either wrong or expired |
401 | unauthorized | invalid_app_id | Invalid app_id |
401 | unauthorized | invalid_app_url | Invalid app redirect URL |
404 | not_found | not_found | The requested resource could not be found. The requested resource either does not exist or is temporarily down |
429 | too_many_requests | too_many_requests | The user has sent too many requests in a given amount of time |
500 | internal_server_error | internal_server_error | An internal error has occurred. If the error persists, please contact our support |
501 | not_implemented | provider_endpoint_unavailable | The provider endpoint is currently unavailable or has not been implemented yet |
503 | service_unavailable | provider_unavailable | The provider is currently unavailable. Please try again later |
Updated 12 months ago