Tabelas de erros das APIs
As tabelas abaixo apresentam os possíveis erros que podem ser retornados em nossas APIs de fluxo de pagamento de contas.
Tabela de erros da API de Consulta de Dados
Tentativas de pagamentos realizadas através do código de barras ou linha digitável.
Mensagem de erro | Código do erro | Tipo de transação | Recomendação |
---|---|---|---|
TRANSACAO JA REALIZADA | 68 | Concessionária e ficha de compensação | Retornar que o pagamento já foi realizado. |
PAGAMENTO NAO REALIZADO, ESTE RECEBIMENTO NAO PODE SER REALIZADO POR ESTE CANAL | 258 | Concessionária e ficha de compensação | Informar que esse boleto específico só é aceito em unidades próprias. |
MAXIMO DE DIAS DE ATRASO EXCEDIDO | 260 | Ficha de compensação | Informar que esse boleto contém regras que não permite o pagamento após alguns dias do seu vencimento. |
PAGAMENTO JA EFETUADO | 183 | Concessionária e ficha de compensação | Alertar o usuário que o pagamento já foi realizado. |
DOCUMENTO NAO RECEBIVEL NA INSTITUICAO | 245 | Ficha de compensação | Informar que não é possível realizar esse tipo de pagamento. Esse retorno é apresentado sempre que a Celcoin não consegue processar um pagamento devido a uma restrição. Exemplo: pagamento só pode ser realizado em um banco específico. |
RECEBIMENTO NAO AUTORIZADO. DOCUMENTO VENCIDO | 244 | Concessionária e ficha de compensação | Informar que o pagamento está vencido e que existe uma regra que restringe o pagamento. |
CODIGO BARRAS INVALIDO | 243 | Concessionária e ficha de compensação | Alertar sobre o preenchimento de um código de barras invalido. |
COD-BARRAS INVALIDO | 240 | Concessionária e ficha de compensação | Alertar sobre o preenchimento de um código de barras invalido. |
PAGAMENTO NAO PERMITIDO | 184 | Concessionária e ficha de compensação | Informar que não é possível realizar esse tipo de pagamento. Esse retorno é apresentado sempre que a Celcoin não consegue processar um pagamento devido a uma restrição. Exemplo: pagamento só pode ser realizado em um banco especifico. |
TRANSACAO NAO ENCONTRADA | 24 | Concessionária e ficha de compensação | Deve ser retornado para o usuário que o código de barras ou linha digitável é inválido. |
PROBLEMA COM O REGISTRO DA CONSULTA | 612 | Ficha de compensação | Nesse caso, a Celcoin, ao consultar o boleto via Núclea, não obteve os dados no formato correto para realizar o cálculo. Isso indica que o emissor não cadastrou esses dados de forma adequada. É necessário que o usuário entre em contato com o banco emissor e informe que há um problema no registro dos dados do boleto para o cálculo. |
CEDENTE NAO AUTORIZADO. PAGAMENTO NAO EFETUADO. | 619 | Concessionária e ficha de compensação | Mensagem de retorno para convênios que não são aceitos. É possível encaminhar para o suporte para verificarem a possibilidade de pagamento. |
FALHA NA COMUNIC JUNTO AO NOSSO PARCEIRO. FAVOR TENTE NOVAMENTE. | 658 | Concessionária e ficha de compensação | Nesse caso, como a Celcoin não teve sucesso ao tentar realizar a tentativa de consulta, o recomendado é fazer novamente. |
FALHA NA COMUNIC COM A INSTITUICAO. FAVOR TENTE NOVAMENTE. | 620 | Concessionária e ficha de compensação | Nesse caso, como a Celcoin não teve sucesso ao tentar realizar a tentativa de consulta, o recomendado é fazer novamente. |
Existe Pendencia. Este pagamento esta pendente de confirmacao | 621 | Concessionária e ficha de compensação | Essa mensagem é apresentada quando a tentativa da efetivação do pagamento ainda não foi concluída. Nesse caso, sua aplicação deve seguir com o id gerado na primeira requisição. |
DIVERGENCIA NO REGISTRO. NAO FOI POSSIVEL CALCULAR JUROS/MULTAS, ENTRE EM CONTATO COM O FAVORECIDO | 648 ou 649 | Ficha de compensação | Problema com o registro na CIP, para esse cenário é necessário entrar em contato com o favorecido. |
BOLETO DE PAGAMENTO JA BAIXADO | 628 | Ficha de compensação | Essa mensagem é apresentada quando o boleto já foi pago. |
BOLETO ENCONTRADO NA BASE E CLIENTE BENEFICIARIO INAPTO NA INSTITUICAO EMISSORA DO BOLETO | 630 | Ficha de compensação | Deve ser apresentada uma mensagem informando que o beneficiário está inapto na instituição emissora do boleto, portanto, ele deve entrar em contato com ela. |
BOLETO ENCONTRADO NA BASE E CLIENTE BENEFICIARIO SEM CADASTRO | 631 | Ficha de compensação | Deve ser apresentada uma mensagem informando que o beneficiário está inapto na instituição emissora do boleto, portanto, ele deve entrar em contato com ela. |
BOLETO ENCONTRADO NA BASE E CLIENTE BENEFICIARIO EM ANALISE NA INSTITUICAO EMISSORA DO BOLETO | 632 | Ficha de compensação | Deve ser apresentada uma mensagem informando que o beneficiário está inapto na instituição emissora do boleto, portanto, ele deve entrar em contato com ela. |
BOLETO EXCEDEU O LIMITE DE PAGAMENTOS PARCIAIS | 633 | Ficha de compensação | Retornar para o usuário que ele tem restrições com o beneficiário. |
BAIXA OPERACIONAL EM DUPLICIDADE PARA BOLETO DE PAGAMENTO QUE NAO PERMITE PAGAMENTO PARCIAL | 634 | Ficha de compensação | Retornar para o usuário que ele tem restrições com o beneficiário. |
BAIXA OPERACIONAL JA REGISTRADA PARA BOLETO DE PAGAMENTO QUE NAO PERMITE PAGAMENTO PARCIAL | 635 | Ficha de compensação | Retornar para o usuário que ele infringiu a regra de pagamentos parciais estabelecida pelo beneficiário. |
BOLETO EXCEDEU O VALOR DE SALDO PARA PAGAMENTO PARCIAL PARA O TIPO DE MODELO DE CALCULO 04 | 636 | Ficha de compensação | Retornar informação de valor excedido do boleto para pagamento parcial. |
BOLETO ENCONTRADO NA BASE E BENEFICIÁRIO INAPTO EM INSTITUICAO DIFERENTE DA EMISSORA DO BOLETO | 637 | Ficha de compensação | Informar que o pagador tem restrições com banco e por isso não será possível realizar o pagamento. |
BOLETO ENCONTRADO NA BASE E BENEFICIARIO EM ANALISE EM INSTITUICAO DIFERENTE DA EMISSORA DO BOLETO | 638 | Ficha de compensação | Informar que o pagador tem restrições com banco e por isso não será possível realizar o pagamento. |
BOLETO NAO PERMITIDO APOS DATA LIMITE DE PAGAMENTO | 639 | Ficha de compensação | Apresenta ao usuário que esse pagamento já teve sua data limite de pagamento ultrapassada. |
CODIGO DE BARRAS NAO LOCALIZADO NA BASE CENTRALIZADA | 642 | Ficha de compensação | Deve ser retornado para o usuário que o código de barras ou linha digitável é inválido. |
SPTRANS INDISPONIVEL. POR FAVOR, TENTE NOVAMENTE. | 714 | Recarga bilhete único | Informar que ocorreu uma intermitência e pedir para tentar novamente. |
CEDENTE NAO AUTORIZADO. PAGAMENTO NAO EFETUADO. | 481 | Concessionária e ficha de compensação | Nesse caso, o indicado é informar ao usuário que o pagamento não deu certo e entrar em contato com a equipe de suporte da Celcoin para validar o que aconteceu. |
Out of call volume quota. Quota will be replenished in 00:XX:XX | 403 | Concessionária e ficha de compensação | Retorna ao atingir o limite de 20 consultas sequenciais com a mesma linha digitável ou código de barras. |
Tente novamente no próximo dia útil. O valor atualizado para este boleto está indisponível. | 780 | Ficha de compensação | Essa mensagem é apresentada geralmente quando o cliente tenta consultar um pagamento de Ficha de Compensação cujas informações de cálculo estão indisponíveis na plataforma centralizadora de boletos. Por exemplo em títulos que só podem ser pagos e consultados em dias úteis. Solicite que o cliente tente pagar o boleto novamente no próximo dia útil. Você pode testar esse cenário em sandbox com o cenário "Caso em que não é possível fazer a consulta do boleto em dias não úteis" da nossa massa de testes. |
Nao e possivel pagar esse tributo. Data de liquidacao posterior a data de vencimento. | 820 | Concessionária | Esta mensagem aparece quando um tributo está sendo pago fora da grade horária de liquidação e a próxima janela de liquidação já está fora da validade, por isso não aceita a liquidação do pagamento, evitando assim que o pagamento seja devolvido. |
Erro na conversão do código de barras para linha digitável. | 821 | Concessionária e ficha de compensação | Esta mensagem aparece quando não é possível converter a linha digitável em código de barras, normalmente porque o cliente digitou incorretamente a linha digitável. Peça ao cliente para verificar a linha digitável inserida. |
Erro na conversão da linha digitável para código de barras. | 822 | Concessionária e ficha de compensação | Esta mensagem aparece quando não é possível converter o código de barras em linha digitável, normalmente porque o cliente digitou incorretamente o código de barras. Peça ao cliente para verificar a linha digitável inserida. |
Erro genérico Veja Resolução | 999 | Todas | Quando este erro ocorrer, a mensagem irá conter um texto livre referente a uma falha ainda não mapeada com um código de erro específico. Exemplo: "errorCode": "999", "message": "Código em barras inválido". Exemplo caso seja enviado na consulta um "type" diferente do tipo de conta (ficha de compensação e concessionaria) irá retornar "errorCode": "999", "message": "Tipo Servico Divergente". |
Tabela de erros da API de Reserva de Saldo
Tentativas de reserva de saldo para efetuação do pagamento de contas.
Mensagem de erro | Código do erro | Tipo de transação | Recomendação |
---|---|---|---|
OPERACAO NAO EFETUADA. TENTE NOVAMENTE | 598 | Concessionaria e ficha de compensação | Pode estar relacionado a algum problema momentâneo. É necessário sinalizar que o usuário tente novamente. |
VALOR NAO PERMITIDO | 44 | Ficha de compensação | Ocorre quando o usuário insere algum valor que não está permitido para a transação. |
CONTA NAO PERMITE ALTERAR VALOR | 263 | Ficha de compensação | Em um pagamento de contas, que retornou o indicativo de "permite alterar valor" = false, será necessário inserir o valor total atualizado retornado na consulta. Caso insira um valor diferente esse erro será apresentado. |
CODIGO BARRAS INVALIDO | 243 | Concessionaria e ficha de compensação | Alertar sobre o preenchimento de um código de barras invalido. |
COD-BARRAS INVALIDO | 240 | Concessionaria e ficha de compensação | Alertar sobre o preenchimento de um código de barras invalido. |
PAGAMENTO NAO PERMITIDO | 184 | Concessionaria e ficha de compensação | Retornar para o usuário que ele infringiu a regra de pagamentos parciais estabelecida pelo beneficiário. |
TRANSACAO NAO ENCONTRADA | 24 | Concessionaria e ficha de compensação | Essa mensagem é apresentada sempre que houver uma tentativa de retirada de saldo de uma conta para um transid que não existe. |
FALHA NA COMUNIC JUNTO AO NOSSO PARCEIRO. FAVOR TENTE NOVAMENTE | 658 | Concessionaria e ficha de compensação | Nesse caso, houve uma falha de comunicação na tentativa de realizar o pagamento, por isso é necessário fazer uma consulta do status do pagamento para confirmar se o pagamento foi realizado e, caso não, pedir ao usuário que o refaça. |
FALHA NA COMUNIC COM A INSTITUICAO. FAVOR TENTE NOVAMENTE. | 620 | Concessionaria e ficha de compensação | Nesse caso, houve uma falha de comunicação na tentativa de realizar o pagamento, por isso é necessário fazer uma consulta do status do pagamento para confirmar se o pagamento foi realizado e, caso não, pedir ao usuário que o refaça. |
Existe Pendencia. Este pagamento esta pendente de confirmacao | 621 | Concessionaria, ficha de compensação | Essa mensagem é apresentada quando a tentativa da efetivação do pagamento ainda não foi concluída. Nesse caso, sua aplicação deve seguir com o id gerado na primeira requisição. |
VALOR MENOR QUE O MINIMO PERMITIDO | 622 | Ficha de compensação | Essa mensagem de erro é apresentada se no retorno da consulta CIP (Campo minValue), o valor inserido para a efetivação for menor que o mínimo permitido. |
VALOR MAIOR QUE O MAXIMO PERMITIDO | 623 | Ficha de compensação | Essa mensagem de erro é apresentada se no retorno da consulta CIP (Campo minValue), o valor inserido para a efetivação for menor que o mínimo permitido. |
PROTOCOLOID CONSULTA JA ULTILIZADO POR OUTRO PAGAMENTO | 652 | Concessionaria e ficha de compensação | Esse erro é apresentado sempre que o ID identificador, usado na requisição, for utilizado novamente. |
PROTOCOLOID CONSULTA NAO LOCALIZADO NA DATA ATUAL | 653 | Concessionaria e ficha de compensação | Esse erro é apresentado quando a consulta não é realizada no mesmo dia da criação do pagamento. |
COD BARRAS/LINHA DIGITAVEL INCORRETA PARA O PROTOCOLOID CONSULTA INFORMADO | 655 | Concessionaria e ficha de compensação | Alertar sobre o preenchimento de um código de barras invalido. |
BOLETO DE PAGAMENTO JA BAIXADO | 628 | Ficha de compensação | Informar o usuário que esse pagamento já foi realizado. |
VALOR A PAGAR ATUALIZADO MAIOR QUE O VALOR MAXIMO PERMITIDO | 656 | Ficha de compensação | Retorna caso a data limite de pagamento esteja expirada e o valor original + encargos é maior que o valor registrado na Núclea. |
VALOR A PAGAR ATUALIZADO MENOR QUE O VALOR MINIMO PERMITIDO | 657 | Ficha de compensação | Essa mensagem de erro é apresentada caso ocorra uma tentativa de pagamento com valor diferente do retornado no campo totalAtualizado |
SPTRANS INDISPONIVEL. POR FAVOR, TENTE NOVAMENTE. | 714 | Recarga bilhete único | Retornado caso ocorra intermitência junto a SPTrans. |
ID CONSULTA CIP NAO ENCONTRADO | 640 | Ficha de compensação | Retorno ao realizar uma efetivação de contas utilizando um "transactionIdAuthorize" inválido. |
Erro genérico Veja Resolução | 999 | Todas | Quando este erro ocorrer, a mensagem irá conter um texto livre referente a uma falha ainda não mapeada com um código de erro específico. Exemplo: "errorCode": "999", "message": "Cpf/Cnpj invalidos" |
Tabela de erros da API de Confirmação de Pagamento
Mensagem de erro | Código do erro | Tipo da transação | Recomendação |
---|---|---|---|
TRANSACAO NAO ENCONTRADA | 24 | Todas | Deve ser retornado para o usuário que o código de barras ou linha digitável é inválido. |
FALHA NA COMUNIC JUNTO AO NOSSO PARCEIRO. FAVOR TENTE NOVAMENTE. | 658 | Todas | Nesse caso, houve uma falha de comunicação na tentativa de realizar o pagamento, por isso é necessário fazer uma consulta do status do pagamento para confirmar se o pagamento foi realizado e, caso não, pedir ao usuário que o refaça. |
FALHA NA COMUNIC COM A INSTITUICAO. FAVOR TENTE NOVAMENTE. | 620 | Todas | Nesse caso, houve uma falha de comunicação na tentativa de realizar o pagamento, por isso é necessário fazer uma consulta do status do pagamento para confirmar se o pagamento foi realizado e, caso não, pedir ao usuário que o refaça. |
BOLETO NÃO PERMITE ALTERAR VALOR | 613 | Ficha de Compensação | A chamada de confirmação do pagamento não deve alterar o valor de pagamento do boleto. |
SPTRANS INDISPONIVEL. POR FAVOR, TENTE NOVAMENTE. | 714 | Todas | Informar que ocorreu uma intermitência e pedir para tentar novamente. |
JA EXISTE UMA EFETIVAÇÃO SENDO PROCESSADA PARA O PAGAMENTO EM QUESTAO | 819 | Todas | A chamada de confirmação do pagamento não deve ser enviada mais de uma vez. O erro retornado evitará duplicidade nos pagamentos. |
PAGAMENTO NAO EFETUADO. CEDENTE NAO REGISTRADO | 480 | Todas | Informar que não foi localizado o código de barras para o cliente. |
Updated about 2 months ago