Tabelas de erros das APIs
Criamos as tabelas abaixo com objetivo de apresentar os erros que nossas apis que envolvem o fluxo de pagamento de contas apresenta.
Tabela de consulta de um pagamento através do código de barras ou linha digitável
Mensagem de erro | Código do erro | Tipo de transação | Resoluçã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 que o código de barras preenchido é inválido. |
COD-BARRAS INVALIDO | 240 | Concessionária e ficha de compensação | Alertar que o código de barras preenchido é inválido. |
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. |
CEDENTE NAO AUTORIZADO. PAGAMENTO NAO EFETUADO. | 619 | Concessionária e ficha de compensação | Retorna para convênios que não são aceitos. (É possível que encaminhe 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 do pagamento o recomendado é pedir ao usuário que tente efetuar a tentativa de pagamento 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 do pagamento o recomendado é pedir ao usuário que tente efetuar a tentativa de pagamento novamente. |
Existe Pendencia. Este pagamento esta pendente de confirmacao | 621 | Concessionária e ficha de compensação | Essa mensagem será apresentada quando ocorrer a tentativa da efetivação, porém ela 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 a data limite do pagamento expirou, dessa forma, deve ser apresentado esse informativo ao seu usuário. |
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 | Retorna que o boleto excedeu valor 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 indicado é informar ao usuário que não deu certo o pagamento 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 | 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 | |
PAGAMENTO NÃO PERMITIDO PARA ESSE BENIFICIARIO | 728 | Concessionária e ficha de compensação | Essa mensagem é apresentada uma vez que a instuição financeira detentora do boleto está na blacklist da Celcoin, nesse caso o ideal é apresentar para o usuario que não foi possível efetuar o pagamento, para ele tentar novamente em outro horário. |
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" |
Tabela de erros da API de reservar saldo para efetuar o pagamento de uma conta
Mensagem de erro | Código do erro | Tipo de transação | Resolução |
---|---|---|---|
OPERACAO NAO EFETUADA. TENTE NOVAMENTE | 598 | Concessionaria e ficha de compensação | Pode estar relacionado a algum problema momentanêo, é necessario sinalizar que o usuario tente novamente. |
VALOR NAO PERMITIDO | 44 | Ficha de compensação | Ocorre quando o usuario 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 retorno o indicativo de permite alterar valor = false, será necessario inserir o valor total atualizado retornado na consulta. Caso insira um valor diferente o erro será retornado |
CODIGO BARRAS INVALIDO | 243 | Concessionaria e ficha de compensação | Alertar que o código de barras preenchido é invalido. |
COD-BARRAS INVALIDO | 240 | Concessionaria e ficha de compensação | Alertar que o código de barras preenchido é invalido. |
PAGAMENTO NAO PERMITIDO | 184 | Concessionaria e ficha de compensação | Retornar para o usuario que ele infrinjiu a regra de pagamentos parciais estabelecida pelo beneficiario |
TRANSACAO NAO ENCONTRADA | 24 | Concessionaria e ficha de compensação | Essa mensagem é apresentada sempre que tentar realizar o processo 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 como a Celcoin não teve sucesso ao tentar realizar a tentativa do pagamento o recomendado é pedir ao usuário que tente efetuar a tentativa de pagamento novamente. |
FALHA NA COMUNIC COM A INSTITUICAO. FAVOR TENTE NOVAMENTE. | 620 | Concessionaria e ficha de compensação | Nesse caso como a Celcoin não teve sucesso ao tentar realizar a tentativa do pagamento o recomendado é pedir ao usuário que tente efetuar a tentativa de pagamento novamente. |
Existe Pendencia. Este pagamento esta pendente de confirmacao | 621 | Concessionaria, ficha de compensação | Essa mensagem será apresentado quando ocorrer a tentativa da efetivação, porém ela não foi concluida. 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 | No retorno da consulta CIP (Campo minValue), caso o valor inserido para a efetivação seja menor que o minimo permitido |
VALOR MAIOR QUE O MAXIMO PERMITIDO | 623 | Ficha de compensação | No retorno da consulta CIP (Campo minValue), caso o valor inserido para a efetivação seja menor que o minimo permitido |
PROTOCOLOID CONSULTA JA ULTILIZADO POR OUTRO PAGAMENTO | 652 | Concessionaria e ficha de compensação | Esse é apresentado sempre que o Id identificador usado na requisição é utilizado novamente. |
PROTOCOLOID CONSULTA NAO LOCALIZADO NA DATA ATUAL | 653 | Concessionaria e ficha de compensação | Esse erro é apresentaod 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 que o código de barras preenchido é 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 |
VALOR A PAGAR ATUALIZADO MENOR QUE O VALOR MINIMO PERMITIDO | 657 | Ficha de compensação | Retornado caso ocorra a tentativa de pagamento com um 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 confirmar o pagamento de uma conta
Mensagem de erro | Código do erro | Tipo da transação | Resolução |
---|---|---|---|
TRANSACAO NAO ENCONTRADA | 24 | Todas | Deve ser retornado para o usuário que o código de barras ou linha digitavel é invalido. |
FALHA NA COMUNIC JUNTO AO NOSSO PARCEIRO. FAVOR TENTE NOVAMENTE. | 658 | Todas | Nesse caso como a Celcoin não teve sucesso ao tentar realizar a tentativa do pagamento o recomendado é pedir ao usuário que tente efetuar a tentativa de pagamento novamente. |
FALHA NA COMUNIC COM A INSTITUICAO. FAVOR TENTE NOVAMENTE. | 620 | Todas | Nesse caso como a Celcoin não teve sucesso ao tentar realizar a tentativa do pagamento o recomendado é pedir ao usuário que tente efetuar a tentativa de pagamento novamente. |
SPTRANS INDISPONIVEL. POR FAVOR, TENTE NOVAMENTE. | 714 | Todas | Informar que ocoreu uma intermitência e pedir para tentar novamente |
Updated about 1 month ago
Did this page help you?