Below is a list of error codes returned by the Pix cash-out API. These errors are sent in the cash-out webhook, where the error code will be provided in the "error_code" parameter and the descriptive message in the "reason" parameter. The codes cover a wide range of errors that can occur during transaction processing, from validation failures to problems with settlement banks or receivers.
Make sure you properly handle these errors in your system in order to provide a better user experience and ensure transactions are handled efficiently.
Parameters that return errors in Webhooks: "error_code" and "reason"
- Error Code: The error code will be found in the "error_code" parameter of the webhook.
- Error Message: The corresponding message will be available in the "reason" parameter of the webhook.
| Error Code | Error Message |
|---|---|
| OUT001 | Pix key not found |
| OUT002 | Pix key search has failed |
| OUT003 | The transaction was rejected by the settlement bank |
| OUT004 | The transaction was failed due to error on settlement bank |
| OUT005 | The transaction was rejected by the receiving bank |
| OUT006 | The transaction was failed due to timeout on receiving bank |
| OUT007 | The transaction was denied due to a risk rule |
| OUT008 | The provided CPF/CNPJ does not match the recipient’s CPF/CNPJ |
| OUT009 | The transaction was failed due to timeout on settlement bank |
| OUT010 | No provider available |
| OUT011 | Cash-outs are not allowed for legal entities |
| OUT012 | The transaction was failed due to error on receiving bank |
| OUT013 | Amount limit per transaction, set by the settlement bank, has been exceeded |
| VAL001 | Invalid amount |
| VAL002 | Invalid CNPJ |
| VAL003 | Invalid CPF |
| VAL004 | Invalid document number (CPF/CNPJ) |
| VAL005 | Invalid email address |
| VAL006 | Invalid EndToEndId: {value} |
| VAL007 | The public key is not valid |
| VAL008 | Password is too weak |
| VAL009 | Invalid txid |
| VAL010 | Invalid wallet ID format! |
| VAL011 | Invalid pix key format |
| AC003 | Account not active |
| AC001 | Account has no sufficient funds for cash-out |
| PLN004 | The minimum balance allowed to make cash out is {min} |
| PLN003 | The maximum charge amount allowed for your accounts is {max} |
| PLN002 | The maximum cash out amount allowed for your accounts is {max} |
| PLN006 | Cash-out daily limit reached |
| PLN007 | Cash-in daily limit reached |
| IN001 | The charge creation has failed due to error on settlement bank |