Error handling

Our API returns errors with an HTTP status code following REST protocols and a body as below.

{
	"message": "message error comes here",
	"code": "error.code",
	"request-id": "624384bfacf9b0580e503b4f"
}

Field	Description
message	Descriptive error message
code	Error code related to the exception that occurred. Error codes in the table below.
request-id	Unique UUID which identifies your request

Error codes

Error code	Error message
integrator.not_found	Integrator not found
integrator.conflict	There is already an integrator for this email
beneficiary.conflict	Beneficiary already exists
beneficiary.not_found	Beneficiary not found
beneficiary.not_for_integrator	Beneficiary does not belong to integrator
currency.not_found	Currency not found
auth.invalid_credentials	Invalid credentials
payment_contact.not_found	Payment Contact not found
payment.not_found	Payment not found
transfer.not_found	Transfer not found
transfer.invalid_transfer	Invalid transfer
upload.error-has-occurred	Error has occurred while file upload
web.invalid_or_missing_body	Request body is required
web.not_acceptable	Invalid format
web.unsupported_media_type	Unsupported media type
web.method_not_allowed	Http method is invalid '{0}'
web.missing_parameter	Parameters are required '{0}'
web.missing_part	Invalid parameters '{0}'
web.no_handler	Invalid URL
web.missing_header	Header is not present '{0}'
web.missing_cookie	Cookies is not present '{0}'
web.missing_matrix_variable	Error has occurred
client_error.error_occurred	An unexpected error occurred{0}
unknown_error	Something went wrong