Tabela de erros Pix

Pagamento

CódigoDescrição
40Saldo insuficiente.
400Ocorreu um erro na comunicação com o parceiro.
598Slip not created.
99Error desconhecido proc PROC_NAME
999*Ocorreu um erro inesperado.
CLP001O valor máximo total transacionado no dia foi atingido. Ou Valor máximo aceitado por transação atingido. Ou Cliente não reconhecido
CLP002Não foi possível verificar limite de transação. Tente novamente mais tarde.
CLP003Existe uma transacao pendente, favor aguarde para realizar uma nova operacao.
CLP004Existe uma transação idêntica pendente. Favor aguarde para realizar esta operação para evitar duplicidade.
CLP010Transação em processamento. Favor consultar o status da transação ou aguardar o webhook.
CLP011Já existe uma transação com o mesmo EndToEnd. Favor realizar uma nova operação.
PBE150General reject operation.
PBE300Duplicated EndToEndId.
PBE304Dict bind was not found with this key: {key}.
PBE308Registered account does not allow PIX payment transactions.
PBE309It is not possible update a payment with a status different of INITIATED. Current status is: {CurrentStatus}
PBE310Invalid key format. The accepted key formats, are from: CPF, CNPJ, EMAIL, EVP and PHONE
PBE316Inner PSP transactions calls are not allowed.
PBE317Entry queried is in custody of participant making the query.
PBE323Forbidden It is not possible revert a payment when status not is CONFIRMED or PARTIALLY_REVERTED.
PBE324Settlement aborted due to timeout.
PBE325Transaction stopped due to error at the Creditor Agent.
PBE326Creditor account number invalid or missing.
PBE327Account specified is blocked, prohibiting posting of transactions against it.
PBE328Creditor account number closed.
PBE329Creditor account type missing or invalid.
PBE330Transaction type not supported/authorized on this account.
PBE332Specified message amount is equal to zero.
PBE333Amount of funds available to cover specified message amount is insufficient.
PBE334Amount received is not the amount agreed or expected.
PBE335Number of transactions is invalid or missing. Generic usage if cannot specify between group and payment information levels.
PBE336Identification of end customer is not consistent with associated account number.(formerly CreditorConsistency).
PBE337Value in Creditor Identifier is incorrect.
PBE338Content is incorrect
PBE339The order was rejected by the bank side (for reasons concerning content).
PBE340Signer is not allowed to sign this operation type.
PBE341Invalid creation date and time in Group Header (eg, historic date).
PBE342Associated message, payment information block or transaction was received after agreed processing cut off date, date in the past.
PBE343Settlement of the transaction has failed.
PBE344End to End Id missing or invalid.
PBE345Debtor ClearingSystemMember identifier is invalid or missing.
PBE346Creditor ClearingSystemMember identifier is invalid or missing.
PBE399Duplicated EndToEndId.
PBE414Specific transaction/message amount is greater than allowed maximum.
PBE415Creditor or Ultimate Creditor identification code missing or invalid.
PBE416Regulatory Reason.
PBE417Due to specific service offered by the Creditor Agent.
PBE419The value of property 'Urgency' must be NORMAL when 'PaymentType' is SCHEDULED.
PBE423The AdditionalInformation field should be blank.
PBE424Please add text to AdditionalInformation.
PBE425The AdditionalInformation field must be up to 105 characters.
PBE426Reversal Pix Payment period has expired.
PBE427Reversal amount is above the original transaction amount.
PBE428'VlcpAmount' and 'VldnAmount' properties are required when 'TransactionalType' is CHANGE.
PBE429'VldnAmount' property is required when 'TransactionType' is WITHDRAWAL.
PBE430It is not possible send a value in 'VlcpAmount' when 'TransactionType' is WITHDRAWAL.
PBE431'VldnAmount' property must have the same value than 'Amount' property when 'TransactionType' is WITHDRAWAL.
PBE433It is not possible send a value in 'VlcpAmount' or 'VldnAmount' when 'TransactionType' is TRANSFER.
PBE434'VlcpAmount' property must have the same value than 'Amount' property when 'TransactionType' is CHANGE.
PBE7000Creditor name invalid or missing.
PBE7001Creditor person type invalid or missing.
PBE7002Creditor titularity invalid or missing.
PBE7003Account invalid or missing.
PBE7004Account ISPB invalid or missing.
PBE7005Account status invalid.
PBE7006Creditor status invalid.
PBE7007Block by AML API.
PBE7008'TaxIdPaymentInitiator' property is required when 'InitiationType' is PAYMENT_INITIATOR.
PBE7009'TransactionIdentification' value must be an identifier from a STATIC_QRCODE when 'InitiationType' is PAYMENT_INITIATOR.
PBE7010It is not possible send a value in 'CreditParty.Key' when 'InitiationType' is MANUAL.
PBE7011'CreditParty.Key' property is required when 'InitiationType' is DICT, STATIC_QRCODE or DYNAMIC_QRCODE.
PBE7012Limit has been rejected
PBE7013CNPJ of the payment initiator is not registered in the Pix arrangement.
PBE7014It is not possible send 'TransactionIdentification' property when 'InitiationType' is MANUAL or DICT.
PBE7015'TransactionIdentification' property is required when 'InitiationType' is DYNAMIC_QRCODE.
PBE7016It is not possible send 'TaxIdPaymentInitiator' property when the EMV is from a DYNAMIC_QRCODE.
PBE7017'TransactionIdentification' property must be up to 25 characteres when is present and 'InitiationType' is STATIC_QRCODE.
VLP001InitiationType é um campo de preenchimento obrigatório.
VLP002InitiationType MANUAL obriga a ausência de chave DICT no payload.
VLP003Campo transactionIdentification é de uso exclusivo para pagamentos de QRCodes. InitiationType STATIC_QRCODE ou DYNAMIC_QRCODE
VLP004InitiationType DICT obriga a presença de chave DICT no payload.
VLP005Campo transactionIdentification é de uso exclusivo para pagamentos de QRCodes. InitiationType STATIC_QRCODE ou DYNAMIC_QRCODE
VLP006InitiationType STATIC_QRCODE obriga a presença de chave DICT no payload.
VLP007Campo transactionIdentification é de preenchimento obrigatório para pagamentos de QR Codes.
VLP008InitiationType DYNAMIC_QRCODE obriga a presença de chave DICT no payload.
VLP009Campo transactionIdentification é de preenchimento obrigatório para pagamentos de QR Codes.
VLP014Quando campo InitiationType é PAYMENT_INITIATOR, é obrigatória a presença de um CNPJ no campo taxIdPaymentInitiator do payload.
VLP015Os Campos creditParty.key e endToEndId devem ser preenchidos quando há uma consulta ao DICT utilizando o initiationType PAYMENT_INITIATOR.
VLP016Os Campos creditParty.key e endToEndId não devem ser preenchidos quando não há uma consulta ao DICT utilizando o initiationType PAYMENT_INITIATOR.
VLP017Campo transactionIdentification deve ser preenchido quando o intiationType é PAYMENT_INITIATOR.
VLP018Campo initiationType contém um valor não reconhecido.
VLP021Quando paymentType está preenchido com Valor SCHEDULED, o campo urgency deve ser preenchido com valor NORMAL.
VLP022Quando paymentType está preenchido com Valor IMMEDIATE ou FRAUD, o campo urgency deve ser preenchido com valor HIGH.
VLP023Valor em dinheiro disponibilizado é obrigatório neste tipo de transação.
VLP024Valor da compra não pode ser inserido neste tipo de transação.
VLP025O código de ISPB em operações de saque é obrigatório neste tipo de transação.
VLP026O código de ISPB em operações de saque está fora do padrão '[0...9]{8}'.
VLP027O modo de agente de saque é obrigatório neste tipo de transação.
VLP028O modo de agente de saque deve ser um dos seguinte: AGTEC, AGTOT ou AGPSS.
VLP029Valor da compra não pode ser inserido neste tipo de transação.
VLP030Valor em dinheiro disponibilizado não pode ser inserido neste tipo de transação.
VLP031O modo de agente de saque não pode ser inserido neste tipo de transação.
VLP032O código de ISPB não pode ser inserido neste tipo de transação.
VLP033Valor em dinheiro disponibilizado é obrigatório neste tipo de transação
VLP034Valor da compra é obrigatório neste tipo de transação.
VLP035O código de ISPB em operações de saque é obrigatório neste tipo de transação.
VLP036O código de ISPB em operações de saque está fora do padrão '[0...9]{8}'.
VLP037O modo de agente de saque é obrigatório neste tipo de transação.
VLP038O modo de agente de saque deve ser um dos seguinte: AGTEC, AGTOT ou AGPSS.
VLP039O valor em dinheiro disponibilizado e da compra não deve ser diferente do valor da transação.
VLP040O valor em dinheiro disponibilizado não deve ser diferente do valor da transação.
VLP041O Campo creditParty.key não pode ultrapassar 77 caracteres
VLP042Quando initiationType é STATIC_QRCODE o campo transactionIdentification não pode ultrapassar 25 caracteres
VLP043Quando initiationType é DYNAMIC_QRCODE o campo transactionIdentification não pode ultrapassar 35 caracteres
VLP047DebitParty é um campo de preenchimento obrigatório.
VLP044É necessário informar pelo menos um dos campos: transactionId, endtoendId, ou clientCode
  • Em caso de erro 500 durante a fase de pagamento, deve-se:
    Consulta: Consultar o status do pagamento utilizando o clientCode, e em caso negativo fazer uma nota tentativa, e/ou;
    Retry: Tentar novamente o pagamento utilizando o mesmo clientCode original do pagamento, uma vez que a proteção da idempotencia do cliente (clientCode) não permitirá a duplicação do pagamento e o cliente receberá um erro 400 ("Pagamento já realizado") no caso de repetição;

Cobrança imediata (COB)

CódigoDescrição
CI003Chave informada não cadastrada.
VLI001O valor original é obrigatório neste tipo de transação.
VLI002Não é permitido preencher os objetos 'change' e 'withdrawal' simultaneamente.
VLI003Valor em dinheiro disponibilizado é obrigatório neste tipo de transação.
VLI004O valor 'Amount.Original' não pode ser maior que 0 quando o tipo de transação é WITHDRAWAL.
VLI005O código de ISPB em operações de saque é obrigatório neste tipo de transação.
VLI006O código de ISPB em operações de saque está fora do padrão '[0-9]{8}'.
VLI007O modo de agente de saque é obrigatório neste tipo de transação.
VLI008O modo de agente de saque deve ser um dos seguinte: AGTEC, AGTOT ou AGPSS.
VLI009Valor da compra é obrigatório neste tipo de transação.
VLI010Valor em dinheiro disponibilizado é obrigatório neste tipo de transação.
VLI011O valor em dinheiro disponibilizado e da compra não deve ser diferente do valor da transação.
VLI012O código de ISPB em operações de saque é obrigatório neste tipo de transação.
VLI013O código de ISPB em operações de saque está fora do padrão '[0-9]{8}'.
VLI014O modo de agente de saque é obrigatório neste tipo de transação.
VLI015O modo de agente de saque deve ser um dos seguinte: AGTEC, AGTOT ou AGPSS.
UI005Chave informada não cadastrada.

Cobrança com vencimento (COBV)

CódigoDescrição
VLP002Chave Pix informada não é válida para este tipo de ação. Contate o suporte.
VLP046É necessário informar pelo menos um dos campos: transactionId, transactionIdentification, ou clientRequestId.
404Não foram encontrados dados para a transação informada.

Cobrança dinâmica (legado)

CódigoDescrição
LC003Chave Pix informada não é válida para este tipo de ação. Contate o suporte. / Chave informada não cadastrada.
UIM001Chave Pix informada não é válida para este tipo de ação. Contate o suporte. / Chave informada não cadastrada.

Cobrança estática

CódigoDescrição
ST003Chave informada não cadastrada. / Chave Pix informada não é válida para este tipo de ação. Contate o suporte.
400Não foi retornado transacaoRealizadaId ao tentar criar um BRCode estatico
999Erro desconhecido

Estorno

CódigoDescrição
11Transação original não encontrada.
12Limite de devolução excedido para a transação original.
99Transação de recebimento não encontrada.
999Erro desconhecido no account service
40Saldo insuficiente

DICT (Diretório de identificadores de contas transacionais)

CódigoDescrição
909Não foram encontrados dados para a chave informada.
513Ocorreu um problema ao tentar comunicar o parceiro.
VLP048Transação não concluída. Verifique o formato da chave informada e tente novamente.
CBE180Não encontramos a chave informada

QR Code

CódigoDescrição
CR001Erro ao contatar parceiro.

Participantes

CódigoDescrição
55Nenhum registro cadastrado encontrado.
513Ocorreu um problema ao tentar comunicar o parceiro.