# Catálogo de Códigos de Erro e Negação

Esta referência lista os códigos de erro do sistema retornados pela API (`TPVPCxxxx`) e os códigos de negação financeira (`xxx`) retornados pela rede bancária.

## 1. Erros do Sistema da API (TPVPC)

Estes códigos aparecem na **resposta síncrona** (`resultado.codigo`) quando a requisição é rejeitada pela lógica da API Cloud antes de chegar ao banco.

| Código | Mensagem / Causa | Ação Sugerida |
| :--- | :--- | :--- |
| **TPVPC0009** | *El importe de la devolución supera el importe de la operación original* | O valor do estorno é maior que o valor da venda original. |
| **TPVPC0014** | *Error en el sistema* | Erro no sistema. Tente novamente mais tarde ou entre em contato com o Administrador. |
| **TPVPC0015** | *Faltan datos para llevar a cabo la operación solicitada* | Faltam campos obrigatórios na requisição. |
| **TPVPC0016** | *El comercio no posee ningún terminal TPVPC válido* | O número do `terminal` enviado não está vinculado à conta do seu `comercio`. |
| **TPVPC0018** | *La tarjeta no se ha leído correctamente* | Erro de leitura do cartão. Verifique a associação leitor/terminal. |
| **TPVPC0019** | *La tarjeta no se ha leído correctamente* | Erro de leitura do cartão. Verifique a associação leitor/terminal. |
| **TPVPC0020** | *Se ha producido un error al realizar la operación* | Erro genérico na operação. Tente novamente. |
| **TPVPC0021** | *No se han recibido todos los datos necesarios para modificar su contraseña* | Faltam dados para a modificação da senha. |
| **TPVPC0024** | *La contraseña especificada no puede ser utilizada por motivos de seguridad* | A política de segurança impede esta senha. Escolha outra. |
| **TPVPC0025** | *El formato del número de tarjeta introducido no es válido* | Formato do número do cartão inválido. |
| **TPVPC0026** | *La tarjeta no se ha leído correctamente* | Erro de leitura do cartão. Verifique a condição do cartão. |
| **TPVPC0027** | *El formato de la fecha de caducidad introducida no es válido* | Formato de data de validade inválido. |
| **TPVPC0030** | *El sistema está ocupado* | O terminal está ocupado processando outra requisição. Tente novamente mais tarde. |
| **TPVPC0031** | *Se ha producido un error al realizar la operación* | Erro genérico na operação. Tente novamente. |
| **TPVPC0032** | *El sistema no puede acceder a las operaciones requeridas* | O sistema não pode acessar as operações solicitadas momentaneamente. |
| **TPVPC0033** | *Faltan datos para realizar la autenticación* | Faltam dados de autenticação. |
| **TPVPC0034** | *El usuario con el que intenta acceder ha sido bloqueado* | Usuário bloqueado. Contate o Administrador. |
| **TPVPC0035** | *El usuario con el que intenta acceder está dado de baja* | Usuário cancelado/inativo. Contate o Administrador. |
| **TPVPC0036** | *Faltan datos para llevar a cabo la operación solicitada* | Faltam dados para a operação. |
| **TPVPC0037** | *El sistema no puede acceder al usuario especificado* | Problema de acesso temporário para o usuário. |
| **TPVPC0039** | *El perfil del usuario especificado sólo tiene acceso al Módulo de Administración* | Este usuário não pode realizar operações, apenas administração. |
| **TPVPC0040** | *El sistema no ha podido completar la operación especificada* | Erro genérico de conclusão. Tente novamente. |
| **TPVPC0042** | *El sistema no soporta actualmente el método de autenticación especificado* | Método de autenticação não suportado. |
| **TPVPC0043** | *Está intentando realizar una operación de alta sobre un usuario ya existente* | O usuário já existe. |
| **TPVPC0044** | *El formato del número de teléfono introducido no es válido* | Formato de número de telefone inválido. |
| **TPVPC0048** | *El medio de pago especificado no es válido* | Meio de pagamento não suportado pelo estabelecimento. |
| **TPVPC0051** | *No se han definido criterios suficientes* | Critérios insuficientes para a operação. |
| **TPVPC0052** | *La contraseña no es correcta* | Senha incorreta. Tente novamente. |
| **TPVPC0053** | *El usuario especificado no existe* | Usuário não encontrado. |
| **TPVPC0055** | *El comercio no tiene habilitada la operativa de Entrada Manual de datos* | A Entrada Manual (digitação do PAN) está desabilitada para este estabelecimento. |
| **TPVPC0056** | *Usuario creado satisfactoriamente, pero error al término* | Usuário criado, mas a operação terminou com erro. |
| **TPVPC0057** | *El código de entidad especificado no existe* | O código da entidade não existe. |
| **TPVPC0058** | *La moneda especificada no coincide con la moneda del terminal* | Incompatibilidade de moeda. |
| **TPVPC0059** | *El sistema no puede acceder al terminal especificado* | Verifique se o terminal existe e tente novamente. |
| **TPVPC0060** | *No existe ningún terminal apropiado para tratar la marca de tarjeta introducida* | Bandeira do cartão não suportada pela configuração do terminal. |
| **TPVPC0061** | *El sistema no ha podido completar la operación especificada* | Erro genérico de conclusão. Tente novamente. |
| **TPVPC0062** | *Usuario modificado satisfactoriamente, pero error al término* | Usuário modificado, mas a operação terminou com erro. |
| **TPVPC0063** | *El sistema no ha podido completar la operación especificada* | Erro genérico de conclusão. Tente novamente. |
| **TPVPC0064** | *Usuario dado de baja satisfactoriamente, pero error al término* | Usuário desativado, mas a operação terminou com erro. |
| **TPVPC0065** | *El usuario especificado ya está dado de baja* | O usuário já está inativo. |
| **TPVPC0066** | *No se han encontrado usuarios* | Nenhum usuário encontrado correspondente aos critérios de pesquisa. |
| **TPVPC0071** | *El comercio no tiene habilitada la operativa de Preautorizaciones* | Pré-autorizações desabilitadas para este estabelecimento. |
| **TPVPC0072** | *Operación incompleta, no se ha recibido CVC2* | Faltam dados de autenticação CVC2. |
| **TPVPC0074** | *El CVC2 introducido no coincide* | CVC2 inserido está incorreto. |
| **TPVPC0075** | *El perfil del usuario especificado no tiene acceso al TPVPC* | O perfil do usuário não tem acesso ao TPVPC. |
| **TPVPC0077** | *Acceso denegado al sistema* | Mensagem de acesso inválida. Verifique o formato, a assinatura e a data. |
| **TPVPC0078** | *Operación sobre la que no tiene permisos asignados* | Permissões insuficientes. |
| **TPVPC0079** | *El comercio / terminal que ha especificado no existe* | Estabelecimento/Terminal não encontrado. |
| **TPVPC0081** | *Contraseña incorrecta* | Senha incorreta para a operação solicitada. |
| **TPVPC0083** | *La configuración de su lector no es la correcta* | Erro de configuração do leitor. Verifique com o Administrador. |
| **TPVPC0084** | *La tarjeta no se ha leído correctamente* | Erro de leitura do cartão. Verifique o cartão/leitor. |
| **TPVPC0085** | *La tarjeta no se ha leído correctamente* | Erro de leitura do cartão. Verifique o cartão/leitor. |
| **TPVPC0087** | *El sistema está ocupado* | Sistema ocupado. Tente novamente mais tarde. |
| **TPVPC0089** | *Se ha producido un error al realizar la operación* | Erro genérico na operação. Tente novamente. |
| **TPVPC0090** | *El terminal no tiene asociado ningún lector válido* | Nenhum leitor válido associado ao terminal. |
| **TPVPC0091** | *Se ha producido un error. La operación especificada no existe* | Operação não encontrada. |
| **TPVPC0092** | *Se ha producido un error al realizar la operación* | Erro genérico na operação. Tente novamente. |
| **TPVPC0093** | *Se ha producido un error al realizar la operación* | Erro genérico na operação. Tente novamente. |
| **TPVPC0094** | *No es posible realizar más confirmaciones sobre la preautorización original* | Pré-autorização já confirmada ou cancelada. |
| **TPVPC0096** | *Se ha producido un error en el sistema* | Formato de dados inválido. |
| **TPVPC0097** | *Su contraseña no puede modificarse* | Limite de modificações atingido para hoje. |
| **TPVPC0099** | *El comercio no está habilitado para operar con tarjeta fidelización* | Cartões de fidelidade desabilitados para este estabelecimento. |
| **TPVPC0100** | *No puede realizar una DEVOLUCION/CONFIRMACION sobre la operación especificada* | Operação não permitida na transação especificada. |
| **TPVPC0101** | *La firma no es correcta* | Incompatibilidade do hash calculado. Verifique o JSON/Chave. |
| **TPVPC0102** | *El certificado no es válido* | Certificado inválido ou CA não confiável. |
| **TPVPC0103** | *El certificado ya está asociado a otro usuario* | Certificado já em uso. |
| **TPVPC0104** | *La tarjeta no está asociada a ningún usuario válido en TPV PC* | Cartão não vinculado a um usuário válido. |
| **TPVPC0107** | *El comercio no tiene configurada la moneda especificada* | Moeda não configurada para o estabelecimento. |
| **TPVPC0108** | *Se ha producido un error al realizar la conversión de divisas* | Erro de conversão de moeda. |
| **TPVPC0109** | *La tarjeta no admite el pago en la divisa especificada* | O cartão não suporta esta moeda. |
| **TPVPC0110** | *El número de plazos indicado no es válido* | Número de parcelas inválido. |
| **TPVPC0112** | *El importe de una recarga debe ser múltiplo de 5.00 Euros* | Valor de recarga inválido (deve ser múltiplo de 5). |
| **TPVPC0113** | *El importe de una recarga debe ser múltiplo de 10.00 Euros* | Valor de recarga inválido (deve ser múltiplo de 10). |
| **TPVPC0114** | *El comercio no tiene habilitada la operativa de Entrada Manual de datos* | Entrada Manual desabilitada. |
| **TPVPC0115** | *La tarjeta utilizada no admite aplazamiento de pagos* | O cartão não suporta parcelamento. |
| **TPVPC0117** | *El sistema ya está procesando una operación con los mismos datos* | Requisição duplicada em andamento. Tente novamente mais tarde. |
| **TPVPC0118** | *Operación anterior con resultado AUTORIZADA* | Duplicada: A operação idêntica anterior foi Autorizada. |
| **TPVPC0119** | *Operación anterior con resultado de ERROR* | Duplicada: A operação idêntica anterior teve um Erro. |
| **TPVPC0120** | *Operación anterior con resultado RECHAZADA* | Duplicada: A operação idêntica anterior foi Rejeitada. |
| **TPVPC0121** | *No se puede realizar la acción requerida sobre la operación* | Ação não permitida na operação. |
| **TPVPC0122** | *No se ha podido llevar a cabo la operación debido a un error en el importe* | Erro de valor. |
| **TPVPC0123** | *No se puede realizar acción sobre operación errónea o denegada* | Não é possível atuar em uma operação que falhou/foi negada anteriormente. |
| **TPVPC0124** | *No se puede realizar la acción requerida debido a un error* | Erro genérico impedindo a ação. |
| **TPVPC0126** | *La tarjeta utilizada no es válida* | Cartão inválido. |
| **TPVPC0127** | *No existe ninguna lista negra para el comercio especificado* | Lista negra não encontrada para o estabelecimento. |
| **TPVPC0128** | *No se puede actualizar la información de la descarga para el comercio* | Não é possível atualizar as informações de download. |
| **TPVPC0129** | *No se puede asignar la operativa de Lista Negra al comercio* | Falha na atribuição da operação de Lista Negra. |
| **TPVPC0131** | *El comercio no tiene activada esta operativa* | Operação desabilitada para o estabelecimento. |
| **TPVPC0135** | *Error al tratar mensaje PUP* | Erro na mensagem PUP. |
| **TPVPC0148** | *No es posible realizar el aplazamiento del pago* | Pagamento parcelado não é possível. |
| **TPVPC_EMV0000**| *Error interno en el protocolo TPVPC EMV* | Erro Interno do Protocolo EMV. |
| **TPVPC_EMV0001**| *Error interno en el protocolo TPVPC EMV* | Erro Interno do Protocolo EMV. |
| **TPVPC_EMV0002**| *Error interno en el protocolo TPVPC EMV* | Erro Interno do Protocolo EMV. |
| **TPVPC_EMV0003**| *Error interno en el protocolo TPVPC EMV* | Erro Interno do Protocolo EMV. |
| **TPVPC_EMV0004**| *Error en el proceso TLS* | Erro no Processo TLS. |
| **TPVPC_EMV0005**| *Pin OnLine Solicitado no Introducido* | PIN Online solicitado, mas não inserido. |
| **TPVPC_EMV0006**| *Terminal no Operativo. Sin Claves Simétricas* | Terminal inoperante (Sem Chaves Simétricas). |
| **TPVC0001** | *Error al conectar con el pinpad* | Erro de conexão com o PIN pad. |
| **TPVC0002** | *Error en el tratamiento de la petición* | Erro no tratamento da requisição. |
| **TPVC9999** | *Se ha producido un error en la ejecución* | Erro de execução. |

## 2. Códigos de Negação Financeira

Esses códigos aparecem na **notificação assíncrona** (`codigoRespuesta`) quando o banco processa e rejeita a transação. Eles indicam o motivo pelo qual o emissor recusou o cartão.

### Lista de Códigos de Negação

| Código | Descrição | Ação / Significado |
| :--- | :--- | :--- |
| **101** | Cartão Expirado | O cartão está expirado. Solicite ao cliente um novo cartão. |
| **102** | Cartão Bloqueado | Cartão bloqueado temporariamente pelo emissor. |
| **104** | Operação não permitida | Não permitida para este cartão ou terminal. |
| **106** | Tentativas de PIN Excedidas | O cartão está bloqueado devido a muitas tentativas de PIN incorretas. |
| **107** | Contate o Emissor | Por favor, entre em contato com o emissor do cartão. |
| **109** | Identificação Inválida | Identificação inválida do terminal ou estabelecimento. |
| **110** | Valor Inválido | O valor é inválido. |
| **112** | PIN Obrigatório | Entrada de PIN obrigatória exigida. |
| **114** | Operação não suportada | O cartão não suporta o tipo de operação solicitada. |
| **116** | Fundos Insuficientes | Transação recusada devido a saldo ou limite de crédito. |
| **117** | PIN Incorreto | PIN incorreto. Nova tentativa permitida. |
| **118** | Cartão não registrado | Cartão não registrado. |
| **119** | Desconhecido | Erro desconhecido. |
| **120** | Negação SIS | Operação negada pelo SIS. |
| **121** | Valor Excedido | Excede o limite de adiantamento de dinheiro (saque). |
| **122** | Controle VCA | Negação devido a controles do VCA. |
| **123** | Erro CAUV | CAUV incorreto. |
| **124** | Mudança de PIN Exigida | O portador do cartão deve mudar o PIN antes de operar. |
| **125** | Cartão Não Efetivo | Cartão não efetivo. |
| **126** | Bloco de PIN Inválido | Formato de Bloco de PIN inválido. |
| **129** | Cartão inoperante (CVC2) | Erro no CVC2/CVV. |
| **130** | Moeda Não Suportada | Moeda não suportada pelo emissor. |
| **160** | Erro CEPS | O terminal indica que a operação de consumo CEPS falhou. |
| **161** | Bandeira Não Admitida | Bandeira do cartão não admitida pelo emissor. |
| **167** | Contate o Emissor | Por favor, entre em contato com o emissor do cartão. |
| **180** | Cartão não suportado | Cartão não suportado pelo sistema. |
| **181** | Restrições de Débito | Cartão com restrições de débito. |
| **182** | Restrições de Crédito | Cartão com restrições de crédito. |
| **183** | Restrições de Débito (Conta de Crédito) | Cartão com restrições de débito (conta de crédito). |
| **184** | Erro de Autenticação | Falha genérica de autenticação. |
| **185** | Controle de Dispositivo | Dispositivos não adaptados ao EMV. |
| **187** | Erro Criptográfico EMV | Erro na criptografia EMV. |
| **190** | Negação Genérica | Recusado pelo emissor por vários motivos. |
| **191** | Erro de Data de Validade | Data de validade inválida. |
| **192** | Dados de Case Não Encontrados | Dados de case não encontrados. |
| **193** | Valor Excedido | Valor excedido. |
| **194** | Rejeição da Operadora | Rejeição pela operadora de telefonia. |
| **195** | Inserção de Chip Obrigatória | É obrigatório inserir o Chip. |
| **196** | Inserção de Chip Obrigatória | É obrigatório inserir o Chip. |
| **198** | Negação DCC | Negação DCC para envio de contravalores. |
| **201** | Cartão Expirado (Captura) | Ordem para retirar/reter o cartão. |
| **202** | Cartão Bloqueado (Captura) | Ordem para retirar/reter o cartão (Bloqueado pelo emissor). |
| **204** | Operação Não Permitida | Não permitida para este cartão/terminal. |
| **206** | Tentativas de PIN Excedidas | Reter o cartão. |
| **207** | Condições Especiais | Reter o cartão. |
| **208** | Cartão Bloqueado (Captura) | Ordem para retirar/reter o cartão (Bloqueado pelo emissor). |
| **209** | Cartão Bloqueado (Captura) | Ordem para retirar/reter o cartão (Bloqueado pelo emissor). |
| **210** | Retenção VCA | Retenção devido a controles do VCA. |
| **280** | Erro de CVV (Captura) | Erro de CVV1/CVC1 ou CVV2/CVC2. Reter o cartão. |
| **290** | Negação Genérica (Captura) | Negado por vários motivos. Ordem para retirar o cartão. |
| **912** | Cartão não encontrado | Número de cartão inexistente (*Número de tarjeta inexistente*). |