In the response you can have these type of enums for this endpoint.
| Value | Description |
|---|
pending | The transaction is pending to be registered in bacen. |
fail | The transaction failed; The transaction is reversed. |
success | The transaction is successful. |
waiting | The transaction has been registered with the central bank, however it is awaiting the web hook from the central bank. |
| Type | Description |
|---|
credit | Deposit transaction |
debit | Withdraw transaction |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| Error Code | Message | Status Code |
|---|
DICT_KEY_NOT_ACTIVE | The DICT key provided is not active. | 400 |
PIX_WITHDRAW_PAYLOAD_INVALID | Invalid DICT key format | 400 |
ADDRESSING_KEY_NOT_FOUND | The DICT key provided doesn't exist | 400 |
DICT_KEY_BACEN_TIME_OUT | Processing the request in DICT took longer than expected. Try again please | 408 |
| Error Code | Message | Status Code |
|---|
SPI_EXTERNAL_ERROR | An error occurred while communicating with the SPI external system. | 503 |
BUCKET_MAX_SIZE_EXCEEDED | Too many wrong DICT key consults. Try again in 1 minute | 429 |
RATE_LIMITED | The user has sent too many requests in a given amount of time wait 1 minute and try again | 429 |
| errorCode | errorMessage |
|---|
AB03 | Settlement of the interrupted transaction due to timeout in the SPI. |
AB09 | Transaction interrupted due to error in the receiving user participant. |
AB11 | Timeout of the participant issuing the payment order. |
AC03 | Agency Number and/or Transactional Account of the Nonexistent or Invalid Receiver User. |
AC06 | Receiving user transactional account is blocked. |
AC07 | Receiving user transactional account number. |
AC14 | Incorrect type for the receiving user transaction account. |
AG03 | Type of transaction is not supported/authorized in the receiving user transaction account. Example: Transfer to Salary Account. |
AG12 | Payment/return order is not allowed in SPI whose resources are transferred from one transaction account to another in the same participating institution or among participants who use the settlement service of the same liquidating participant in the SPI (Booktransfer). |
AG13 | It is not allowed to return the return of an instant payment. |
AGNT | Direct participant is not liquidator of the payer user participant. |
AM01 | Instant payment order with zero value. |
AM02 | Payment Order/Return in amount that makes the limit allowed for the type of credited transaction account. |
AM04 | Insufficient balance in the PI account of the payer user participant. |
AM09 | Return of payment in amount that surpasses the amount of the corresponding instant payment order. |
AM12 | Divergence between the sum of the block values‘ValueDateAdoDinheiroThe Compraa’ and the field ‘Valor’. |
AM18 | Amount of invalid transactions. |
BE01 | CPF/CNPJ of the receiving user is not consistent with the specified transaction account holder. |
BE05 | CNPJ of the payment initiator is not registered in the PIX arrangement. |
BE17 | QR code rejected by the receiving user participant. |
CH11 | CPF/CNPJ of the incorrect receiver user. |
CH16 | Filling in the content of the incorrect message or incompatible with the business rules. |
DS04 | Order rejected by the receiving user participant. |
DS0G | Participant who signed the message is not authorized to perform the operation in the debited PI account. In the event that the participant who signed the message is not the holder of the PI account debited nor is the liquidator in the PAID USER participant SPI. |
DS24 | Order rejected by extrapolation of the time elapsed between the shipping of PAIN.013 and the receipt of PACS.008 corresponding by the receiving user participant. |
DS27 | Participant is not registered or has not started the operation in the SPI. |
DT02 | Date and Time of Shipping the Invalid Message |
DT05 | Transaction goes beyond the maximum deadline for return of instant payment regulated by the Pix arrangement. |
ED05 | Instant payment processing error (generic error). |
FF07 | Inconsistency between the purpose of the transaction and the filling of the block Elements Structured <strd>. |
FF08 | Mal formatted operation identifier. |
MD01 | ISPB of the participant service facilitator pix withdrawal or pix existent change. |
RC09 | ISPB of the invalid or nonexistent payer user participant. |
RC10 | ISPB of the invalid or nonexistent receiver participant. |
RR04 | Payment order in which the payer user is sanctioned by resolution of the United Nations Security Council (CSNU). In cases where the receiving user is sanctioned, the payment order should not be rejected. |
SL02 | The original transaction is not related to the pix or pix exchange service. |
| name | message | statusCode |
|---|
PIX_WITHDRAW_TAX_ID_INVALID | DICT key does not belong to the tax id informed | 400 |
PIX_WITHDRAW_ACCOUNT_MISMATCH | Account mismatch validation failed | 400 |
