Tabela de erros do pagamento web

Documentação para possíveis erros encontrados no pagamento via web.

Repostas da requisição

Modelos de retorno existentes:

Padrão 1

{
    "message": "Error",
    "errors": {
        "customer.name": [
            "This field is required"
        ]
    }
}

Padrão 2

{
    "statusCode": 500,
    "message": "Aconteceu um problema no servidor, entre em contato com o suporte técnico - HV000028: Unexpected exception during isValid call."
}

Padrão 3

{
    "message": "A referencia informada para esta transacao já encontra-se cadastrada."
}

Padrão 4

{
    "statusCode": 401,
    "message": "Unauthorized"
}

Lista de erros

HTTP Status	Mensagem de erro	Cenário
400	This field is required	Parâmetro obrigatório não foi informado. Parâmetro informado na resposta da requisição
400	must be greater than or equal to 500	Valor total da requisição não corresponde com valores mínimos para uma transação
400	must not be empty	Valor do campo não pode ser vazio
400	Invalid value	Valor passado no campo é inválido. Erro causado normalmente pelo tipo do campo enviado não ser o tipo pedido na requisição. Também pode ocorrer em enumerações onde o valor enviado não seja um dos valores mapeados na requisição
400	Documento legal do Brasil deve possuir 11 ou 14 digitos.	Documento legal (CPF ou CNPJ) enviado com a quantidade errada de dígitos
400	Para prosseguir é necessário informar um telefone válido.	O telefone enviado não pôde ser validado pois possui um formato inválido
400	Para prosseguir é necessário informar um e-mail.	O email enviado não pôde ser validado pois possui um formato inválido
400	A referencia informada para esta transacao já encontra-se cadastrada.	A referência desta transação já se encontra registrada em nosso banco de dados e não pode ser paga novamente
400	O pagamento não pode ser processado por falha de comunicação com sistema de anti-fraude.	Problemas de comunicação com o sistema de antifraude
400	Essa modalidade de pagamento não está disponível pelo sistema	O sistema identificou uma tentativa de pagamento com uma modalidade não disponível (tentativa de pagamento que não seja por cartão)
400	Não encontramos o cartão tokenizado informado.	Cartão não identificado
400	Nao foi possível prosseguir com o processamento da transação. Verifique a configuração do estabelecimento e tente novamente.	Problemas na verificação do MDR
400	Não existe nenhum gateway configurado para essa transação	Não foi possível localizar nenhum gateway para completar a transação
401	Unauthorized	Token de autorização não informado ou inválido
500	Aconteceu um problema no servidor, entre em contato com o suporte técnico - HV000028: Unexpected exception during isValid call.	O gateway não foi capaz de finalizar a requisição no servidor
500	Aconteceu um problema no processamento da transação junto ao gateway.	Problema de comunicação com o servidor