Códigos de erro do Pix
Os 75 códigos que aparecem nas rejeições (pacs.002), nas devoluções (pacs.004) e nas consultas ao DICT, com a definição oficial do Banco Central. Quer ver o caminho do Pix em cada erro? Abra os cenários animados.
Rejeição do Pix (pacs.002)
- AB03 Liquidação da transação interrompida devido a timeout no SPI · SPI (Banco Central)
- AB09 Transação interrompida devido a erro no participante do usuário recebedor · PSP recebedor
- AB11 Timeout do participante emissor da ordem de pagamento · SPI (Banco Central)
- AC03 Número da agência e/ou conta transacional do usuário recebedor inexistente ou inválido · PSP recebedor
- AC06 Conta transacional do usuário recebedor encontra-se bloqueada · PSP recebedor
- AC07 Número da conta transacional do usuário recebedor encerrada · PSP recebedor
- AC14 Tipo incorreto para a conta transacional do usuário recebedor · PSP recebedor
- AG01 Transação relativa a ingresso de novos recursos em conta transacional destinados a exploração de loteria de apostas de quota fixa ilegais · PSP recebedor
- AG03 Tipo de transação não é suportado/autorizado na conta transacional do usuário recebedor. Exemplo: transferência para conta salário · PSP recebedor
- AG12 Não é permitida ordem de pagamento/devolução no SPI cujos recursos sejam transferidos de uma conta transacional para outra em uma mesma instituição participante ou entre participantes que utilizem o serviço de liquidação de um mesmo participante liquidante no SPI (booktransfer) · SPI (Banco Central)
- AG13 Não é permitido devolver a devolução de um pagamento instantâneo · SPI (Banco Central)
- AGNT Participante direto não é liquidante do participante do usuário pagador · SPI (Banco Central)
- AM01 Ordem de pagamento instantâneo com valor zero · SPI (Banco Central)
- AM02 Ordem de pagamento/devolução em valor que faz superar o limite permitido para o tipo de conta transacional creditada · PSP recebedor
- AM04 Saldo insuficiente na conta PI do participante do usuário pagador · SPI (Banco Central)
- AM09 Devolução de pagamento em valor que faz superar o valor da ordem de pagamento instantâneo correspondente · PSP recebedor
- AM12 Divergência entre a somatória dos valores do bloco valorDoDinheiroOuCompra e o campo valor · SPI (Banco Central)
- AM18 Quantidade de transações inválida · SPI (Banco Central)
- AM23 Soma dos tributos informados resulta em valor inválido (superior ao valor da transação) · SPI (Banco Central)
- BE01 CPF/CNPJ do usuário recebedor não é consistente com o titular da conta transacional especificada · PSP recebedor
- BE05 CNPJ do iniciador de pagamento não se encontra cadastrado no arranjo Pix · SPI (Banco Central)
- BE15 Campo idConciliacaoRecebedor indevidamente não preenchido ou preenchido incorretamente · PSP recebedor
- BE17 QR Code rejeitado pelo participante do usuário recebedor · PSP recebedor
- CH11 CPF/CNPJ do usuário recebedor incorreto · PSP recebedor
- CH16 Preenchimento do conteúdo da mensagem incorreto ou incompatível com as regras de negócio · SPI (Banco Central)
- CN01 Agendamento de pagamento recorrente cancelado com statusDoCancelamento igual a "ACCR (confirmado)" · PSP recebedor
- DS02 Ordem de pagamento rejeitada em função de configurações pré-estabelecidos pelos operadores da instituição no SPI-Web: - bloqueio manual de envio de Pix; - bloqueio automático de envio de Pix; ou - atingimento do limite mínimo operacional da Conta PI · SPI (Banco Central)
- DS04 Ordem rejeitada pelo participante do usuário recebedor · PSP recebedor
- DS0G Participante que assinou a mensagem não é autorizado a realizar a operação na conta PI debitada. No caso em que o participante que assinou a mensagem não é o titular da conta PI debitada nem é o liquidante no SPI do participante do usuário pagador · SPI (Banco Central)
- DS27 Participante não se encontra cadastrado ou ainda não iniciou a operação no SPI · SPI (Banco Central)
- DT02 Data e Hora do envio da mensagem inválida · SPI (Banco Central)
- DT05 Transação extrapola o prazo máximo para devolução de pagamento instantâneo regulamentado pelo arranjo Pix · SPI (Banco Central)
- DU03 Ordem de pagamento rejeitada para evitar pagamento em duplicidade, quando a cobrança já tiver sido liquidada por outro arranjo de pagamento, por exemplo, boleto · PSP recebedor
- DUPL Pagamento efetuado em duplicidade nos casos em que as ordens de pagamento possuem IdConciliacaoDoRecebedor iguais para um mesmo usuário recebedor. É permitido que duas cobranças tenham o mesmo IdConciliacaoDoRecebedor desde que correspondam a usuários recebedores diferentes · PSP recebedor
- ED05 Erro no processamento do pagamento instantâneo (erro genérico) · SPI (Banco Central)
- FF07 Inconsistência entre a finalidade da transação e o preenchimento do bloco elementos Structured <Strd> · SPI (Banco Central)
- FF08 Identificador da operação mal formatado · SPI (Banco Central)
- FRAD Ordem de pagamento rejeitada por fundada suspeita de fraude · PSP recebedor
- INDT Conteúdo da mensagem incompatível com os parâmetros atribuídos à cobrança (QR Code) ou à instrução de pagamento (pain.013) que a originou · PSP recebedor
- MD01 ISPB do participante facilitador de serviço Pix Saque ou Pix Troco inexistente · SPI (Banco Central)
- RC09 ISPB do participante do usuário pagador inválido ou inexistente · SPI (Banco Central)
- RC10 ISPB do participante do usuário recebedor inválido ou inexistente · SPI (Banco Central)
- RR04 Ordem de pagamento em que o usuário pagador é sancionado por resolução do Conselho de Segurança das Nações Unidas (CSNU). Nos casos em que o usuário recebedor for o sancionado, a ordem de pagamento não deve ser rejeitada · PSP recebedor
- RR06 O bloco de elementos somente poderá ser preenchido quando os campos cpfCnpjUsuarioPagador e cpfCnpjUsuarioRecebedor forem ambos Pessoa Jurídica (14 caracteres) e o campo formaDeIniciacao for igual a 'QRES', 'APES', 'MANU' ou 'DICT' · SPI (Banco Central)
- SL02 A transação referenciada na mensagem de devolução (pacs.004) original não está relacionada aos serviços de Pix Saque ou Pix Troco · PSP recebedor
- UPAY Pagamento é indevido por ausência de recorrência válida/ativa · PSP recebedor
Motivo de devolução (pacs.004)
- BE08 Devolução de pagamento iniciada pelo participante do usuário recebedor no âmbito do Mecanismo Especial de Devolução. Deve ser preenchido sempre que uma solicitação de devolução for iniciada pelo participante do usuário pagador com o motivo falha operacional do PSP do pagador ou sempre que a devolução for iniciada pelo participante do usuário recebedor por falha operacional em seus próprios sistemas · PSP recebedor
- FR01 Devolução de pagamento, iniciada pelo participante do usuário recebedor no âmbito do Mecanismo Especial de Devolução, motivada por fundada suspeita de fraude. Deve ser preenchido sempre que uma solicitação de devolução for iniciada pelo participante do usuário pagador com o motivo fundada suspeita de fraude ou sempre que a devolução for iniciada pelo participante do usuário recebedor por fundada suspeita de fraude · PSP recebedor
- MD06 Devolução de pagamento solicitado pelo usuário recebedor · PSP recebedor
- SL02 Devolução de pagamento solicitada pelo usuário recebedor motivada por um erro na transação ou desacordo entre as partes relacionados ao Pix Saque ou ao Pix Troco · PSP recebedor
Erro na consulta de chave (DICT)
- Forbidden Requisição de participante autenticado viola alguma regra de autorização · DICT
- BadRequest Requisição com formato inválido · DICT
- NotFound Entidade não encontrada · DICT
- ResourceConflict Este recurso está sendo processado por outra operação no momento. Indica-se que a requisição seja feita novamente em instantes · DICT
- Gone Recurso não está mais disponível · DICT
- RateLimited Limite de requisições foi atingido Ver seção sobre limitação de requisições · DICT
- InternalServerError Condição inesperada ao processar requisição · DICT
- ServiceUnavailable Serviço não está disponível no momento. Pode estar em manutenção ou fora da janela de funcionamento · DICT
- RequestSignatureInvalid Assinatura digital da requisição enviada é inválida · DICT
- RequestIdAlreadyUsed Requisição foi feita com mesmo `RequestId` de requisição feita anteriormente, mas com parâmetros diferentes · DICT
- InvalidReason Requisição foi feita com uma razão inválida para a operação · DICT
- ParticipantInvalid O participante não pode participar na operação solicitada · DICT
- TaxIdNumberBlocked O CPF/CNPJ encontra-se bloqueado por ordem judicial · DICT
- UserOrAccountWithFraudRelatedRestriction Conta/usuário com restrição motivada por fundada suspeita de fraude em transações Pix · DICT
- DeprecatedResource Este recurso foi deprecado · DICT
- EntryInvalid Existem campos inválidos ao tentar criar ou atualizar vínculo · DICT
- EntryLimitExceeded Número de vínculos associados a conta transacional excedeu o limite máximo · DICT
- EntryAlreadyExists Já existe vínculo para essa chave com o mesmo participante e dono · DICT
- EntryCannotBeQueriedForBookTransfer Vínculo consultado está custodiado no mesmo PSP do usuário pagador para quem está sendo feita a consulta. Quando o pagador e o recebedor estão no mesmo PSP, não deve ser feita consulta ao DICT · DICT
- EntryKeyOwnedByDifferentPerson Já existe vínculo para essa chave mas ela é possuída por outra pessoa. Indica-se que seja feita uma reivindicação de posse · DICT
- EntryKeyInCustodyOfDifferentParticipant Já existe vínculo para essa chave com o mesmo dono, mas ela encontra-se associada a outro participante. Indica-se que seja feita uma reivindicação de portabilidade · DICT
- EntryLockedByClaim Existe uma reivindicação com status diferente de concluída ou cancelada para a chave do vínculo. Enquanto estiver nessa situação, o vínculo não pode ser excluído · DICT
- EntryTaxIdNumberByDifferentOwner CPF/CNPJ do vínculo diferente do CPF/CNPJ do dono da chave · DICT
- EntryBlocked O vínculo encontra-se bloqueado por ordem judicial e não pode ser consultado · DICT
- EntryWithFraudRelatedRestriction O vínculo encontra-se bloqueado devido à associação da conta/usuário com restrição motivada por fundada suspeita de fraude em transações Pix · DICT