The most common errors using our PIX API.
customerErrors
Error Code | Message | Status Code |
---|---|---|
CUSTOMER_NOT_FOUND | The customer provided was not found, check it and try again. | 404 |
CUSTOMER_ID_REQUIRED | A customer ID is required. | 400 |
CUSTOMER_BLOCKED | The customer provided is blocked. | 403 |
partnerErrors
Error Code | Message | Status Code |
---|---|---|
PARTNER_ERP_TOKEN_PARAMETER_NOT_FOUND | The ERP token parameter for the partner was not found. | 404 |
PARTNER_ERP_TOKEN_PARAMETER_INVALID | The ERP token parameter provided for the partner is invalid. | 401 |
PARTNER_NOT_FOUND | The partner was not found. | 404 |
cnpjValidationErrors
Error Code | Message | Status Code |
---|---|---|
CNPJ_VALIDATED | CNPJ validated but not yet approved. | 403 |
CNPJ_NOT_VALIDATED | CNPJ not validated. | 400 |
PJ_DENIED | PJ register refused. | 403 |
PARTNER_PJ_NOT_FOUND | Partner accept PJ param not found. | 404 |
BUSINESS_APP_NOT_FOUND | Business application was not found, check the CNPJ provided and try again. | 404 |
CPF_HAS_NO_LINK_WITH_CNPJ | The CPF and CNPJ provided have no link. | 403 |
pixChargeErrors
Error Code | Message | Status Code |
---|---|---|
PIX_CHARGE_INVALID_PARAMETER | One or more parameters provided for the Pix charge are invalid. | 400 |
PIX_CHARGE_ID_NOT_FOUND | The Pix charge ID provided was not found. | 404 |
PIX_CHARGE_INTERNAL_ERROR | Error on generating Dynamic QRCode Immediate. | 50 |
pixTransferErrors
Error Code | Message | Status Code |
---|---|---|
PIX_TRANSFER_INVALID_PARAMETER | One or more parameters provided for the Pix transfer are invalid. | 400 |
PIX_TRANSFER_ID_NOT_FOUND | The Pix transfer ID provided was not found. | 404 |
PIX_TRANSFER_END_TO_END_NOT_FOUND | The Pix transfer ID provided was not found. | 404 |
PIX_TRANSFER_INTERNAL_ERROR | Error on processing Pix transfer. | 500 |
qrCodeErrors (Validation)
Error Code | Message | Status Code |
---|---|---|
QRCODE_DICT_KEY_NOT_FOUND | QR code dictionary key not found. | 404 |
QRCODE_DICT_KEY_INVALID | QR code dictionary key is invalid. | 400 |
QRCODE_CITY_NOT_FOUND | QR code city not found. | 404 |
QRCODE_CITY_INVALID | QR code city is invalid. | 400 |
QRCODE_CUSTOMER_ID_INVALID | The customer ID provided in the QR code is invalid | 400 |
QRCODE_ZIP_CODE_NOT_FOUND | QR code ZIP code not found. | 404 |
QRCODE_ZIP_CODE_INVALID | QR code ZIP code is invalid. | 400 |
QRCODE_EXPIRATION_INVALID | QR code expiration is invalid. | 400 |
QRCODE_EXPIRATION_REQUIRED | QR code expiration is required. | 400 |
QRCODE_EXTERNAL_ID_REQUIRED | External ID is required for the QR code. | 400 |
QRCODE_EXTERNAL_ID_INVALID | The external ID provided for the QR code is invalid. | 400 |
QRCODE_EXTERNAL_ID_DUPLICATED | The external ID provided for the QR code is already in use. | 409 |
QRCODE_AMOUNT_REQUIRED | Amount is required for the QR code. | 400 |
QRCODE_AMOUNT_INVALID | The amount provided for the QR code is invalid. | 400 |
QRCODE_MIN_AMOUNT_INVALID | The minimum amount for the QR code is invalid. | 400 |
QRCODE_DESCRIPTION_INVALID | QR code description is invalid. | 400 |
QRCODE_DESCRIPTION_MAX_LENGTH | QR code description exceeds maximum length. | 400 |
QRCODE_TAX_ID_NOT_FOUND | Tax ID for QR code not found. | 404 |
QRCODE_TAX_ID_INVALID | The tax ID for the QR code is invalid. | 400 |
QRCODE_TAX_ID_NOT_ALLOWED | The tax ID provided for the QR code is not allowed. | 403 |
QRCODE_TAX_ID_REQUIRED | Tax ID is required for the QR code. | 400 |
QRCODE_PAYER_REQUEST_INFORMATION_INVALID | Payer request information for the QR code is invalid. | 400 |
QRCODE_PAYER_REQUEST_INFORMATION_LENGTH | Payer request information for the QR code exceeds maximum length. | 400 |
QRCODE_RESTRICT_PAYERS_TAX_ID_INVALID | The tax ID of restrict payers provided in the QR code is invalid. | 400 |
QRCODE_INVALID_FORMAT | QR code has an invalid format. | 400 |
QRCODE_INVALID_PAYLOAD | QR code payload is invalid. | 400 |
QRCODE_INVALID_IMMEDIATE_PAYLOAD | Immediate payload for QR code is invalid. | 400 |
QRCODE_RECEIVER_INFORMATION_INVALID | The receiver information provided is invalid | 400 |
QRCODE_ADDITIONAL_DATA_FIELD_INVALID | Additional data field for QR code is invalid. | 400 |
QRCODE_TAX_ID_NOT_ALLOWED_PAYMENT | Tax ID not allowed for QR code payment. | 403 |
QRCODE_NAME_INVALID | Name for QR code is invalid. | 400 |
QRCODE_EXPIRATION | QR code expiration error. | 400 |
pixWithdrawErrors
Error Code | Message | Status Code |
---|---|---|
PIX_WITHDRAW_ISPB_NOT_FOUND | ISPB for PIX withdrawal not found. | 404 |
PIX_WITHDRAW_INTERNAL_ERROR | Internal error during PIX withdrawal. | 500 |
PIX_WITHDRAW_DICT_KEY_INVALID | DICT key for PIX withdrawal is invalid. | 400 |
PIX_WITHDRAW_DICT_KEY_REQUIRED | DICT key is required for PIX withdrawal. | 400 |
PIX_WITHDRAW_DICT_KEY_NOT_FOUND | DICT key for PIX withdrawal not found. | 404 |
PIX_WITHDRAW_EXTERNAL_ID_INVALID | External ID for PIX withdrawal is invalid. | 400 |
PIX_WITHDRAW_EXTERNAL_ID_REQUIRED | External ID is required for PIX withdrawal. | 400 |
PIX_WITHDRAW_EXTERNAL_ID_NOT_FOUND | External ID for PIX withdrawal not found. | 404 |
PIX_WITHDRAW_EXTERNAL_ID_DUPLICATED | The external ID for PIX withdrawal is already in use. | 409 |
PIX_WITHDRAW_ACCOUNT_NUMBER_NOT_FOUND | Account number for PIX withdrawal not found. | 404 |
PIX_WITHDRAW_ACCOUNT_NUMBER_REQUIRED | Account number is required for PIX withdrawal. | 400 |
PIX_WITHDRAW_ACCOUNT_NUMBER_BLOCKED | Account number for PIX withdrawal is blocked. | 403 |
PIX_WITHDRAW_ACCOUNT_NUMBER_NOT_ALLOWED | Account number for PIX withdrawal is not allowed. | 403 |
PIX_WITHDRAW_ACCOUNT_NUMBER_INVALID | Account number for PIX withdrawal is invalid. | 400 |
PIX_WITHDRAW_ACCOUNT_NUMBER_LOCKED | Account number for PIX withdrawal is locked. | 403 |
PIX_WITHDRAW_AMOUNT_REQUIRED | Amount is required for PIX withdrawal. | 400 |
PIX_WITHDRAW_AMOUNT_INVALID | The amount for PIX withdrawal is invalid. | 400 |
PIX_WITHDRAW_MIN_AMOUNT_INVALID | The minimum amount for PIX withdrawal is invalid. | 400 |
PIX_WITHDRAW_MAX_AMOUNT_INVALID | The maximum amount for PIX withdrawal is invalid. | 400 |
accountErrors
Error Code | Message | Status Code |
---|---|---|
ACCOUNT_NUMBER_NOT_FOUND | The account number provided was not found. | 404 |
ACCOUNT_CREATION_FAILED | Failed to create the pix account. | 500 |
dictErrors
Error Code | Message | Status Code |
---|---|---|
DICT_KEY_NOT_ACTIVE | The DICT key provided is not active. | 400 |
spiErrors
Error Code | Message | Status Code |
---|---|---|
SPI_EXTERNAL_ERROR | An error occurred while communicating with the SPI external system. | 503 |