Os códigos de erro são constantes que representam algum problema no fluxo transacional. Estes códigos podem ser retornados na resposta da api ou no campo error_info.error_code dos hooks. Novos erros podem ser adicionados conforme a necessidade.
Os possíveis códigos de erro são:
NOT FOUND:
MERCHANT_NOT_FOUND: Loja configurada para o app_client, não encontrada.
CHANNEL_NOT_FOUND: Canal configurado para o app_client, não encontrado.
CREDENTIALS_NOT_FOUND: Credenciais informadas para o hook, não encontradas.
CARD_NOT_FOUND: Cartão não encontrado.
TRANSACTION_NOT_FOUND: Transação de cartão não encontrada.
PIX_NOT_FOUND: Pix não encontrado.
PIX_BATCH_NOT_FOUND: Lote de pix não encontrado.
SLIP_NOT_FOUND: Boleto não encontrado.
SLIP_BATCH_NOT_FOUND: Lote de boletos não encontrado.
CARD_CONFIG_NOT_FOUND: Configuração para criação de transações de cartão, não encontrada.
CARD_INTEGRATION_NOT_FOUND: Integração definida para transações de cartão, não encontrada.
ANTI_FRAUD_INTEGRATION_NOT_FOUND: Integração definida para execução do antifraude, não encontrada.
ANTI_FRAUD_CONFIG_NOT_FOUND: Configuração para análise do antifraude, não encontrada.
PIX_CONFIG_NOT_FOUND: Configuração para criação de pix, não encontrada.
PIX_INTEGRATION_NOT_FOUND: Integração definida para criação de pix, não encontrada.
SLIP_CONFIG_NOT_FOUND: Configuração para criação de boletos, não encontrada.
SLIP_INTEGRATION_NOT_FOUND: Integração definida para geração de boletos, não encontrada.
UNPROCESSABLE ENTITY OR BAD REQUEST
UNPROCESSABLE_REQUEST: Requisição não processável. Ex: Status não permite a ação desejada.
PROVIDER_BAD_REQUEST: O provedor devolveu bad request na requisição.
REQUIRED_PARAM: Algum parâmetro obrigatório não foi recebido.
INVALID_PARAM_TYPE: O tipo de dado de algum parâmetro é inválido.
INVALID_PARAM_VALUE: O valor de algum parâmetro é inválido.
INVALID_PARAM: Algum parâmetro informado não é aceito.
INTERNAL SERVER ERROR
PROVIDER_INTERNAL_ERROR: Ocorreu um erro interno no provedor e não recebemos a especificação do erro.
PROVIDER_UNMAPPED_ERROR: Ocorreu um erro no provedor que não foi mapeado na base gsurf.
PROVIDER_TIMEOUT: Timeout na requisição ao provedor.
PROVIDER_CONNECTION_ERROR: Erro de conexão com o provedor.
PROVIDER_UNAUTHORIZED_ERROR: Problema de autenticação no provedor.
PROVIDER_4XX_ERROR: Algum erro na faixa dos 400 que não foi mapeado de forma específica.
PROVIDER_UNEXPECTED_CONTENT: A requisição com o provedor foi feita com sucesso, mas o conteúdo da resposta não está no formato esperado.
UNMAPPED_EXCEPTION: Exceção não mapeada.
DB_ERROR: Problemas com o bando de dados.
EXECUTION_BROKEN: Execução interrompida por erro de lógica.
INTERNAL_ERROR: Erro interno não mapeado.
ACCESS
UNAUTHORIZED: Não Autorizado. Não autenticado.
FORBIDDEN: Sem permissão para acessar o recurso.