Catálogo de códigos de error y denegación

Esta referencia enumera los códigos de error del sistema devueltos por la API (TPVPCxxxx) y los códigos de denegación financiera (xxx) devueltos por la red bancaria.

1. Errores del sistema de la API (TPVPC)

Estos códigos aparecen en la respuesta síncrona (resultado.codigo) cuando la lógica de API Cloud rechaza la petición antes de llegar al banco.

Código	Mensaje / Causa	Acción sugerida
TPVPC0009	El importe de la devolución supera el importe de la operación original	El importe de la devolución es mayor que el importe de la venta original.
TPVPC0014	Fallo en el sistema	Error del sistema. Reinténtalo más tarde o contacta al Administrador.
TPVPC0015	Faltan datos para ejecutar la operación solicitada	Faltan campos obligatorios en la petición.
TPVPC0016	El comercio no dispone de un terminal TPVPC válido	El número de `terminal` enviado no está vinculado a tu cuenta de `comercio`.
TPVPC0018	La tarjeta no ha sido leída de forma correcta	Error de lectura de la tarjeta. Verifica la asociación lector/terminal.
TPVPC0019	La tarjeta no ha sido leída de forma correcta	Error de lectura de la tarjeta. Verifica la asociación lector/terminal.
TPVPC0020	Ha ocurrido un error al realizar la operación	Error de operación genérico. Vuelve a intentarlo.
TPVPC0021	No se recibieron todos los datos necesarios para modificar su contraseña	Faltan datos para modificar la contraseña.
TPVPC0024	La contraseña indicada no se puede utilizar por motivos de seguridad	La política de seguridad impide el uso de esta contraseña. Elige una distinta.
TPVPC0025	El formato del número de tarjeta ingresado es inválido	Formato del número de tarjeta no válido.
TPVPC0026	La tarjeta no ha sido leída de forma correcta	Error de lectura de la tarjeta. Comprueba el estado físico de la tarjeta.
TPVPC0027	El formato de la fecha de caducidad indicada es inválido	Formato de la fecha de expiración no válido.
TPVPC0030	El sistema se encuentra ocupado	El terminal está ocupado procesando otra petición. Reinténtalo más tarde.
TPVPC0031	Ha ocurrido un error al realizar la operación	Error de operación genérico. Reinténtalo.
TPVPC0032	El sistema no logra acceder a las operaciones requeridas	El sistema no puede acceder momentáneamente a las operaciones solicitadas.
TPVPC0033	Faltan datos para ejecutar la autenticación	Faltan datos de autenticación.
TPVPC0034	El usuario con el cual intenta acceder ha sido bloqueado	Usuario bloqueado. Contacta al Administrador.
TPVPC0035	El usuario con el cual intenta acceder está dado de baja	Usuario cancelado/inactivo. Contacta al Administrador.
TPVPC0036	Faltan datos para ejecutar la operación solicitada	Faltan datos para la operación.
TPVPC0037	El sistema no logra acceder al usuario especificado	Problema de acceso temporal para el usuario.
TPVPC0039	El perfil del usuario indicado solo tiene acceso al Módulo de Administración	Este usuario no puede realizar operaciones, solo labores de administración.
TPVPC0040	El sistema no logró completar la operación especificada	Error de finalización genérico. Reinténtalo.
TPVPC0042	El sistema no soporta en este momento el método de autenticación especificado	Método de autenticación no soportado.
TPVPC0043	Está intentando ejecutar una operación de alta sobre un usuario que ya existe	El usuario ya existe.
TPVPC0044	El formato del número de teléfono ingresado es inválido	Formato del número de teléfono no válido.
TPVPC0048	El medio de pago indicado no es válido	El comercio no admite el método de pago especificado.
TPVPC0051	No se definieron criterios suficientes	Criterios insuficientes para realizar la operación.
TPVPC0052	La contraseña es incorrecta	Contraseña incorrecta. Reinténtalo.
TPVPC0053	El usuario indicado no existe	No se encuentra el usuario.
TPVPC0055	El comercio no tiene activa la operativa de Entrada Manual de datos	La entrada manual (digitación del PAN) está deshabilitada.
TPVPC0056	Usuario creado con éxito, pero con error al término	Usuario creado, pero la operación finalizó con un error.
TPVPC0057	El código de entidad indicado no existe	El código de la entidad no existe.
TPVPC0058	La moneda indicada no coincide con la moneda del terminal	La moneda no coincide.
TPVPC0059	El sistema no logra acceder al terminal especificado	Asegúrate de que el terminal existe y reinténtalo.
TPVPC0060	No existe terminal adecuado para procesar la marca de tarjeta ingresada	Marca de tarjeta no soportada por el terminal.
TPVPC0061	El sistema no logró completar la operación especificada	Error genérico de finalización. Reinténtalo.
TPVPC0062	Usuario modificado con éxito, pero con error al término	Usuario modificado, pero la operación finalizó con error.
TPVPC0063	El sistema no logró completar la operación especificada	Error genérico de finalización. Reinténtalo.
TPVPC0064	Usuario dado de baja con éxito, pero con error al término	Usuario desactivado, pero la operación finalizó con error.
TPVPC0065	El usuario indicado ya está dado de baja	El usuario ya se encuentra inactivo.
TPVPC0066	No se encontraron usuarios	No se encontraron usuarios que coincidan con la búsqueda.
TPVPC0071	El comercio no tiene activa la operativa de Preautorizaciones	Preautorizaciones deshabilitadas para este comercio.
TPVPC0072	Operación incompleta, no se recibió el CVC2	Faltan datos de autenticación CVC2.
TPVPC0074	El CVC2 ingresado no coincide	CVC2 introducido es incorrecto.
TPVPC0075	El perfil del usuario indicado no tiene acceso al TPVPC	El perfil del usuario carece de acceso a TPVPC.
TPVPC0077	Acceso denegado hacia el sistema	Mensaje de acceso inválido. Revisa formato, firma y fecha.
TPVPC0078	Operación sobre la cual no tiene permisos asignados	Permisos insuficientes.
TPVPC0079	El comercio o terminal que indicó no existe	No se encuentra el comercio o terminal.
TPVPC0081	Contraseña errónea	Contraseña incorrecta para la operación.
TPVPC0083	La configuración de su lector es incorrecta	Error de configuración del lector. Consulta al Administrador.
TPVPC0084	La tarjeta no ha sido leída de forma correcta	Error de lectura de tarjeta. Revisa tarjeta/lector.
TPVPC0085	La tarjeta no ha sido leída de forma correcta	Error de lectura de tarjeta. Revisa tarjeta/lector.
TPVPC0087	El sistema se encuentra ocupado	El sistema está ocupado. Reinténtalo luego.
TPVPC0089	Ha ocurrido un error al realizar la operación	Error genérico de operación. Reinténtalo.
TPVPC0090	El terminal no posee ningún lector válido asociado	No hay lector válido asociado al terminal.
TPVPC0091	Ha ocurrido un error. La operación especificada no existe	La operación no existe.
TPVPC0092	Ha ocurrido un error al realizar la operación	Error genérico de operación. Reinténtalo.
TPVPC0093	Ha ocurrido un error al realizar la operación	Error genérico de operación. Reinténtalo.
TPVPC0094	No es posible realizar más confirmaciones sobre la preautorización original	La preautorización ya fue confirmada o cancelada.
TPVPC0096	Ha ocurrido un error en el sistema	Formato de datos inválido.
TPVPC0097	Su contraseña no se puede modificar	Límite diario de modificaciones alcanzado.
TPVPC0099	El comercio no está habilitado para operar con tarjeta de fidelización	Tarjetas de fidelización deshabilitadas para este comercio.
TPVPC0100	No puede efectuar una DEVOLUCION o CONFIRMACION sobre la operación indicada	Operación no permitida en esta transacción.
TPVPC0101	La firma no es correcta	El hash calculado no coincide. Revisa el JSON/Clave.
TPVPC0102	El certificado es inválido	Certificado no válido o CA no confiable.
TPVPC0103	El certificado ya se encuentra asociado a otro usuario	El certificado ya está en uso.
TPVPC0104	La tarjeta no está asociada a ningún usuario válido del TPV PC	La tarjeta no está vinculada a un usuario válido.
TPVPC0107	El comercio no posee configurada la moneda especificada	La moneda no está configurada en el comercio.
TPVPC0108	Ha ocurrido un error al efectuar la conversión de divisas	Error al convertir divisas.
TPVPC0109	La tarjeta no acepta el pago en la divisa especificada	La tarjeta no admite esta divisa.
TPVPC0110	El número de plazos indicado es inválido	Número de plazos no válido.
TPVPC0112	El importe de recarga debe ser múltiplo de 5.00 Euros	Importe de recarga inválido (debe ser múltiplo de 5).
TPVPC0113	El importe de recarga debe ser múltiplo de 10.00 Euros	Importe de recarga inválido (debe ser múltiplo de 10).
TPVPC0114	El comercio no tiene activa la operativa de Entrada Manual de datos	Entrada manual deshabilitada.
TPVPC0115	La tarjeta empleada no acepta aplazamiento de pagos	La tarjeta no admite pago en cuotas.
TPVPC0117	El sistema ya se encuentra procesando una operación con idénticos datos	Petición duplicada en proceso. Reinténtalo luego.
TPVPC0118	Operación previa con resultado AUTORIZADA	Duplicado: La operación idéntica anterior fue Autorizada.
TPVPC0119	Operación previa con resultado de ERROR	Duplicado: La operación idéntica anterior tuvo un Error.
TPVPC0120	Operación previa con resultado RECHAZADA	Duplicado: La operación idéntica anterior fue Rechazada.
TPVPC0121	No se puede efectuar la acción requerida sobre esta operación	Acción no permitida en esta operación.
TPVPC0122	No se pudo llevar a cabo la operación a causa de un error en el importe	Error en el importe.
TPVPC0123	No se puede efectuar acción sobre una operación errónea o denegada	No se puede actuar sobre una operación fallida/denegada previamente.
TPVPC0124	No se puede efectuar la acción requerida a causa de un error	Error genérico que impide la acción.
TPVPC0126	La tarjeta empleada no es válida	Tarjeta inválida.
TPVPC0127	No existe lista negra para el comercio indicado	No se halló lista negra para el comercio.
TPVPC0128	No se puede actualizar la información de descarga para el comercio	No se pudo actualizar la información de descarga.
TPVPC0129	No se puede asignar la función de Lista Negra al comercio	Fallo al asignar la Lista negra.
TPVPC0131	El comercio no tiene activa esta operativa	Operación desactivada en el comercio.
TPVPC0135	Fallo al procesar mensaje PUP	Error en el mensaje PUP.
TPVPC0148	Es imposible efectuar el aplazamiento del pago	No es posible procesar el pago a plazos.
TPVPC_EMV0000	Fallo interno en el protocolo TPVPC EMV	Error interno del protocolo EMV.
TPVPC_EMV0001	Fallo interno en el protocolo TPVPC EMV	Error interno del protocolo EMV.
TPVPC_EMV0002	Fallo interno en el protocolo TPVPC EMV	Error interno del protocolo EMV.
TPVPC_EMV0003	Fallo interno en el protocolo TPVPC EMV	Error interno del protocolo EMV.
TPVPC_EMV0004	Fallo en el proceso TLS	Error en el proceso TLS.
TPVPC_EMV0005	Pin OnLine Requerido no Ingresado	Se solicitó PIN Online pero no se ingresó.
TPVPC_EMV0006	Terminal Inoperativo. Carece de Claves Simétricas	Terminal inoperativo (sin claves simétricas).
TPVC0001	Fallo de conexión con el pinpad	Error de conexión con el PIN pad.
TPVC0002	Fallo en el manejo de la petición	Error en el manejo de la petición.
TPVC9999	Ha ocurrido un fallo durante la ejecución	Error de ejecución.

2. Códigos de denegación financiera

Estos códigos aparecen en la notificación asíncrona (codigoRespuesta) cuando el banco procesa y rechaza la transacción. Indican el motivo por el cual el emisor denegó la tarjeta.

Lista de códigos de denegación

Código	Descripción	Acción / Significado
101	Tarjeta expirada	La tarjeta ha caducado. Solicita otra tarjeta al cliente.
102	Tarjeta bloqueada	Tarjeta bloqueada de forma temporal por el emisor.
104	Operación no autorizada	No permitida para esta tarjeta o terminal.
106	Límite de PIN excedido	La tarjeta se bloqueó por demasiados intentos fallidos de PIN.
107	Contactar al emisor	Ponte en contacto con el emisor de la tarjeta.
109	Identificación inválida	Identificación inválida del terminal o comercio.
110	Importe inválido	El importe no es válido.
112	PIN obligatorio	Se exige la introducción obligatoria del PIN.
114	Operación no soportada	La tarjeta no admite el tipo de operación solicitada.
116	Fondos insuficientes	Transacción denegada debido al saldo o límite de crédito.
117	PIN incorrecto	PIN erróneo. Se permite reintentar.
118	Tarjeta no registrada	La tarjeta no está registrada.
119	Desconocido	Error desconocido.
120	Denegación SIS	Operaciones denegadas por el SIS.
121	Importe excedido	Sobrepasa el límite de adelanto de efectivo.
122	Control VCA	Denegación por controles VCA.
123	Error CAUV	CAUV erróneo.
124	Cambio de PIN requerido	El titular debe cambiar su PIN antes de operar.
125	Tarjeta no efectiva	La tarjeta no está operativa.
126	Bloque de PIN inválido	Formato de bloque de PIN incorrecto.
129	Tarjeta inoperante (CVC2)	Fallo en el CVC2/CVV.
130	Moneda no soportada	Moneda no admitida por el banco emisor.
160	Error CEPS	El terminal reporta que la operación CEPS ha fallado.
161	Marca no admitida	Marca de tarjeta rechazada por el emisor.
167	Contactar al emisor	Ponte en contacto con el emisor de la tarjeta.
180	Tarjeta no soportada	Tarjeta rechazada por el sistema.
181	Restricciones de débito	Tarjeta con limitación de débito.
182	Restricciones de crédito	Tarjeta con limitación de crédito.
183	Restricciones de débito (Cuenta de crédito)	Tarjeta con limitación de débito (cuenta de crédito).
184	Error de autenticación	Fallo genérico de autenticación.
185	Control de dispositivo	Dispositivos sin adaptación a EMV.
187	Error en criptografía EMV	Fallo en la criptografía EMV.
190	Denegación genérica	Rechazada por el banco emisor por varios motivos.
191	Error en fecha de caducidad	Fecha de expiración errónea.
192	Datos de case no encontrados	No se hallaron datos de case.
193	Importe excedido	Se superó el importe permitido.
194	Rechazo del operador	Rechazo por parte de la operadora telefónica.
195	Inserción de Chip requerida	Es obligatorio introducir el Chip.
196	Inserción de Chip requerida	Es obligatorio introducir el Chip.
198	Denegación DCC	Denegación DCC en envío de contravalores.
201	Tarjeta expirada (Captura)	Orden de retirar y retener la tarjeta.
202	Tarjeta bloqueada (Captura)	Orden de retirar y retener la tarjeta (Bloqueada por emisor).
204	Operación no autorizada	No permitida para esta tarjeta/terminal.
206	Límite de PIN excedido	Retener la tarjeta.
207	Condiciones especiales	Retener la tarjeta.
208	Tarjeta bloqueada (Captura)	Orden de retirar y retener la tarjeta (Bloqueada por emisor).
209	Tarjeta bloqueada (Captura)	Orden de retirar y retener la tarjeta (Bloqueada por emisor).
210	Retención VCA	Retención a causa de controles VCA.
280	Error de CVV (Captura)	Error en CVV1/CVC1 o CVV2/CVC2. Retén la tarjeta.
290	Denegación genérica (Captura)	Denegada por diversos motivos. Orden de retirar la tarjeta.
912	Tarjeta no encontrada	Número de tarjeta inexistente (Número de tarjeta inexistente).