Errors

When interacting with the Paybin API, handling errors gracefully is crucial. An error response will not have an HTTP status code of 200. Instead, specific error codes are returned to indicate various types of issues. Below is a table of error status codes you might encounter, along with their meanings, to aid in quick understanding and resolution. Additionally, you will see the HTTP status code reflected in the response body, providing further clarity on the nature of the error encountered.

Before reaching out to support with an error, please be aware that 99% of all reported errors are, in fact, user errors. Therefore, please carefully check your code before contacting Paybin support.

Status codes

Properly understanding and handling these error codes in your application is key to ensuring a smooth user experience and maintaining the integrity and security of your interactions with the Paybin platform.

Code	Description
`400`	Bad Request - The request was unacceptable, often due to missing a required parameter or supplying invalid data.
`401`	Unauthorized - Authentication failed or the user does not have permissions for the requested operation.
`406`	Not Acceptable - The requested resource can only generate content not acceptable according to the Accept headers sent in the request.
`409`	Conflict - The request could not be completed due to a conflict with the current state of the target resource, often due to simultaneous updates or conflicts with the resource's state.

Messages

Code	Message
`Z100`	An error occurred!
`Z501`	This withdrawal has been executed.
`Z503`	This reference ID is already associated with a wallet for the specified symbol and network.
`Z505`	Invalid request.
`Z507`	Insufficient withdrawal amount.
`Z509`	Please check your email to approve the withdrawal.
`Z511`	Invalid address.
`Z513`	Insufficient balance.
`Z515`	Invalid withdrawal update request.
`Z517`	Withdrawal not found.
`Z519`	Duplicate withdrawal request.
`Z521`	Invalid credentials.
`Z523`	Invalid body hash.
`Z525`	Invalid symbol requested.
`Z527`	Unauthorized user for this withdrawal.
`Z529`	Please check your phone to approve the withdrawal.