Tabela de erros Pix

Abaixo, listamos os erros que podem ocorrer durante a integração e também podem ocorrer em alguns casos quando a operação já estiver em produção.

Importante: Caso o erro encontrado não esteja listado abaixo e, sua empresa tiver uma integração via BaaS com a Celcoin, verifique também a página abaixo:

https://developers.celcoin.com.br/docs/tabela-de-erros-mapeados

Pagamentos e Devoluções

CódigoDescrição
40Saldo insuficiente.
400Ocorreu um erro na comunicação com o parceiro.
400A data {dpp} informada não corresponde a uma data válida.
400O campo Bank deve ser preenchido apenas com números
400Necessário informar pelo menos um dos campos: endtoEndId, transactionId, ou transacationIdBRCode
400Ocorreu um erro na comunicação com o parceiro.
500Ocorreu um erro inesperado
500Não foi possível determinar o resultado da interação.
500Não foi possível criar o pedido de devolução.
500The value '{transactionId}' is not valid.
500Não foi possível localizar dados associado ao refundId informado.
598-SISlip not created.
99Error desconhecido proc PROC_NAME
999Ocorreu um erro inesperado.
999Erro desconhecido (abrir chamado para suporte)
CIE999Ocorreu um erro interno durante a chamada da api.
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.
CLP004Já existe uma transacao com esse clientCode, favor realizar uma nova operacao
CLP005Não localizamos nenhum pagamento associado ao parâmetro informado.
CLP006Cliente nao autorizado para o produto Pix
CLP007BrCodeId não localizado
CLP008Não foi retornado transacaoRealizadaId
CLP009Operacao nao efetuada. Beneficiário não pode ser igual ao pagador para transações da mesma instituição
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.
PBE342Data de pagamento desejada não pode ser menor que a data atual!
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.
PIE001Houve um erro interno na api.
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
VLP044É necessário informar pelo menos um dos campos: transactionId, endtoendId, ou clientCode
VLP047DebitParty é um campo de preenchimento obrigatório.
VLP048Transação não concluída. Verifique o formato da chave informada e tente novamente.
VLP049Valor máximo excedido para essa operação
VLP050Não localizamos nenhuma devolução associado ao parâmetro informado.
VLP051Necessário informar pelo menos um dos campos: paymentDevolutionId, endtoendId, ou clientCode
VLP052O valor original excede o limite maximo legal
VLP054Numero da conta não existe ou não esta ativa no virtual BaaS
VLP055O valor da devolução é de preenchimento obrigatório e deve ser maior que zero.
VLP055Operação não permitida. Clientes Full baas não podem realizar requisições para a Api Pix diretamente.
VLP056O campo 'reason' é obrigatório e deve ser preenchido com um dos seguintes valores: BE08, FR01, MD06 ou SL02.
VLP057Operação não permitida. Clientes Full baas não podem realizar requisições para a Api Pix diretamente.
VLP058Não é permitido realizar Pix através do debitparty.taxid informado.
VLP059O valor de um pagamento precisa seguir o regex '^[0-9]{0,10}(\.[0-9]{1,2})?$'.
VLP059O valor de um pagamento é de preenchimento obrigatório e deve ser maior que zero.
VLP059O campo 'CreditParty.TaxId' deve ser numerico.
VLP059O campo 'CreditParty.Account' deve ser numerico.
VLP059O campo 'RemittanceInformation' esta invalido.
VLP059O campo 'CreditParty.Name' esta invalido
VLP059O campo 'CreditParty.Bank' deve ser numerico.
VLP059O campo 'CreditParty.Branch' não deve conter mais que 4 caracteres.
VLP059O campo 'DebitParty.TaxId' deve ser numerico.
VLP059O campo 'DebitParty.Account' deve ser numerico.
VLP059O valor de um pagamento é de preenchimento obrigatório e deve ser maior que zero
VLP059O campo 'DebitParty.Name' esta invalido.

Informações relevantes em casos de erros no fluxo de pagamento:

Em caso de erro 500 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.

Erros relacionados a QR Codes Dinâmicos (Dynamic)

CódigoDescrição
500BrCodeId não localizado
500Não foi possivel deletar o BrCodeDynamic'
500Nullable object must have a value.
500Ocorreu um problema durante a atualização dos dados do QRCode Dinâmico.
500Ocorreu um erro inesperado
999Nenhum BRCode Dynâmico ativo encontrado para o transactionId informado.
999È necessario informar uma url valida
999Payload não encontrado
999Ocorreu um erro interno durante a chamada da api.
CI005Esse qrcode está vinculado a instituição indireta, por esse motivo não poderá ser alterado.
CR001Object reference not set to an instance of an object.
CLP007BrCodeId não localizado
PBE319Can't delete a Pix Collection with status different of 'ACTIVE'.
PBEXXXNão foi retornado transactionId na inserção do Br Code na base de dados.
PBEXXXErro ao comunicar com o PSTI.
PCE001The field CPF must match the regular expression '^\d{11}$
PCE001The field CNPJ must match the regular expression '^\d{14}$
PCE001The field PostalCode must match the regular expression
PCE001-The field merchant.merchantCategoryCode must match the regular expression '^\d{4}$' and need have 4 or less characters.
PCE001{Generic invalid field message}
PCE003Fields 'Debtor.CPF' and 'Debtor.CNPJ' can't be filled at same time.
PCE003Fields 'Debtor.CPF' and 'Debtor.CNPJ' can't be filled at same time.
PCE91The field Original must match the regular expression '^\d{1,10}\.\d{2}$' for 'Amount.Original'.
PCE91Ao informar um pagador deve ser informado: Nome um CPF ou CNPJ para o mesmo
PIE001Campo obrigatório não preenchido ou contendo erro de preenchimento.
PIE001Houve um erro interno na api.
ST003Chave informada não cadastrada.
VL004Não foi possível localizar a cobrança associada ao parâmetro informado.
VLP002Chave informada não cadastrada.
VLP045É necessário informar pelo menos um dos campos: transactionId ou transactionIdentification.
VLP054Numero da conta não existe ou não esta ativa no virtual BaaS
VLP055Valor de transactionId deve ser positivo e maior que zero!

Erros relacionados ao Location do QR Code

CódigoDescrição
400Error converting value "" + type + "" to 'type' 'LocationType'. Path ''type'', line 3, position 16.
400The field MerchantCategoryCode must match the regular expression '\d{4}' for 'Merchant.MerchantCategoryCode'
400The field PostalCode must match the regular expression '\d{8}' for 'Merchant.PostalCode'.
500Ocorreu um erro inesperado
999Ocorreu um erro inesperado
CEL003Parametro LocationId deve ser um inteiro positivo válido.
CR001Erro ao contatar o Parceiro
CR001Object reference not set to an instance of an object.
CR001Value cannot be null (Parameter 's').
CR888The {field} field is required.
PBE999Parametro LocationId deve ser um inteiro positivo válido.
PIE001Houve um erro interno na api.
PIE003O identificador fornecido não coincide com um location válido.
PIE004Ocorreu um erro inesperado durante a geração da imagem.

Cobrança estática

CódigoDescrição
400Não foi retornado transacaoRealizadaId ao tentar criar um BRCode estatico
404transactionId não existente na base
500Não foi retornado transacaoRealizadaId ao tentar criar um BRCode estatico
500Ocorreu um erro inesperado
999Erro desconhecido
ST003Chave informada não cadastrada.
ST003Chave Pix informada não é válida para este tipo de ação. Contate o suporte.
CLP006Cliente nao autorizado para o produto Pix
CLP007QRCode não localizado
ST003Chave informada não cadastrada.
ST003Chave Pix informada não é válida para este tipo de ação. Contate o suporte.
ST003Key not Found
PBE360Invalid Parameters.
VLP054Numero da conta não existe ou não esta ativa no virtual BaaS
VLP055Valor de transactionId deve ser positivo e maior que zero!
PIE001Houve um erro interno na api.
PIE003O identificador fornecido não coincide com um QRCode Estático válido.
ST004Campo withdrawalServiceProvider é obrigatório para gerar um QR Code de saque
ST005Não foi localizado um agente de saque AGTEC para esse usuario

Erros relacionados à Geração do EMV

CódigoDescrição
500Ocorreu um erro inesperado
999Ocorreu um erro interno na API
PBE150General reject operation
PCE001EMV Merchant Account Information field is over the maximum size allowed.
PCE002Error reading emv: [Invalid Crc].
VLP100O payerId é obrigatório e deve ser um cpf/cnpj válido

Erros relacionados ao QR Code Duedate

CódigoDescrição
404Não foram encontrados dados para a transação informada.
500Ocorreu um erro inesperado
999Ocorreu um erro interno durante a chamada da api.
999È necessario informar uma url valida
999Payload não encontrado
CI003Chave informada não cadastrada
CI005Esse qrcode está vinculado a instituição indireta, por esse motivo não poderá ser alterado.
DE004Nao foi possivel excluir, location não encontrado.
PBE319Can't delete a Pix Collection with status different of 'ACTIVE'.
PBE360Invalid Parameters
PBE410Can't create a new PixCollectionDueDate when the location type is COB
PBE411Collection does not have a location to unlink.
PCE001{Custom Message Invalid Field}
PCE003Fields Receiver.CPF and Receiver.CNPJ can't be null at same time.
PCE003The Calendar.DueDate field cannot be less than the current date.
VLP001Não foi retornado BRCode Location.
VLP002Chave Pix informada não é válida para este tipo de ação. Contate o suporte.
VLP002Chave informada não cadastrada.
VLP002Chave Pix informada não é válida para este tipo de ação. Contate o suporte.
VLP002Não foi possível localizar a cobrança associada ao parâmetro informado.
VLP002Chave Pix informada não é válida para este tipo de ação. Contate o suporte. / Chave informada não cadastrada.
VLP045É necessário informar pelo menos um dos campos: transactionId, transactionIdentification ou clientRequestId
VLP046É necessário informar pelo menos um dos campos: transactionId, transactionIdentification, ou clientRequestId.
VLP050É necessário informar pelo menos um dos campos: debtor.cnpj ou debtor.cpf.
VLP052O valor original excede o limite maximo legal.
VLP059É necessário informar o receiver.
VLP060É necessário informar o campo key.
VLP061É necessário informar o debtor.
VLP062"É necessário informar o campo clientRequestId.
VLP063É necessário informar o campo debtor.name.
VLP064É necessário informar um valor válido para locationId.
VLP066"Os campos [Date] e [AmountPerc] do objeto amountDicount.discountDateFixed devem ser informados.
VLP067O campo amountDicount.discountDateFixed não pode conter mais que 3 objetos.
VLP068As datas do campo discountDateFixed precisam ser diferentes.
VLP069A data do campo discountDateFixed deve ser menor que a data de vencimento.
VLP070A data do campo discountDateFixed deve ser maior que a data de criação.
VLP071O valor de desconto não pode ser igual ou maior que o valor da cobrança.
VLP072O valor da porcentagem não pode ser menor que 0.0 ou maior que 100.00%.
VLP073O valor de abatimento não pode ser igual ou maior que o valor da cobrança.
VLP074O valor da multa não pode ser igual ou maior que o valor da cobrança.
VLP075O valor do juros não pode ser igual ou maior que o valor da cobrança.

Estorno

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

DICT (Diretório de identificadores de contas transacionais)

CódigoDescrição
400Campo PayerId deve ser um CPF/CNPJ valido.
429Rate Limit Error
500Ocorreu um erro inesperado
513Ocorreu um problema ao tentar comunicar o parceiro.
909Não foram encontrados dados para a chave informada.
999Ocorreu um erro inesperado
VLP048Transação não concluída. Verifique o formato da chave informada e tente novamente.
CBE180Não encontramos a chave informada
PBE315No entry was found due the search criteria
PBE352Invalid parameters, {Complemento} [Mensagem padrao para parametros invalidos]
PBE354rate limit reached for policy
PBE359Invalid reason
PBE359Invalid status
PBE360Invalid parameters, {Complemento} [Mensagem padrao para parametros invalidos]
PBE361The {Total} entries limit has been exceeded for the set: participant, branch and account number.There are currently {Total} entries and 0 claimed
PBE362Entry already exists for key
PBE364Entry owned by different person
PBE365Entry in custody of different participant
PBE370Cannot create a portability for a key that is owned by someone other than the claimer, Cannot create an ownership claim for a key that is already owned by the claimer
PBE371Entry associated with given key does not exist
PBE372A claim already exist for key
PBE373Claim resulting entry already exists
PBE374Current claim status does not allow an operation to be made
PBE380Current infraction report does not allow an operation to be made
PCE001The field '{FieldName}' is invalid.
PCE001Os campos de invalid data, estarão com esse codigo. O código de erro vai ser o mesmo para todos, apenas mudando a mensagem do erro.

Participantes

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