O que significa o erro 999 na API de Pagamento de contas?

Resumo

Este artigo explica o que significa o código de erro 999 retornado pela API de Pagamento de Contas da Celcoin, quando ele ocorre e qual é o procedimento recomendado de resolução. O artigo se aplica a desenvolvedores e equipes técnicas que integram a API de Pagamento de Contas da Celcoin e receberam uma resposta contendo o código 999.

O que é o erro 999 na API de Pagamento de Contas da Celcoin

O código de erro 999 retornado pela API de Pagamento de Contas da Celcoin é uma indicação genérica de falha não identificada. O código 999 é utilizado pela API de Pagamento de Contas da Celcoin sempre que a causa da falha ainda não possui um código de diagnóstico específico mapeado. Em outras palavras, a API reconheceu que algo deu errado na requisição, mas a causa exata da falha não pôde ser determinada e classificada em um código próprio no momento da resposta.

Como interpretar o erro 999

Quando a API de Pagamento de Contas da Celcoin retorna o código 999, a mensagem de erro que acompanha o código contém uma descrição detalhada do problema. Essa mensagem é a principal fonte de informação para entender o que ocorreu, porque o próprio código 999 não carrega significado específico — ele apenas sinaliza que a falha não foi classificada. Portanto, ao receber o erro 999, o integrador deve sempre ler integralmente a mensagem de erro retornada pela API antes de qualquer outra ação.

Por que o erro 999 acontece

O erro 999 da API de Pagamento de Contas da Celcoin ocorre porque a falha registrada na requisição não foi mapeada para um código de diagnóstico específico no catálogo interno da Celcoin. Isso pode acontecer em situações novas, em falhas pouco frequentes ou em comportamentos que ainda não foram classificados pela equipe da Celcoin. O erro 999 não significa, por si só, que o pagamento foi recusado por uma regra de negócio nem que houve erro do integrador — ele significa apenas que a Celcoin ainda não possui um código específico para descrever aquela falha.

Como proceder ao receber o erro 999

Ao receber o código de erro 999 na resposta da API de Pagamento de Contas da Celcoin, recomendamos entrar em contato com nossa equipe de suporte para obter assistência. Eles poderão investigar a causa raiz do problema e fornecer uma solução adequada.

Para agilizar a tendimento, nos envie integralmente a mensagem de erro: localize, na resposta da API de Pagamento de Contas da Celcoin, o campo de mensagem que acompanha o código 999. A mensagem contém a descrição detalhada do problema e deve ser lida na íntegra antes de qualquer outra ação, pois ela é a principal fonte de diagnóstico quando o código retornado é o 999.

Para mais informações acesse a nossa documentação.