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