Erros

Nesta seção, você encontrará a visão geral sobre os erros que pode receber nos endpoints do produto Unico IDPay

---

Introdução

---

O Unico IDPay utiliza códigos de resposta HTTP convencionais para indicar o sucesso ou falha de uma solicitação de API.

Como regra geral:

• Códigos no intervalo 2xx indicam sucesso na requisição;

• Códigos no intervalo 4xx indicam parâmetros incorretos ou incompletos (por exemplo, um parâmetro obrigatório foi omitido ou uma operação falhou com terceiros, etc.);

• Códigos no intervalo 5xx indicam que houve um erro nos servidores do produto Unico IDPay.

O Unico IDPay também gera uma mensagem de erro e um código de erro formatado em JSON:

{
    "error": {
        "code": "40004",
        "description": "transaction id is invalid"
    }
}

Erros possíveis

---

Neste tópico, você encontrará os possíveis erros dos endpoints, separados por seu HTTP response.

Criação da transação

---

Consulta do status da transação

---

Recuperação do conjunto probatório da transação

---

Reenvio da notificação da transação

---

Onboarding de cartão de crédito

---

HTTP Code	Código	Descrição	Motivo
400	40001	error decoding json	Os dados enviados não condizem com o contrato do serviço.
400	40002	error validating json	Alguma informação está mal formatada ou não foi preenchida.
400	40027	replicated transaction	A transação enviada já existe, não podendo cria-lá novamente.
400	40030	invalid identity	O CPF enviado na requisição é diferente do CPF do processID informado.
400	40045	max value reached	Quando a transação atinge um valor maior que o permitido.
400	40054	processID is invalid	Quando o processID enviado na requisição é inválido (ou não existe).
400	40055	processID is expired	Quando o processoID que está sendo utilziado é muito antigo.
403	40301	not allowed	O usuário não tem permissão para fazer tal ação.
404	40404	company not found	A empresa informada não existe.
404	40410	processID not found	Quando o processo informado não existe.
404	40412	image not found	Quando o processo informado pelo usuário não possuí uma imagem.
429	40001	too many requests	Ratelimit atingido.
429	42901	too many requests	Quando o cliente está enviando muitas requisições, maior que o pré-definido.
500	50001	internal error	Falha interna no serviço.

---

Dúvidas?​

Não encontrou algo ou ainda precisa de ajuda? Se já é um cliente ou parceiro, pode entrar em contato através da Central de Ajuda.