Enum and error list for the pix charge endpoint. (/pix/transfer/v2/erp-withdraw)
Responses:
In the response you can have these type of enums for this endpoint.
pixTransactionStatus enum
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.
Pix Transaction Type
Type
Description
credit
Deposit transaction
debit
Withdraw transaction
Error list
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
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
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
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
spiErrors
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
pix_transaction_failed
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 .
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.
