---
title: Erros
description: Visão geral dos códigos de status HTTP e respostas de erro retornadas pelos endpoints da REST API da Verificação de Cartão Não Presente.
canonical: https://developer.unico.io/pt-BR/developers/regional-solutions/card-not-present-verification/integration/apis/errors
locale: pt-BR
generated_by: markdown-export
---

- [/pt-BR/](/pt-BR/)
- Soluções Regionais
- [Verificação de Cartão Não Presente](/pt-BR/developers/regional-solutions/card-not-present-verification)
- [Integração](/pt-BR/developers/regional-solutions/card-not-present-verification/integration/overview)
- [APIs](/pt-BR/developers/regional-solutions/card-not-present-verification/integration/apis)
- Erros

**Nesta página# Erros

### Introdução​

A Verificação de Cartão Não Presente 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 Verificação de Cartão Não Presente.

A Verificação de Cartão Não Presente 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​

HTTP CodeCódigoDescriçãoMotivo40040001error decoding jsonOs dados enviados não condizem com o contrato do serviço.40040002error validating jsonAlguma informação está mal formatada ou não foi preenchida.40040021invalid phoneO telefone informado é inválido, deve seguir o padrão: 55 DDD NUMERO. Ex: 5543999999999.40040022invalid emailO e-mail informado é inválido.40040027replicated transactionA transação enviada já existe, não podendo criá-la novamente.40040045max value reachedQuando a transação atinge um valor maior que o permitido.40340301not allowedO usuário não tem permissão para fazer tal ação.40440404company not foundA empresa informada não existe.42940001too many requestsRatelimit atingido.50050001internal errorFalha interna no serviço.
#### Consulta do status da transação​

HTTP CodeCódigoDescriçãoMotivo40040001error decoding jsonOs dados enviados não condizem com o contrato do serviço.40040002error validating jsonAlguma informação está mal formatada ou não foi preenchida.40040004transaction id is invalidO id da transação é inválido (formato).40340301not allowedO usuário não tem permissão para fazer tal ação.40440401transaction not foundA transação não foi encontrada.50050001internal errorFalha interna no serviço.
#### Recuperação do conjunto probatório da transação​

HTTP CodeCódigoDescriçãoMotivo40040004transaction id is invalidO id da transação é inválido (formato).40040009transaction status is invalidO status da transação é inválido (não permitido para geração do conjunto probatório).40340301not allowedO usuário não tem permissão para fazer tal ação.40440401transaction not foundA transação não foi encontrada.50050001internal errorFalha interna no serviço.
#### Reenvio da notificação da transação​

HTTP CodeCódigoDescriçãoMotivo40040001error decoding jsonOs dados enviados não condizem com o contrato do serviço.40040002error validating jsonAlguma informação está mal formatada ou não foi preenchida.40040004transaction id is invalidO id da transação é inválido (formato).40040009transaction status is invalidO status da transação não permite o reenvio de notificação (já está concluído).40040021invalid phoneO telefone informado é inválido, deve seguir o padrão: 55 DDD NUMERO. Ex: 5543999999999.40040022invalid emailO e-mail informado é inválido.40340301not allowedO usuário não tem permissão para fazer tal ação.40440401transaction not foundA transação não foi encontrada.42940001too many requestsRatelimit atingido.50050001internal errorFalha interna no serviço.
#### Onboarding de cartão de crédito​

HTTP CodeCódigoDescriçãoMotivo40040001error decoding jsonOs dados enviados não condizem com o contrato do serviço.40040002error validating jsonAlguma informação está mal formatada ou não foi preenchida.40040027replicated transactionA transação enviada já existe, não podendo criá-la novamente.40040030invalid identityO CPF enviado na requisição é diferente do CPF do `processID` informado.40040045max value reachedQuando a transação atinge um valor maior que o permitido.40040054processID is invalidQuando o `processID` enviado na requisição é inválido (ou não existe).40040055processID is expiredQuando o `processID` que está sendo utilizado é muito antigo.40340301not allowedO usuário não tem permissão para fazer tal ação.40440404company not foundA empresa informada não existe.40440410processID not foundQuando o processo informado não existe.40440412image not foundQuando o processo informado pelo usuário não possui uma imagem.42940001too many requestsRatelimit atingido.42942901too many requestsQuando o cliente está enviando muitas requisições, acima do pré-definido.50050001internal errorFalha interna no serviço.Última atualização em 8 de out. de 2026**