0% encontró este documento útil (0 votos)
377 vistas105 páginas

5 - TPV VIRTUAL Manual

El Manual TPV Virtual por Redirección de BBVA proporciona directrices para la integración de su sistema de pagos en línea, incluyendo aspectos técnicos, de seguridad y operativos. Se detalla la obligatoriedad de la Autenticación Reforzada (SCA) bajo la regulación PSD2 y se ofrecen opciones de personalización y herramientas de gestión para los comercios. Además, se explican las medidas de seguridad implementadas y las características de los pagos, incluyendo soporte para múltiples monedas y tarjetas.
Derechos de autor
© © All Rights Reserved
Nos tomamos en serio los derechos de los contenidos. Si sospechas que se trata de tu contenido, reclámalo aquí.
Formatos disponibles
Descarga como PDF, TXT o lee en línea desde Scribd
0% encontró este documento útil (0 votos)
377 vistas105 páginas

5 - TPV VIRTUAL Manual

El Manual TPV Virtual por Redirección de BBVA proporciona directrices para la integración de su sistema de pagos en línea, incluyendo aspectos técnicos, de seguridad y operativos. Se detalla la obligatoriedad de la Autenticación Reforzada (SCA) bajo la regulación PSD2 y se ofrecen opciones de personalización y herramientas de gestión para los comercios. Además, se explican las medidas de seguridad implementadas y las características de los pagos, incluyendo soporte para múltiples monedas y tarjetas.
Derechos de autor
© © All Rights Reserved
Nos tomamos en serio los derechos de los contenidos. Si sospechas que se trata de tu contenido, reclámalo aquí.
Formatos disponibles
Descarga como PDF, TXT o lee en línea desde Scribd

Manual TPV

VIRTUAL

Redirección
Versión adaptada a EMV 3DS 2.2

Versión 1.3
CONTROL DE VERSIÓN

VERSIÓN FECHA AFECTA BREVE DESCRIPCIÓN DEL CAMBIO

1.0 09/01/2020 TODO Documento inicial

1.1 03/06/2020 TODO Optimización de estructura

1.2 20/07/2020 Aspectos básicos - Fecha aplicación SCA para entidades españolas
Introducción

1.3 11/03/2021 Tarjetas de prueba Actualización de información

Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier medio
y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

2
ÍNDICE DE CONTENIDO

1. ASPECTOS BASICOS - INTRODUCCIÓN .............................................................3

1.1. Descripción del flujo de una operación.....................................................4

1.2. Tarjetas aceptadas ...................................................................................5

1.3. Idiomas TPV ............................................................................................5

1.4. Monedas / Divisas ...................................................................................5

1.5. Elementos de seguridad ...........................................................................6

CES (Comercio Electrónico Seguro) ...................................................................6

CVV .................................................................................................................7

VELOCITY CHECKS ............................................................................................7

1.6. Herramientas Back Office ...........................................................................7

1.7. Pago en 1 Clic +Tokenización .....................................................................7

1.8. Reglamentación .........................................................................................8

2. ASPECTOS OPERATIVOS ................................................................................10

2.1. Tipos de petición de autorización .............................................................10

2.2. Envío de petición al TPV Virtual ................................................................14

2.3. Notificación On-Line (Recepción del resultado).........................................15

2.4. Retorno del control de la navegación del comprador .................................15

2.5. Personalización ........................................................................................16

2.6. Reintentos de Pago ..................................................................................17

3. MEDIDAS DE SEGURIDAD ..............................................................................18

Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier
medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

1
3.1. Medidas de seguridad adicionales ...........................................................18

3.2. Señales para detectar fraude en internet ..................................................18

3.3. Control de operaciones ...........................................................................19

4. VENDER EN EL EXTRANJERO ..........................................................................22

4.1. Operativa DCC (Dinamic Currency Conversion) .........................................22

4.2. Liquidación Multidivisa .............................................................................22

5. INTEGRACIÓN - FORMULARIO DATOS PETICIÓN OPERACIÓN ..........................24

5.1. Excepciones a SCA ...................................................................................24

5.2. Transacciones iniciadas por el comercio (COF - MIT) .................................26

Transacciones MIT y uso de tokenización (pago por referencia) .......................26

5.3. Ejemplo EMV 3DS .....................................................................................27

6. BIZUM ..........................................................................................................28

7. ACCESO AL ENTORNO DE PRUEBAS ...............................................................31

8. MÓDULO DE ADMINISTRACIÓN .....................................................................35

8.1. Consulta y administración de operaciones ................................................36

8.2. Confirmación de una operación ................................................................37

8.3. Realizar una devolución ...........................................................................37

8.4. Informe....................................................................................................38

8.5. Consulta de totales ..................................................................................38

8.6. Consulta notificación ...............................................................................39

8.7. Cambio de contraseña..............................................................................39

ANEXO – Parámetros de Entrada – Salida..........................................................41

Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier
medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

2
1. ASPECTOS BASICOS - INTRODUCCIÓN
BBVA dispone de una unidad específica para eCommerce en la que trabajan gestores
especializados en plataformas de pagos virtuales y un equipo de back-office para facilitar
a nuestros clientes soluciones diferenciadas y seguras, así como un amplio conjunto de
servicios en el ámbito de las ventas por Internet.

La guía de comercios BBVA recoge aspectos a tener en cuenta por los comercios que
deseen utilizar el TPV Virtual BBVA en la instrumentación de sus compras por Internet,
así como el conjunto de funcionalidades (perfiles de funcionamiento, tipos de peticiones
de autorización, nivel de seguridad de los pagos...) y especificaciones técnicas
necesarias para realizar la conexión del comercio con el TPV Virtual.

Además, se detallan las opciones disponibles en la aplicación de administración del


BBVA, de gran utilidad cara a la gestión de los pedidos del comercio.

En este documento se muestran las especificaciones para aquellos comercios que


realicen la conexión técnica mediante la Redirección del Comprador (habitualmente el
Titular de la Tarjeta) a la página de Pago de BBVA, con algunas excepciones que se
mencionarás más adelante (Devoluciones, Confirmaciones, Tokenización, conexión
Insite, etc.).

Con la entrada en vigor de la nueva Regulación de Pagos PSD2 el 14 de Septiembre de


2019, se introduce la obligatoriedad de que las compras realizadas por TPV virtual sean
Autenticadas con doble factor si la tarjeta es emitida en un país del Espacio Económico
Europeo, salvo que se pueda y quiera aplicar alguna de las excepciones recogidas en
dicha regulación. Esto se conoce como Autenticación Reforzada o Strong Customer
Autenthication (SCA). Sin embargo la obligación de aplicar SCA se ha retrasado hasta el
próximo 14 de noviembre de 2020 para las entidades españolas.

Con esta guía se facilita la información técnica necesaria para que el comercio, o su
servicio de informática, realicen de forma satisfactoria la adaptación del TPV Virtual
BBVA a la nueva funcionalidad de EMV3DS (en su versión 3DS 2.2) lo que permitirá al
comercio beneficiarse de un sistema de Autenticación con menos fricción, y también le
ofrece la posibilidad de solicitar excepciones a la Autenticación de doble factor derivada
de la nueva regulación de PSD2 con autorización previa por parte de BBVA.

Para más información acerca de PSD2 y EMV3DS tienen a su disposición la presentación


que BBVA ha creado con el fin de aclarar las novedades que comporta.
Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier
medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

3
Para aquellos comercios que ya estén procesando pagos con esta integración
(Redirección) es importante notar que no es imprescindible realizar ningún cambio ni
adaptación para poder procesar transacciones en EMV3DS, aunque es recomendable
proporcionar el máximo de información complementaria (lo que requiere el envío de
nuevos parámetros por parte del comercio y por tanto un desarrollo informático) a fin de
que la pasarela y el Banco Emisor sean capaces de realizar una análisis de Riesgo de la
transacción más eficiente.

1.1. Descripción del flujo de una operación


En el siguiente esquema se presenta el flujo de una transacción por Redirección.

1. El titular selecciona los productos que desea comprar en el comercio, cesta de la


compra.

2. El comercio redirige la sesión del navegador del cliente a la URL del TPV virtual. En
esta URL el cliente introduce los datos de tarjeta.

3. El TPV virtual informa al comercio del resultado de la operación y devuelve la sesión


del navegador del cliente al comercio para que continúe navegando en su tienda web.

En este modelo los datos de la tarjeta se informan en el TPV Virtual de BBVA, con lo que
el comercio no tiene contacto con estos datos y de esta forma evita tener cumplir con los
requisitos del programa PCI-DSS de seguridad en el tratamiento de datos de tarjeta.

Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier
medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

4
1.2. Tarjetas aceptadas
Las tarjetas aceptadas son las mismas que se admiten en los comercios con TPV físico,
concretamente Visa, Visa Electron, MasterCard y Maestro. Se puede solicitar la
posibilidad de operar con tarjetas JCB, así como American Express, Union Pay, Diners
Club y Discovery.

Adicionalmente se puede incorporar el nuevo sistema de pago Bizum, para lo que el


comercio tan solo necesita incluir un nuevo parámetro en la llamada al TPV Virtual.

1.3. Idiomas TPV


El TPV virtual soporta 13 idiomas diferentes:
- Castellano
- Inglés
- Francés
- Alemán
- Holandés
- Italiano
- Sueco
- Portugués
- Valenciano
- Polaco
- Catalán
- Gallego
- Euskera.

1.4. Monedas / Divisas


Se pueden procesar las transacciones con la gran mayoría de monedas del mundo, como
por ejemplo:

- Euros
- Dólares
- Libras
- Yenes
- Dólar Canadiense
- Nuevo Peso Mexicano
- Franco Suizo
Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier
medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

5
- Real Brasileño
- …

A nivel de configuración de la pasarela, algunas monedas aceptan el uso de decimales


y otras no.

En BBVA te damos la opción de recibir el abono de las ventas realizadas en la misma


moneda de la operación original. De esta forma el comercio elimina los riesgos de tipo
de cambio. Para ampliar información ir al apartado [Link] EN EL EXTRANJERO.

1.5. Elementos de seguridad


El TPV Virtual de BBVA ofrece los máximos elementos de seguridad para proteger al
comercio ante posibles pagos fraudulentos:

CES (Comercio Electrónico Seguro)

El TPV virtual de BBVA integra CES (Compra Electrónica Segura) que, bajo los
protocolos internacionales Verified by Visa y MasterCard SecureCode (ambos basados
en la tecnología 3DSecure), aporta una alta seguridad y protección en los pagos. En
2019, con la implantación de 3DSecure 2.x han pasado a llamarse VISA SECURE y
MASTERCAD IDENTITY CHECK.

Mediante la aplicación de estos protocolos se consigue la autenticación del titular al


realizar la compra, es decir, que el cliente se identifique como legítimo titular de la tarjeta
que está utilizando.

Desde Septiembre de 2019 existe una nueva regulación llamada PSD2, que requiere que
las compras se procesen mediante sistemas de autenticación reforzada, salvo en
determinadas situaciones que pueden ser excepcionadas. Los sistemas de tarjetas se
han adaptado a los requerimientos de esta ley con la publicación del protocolo EMV3DS,
especialmente a partir de su versión 2.2 que es la que integrará el TPV virtual a partir de
Mayo de 2020 (aunque se podrán realizar pruebas en entorno de test desde Abril de
2020).

El comercio que procese por redirección con 3DSecure v1 no requiere de ninguna


adaptación ya que el propio TPV realizará los cambios necesarios. No obstante si se
desea enviar información enriquecida para permitir al Banco emisor a realizar una
autenticación Frictionless (y como consecuencia mejorar la experiencia de usuario y la
conversión) habrá que añadir esta información en los campos correspondientes.

Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier
medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

6
Asimismo si el comercio desea hacer uso de las excepciones contempladas en la
regulación y BBVA así lo autoriza, también se deberán realizar las modificaciones
necesarias para su implementación.

CVV

El TPV virtual de BBVA solicita de forma obligatoria la introducción del CVV2 de la tarjeta
(serie de tres números situados en la parte posterior de la tarjeta) cómo una medida
antifraude.

VELOCITY CHECKS

Los filtros de seguridad o Velocity Checks que se configuran en el TPV virtual permiten
prevenir los fraudes. Se validan diferentes parámetros de los datos de la compra como
la IP, número de tarjeta, número de intentos,… y si la operación no pasa favorablemente
estos filtros de seguridad se deniega la operación.

1.6. Herramientas Back Office


Las operaciones del TPV virtual se pueden consultar y gestionar desde una herramienta
que tienen a su disposición nuestros comercios: el MÓDULO DE ADMINISTRACIÓN
(Ver apartado 8). Desde esta herramienta se pueden realizar, entre otras, las consultas
de los movimientos del TPV virtual, consultas de totales, anulaciones de operaciones y
devoluciones parciales o totales.

Además, la solución eCommerce BBVA incluye un sistema de envío periódico de


información que complementa la información que recibe habitualmente el comercio. En
estos ficheros se envía información de las operaciones liquidadas, de las reclamaciones
(Charge-backs) recibidas, del fraude confirmado que ha sufrido el comercio y de las
peticiones de documentación (Retrieval requests) que han sido solicitadas.

1.7. Pago en 1 Clic +Tokenización


El Pago en 1 Clic o Tokenización consiste en que los datos de la tarjeta se almacenen
en la propia pasarela, proporcionando al comercio un Alias (Token) de la misma para que
éste pueda solicitar pagos a esa tarjeta sin la necesidad de que el comprador introduzca
cada vez esa información.
De esta forma se simplifica y agiliza el proceso de pago para compradores recurrentes,
lo que resulta de especial utilidad en entornos móviles.
Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier
medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

7
Dado que el comercio no procesa ni almacena los datos de tarjeta no ha de cumplir con
los requisitos de la Normativa PCI-DSS.

PCI-DSS (Payment Card Industry - Data Security Standard) son los estándares de
seguridad (requisitos técnicos y operativos) que tienen que cumplir todos los
participantes en el sector que procesan o almacenan datos de tarjeta (entidades
financieras, comercios, proveedores de servicios, empresas de software, etc.)

Para activar esta opción tendrá que solicitarlo en su oficina, en Línea Comercio o, en caso
de tener uno asignado, a su gestor en eCommerce.

En este caso hay que destacar la diferencia entre Pago en 1 click y transacciones
generadas por el comercio (MIT – Merchant Initiated Transactions). Los pagos en 1 click
son aquellos en que el comprador está presente en la compra online, aunque no se le
soliciten los datos de la tarjeta al estar estos previamente guardados (Tokenizados). Estas
operaciones han de ser Autenticadas de acuerdo a PSD2 (salvo que se aplique alguna
excepción) y por tanto es posible que se le solicite al comprador alguna información
adicional por parte del Banco emisor de la tarjeta.

Las operaciones iniciadas por el Comercio en cambio son aquellas en que el comprador no
está presente en la compra, como resultado de un acuerdo previo entre ambas partes en
que el comprador dio su autorización mediante un método validado. Un ejemplo de estas
transacciones son las suscripciones mensuales a servicios como gimnasios.

1.8. Reglamentación
El TPV Virtual, por su naturaleza, está sujeto a unas reglas que se derivan de su
participación en los sistemas de medios de pago internacionales así como de su
gestión por parte de BBVA.

Esta normativa está recogida en el contrato de Establecimientos firmado entre BBVA y


el comercio.

Algunas de las reglas más relevantes son enumeradas a continuación:

1. El comercio solo podrá procesar transacciones originadas desde la(s) página(s)


web registrada(s) en el contrato con BBVA.

2. El sitio web ha de cumplir, entre otros, los siguientes requisitos:

o El nombre del comercio y el de la persona propietaria, física o jurídica, de


dicha web han de aparecer en la página principal y en la página de pago
Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier
medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

8
del site, así como la residencia o domicilio del comercio (incluido el país).

o Política de anulación de compras y devolución de productos.

o Política de envío de mercancías y plazo de entrega, o de prestación de


servicio, según convenga.

o Datos del servicio de atención al cliente, dirección de correo electrónico y


número de teléfono.

o Política de privacidad y protección de datos personales.

3. El comercio procederá a la anulación inmediata de las operaciones de tarjeta


cuando se haya producido un cargo indebido, o no se haya materializado
completamente el proceso de venta y entrega de mercancía.

4. El comercio no almacenará de ninguna manera los datos de las tarjetas en


su instalación, excepto que fuese necesario para su funcionamiento, en cuyo
caso estará sujeto al programa de Seguridad PCI/DSS de VISA y
MASTERCARD. Aún en este caso está terminantemente prohibido guardar el
CVV2 bajo ninguna circunstancia.

5. El comercio solo podrá procesar bajo un mismo número de establecimiento


operaciones que se engloben bajo el código de actividad con el que se ha
registrado. Además, en los casos en que el comercio se dedique a actividades
especiales (tabaco, medicamentos, contenidos de adultos, líneas aéreas y juegos
de azar), tendrá que solicitarse expresamente autorización de forma previa a
BBVA para que ésta transmita la propuesta a las marcas de tarjetas.

6. El comercio estará sujeto a las leyes españolas de Defensa de los consumidores


y usuarios, y en especial a los artículos que regulan la Venta No Presencial. A tal
efecto se aplica Ley 3/2014, de 27 de marzo, por la que se modifica el texto
refundido de la Ley General para la Defensa de los Consumidores y Usuarios y
otras leyes complementarias, aprobado por el Real Decreto Legislativo 1/2007, de
16 de noviembre, y que aplica la Directiva 2011/83/UE del Parlamento Europeo.

Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier
medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

9
2. ASPECTOS OPERATIVOS
2.1. Tipos de petición de autorización
En función de las necesidades de cada comercio el TPV Virtual ofrece una elevada
variedad de peticiones de autorización, que el comercio puede combinar según sus
necesidades.

Pago estándar (Ds_Merchant_TransactionType = “0”)

Es el caso más general. En él la transacción es iniciada por el titular que está presente
durante el proceso de la misma. Una vez se ha recibido la petición de compra por parte
del comercio, el TPV Virtual solicita al cliente los datos para realizar la transacción de
autorización.

Si el banco del titular de la tarjeta dispone de un sistema de autenticación se solicitará al


titular por parte del banco emisor la correspondiente prueba de autenticación, en caso
que la transacción se haya procesado por un terminal configurado con compra segura.

La solicitud de Autorización se lleva a cabo en tiempo real, produciendo un cargo


inmediato en la cuenta del titular asociada a la tarjeta (crédito o débito). Hay que notar
que las garantías en ambos tipos de tarjetas son idénticas.

La transacción es capturada automáticamente por el TPV Virtual y enviada diariamente


al proceso batch para que se proceda al abono al comercio.

El titular de la tarjeta recibe un justificante del pago realizado.

Preautorización (Ds_Merchant_TransactionType = “1”)

NOTA: de acuerdo a la normativa de las marcas internacionales, esta operativa


está restringida a aquellos comercios cuya actividad sea una de las siguientes:
hoteles, agencias de viajes y alquiler de vehículos.

Puede utilizarse cuando en el momento de la compra no se puede determinar el


importe exacto de la misma o, por alguna razón, el comercio no desea que el importe
sea cargado en la cuenta del cliente de forma inmediata.

La transacción es transparente para el titular que en todo momento actúa exactamente


igual que en el caso anterior, es decir, facilita sus datos y se autentica si corresponde,
recibiendo por parte del TPV Virtual el correspondiente justificante.
Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier
medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

10
La solicitud de preautorización se lleva a cabo en tiempo real, produciendo una
retención por el importe de la venta en la cuenta del titular.

La transacción no se captura y, por tanto, no produce efectos contables en la cuenta


del titular ni por tanto abono al comercio (en el caso de tarjetas de débito algunas
entidades emisoras SÍ efectúan apuntes contables al titular, que se anulan
automáticamente pasados unos días).

Toda preautorización debe tener una Confirmación de Preautorización en un


período máximo de 7 días naturales, contando el día de la Preautorización dentro de
estos 7 días (ej. Preautorización el día 03/05, máximo día para enviar la confirmación
09/05). En caso contrario perderá su validez como garantía de pago.

Confirmación de Preautorización (Ds_Merchant_TransactionType = “2”)

Complementa de forma inseparable la operación anterior.

El titular no está presente y, por tanto, es siempre iniciada por el comercio.

Debe realizarse en los 7 días siguientes a la preautorización original (contando el día


de la Preautorización dentro de estos 7 días) y su importe debe ser MENOR, IGUAL o,
como mucho, hasta un 15% superior al importe de la operación original.

Esta transacción se trata contablemente, regularizando automáticamente el apunte en


la cuenta del titular y enviándose al proceso batch para su abono al comercio.

La confirmación de preautorización tiene garantía de pago y conserva las


condiciones respecto a transacción segura de su Preautorización original.

El TPV Virtual validará la existencia de la operación original y el importe que se desea


confirmar, rechazando la operación en caso de existir algún error.

Anulación de Preautorización (Ds_Merchant_TransactionType = “9”)

El titular no está presente y, por tanto, es siempre iniciada por el comercio. Debe
realizarse en los 7 días siguientes a la preautorización original (contando el día de
la Preautorización dentro de estos 7 días).

El TPV Virtual validará la existencia de la operación original, rechazando la operación en


caso de existir algún error.
Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier
medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

11
Devolución Parcial o Total (Ds_Merchant_TransactionType = “3”)

Son transacciones contables iniciadas por el comercio. También podrá utilizar el


módulo de administración del TPV Virtual para realizarlas manualmente.

El TPV Virtual comprueba la existencia de la autorización original que se desea


devolver, así como que la suma de los importes devueltos no supere en ningún caso el
importe autorizado original.

Producen efecto contable en la cuenta del titular (algunas entidades emisoras


pueden demorar unos días el abono al titular) y, por tanto, son capturadas
automáticamente y enviadas al proceso de liquidación que procederá a realizar el cargo
correspondiente en la cuenta del comercio.

Autenticación (Ds_Merchant_TransactionType = “7”)

Este tipo de operación puede ser utilizado por el comercio cuando el importe de la venta
no puede ser determinado con exactitud en el momento de producirse la misma.

La operativa es similar a la de las preautorizaciones, dado que no hay apunte contable,


pero para este tipo de operación no se producen retenciones en cuenta al titular. Se
validará el CVV2, si la fecha de caducidad es la correcta y si la tarjeta está activa.
No se validará si el titular tiene saldo. Para las operaciones bajo 3D Secure el banco
emisor de la tarjeta comprobará la identidad del titular bajo sus criterios de autenticación.

Posteriormente y dentro de los siguientes 45 días naturales el comercio enviará una


confirmación de autenticación que completará la operación original.

Confirmación de autenticación (Ds_Merchant_TransactionType = “8”)

Complementa de forma inseparable la operación anterior.

El titular no está presente y, por tanto, es siempre iniciada por el comercio.

Su importe puede ser diferente al de la operación original (incluso MAYOR con un


máximo de un 15% respecto el importe original).

Esta transacción se trata contablemente, produciendo un apunte en la cuenta del titular


y enviándose al proceso de liquidación diario para su abono al comercio.

Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier
medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

12
Las confirmaciones de autenticación conservan las mismas condiciones de
seguridad respecto a la autenticación original.

El TPV Virtual validará la existencia de la operación, rechazándola en caso de existir


algún error.

Pago 1 Click + Tokenización

Esta operación permite al comercio la opción de almacenar los datos de la tarjeta del
cliente sin necesidad de cumplir con la normativa PCI DSS. Es el método de pago
recomendable para suscripciones sin fecha de caducidad predefinida o para aquellos
comercios que quieran facilitar los pagos posteriores de sus clientes eliminando un paso
en el proceso de compra.

El comercio enviará un primer pago con la presencia del cliente, al que se podrán añadir
pagos posteriores sin presencia de éste.

El comercio no tendrá acceso a los datos de tarjetas. Las operaciones se


identificaran mediante una referencia que se generará en el momento de realizar el
primer pago y que se facilitará al comercio en la respuesta de la operación. Esta
petición se puede realizar por cualquiera de las diferentes entradas: realizarPago o
WebService.

Al procesar la operación, si el comercio accede por la entrada realizarPago, nos


encargaremos de solicitarle al titular el número de tarjeta junto con la fecha de caducidad
y el CVV2. Procesaremos la operación, almacenando nosotros los datos de la tarjeta
(sólo tarjeta y fecha de caducidad, no CVV2) y lo asociaremos a una referencia.
Esta referencia se informará al comercio junto con la respuesta del pago y la fecha de
caducidad. También existe la posibilidad de informar en la respuesta los dígitos de la
tarjeta encriptados: 123456******1234). Una vez que el comercio ya dispone de una
referencia, podrá enviar cargos posteriores para todo tipo de operaciones: autorización,
preautorización, etc... La validez de esta referencia coincidirá con la fecha de caducidad
de la tarjeta.
El comercio también podrá solicitar una referencia para aquellas operaciones procesadas
por ese mismo comercio con un año de anterioridad (siempre y cuando, la tarjeta no haya
caducado).

IMPORTANTE – en todos los TPV virtuales están activados por defecto los
siguientes métodos de pago: 0, 3, 7, 8. En caso que se quiera utilizar algún método
de pago no incluido en los anteriores hay que solicitarlo en su oficina gestora o a
su gestor de comercio electrónico.
Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier
medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

13
A continuación se resumen las principales características de cada tipo de operación:

Operación Original
Tipo de Operación Iniciada por Contable Garantía – Operación Segura
Validaciones

Autorización Titular SI Cuando se reúnan condiciones

Preautorización Titular NO Cuando se reúnan condiciones

Confirmación de Preautorización: 7 días


Comercio SI Mismas que la original
Preautorización Importe < ó =

Anulación de Preautorización: 7 días


Comercio NO
Preautorización Importe =

Autorización:
Devolución
comercio SI Suma de importes devueltos < ó
automática
=120 días

Autenticación Titular NO Cuando se reúnen condiciones

Confirmación de
Comercio SI Autenticación: 45 días Mismas que la original
autenticación

2.2. Envío de petición al TPV Virtual


El comercio debe enviar al TPV Virtual los datos de la petición de pago codificados en
UTF8 a través del navegador del titular, ver Capitulo 5. Para ello deberá preparar un
formulario con los siguientes campos:

• Ds_SignatureVersion: Constante que indica la versión de firma que se está utilizando.

• Ds_MerchantParameters: Cadena en formato JSON con todos los parámetros de la


petición codificada en Base 64 y sin retornos de carro (Se adjunta Excel con listado de
parámetros de entrada y salida, así como los valores posibles de estos campos y los
códigos de error y respuesta).

• Ds_Signature: Firma de los datos enviados. Es el resultado del HMAC SHA256 de la


cadena JSON codificada en Base 64 enviada en el parámetro anterior.

Este formulario debe enviarse a las siguientes URLs dependiendo de si se quiere realizar
una petición de pruebas u operaciones reales:

URL Conexión Entorno


[Link] Pruebas

Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier
medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

14
[Link] Real

2.3. Notificación On-Line (Recepción del resultado)


Una vez gestionada la transacción, el TPV Virtual puede informar al servidor del comercio
el resultado de la misma mediante una conexión directa al servidor del comercio (paso 3
del flujo descrito). Esta notificación es opcional.

La notificación on-line consiste en un POST HTTP (Notificación Síncrona y Asíncrona)


con la información del resultado codificada en UTF-8.

En el POST se incluirán los siguientes campos:

• Ds_SignatureVersion: Constante que indica la versión de firma que se está utilizando.

• Ds_MerchantParameters: Cadena en formato JSON con todos los parámetros de la


respuesta codificada en Base 64 y sin retornos de carro (En el Anexo 12.2 se incluye la
lista de parámetros que se pueden incluir en la notificación on-line).

• Ds_Signature: Firma de los datos enviados. Resultado del HMAC SHA256 de la cadena
JSON codificada en Base 64 enviada en el parámetro anterior. El comercio es
responsable de validar el HMAC enviado por el TPV Virtual para asegurarse de la validez
de la respuesta. Esta validación es necesaria para garantizar que los datos no han sido
manipulados y que el origen es realmente el TPV Virtual.

NOTA: El TPV Virtual envía la notificación on-line a la URL informada por el comercio en
el parámetro Ds_Merchant_MerchantURL.

Alternativamente se puede enviar la respuesta mediante un email a la dirección de correo


electrónico informada en la configuración del Terminal.

Las IP’s desde las cuales se pueden recibir estas notificaciones son:
[Link]
[Link]

2.4. Retorno del control de la navegación del comprador


En el paso 3 del flujo el TPV Virtual (Ver Introducción), se mostrará al cliente un recibo
con el resultado de la operación, siempre y cuando la configuración del comercio así lo
especifique.

Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier
medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

15
Además, en caso de que la operación se deniegue, el cliente tendrá la opción de
reintentar el pago con otra tarjeta u otro método de pago, siempre y cuando la
configuración del comercio lo permita (la opción de reintentar el pago se describe en
detalle en el capítulo 2.6).

Se puede obviar la pantalla de recibo pero en ese caso es el comercio quién está
obligado a mostrar al comprador el resultado del intento de pago. Esta posibilidad se ha
de solicitar a BBVA para su aprobación

Por último, en este paso se devuelve al comercio el control de la navegación del titular.
De esta forma el comercio puede completar el flujo del pago manteniendo una secuencia
de navegación natural para el cliente/comprador.

Opcionalmente el TPV Virtual puede incluir los mismos campos de la notificación on-line.

BBVA recomienda la recepción de la respuesta mediante la notificación online y no


mediante la inclusión de los parámetros en la URLOK/URLKO ya que esta última
depende de la navegación del comprador y no se puede garantizar el retorno a la web
del comercio (por ejemplo si el comprador cierra el navegador).

2.5. Personalización
Las pantallas que se muestran al cliente durante el proceso del pago pueden ser
personalizadas. Por defecto, la imagen que se muestra en el pago es la siguiente:

Existe una herramienta de personalización a la que pueden acceder los comercios y que

Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier
medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

16
permite modificar los colores, el logo, la información a mostrar en la página de pago,
botones,...

Para poder acceder a este servicio, el comercio deberá solicitar el acceso a la herramienta
a su oficina, a Línea Comercios o, en caso de tener uno asignado, a su gestor en
eCommerce.

Se recomienda también solicitar el manual específico que existe para llevar a cabo dicha
personalización.

2.6. Reintentos de Pago


La opción de reintentar el pago ofrece al titular la posibilidad de intentar realizar el pago,
con otra tarjeta o con otro método de pago, cuando la operación ha sido denegada por el
emisor o por error en la autenticación del titular (Error = 184). No se ofrecerá al titular esta
opción de reintento del pago, en caso de que la operación se deniegue por aplicación de
reglas de fraude, por un error técnico en el proceso de autenticación o por cualquier otro
tipo de error.

Para que al cliente le aparezca esta opción, el comercio debe tener una configuración
específica en el Módulo de Administración del TPV-Virtual (Permitir Repetir Pedido = SI,
con reintentos) y cumplir los siguientes requisitos:

• El comercio debe ser capaz de recibir varias notificaciones asociadas al mismo


número de pedido y sólo tener en cuenta la primera notificación que identifique que la
operación está autorizada, o en caso de no recibir ninguna notificación de operación
autorizada, deberá tener en cuenta la última notificación que reciba sobre el número
de pedido en cuestión.
• Actualmente la opción de reintentar no es compatible con los plugins disponibles
para las tiendas virtuales de Prestashop, Magento, etc. En módulos de pago
desarrollados por terceros esta opción podría no funcionar adecuadamente,
provocando un error en la actualización de los pedidos en la tienda virtual.

Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier
medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

17
3. MEDIDAS DE SEGURIDAD
Puesto que se realizan en un entorno no presencial, las operaciones de TPV Virtual son
las más susceptibles de recibir pagos de tarjetas fraudulentas donde el titular no es quien
realiza la compra. Para reducir el riesgo de estas operaciones, BBVA aplicará una serie
de condiciones que limitan la operatoria de cada comercio. Estás limitaciones han de
ajustarse a unos valores que no condicionen las expectativas de venta del comercio pero
que a su vez evite desviaciones exageradas de su facturación habitual (en la mayoría de
los casos significan que se está recibiendo un ataque con tarjetas robadas y/o
fraudulentas).

o Número máximo de operaciones por día (autorizadas y denegadas)

o Importe máximo por operación

o Importe máximo acumulado diario

o Número máximo diario de operaciones (aceptadas y denegadas) por tarjeta


o Importe máximo diario por tarjeta

o Número máximo diario de operaciones (aceptadas y

o denegadas) por usuario (dirección I.P.)

o Importe máximo diario por usuario (dirección I.P.)

o Restricción operativa por países

o Etc…

Cualquier modificación de las medidas de seguridad se tendrá que solicitar a BBVA.

3.1. Medidas de seguridad adicionales


Para proteger los intereses de su comercio y reducir al máximo el volumen de incidencias,
sugerimos adoptar las siguientes medidas de seguridad adicionales a la hora de aceptar
pagos con tarjetas.

3.2. Señales para detectar fraude en internet


Cuando aparezca alguna de las siguientes señales en una compra por internet, el comercio
debe sospechar de ella, pero cuando aparecen más de una, el comercio debe tomar
Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier
medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

18
medidas para evitar ser víctima de un fraude.

o Persona que compra en la tienda por primera vez

o Múltiples operaciones de una misma tarjeta o de un mismo usuario o dirección


de IP en un periodo corto de tiempo

o Múltiples operaciones de una misma tarjeta (o tarjetas de numeración similar)


con diferentes direcciones de entrega.

o Operaciones con números de tarjetas similares.

o Pedidos con la misma dirección de envío pero realizadas con múltiples tarjetas

o Múltiples tarjetas usadas desde una misma dirección IP, o con una misma
dirección de correo electrónico o DNI del usuario registrado.

o Pedidos consistentes en múltiples cantidades del mismo producto

o Pedidos de importe superior al normal

o Pedidos en los que la entrega ha de ser urgente, o incluso “para el día siguiente”.
Los delincuentes quieren estos productos obtenidos fraudulentamente tan
pronto como sea posible, para una posible reventa y no están preocupados por
el sobrecoste del envío.

o Pedidos de productos de alto valor. Estos productos tienen un alto valor de


reventa.

o Pedidos enviados a direcciones internacionales.

o Operaciones de compradores, direcciones IP o números de tarjeta que hayan


procesado con anterioridad operaciones rechazas por posible fraude o que
hayan sido reportadas como fraudulentas.

3.3. Control de operaciones


En el MÓDULO DE ADMINISTRADOR DEL TPV VIRTUAL se informa la DIRECCIÓN I.P.
del comprador y debería comprobarse que:

o Un mismo usuario (misma dirección IP) no ha pagado (o ha intentado pagar) con


más de dos tarjetas diferentes.

o Un mismo usuario (I.P.) o una misma tarjeta, no han realizado múltiples


operaciones en un corto periodo de tiempo.

o No se están realizando compras con tarjetas generadas (los primeros dígitos de


Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier
medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

19
los números de tarjetas son iguales pero los últimos cambian).

o Al realizar diferentes compras, un mismo usuario (I.P.) o una misma tarjeta no se


ha registrado a la web con datos diferentes.

o Si el terminal ha rechazado la primera operación de la tarjeta, verificar que no se


han procesado más operaciones con la misma I.P. o con la misma tarjeta por
importes más bajos.

Mediante el mensaje de respuesta (campo "DS_Response") o el MÓDULO DE


ADMINISTRACIÓN DEL TPV VIRTUAL se informa si la operación ha sido aceptada
(códigos 000 a 099) o denegada (resto de códigos). Los códigos de denegación tipo 2xx,
indican que la tarjeta está bloqueada por pérdida, robo, falsificación del plástico o
por uso fraudulento de la numeración de la tarjeta. En estos casos el comercio tendrá
que bloquear el usuario (identificable mediante dirección I.P. y datos de registro) para no
permitirle la opción de intentar ningún nuevo pago.

También en el mensaje de respuesta hay el campo "Ds_Card_Country" que informa del


código I.S.O. del país donde se ha emitido la tarjeta. Mediante la comparación con la
dirección I.P. del comprador se pueden filtrar comportamientos sospechosos de ser
fraudulentos (p.e. una tarjeta emitida en un país pero que opera mediante una I.P. de otra
país diferente).

Comprobar la validez de los datos de registro del cliente:

o Validar los números de teléfono usando directorios de teléfonos.

o Validar que el código del teléfono y/o su prefijo coincide con el área geográfica
de la dirección de envío del pedido.

o Validar la correspondencia entre el código postal y la ciudad del envío.

o Validar de la dirección email enviando una orden de confirmación.

Establecer límites de control basados en múltiples parámetros. El comercio puede reducir


considerablemente su riesgo de exposición al fraude aplicando controles de operaciones
propios para identificar transacciones de alto riesgo antes de enviarlas para ser
procesadas. Este tipo de controles ayudan a determinar si un titular o una operación han
de ser revisada manualmente por el comercio.

Aplicar límites de revisión basados en el número y/o el importe de las operaciones


realizadas por un mismo usuario en periodo determinado de tiempo.

Aplicar límites de revisión basados en el importe de la venta.

Asegurarse que estos límites de revisión se basan en múltiples parámetros, incluyendo


dirección de entrega, número de teléfono o dirección email.

Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier
medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

20
Contactar con aquellos compradores que excedan estos límites para determinar si la
operativa es legítima y debe ser aceptada, asumiendo siempre que esta operación haya
sido aceptada por el banco emisor.

No permitir a los compradores utilizar más de un usuario, o más de una tarjeta para cada
compra.

Modificar los controles de operaciones y los límites de revisión en función de la


propia experiencia del comercio dependiendo de cada producto, localidades de envío y
patrones de compra de los clientes.

En el caso qua la operación no supere todos los controles indicados, el comercio ha


de rechazar la tarjeta como medio de pago y anular, si procede, la operación del TPV.

Los responsables del comercio han de conocer estas medidas de seguridad, hacer
acciones de formación a todos los empleados que gestionen los pagos con tarjeta y
verificar periódicamente el cumplimiento de estas medidas de seguridad. En caso
contrario, se corre el riesgo de que las operaciones fraudulentas se puedan retroceder al
comercio y, si el número de operaciones retrocedidas o fraudulentas es significativo, se
proceda al bloqueo del terminal y la rescisión del contrato con BBVA.

Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier
medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

21
4. VENDER EN EL EXTRANJERO
El TPV Virtual de BBVA se adapta a las necesidades de expansión internacional de
los comercios integrando soluciones que facilitan la venta fuera de nuestras fronteras:

4.1. Operativa DCC (Dinamic Currency Conversion)


Permite a los clientes de todo el mundo pagar en su propia moneda o en euros en función
de la moneda de origen de la tarjeta. Si el comercio tiene esta opción activada, el sistema
detecta la moneda de la tarjeta, y al usuario se le da la posibilidad de elegir con en qué
moneda quiere pagar su compra, si en Euros o en su moneda de origen. En cualquier caso
el comercio recibirá el abono en euros independientemente de la divisa con la que el cliente
haya realizado el pago.

4.2. Liquidación Multidivisa


Este servicio ofrece la posibilidad de liquidar las ventas que realiza el comercio en la
divisa original de la operación (monedas cotizadas en BBVA), permitiendo el ahorro de
las diferencias económicas que se producen en los tipos de cambio entre el momento de
la operación y la liquidación. Las divisas que no cotizan en BBVA (o que tienen un uso
restringido) se seguirán liquidando en euros.

El comercio no tendrá perjuicios económicos por diferencias de cambio entre el


momento de la operación y la liquidación de la remesa, o entre la liquidación y su
retrocesión en caso de reclamaciones posteriores.

El comercio recibirá la liquidación de tantas remesas como operaciones en monedas


diferentes procese, siempre que sean monedas cotizadas en BBVA. El resto de
facturaciones se liquidarán agrupadas en una única remesa contravaloradas en euros.

Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier
medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

22
MONEDAS COTIZADAS ACTUALMENTE EN BBVA

MONEDA DESCRIPCIÓN
AUD Dólar Australiano
CAD Dólar Canadiense
CHF Franco Suizo
CNY Yuan Renminbi
CZK Corona Checa
DKK Corona Danesa
GBP Libra Esterlina
HKD Dólar Hong Kong
HUF Forint
JPY Yen Japonés
LTL Lita Lituanian
LVL Lat Letón
MAD Dirham Marroquí
MXN Peso Mexicano
NOK Corona Noruega
NZD Dólar New Zeland
PEN Nuevo Sol
PLN Zloty
RUB Rublo Ruso
SAR Rial Saudita
SEK Corona Sueca
SGD Dólar Singapur
TRY Nueva Lira Turca
USD Dólar USA
ZAR Rand Sudafricano

Para activar cualquiera de estas dos opciones deberá solicitarlo en su oficina o a su gestor
eCommerce de BBVA.

Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier
medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

23
5. INTEGRACIÓN - FORMULARIO DATOS PETICIÓN
OPERACIÓN
Los comercios que integran el TPV Virtual mediante Redirección han de enviar al
comprador a la web de Redsys/BBVA para que este complete el Pago, introduciendo los
datos necesarios en el/los formularios que se le presenten según la opción escogida,
habitualmente los datos de la Tarjeta de Pago. El TPV se encargará de redirigir al
comprador al formulario de Autenticación (Challenge EMV3DS) cuando este sea necesario.
En la siguiente URL el Comercio dispone de instrucciones para montar la cadena de
petición al TPV Virtual:

[Link]

Asimismo, el comercio dispone de las siguiente URL donde se describen los mensajes a
enviar a la pasarela en cada caso:

[Link]

Por otro lado el comercio dispone de librerías para la ayuda de la integración del TPV virtual.
Estas librerías están disponibles para PHP, JAVA i .NET y se describe su uso en la
siguiente URL:

[Link]

Los datos a enviar al TPV Virtual están recogidos en el libro Excel Anexo. Revisar la hoja
“Parámetros de Entrada” donde se recogen todos los campos obligatorios y Opcionales.

La integración de EMV3DS incorpora el campo DS_MERCHANT_EMV3DS, un objeto


Variable de tipo JSON descrito en la hoja “DS_MERCHANT_EMV3DS”.

Este campo, a su vez incorpora campos fijos y otros campos variables de estructura JSON,
descritos en sus correspondientes hojas.

Estos parámetros no son obligatorios pero permitirán al Banco Emisor a analizar de forma
más eficiente el riesgo de la transacción y decidir si la transacción requiere de Autenticación
por Challenge (interacción con el comprador) o bien es suficiente con Autenticación
Frictionless (basada en análisis de riesgo). Asimismo, en caso de que el comercio pueda y
desee solicitar una excepción a SCA el banco emisor tendrá mayor capacidad para
autorizar o denegar dicha excepción.

5.1. Excepciones a SCA

Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier
medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

24
Por otro lado se incorpora el campo DS_MERCHANT_EXCEP_SCA en el que el comercio
puede solicitar la excepción de Autenticación a BBVA y el Banco Emisor de la tarjeta, es
decir que la transacción de procese de forma No Segura, siendo consciente de que en caso
de que dicha excepción se aplicase, el comercio asume la responsabilidad financiera de la
transacción en caso de Fraude. La disponibilidad de esta operativa requiere activación por
parte de BBVA.

DATO NOMBRE DEL DATO Long. / Tipo COMENTARIOS

Indicador de DS_MERCHANT_EXCEP_SCA 3/A-N Opcional.


solicitud de Valores posibles: MIT , LWV, TRA ,
excepción. COR, ATD

o LWV: exención por bajo importe (hasta 30 €, con máx. 5 ops. o 100 € acumulado por
tarjeta, estos contadores son controlados a nivel de entidad emisora de la tarjeta).
o TRA: exención por utilizarse un sistema de análisis de riesgo (y considerarse bajo
riesgo) por parte del adquirente/comercio.
o MIT: operación iniciada por el comercio (sin estar asociada a una acción o evento del
cliente) que están fuera del alcance de la PSD2. Este es el caso de las operativas de
pagos de subscripciones, recurrentes, etc, todas las que requieren el
almacenamiento de las credenciales de pago del cliente (COF) o su equivalente
mediante operativas de pagos programados tokenizados (uso funcionalidad “pago
por referencia” en pagos iniciados por el comercio). Toda operativa de pago iniciada
por el comercio (MIT) requiere que inicialmente cuando el cliente concede el permiso
al comercio de uso de sus credenciales de pago, dicho “permiso o mandato” se haga
mediante operación autenticada con SCA. Ver capítulo específico de Operativa COF
/ MIT.
o COR: exención restringida a los casos de uso de un protocolo pago corporativo
seguro
o ATD: autenticación delegada. Esta excepción si bien está contemplada por la
Normativa está todavía en fase de discusión con lo que no es aún operativa.
NOTA: Se deberá tener en cuenta que para las exenciones LWV, TRA y COR la primera
opción será marcar la exención en el paso de la autenticación, para mejorar la experiencia
de usuario. Esto permite que si el emisor no quiere aceptar la propuesta de exención y
requiere SCA pueda solicitar la autenticación en el mismo momento sin necesidad de
rechazar la operación (challenge required EMV3DS).

Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier
medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

25
5.2. Transacciones iniciadas por el comercio (COF - MIT)
Son las transacciones iniciadas por el comercio sin que haya interacción posible con el
cliente. Por ejemplo, pago mensual de un recibo o cuota de subscripción. Este tipo de
exención requiere el marcaje de la operativa como COF (Credencial on File) de acuerdo al
uso concreto que se esté haciendo de las credenciales almacenadas.

Sin embargo no todas las operativas en las que se utilizan datos de tarjeta/credenciales
almacenadas (COF) son consideradas MIT. Por ejemplo, la operativa de pago en 1 clic,
donde las credenciales del cliente están almacenadas o tokenizadas (pago por referencia)
con el objetivo de facilitar al máximo el momento del pago sin tener que solicitarlas de nuevo
al cliente, no se puede considerar una transacción iniciada por el comercio. En tal caso
según PSD2, y mientras no se aplique otra exención, se requiere el uso de autenticación
reforzada (SCA).

No obstante, con PSD2 estando en vigor, toda operativa de pago iniciada por el comercio
(MIT) requiere inicialmente una operación autenticada con SCA que es aquella en la que el
cliente concede el permiso y acuerda con el comercio las condiciones para que se usen
sus datos de pago para cargos posteriores de acuerdo a un servicio prestado continuado
en el tiempo. Esta operativa debe también marcarse debidamente siguiendo la
especificación Card-on-file (COF) para indicar que los datos de tarjeta se están
almacenando para pagos posteriores.

NOTA: El listado completo de todos los parámetros de entrada del SIS se presenta en la
hoja de cálculo adjunta “TPV-Virtual Parámetros [Link]”.

Transacciones MIT y uso de tokenización (pago por referencia)

En muchos casos se suele utilizar la tokenización de las credenciales de pago del cliente
para que el TPV Virtual se encargue del almacenamiento seguro de los mismos y asegurar
el cumplimiento de los estándares de seguridad de PCI DSS, con el objetivo de generar
más tarde pagos iniciados por el comercio sin estar presente el titular de la tarjeta.

En estos casos, en la transacción inicial en la que se solicitar el token o referencia, bajo


PSD2 se debe utilizar 3D Secure para aplicar autenticación reforzada y además se debe
marcar adecuadamente mediante los parámetros COF el uso que se dará a la misma, de
forma que en usos posteriores iniciados por el comercio con el token/referencia, el propio
tpv virtual SIS incorpore de forma automática la información de marcaje de uso adecuada
e información adicional requerida según la marca de la tarjeta (pej: id transacción original
requerido para los pagos COF en Visa “DS_MERCHANT_COF_TXNID”).
Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier
medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

26
5.3. Ejemplo EMV 3DS
A continuación, se muestra un ejemplo del parámetro Ds_Merchant_Parameters, previo a
ser codificado en Base 64:

{“DS_MERCHANT_ORDER":"1552565870",
"DS_MERCHANT_MERCHANTCODE":"999008881",
”DS_MERCHANT_TERMINAL":"999",
"DS_MERCHANT_CURRENCY":"978",
"DS_MERCHANT_TRANSACTIONTYPE":"0",
"DS_MERCHANT_AMOUNT":"1000",
"DS_MERCHANT_MERCHANTURL":"http:\/\/[Link]\/urlNotificaci
[Link]",
"DS_MERCHANT_URLOK":"http:\/\/[Link]\/[Link]",
"DS_MERCHANT_URLKO":"http:\/\/[Link]\/[Link]"",
"DS_MERCHANT_EMV3DS": {
"shipAddrCountry": "840",
"shipAddrCity": "Ship City Name",
"shipAddrState": "CO",
"shipAddrLine3": "Ship Address Line 3",
"shipAddrLine2": "Ship Address Line 2",
"shipAddrLine1": "Ship Address Line 1",
"shipAddrPostCode": "Ship Post Code",
"cardholderName": "Cardholder Name",
"email": "example@[Link]",
"mobilePhone": {"cc": "123","subscriber": "123456789"}
}
}

Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier
medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

27
6. BIZUM
Desde finales de 2019 el TPV Virtual de BBVA incorpora la posibilidad de realizar cobros
mediante BIZUM C2R. Esto es que el comprador pague la transacción mediante la
redirección a una página de pago específica de BIZUM. En esta página el comprador no ha
de introducir los datos de la tarjeta, sino su número de teléfono, su clave Bizum y
posteriormente la OTP (One Time Password) para la firma de la transacción.

El comercio debe realizar cambios para que en el proceso de compra final (checkout)
BIZUM se muestre como una opción más de pago.

Si el comercio dispone de una de las soluciones de comercio electrónico del mercado


(Prestashop, Zen Cart, WooCommerce, OsCommerce …) debe incluir un módulo que
permita esta conexión.

Un ejemplo ilustrativo de la integración con Bizum sería la que se muestra en la siguiente


imagen:

Los pasos necesarios para que un comercio pueda ofrecer BIZUM son básicamente estos
tres puntos:
1. El comercio debe tener activada por su entidad financiera la posibilidad de pagar
con BIZUM.
Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier
medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

28
2. El comercio debe incluir el botón que identifica al pago mediante BIZUM.
3. Realizar una llamada al TPV Virtual con un formato concreto y muy sencillo de
implementar.

Para poder ofrecer el pago con BIZUM a través del TPV virtual se deben realizar unas
pequeñas modificaciones en el servidor del comercio.

Además de los métodos de pago distintos de tarjeta con los que ya puede estar trabajando,
deberá incluir un botón de pago con BIZUM a través del TPV virtual junto al resto de
opciones.

Podrá utilizarse cualquiera de estas dos imágenes:

Estos botones se han incluido en la comunicación de bienvenida que se envió en el alta del
TPV Virtual. También pueden descargarse desde la sección de “Documentación” que se
encuentra en Redsys. El zip tiene el siguiente nombre: Botones Bizum.7z

En el momento que el cliente pulse el botón de pago, se debe generar una petición idéntica
a una petición estándar realizada al TPV Virtual (realizarPago). En dicha petición se deberá
incluir el siguiente campo:

Ds_Merchant_PayMethods
Cuyo valor será la letra "z" minúscula para el pago con BIZUM.

Además, la operativa Bizum tiene dos comportamientos atendiendo al tipo de transacción


que se desee realizar:

a. Pago Bizum estándar: Esta operativa Bizum consiste en realizar una autenticación
del cliente y, seguidamente, la autorización de la operación que se desee realizar.

Para utilizar esta modalidad se deberá incluir el siguiente campo:

Ds_Merchant_TransactionType = 0

b. Pago Bizum de doble flujo: La referencia del doble flujo indica que el comercio
tiene la posibilidad de realizar de manera separada la autenticación y la autorización
Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier
medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

29
de la operación del cliente. La diferencia con el Pago Bizum estándar está en el tipo
de transacción enviado en la petición al TPV Virtual (realizarPago).

Una vez realizada la autenticación, el comercio tiene máximo 30 días para lanzar la
autorización de la operación. Pasado ese tiempo, la autorización no se hará efectiva.

Para estas dos fases se debe tener en cuenta lo siguiente:

Fase 1 (Autenticación)

Para realizar la autenticación se deberá incluir el siguiente campo:

Ds_Merchant_Transaction Type = 7

Fase 2 (Autorización)

Para realizar la autorización se deberá incluir el siguiente campo:

Ds_Merchant_Transaction Type = 8

La identificación del comercio y terminal se realizará mediante alta por parte de su entidad
en el módulo de administración del TPV Virtual y las transacciones serán securizadas de
forma individual mediante una firma digital que realizará el comercio.

NOTA: Los detalles técnicos para realizar una petición por realizarPago se debe seguir la
guía de “TPV-Virtual Manual Integración - Redirecció[Link]”.

A partir de este punto, el TPV Virtual gestionará completamente la autorización sin que sea
necesaria la intervención del comercio. Sin embargo, el comercio que realice una operación
Bizum utilizando el doble flujo, éste deberá intervenir para realizar la autorización de la
operación original. En todo momento, la operativa se ajustará a la personalizada para cada
comercio.

Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier
medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

30
7. ACCESO AL ENTORNO DE PRUEBAS
Para poder realizar las pruebas de instalación, durante el proceso de alta de su TPV Virtual
BBVA, la entidad le facilitará los parámetros de acceso a un entorno de TPV TEST donde,
en un entorno aislado, idéntico al entorno de producción, podrá realizar operaciones de
prueba. Estas ventas serán ficticias, por lo que no tendrán validez contable.

Para acceder a este entorno es preciso tener habilitado el acceso a los puertos 25443 y
26443.

Las características del entorno de pruebas se detallan a continuación:

URL’s pago:

Entrada ‘REALIZAR PAGO’: [Link]

Número de comercio (Ds_Merchant_MerchantCode): XXXXXXXX

Clave secreta (Ds_Merchant_MerchantSignature)


SHA-1: qwertyasdf0123456789
SHA-256: sq7HjrUOBfKmC576ILgskD5srU870gJ7

Otros parámetros
Número de terminal (Ds_Merchant_Terminal = 001)
Código divisa operación (Ds_MerchantCurrency = 978)

Tarjetas de pruebas

Ponemos a su disposición una serie de tarjetas habilitadas para funcionar exclusivamente


en el entorno de pruebas. Dadas las diferentes posibilidades de enrolamiento de las tarjetas
(3DS v1, 3DS v2, etc...) se informan diferentes tarjetas que cubran todos los escenarios:

Tarjetas Autorizadas:

Tarjeta Autorizada 1
Tarjeta: 4548 8120 4940 0004
Caducidad: 12/34
Código de seguridad: (CVV2) 123

Atención: Esta tarjeta está configurada simulando que el titular necesita autenticarse con
su banco. Para ello se debe introducir el Código de Identificación 123456.

Tarjeta Autorizada 2 (3DSecure 1.0 con “iniciapeticion” NO_3DS_V2):


Tarjeta: 4548 8120 4940 0004
Caducidad: 12/34
Código de seguridad: (CVV2) 123
Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier
medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

31
Atención: Esta tarjeta está configurada simulando que el titular necesita autenticarse con
su banco. Para ello se debe introducir el Código de Identificación 123456.

Tarjeta Autorizada 3 (EMV3DS 2.1 con “iniciapeticion” con threeDSMethodURL con


autenticación FRICTIONLESS):
Tarjeta: 4918 0191 6003 4602
Caducidad: 12/34
Código de seguridad: (CVV2) 123

Atención: Como es autenticación Frictionless no ha lugar al Challenge y no se pedirá la


clave de Autenticación

Tarjeta Autorizada 4 (EMV3DS 2.1 con “iniciapeticion” sin threeDSMethodURL con


autenticación FRICTIONLESS):
Tarjeta: 4548 8144 7972 7229
Caducidad: 12/34
Código de seguridad: (CVV2) 123

Atención: Como es autenticación Frictionless no ha lugar al Challenge y no se pedirá la


clave de Autenticación

Tarjeta Autorizada 5 (EMV3DS 2.1 con “iniciapeticion” con threeDSMethodURL con


autenticación CHALLENGE):
Tarjeta: 4918 0191 9988 3839
Caducidad: 12/34
Código de seguridad: (CVV2) 123

Atención:
 Esta tarjeta está configurada simulando que el titular necesita autenticarse con su
banco. Para ello se debe introducir el Código de Identificación 123456.
 Esta tarjeta irá por el flujo EMV3DS, se podrán mandar datos adicionales en el
parámetro DS_MERCHANT_EMV3DS.

Tarjeta Autorizada 6 (EMV3DS 2.1 con “iniciapeticion” sin threeDSMethodURL con


autenticación CHALLENGE):
Tarjeta: 4548 8172 1249 3017
Caducidad: 12/34
Código de seguridad: (CVV2) 123

Atención:
 Esta tarjeta está configurada simulando que el titular necesita autenticarse con su
banco. Para ello se debe introducir el Código de Identificación 123456.
 Esta tarjeta irá por el flujo EMV3DS, se podrán mandar datos adicionales en el
parámetro DS_MERCHANT_EMV3DS.

Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier
medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

32
Tarjeta Autorizada 7 (EMV3DS 2.2 con “iniciapeticion” sin threeDSMethodURL con
autenticación FRICTIONLESS):
Tarjeta: 4548 8161 3458 1156
Caducidad: 12/34
Código de seguridad: (CVV2) 123

Atención: Como es autenticación Frictionless no ha lugar al Challenge y no se pedirá la


clave de Autenticación

Tarjeta Autorizada 8 (3DSecure 2.2 con “iniciapeticion” sin threeDSMethodURL con


autenticación CHALLENGE):
Tarjeta: 4548 8153 2405 8868
Caducidad: 12/34
Código de seguridad: (CVV2) 123

Atención: Esta tarjeta está configurada simulando que el titular necesita autenticarse con
su banco. Para ello se debe introducir el Código de Identificación 123456.

Tarjeta Autorizada 9 (3DSecure 2.2 con “iniciapeticion” sin threeDSMethodURL; acepta


exenciones):
Tarjeta: 4548 8153 2405 8868
Caducidad: 12/34
Código de seguridad: (CVV2) 123

Atención: Esta tarjeta está configurada de forma que acepta exenciones. Si la petición
incluye exenciones la operación se procesa como FRICTIONLESS, es decir NO
AUTENTICA. Si la operación se envía sin solicitud de exencion se procesa como
CHALLENGE, es decir, se solicita clave de Autenticación simulando que el titular necesita
autenticarse con su banco. Para ello se debe introducir el Código de Identificación 123456.

Tarjeta Autorizada 10 (3DSecure 2.2 con “iniciapeticion” sin threeDSMethodURL; acepta


exencion MIT):
Tarjeta: 4548 8153 7402 5114
Caducidad: 12/34
Código de seguridad: (CVV2) 123

Atención: Esta tarjeta está configurada de forma que acepta la exencion MIT. Si la petición
incluye exencion MIT la operación se procesa como FRICTIONLESS, es decir NO
AUTENTICA. Si la operación se envía sin solicitud de exencion o con solicitud de Exención
diferente de MIT se procesa como CHALLENGE, es decir, se solicita clave de Autenticación
simulando que el titular necesita autenticarse con su banco. Para ello se debe introducir el
Código de Identificación 123456.

Tarjetas Denegadas (Código de respuesta 190):

Cualquier operación con valor de CVV2 = 999 o importe terminado en 96

Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier
medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

33
Adicionalmente, la URL para el acceso al módulo de administración es la siguiente:

[Link]

Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier
medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

34
8. MÓDULO DE ADMINISTRACIÓN
El TPV Virtual de BBVA incluye herramienta de administración donde podrá realizar todas
las gestiones relacionadas con su negocio. Ofrece la posibilidad de consultar en tiempo
real el detalle de las ventas realizadas.

Además de consultar las operaciones realizadas, podrá tener un control de los cierres
contables, gestionar devoluciones y visualizar las transacciones que no han finalizado
correctamente, obteniendo información sobre el motivo de denegación.

Accediendo a la dirección [Link] (entorno pruebas) y


[Link] (entorno real), con usuario y
contraseña, que le facilitaremos previamente, podrá realizar todas las operaciones de
gestión relacionas con tu negocio.

Una vez confirmado que el usuario y la contraseña introducidos son correctos, tendrá
acceso a los módulos de Administración habilitados para su comercio:

o Administración: Consulta de operaciones y gestión del TPV


o Usuario: Gestión de su contraseña y de los permisos a otros usuarios del
comercio, si existieran.
o Documentación: Disponibilidad de documentación relacionada con su
TPV.

Los usuarios y el nivel de acceso a las funciones administrativas serán proporcionadas por
BBVA de acuerdo con sus necesidades.

Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier
medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

35
8.1. Consulta y administración de operaciones
Dentro del módulo “Administración” y en el apartado de “Consultas”, podrá consultar y
administrar de forma muy intuitiva todas las operaciones de un TPV Virtual. Podrá consultar
el detalle de las mismas, realizar devoluciones (totales o parciales), y confirmar
manualmente los tipos de operaciones que lo requieran indicadas anteriormente, por
ejemplo, las Autorizaciones en Diferido.

El TPV Virtual ofrece esta posibilidad para los últimos 360 días de operaciones, y siempre
realizadas en intervalos de 30 días como máximo. Es decir, del 1 al 30 ó 31 del mes o del
12-04-2016 al 12-05-2016 por ejemplo.

Además todas estas operaciones podrán ser exportadas a Excel y en formato .txt.

Podrá personalizar la información de las operaciones seleccionando las “Columnas a


mostrar”.

Los códigos de respuesta que se muestran en campo “Resultado operación y código”


pueden consultarse en el Manual del desarrollador – Códigos de respuesta (Ds_Response).

La última columna “Opciones” permite al comercio consultar el detalle de la operación


realizada, hacer una copia del recibo, así como generar y consultar devoluciones totales o
parciales de la operación.

Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier
medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

36
8.2. Confirmación de una operación
Aquellos comercios con operativa de pre-autorizaciones o Autorizaciones en Diferido,
podrán generar confirmaciones y anulaciones de las mismas a partir del módulo de
administración. Asimismo, si el comercio trabaja con la operativa de pre-autenticaciones,
podrá generar las confirmaciones de estas.

8.3. Realizar una devolución


Los usuarios que tengan configurada la autorización para realizar devoluciones, deberán
seleccionar la opción “Generar devolución” de la operación deseada, que se encuentra en
la última columna.

Cuando se accede a esta opción, aparecen los datos de la operación, y una casilla para
indicar el importe a devolver, que puede ser parcial o total (nunca debe sobrepasar al
importe de la operación original). En el caso de operativa DCC, deberá introducir el importe
en la moneda del TPV:

A continuación le mostrará una página ticket de devolución que podrá imprimir o archivar si
lo desea.

Se podrá consultar una devolución pulsando sobre la opción “Resumen devoluciones”, que
aparecerá en la última columna:
Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier
medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

37
8.4. Informe
Pulsando el apartado “Informe” de la parte izquierda de la pantalla, podrá obtener un
resumen de las operaciones OK y no OK del período seleccionado.

8.5. Consulta de totales


Pulsando el apartado “Totales” de la parte izquierda de la página principal, el sistema
solicitará el período cuyos totales desea consultar y, opcionalmente, la marca de tarjeta.

A continuación aparecerá la pantalla con los importes totales y el número de operaciones,


diferenciadas por cada tipo de operación y una distinción entre las autorizadas y las
denegadas.

Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier
medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

38
8.6. Consulta notificación
Pulsando la opción de “Notificaciones”, que aparece en la parte izquierda de la página, se
podrá consultar el resultado de la Notificación OnLine de las operaciones enviada al
comercio en un rango de fechas deseado y se mostrará el resultado de la Notificación,
informando si ésta ha sido correcta o se ha producido algún error, en cuyo caso se informa
del error.

Puede introducir el número de pedido de la operación, si lo conoce, y la búsqueda será más


rápida.

8.7. Cambio de contraseña


Por motivos de seguridad deberá cambiar su contraseña periódicamente. Para hacerlo
deberá acudir al apartado “usuarios” y rellenar la información.

Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier
medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

39
Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier
medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

40
ANEXO – Parámetros de Entrada – Salida

AUTOR: Redsys VALIDADO POR: Comercio APROBADO POR: Redsys


Electrónico
Empresa: Redsys Empresa: Redsys Empresa: Redsys

Firma: Firma: Firma:

Fecha: 12/04/2019 Fecha: 12/04/2019 Fecha: 12/04/2019

Versión Fecha Afecta Breve descripción del


cambio
2.0 27/3/2019 TODO Versión Inicial

2.1 12/4/2019 .-Hoja DS_MERCHANT_EMV3DS


.-Nueva Hoja ErroresSIS (incluidos errores EMV3DS)
.-Cambios Hoja DS_MERCHANT_MPIEXTERNAL

2.2 25/7/2019 Adaptaciones PSD2

2.3 7/10/2019 Hoja DS_MERCHANT_EMV3DS Actualización de


Hoja DS_EMV3DS parámetros para EMV3DS
Hoja DS_MERCHANT_TRANSACTIONTYPE 2.2

2.4 20/11/2019 Añididos parámetros de la seccion AVANCES Actualización de


Parámetro DIRECT_ PAYMENT parámetros para EMV3DS
2.2
2.5 31/1/2020 Añadidos parámetros de la seccion Parámetros de Actualización de
Salida, Errores SIS parámetros para EMV3DS
2.2 y Errores SIS
2.5.1 6/2/2020 Modificados parámetros de la seccion Parámetros de Modificacion de
Salida y Ds_merchant_transactionType parametros OTA y
TransactionType

Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier
medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

41
ÍNDICE

- Parámetros de Entrada

- Parámetros de Salida

- Errores SIS

- Monedas

- Idiomas

- DS_RESPONSE

- DS_MERCHANT_TRANSACTIONTYPE

- DS_MERCHANT_EMV3DS

- DS_EMV3DS

- Phone

- merchantRiskIndicator

- threeDSRequestorAuthenticationIn

fo

threeDSRequestorPriorAuthenticat

ionInfo

- acctInfo

- DS_MERCHANT_DCC

- DS_MERCHANT_PAYMETHODS

- DS_MERCHANT_MPIEXTERNAL

- DS_DCC

Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier
medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

42
PARÁMETROS DE ENTRADA

TIPO OPERACIÓN
REALIZAR WEBSERVICE DOCUMENTACION
DATO PARAMETRO ENTRADA Long. / Tipo (DS_MERCHANT_ REST CONDICIONALES COMENTARIOS
PAGO SOAP ESPECIFICA
TRANSACTIONTYPE)
Las últimas posiciones hacen
Importe DS_MERCHANT_AMOUNT 12 / N 0,1,3,7,15,17,34,3 OBLIGATORIO OBLIGATORIO OBLIGATORIO referencia a los decimales de la
7 moneda. Ejemplo: En el caso del
EURO 43,45 Euros habría que indicar
4345
Representa el código de
autorización necesario para
Código de DS_MERCHANT_ identificar de manera inequívoca
6 / Num 3 OPCIONAL OPCIONAL OPCIONAL
Autorización AUTHORISATIONCODE la transacción original sobre la
que se desea realizar la
devolución. Este parámetro tiene
sentido en aquellos comercios que
permiten repetir el número de
pedido.
Obligatorio para operativa COF
Visa y MC. Valores posibles:
“S”: Sí es primera transacción COF
Indicador de Especificacion
DS_MERCHANT_COF_INI 1 / AN 0,1,7 OPCIONAL OPCIONAL OPCIONAL (almacenar credenciales)
transcción COF es COF ECom
“N”: No es primera transacción
[Link]
COF Cualquier otro valor no se
tendrá en cuenta y
la operación no se procesará como
COF
Opcional. Este identificador es
devuelto en la respuesta de la
Identificador de Especificacion primera operación COF
DS_MERCHANT_COF_TXNID 15/AN 0,1,7 OPCIONAL OPCIONAL OPCIONAL
transacción COF es COF ECom (almacenamiento de credenciales),
[Link] y deberá enviarse en
transacciones sucesivas
realizadas con las credenciales
que
generaron este mismo Id_txn
Opcional para COF Visa y MC.
Valores posibles:
“I”:
Installments
Tipo de Especificacion “R”:
DS_MERCHANT_COF_TYPE 1 / AN 0,1,7 OPCIONAL OPCIONAL OPCIONAL
transacción COF es COF ECom Recurring
[Link] “H”:
Reauthorization
“E”:
Resubmission
“D”: Delayed

Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o
comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

43
PARÁMETROS DE ENTRADA

“M”:
Incremental
“N”: No Show
“C”: Otras

DS_MERCHANT_ 0, 1, 2, 3, 7, 8, Los valores posibles se incluyen


Idioma del 3/N. 9, 15, 17, OPCIONAL
titular CONSUMERLANGUAGE en la hoja Idiomas
34, 37
Se debe enviar el código numérico
Moneda DS_MERCHANT_CURRENCY 4 / Núm. 0, 1, 3, 7, 15, OBLIGATORIO OBLIGATORIO OBLIGATORIO
17, 34, 37 de la moneda según el ISO-4217, ver
hoja Monedas.
Opcional si se
envía el
CVV2 DS_MERCHANT_CVV2 3-4/N 0, 1, 7, 17, 34, CONDICIONAL CONDICIONAL CONDICIONAL parámetro DS_ Código CVV2 de la tarjeta.
37 MERCHANT_PAN y en
funcion de la
configuración del
comercio
Valores posibles:
“true”: identifica la intención de
Para valor realizar la operación sin
Indicador de pago
DS_MERCHANT_DIRECTPAYMENT 4/N 0,1,7,15,17,37 OPCIONAL OPCIONAL OPCIONAL “moto” TPV- autenticación. Este valor no se
sin autenticación
Virtual Pago tendrá en cuenta si la tarjeta
[Link] está afectada por PSD2. ( En test
ya está activo este control)
“moto”: identifica la operación
como pago MOTO
JSON con la
Variable Este campo contiene toda la
información DS_MERCHANT_EMV3DS 0,1,7,17 OPCIONAL OPCIONAL OPCIONAL
/ JSON información necesaria para
de la Object autenticación EMV3DS (V1 o V2)
autenticación
Obligatorio si se Caducidad de la tarjeta. Su
Caducidad DS_MERCHANT_EXPIRYDATE 4/N 0,1,7,17,34,37 CONDICIONAL CONDICIONAL CONDICIONAL envía el formato es AAMM, siendo AA los dos
parámetro DS_ últimos dígitos del año y MM los
MERCHANT_PAN dos dígitos del mes.
Opcional si se
TPV-Virtual Identificador del código de grupo
Código de grupo DS_MERCHANT_GROUP 9/N 0,1,7,15,17,37 CONDICIONAL CONDICIONAL CONDICIONAL envía el
Pago por asociado a la
parámetro DS_
[Link] referencia
MERCHANT_IDENTIFIER

Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o
comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

44
PARÁMETROS DE ENTRADA

Este parámetro indica la


referencia de la tarjeta a
Obligatorio si no utilizar, o la solicitud de
TPV-Virtual
Referencia DS_MERCHANT_IDENTIFIER 8/N 0,1,7,15,17,38 OPCIONAL CONDICIONAL CONDICIONAL se envía el generar una referencia.
Pago por
parámetro Para generar una nueva referencia
[Link]
DS_MERCHANT_PAN enviar “REQUIRED” en caso de
Webservice SOAP o REST el
parámetro DS_MERCHANT_PAN es
Obligatorio
TPV-Virtual
Identificador
DS_MERCHANT_IDOPER 40/A-N 0,1,7,17,37 OPCIONAL OPCIONAL OPCIONAL Integración Identificador de la operación de
de la operación INSITE
de INSITE inSite. pdf

Identificació
n de DS_MERCHANT_MERCHANTCODE 9/N. 0,1,2,3,7,8,9,15,1 OBLIGATORIO OBLIGATORIO OBLIGATORIO Código FUC asignado al comercio.
comercio: 7,34,37
código FUC
Cadena de datos que no procesará
Datos del DS_MERCHANT_MERCHANTDATA 1024 /A-N 0,1,2,3,7,8,9,15,1 OPCIONAL OPCIONAL OPCIONAL el TPV- Virtual y se devolverán
comercio 7,34,37 de la misma forma en la respuesta
Para la entrada de realizar pago esta
información se mostrará al titular en
Identificaci
DS_MERCHANT_MERCHANTNAME 25/A-N 0,1,2,3,7,8,9,15,1 OPCIONAL OPCIONAL OPCIONAL la pantallas con las
ón de 7,34,37 que este interacciona. En caso de
comercio: no informarse
aparecerá el nombre configurado en
la administración del TPV- Virtual
Si el comercio tiene configurada
URL del
notificación online “HTTP” en el
comercio para DS_MERCHANT_MERCHANTURL 250/A-N 0,1,2,3,7,8,9,15,1 OPCIONAL
la 7,34,37 módulo de administración, se
notificación enviará una petición post con el
“on-line” resultado de la transacción a la
URL especificada
Se recomienda, por posibles
problemas en el proceso de
liquidación, que los 4 primeros
dígitos sean numéricos. Para
Número de Pedido DS_MERCHANT_ORDER 12 / A-N. 0,1,2,3,7,8,9,15,1 OBLIGATORIO OBLIGATORIO OBLIGATORIO
los
7,34,37
dígitos restantes solo utilizar
los siguientes caracteres ASCII:
Del 48 = 0 al 57
= 9 Del 65 = A
al 90 = Z
Del 97 = a al 122 = z
Obligatorio si no
se envía el
parámetro DS_
Tarjeta DS_MERCHANT_PAN 19/N 0,1,7,17,34,37 OPCIONAL CONDICIONAL CONDICIONAL Tarjeta. Su longitud depende del tipo
MERCHANT_IDENTIFIER
de tarjeta.
o el valor de
DS_
MERCHANT_IDENTIFIER
Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o
comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

45
PARÁMETROS DE ENTRADA

es “REQUIRED”

Ver hoja
Forma de pago
DS_MERCHANT_PAYMETHODS 1/A DS_MERCHANT_ OPCIONAL Ver hoja DS_MERCHANT_PAYMETHODS
aplicable
PAYMETHODS
La longitud máxima es 125. Para la
Descripción del DS_MERCHANT_ entrada de realizar pago esta
125 / A-N 0,1,2,3,7,8,9,15,1 OPCIONAL OPCIONAL OPCIONAL
producto PRODUCTDESCRIPTION información se mostrará
7,34,37
al titular en la pantallas con las
que este
interacciona.
Operativa especial de pago de
Código del tributos. Código de barras del
DS_MERCHANT_TAX_REFERENCE 100/N 0 OPCIONAL OPCIONAL OPCIONAL
tributo a pagar tributo en operativa especial
de pago de tributos. Se
requiere activación por parte
de la entidad.
Número de DS_MERCHANT_TERMINAL 3/N. 0,1,2,3,7,8,9,15,1 OBLIGATORIO OBLIGATORIO OBLIGATORIO Número de terminal que le asignará
terminal 7,34,37 su banco.
Su longitud máxima es de 60
caracteres. Para la entrada de
Nombre y
DS_MERCHANT_TITULAR 60/A-N 0,1,2,3,7,8,9,15,1 OPCIONAL OPCIONAL OPCIONAL realizar pago esta información se
apellidos del 7,34,37
titular mostrará al titular en la pantallas
con las que este interacciona. En
la pantalla de pago, el titular
podrá modificar este valor.
Formato yyyy-mm-dd. Representa la
fecha de la operación sobre que
la se realiza
DS_MERCHANT_ la devolución, este campo es
Fecha de la 10 / A-N 3 OPCIONAL OPCIONAL OPCIONAL
TRANSACTIONDATE necesario para identificar de
operación
manera inequívoca la transacción
original sobre la que se desea
realizar la devolución. Este
parámetro tiene sentido en
aquellos comercios que permiten
repetir el número de pedido.
DS_MERCHANT_ Tipo de operación. Ver hoja
Tipo de 1 / Num 0,1,2,3,7,8,9,15,1 OBLIGATORIO OBLIGATORIO OBLIGATORIO
transacción TRANSACTIONTYPE 7,34,37 DS_MERCHANT_
TRANSACTIONTYPE
URL en la que se enviará una
petición HTTP get cuando el
URL KO DS_MERCHANT_URLKO 250/A-N 0,1,2,3,7,8,9,15,1 OPCIONAL resultado de la transacción sea
7,34,37 KO. Si este parámetro no viene
informado

Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o
comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

46
PARÁMETROS DE ENTRADA
se usará la configuración en el
módulo de
administración.

URL en la que se enviará una


petición HTTP get cuando el
URLOK DS_MERCHANT_URLOK 250/A-N 0,1,2,3,7,8,9,15,1 OPCIONAL resultado de la transacción sea
7,34,37 OK. Si este parámetro no viene
informado
se usará la configuración en el
módulo de
administración.
TPV-Virtual
Obligatorio si se
ApplePay - Campo en el que se incluyen los
Datos de XPAY DS_XPAYDATA 10000 / A- 0,1 CONDICIONAL CONDICIONAL envia DS_XPAYORIGEN
Guía de datos del enviados por el xPay en
N y DS_XPAYTYPE
Integración de formato Hexadecimal
los
[Link]
TPV-Virtual
Obligatorio si se Origen de la petición. Los posibles
ApplePay -
Origen XPAY DS_XPAYORIGEN 5 / A-N 0,1 CONDICIONAL CONDICIONAL envia DS_XPAYDATAy valores son: Android
DS_ XPAYTYPE Guía de Apple
Integración de
los
[Link]
TPV-Virtual
Obligatorio si se Tipo de xPay. Los posibles
ApplePay -
Tipo de XPAY DS_XPAYTYPE 10 / A-N 0,1 CONDICIONAL CONDICIONAL envia DS_XPAYORIGEN valores son: WEB
y DS_XPAYDATA Guía de InApp
Integración de
los
[Link]
Indica si entre los campos de
respuesta al comercio se
incluye información relativa a
Indicador de
DS_MERCHANT_ TPV-Virtual la dirección de envío que tiene
obtención de
SHIPPINGADDRESSPYP 1 / N 0,1,15 OPCIONAL Manual el titular
datos de
Integración configurada en su cuenta PayPal.
dirección de
PayPal. pdf Los valores que se pueden indicar
PayPal
en dicho campo son:
· S: si se desea obtener dicha
información en la respuesta
del TPV-Virtual.
· N: se NO se desea obtener
dicha
información en la respuesta del
TPV-Virtual.

Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o
comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

47
PARÁMETROS DE ENTRADA

El valor de este parámetro es de


25 posiciones (caracteres). Si
TPV-Virtual el comercio está configurado
DS_MERCHANT_
Descriptor 25 / A-N 0,1,2,3,7,8,9,15,1 OPCIONAL OPCIONAL OPCIONAL Descriptor para poder enviar este
flexible MERCHANTDESCRIPTOR 7,34,37 Flexible. pdf parámetro y no envía ninguna
información, o no está
configurado, por defecto se
enviará el nombre del comercio.
Requiere activación
por porte de la entidad.
TPV-Virtual- Número de personalización que se
Herramienta desea utilizar en la operación.
Código de
DS_MERCHANT_PERSOCODE 1 / N 0,1,3,7,8,9,15,34, OPCIONAL Personalizació Si no se informa dicho parámetro
personalización 37 n_ Manual o el valor que se informa no
Comercios. pdf corresponde con un número de
personalización activa existente
Obligatorio si se No debe repetirse. Valor que
Matching data DS_MERCHANT_MATCHINGDATA 21/A-N 17 CONDICIONAL
envia DS_ enviará en la respuesta para
ACQUIRER_IDENTIFIER identificar a la petición
Identificado Obligatorio si se Es el valor de la interfaz
r del que DS_ACQUIRER_IDENTIFIER 6/N 17 CONDICIONAL envia PUC, por dónde el comercio
procesará la DS_MERCHANT_ procesará la transacción de
operación MATCHINGDATA autorización.
Parámetros para
DS_MERCHANT_MPIEXTERNAL JSON 0,1,7 OPCIONAL Ver Hoja DS_MERCHANT_MPIEXTERNAL
MPI External
Obligatorio si se
envian DS_MERCHANT_
CUSTOMER_MAIL,DS_
MERCHANT_P2F_ Para informar el número de
Telefóno del DS_MERCHANT_CUSTOMER_
19 /A-N 15 CONDICIONAL CONDICIONAL EXPIRYDATE,DS_ teléfono del titular para
titular para MOBILE
enviar el SMS con el enlace.
PayGold MERCHANT_
CUSTOMER_SMS_
TEXT,DS_MERCHANT_
P2F_XMLDATA
Obligatorio si se
envian DS_MERCHANT_
CUSTOMER_MOBILE,DS_
Mail del MERCHANT_P2F_ Para informar la dirección de mail
titular para DS_MERCHANT_CUSTOMER_MAIL 100 /A-N 15 CONDICIONAL CONDICIONAL EXPIRYDATE,DS_ del titular para enviar
PayGold el enlace.
MERCHANT_
CUSTOMER_SMS_
TEXT,DS_MERCHANT_
P2F_XMLDATA

Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o
comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

48
PARÁMETROS DE ENTRADA

Obligatorio si se Permite especificar la fecha de


envían DS_MERCHANT_ caducidad del enlace siendo posible
CUSTOMER_MOBILE,DS_ especificar la fecha de cada
Fecha de MERCHANT_CUSTOMER_ operación mediante este parámetro.
DS_MERCHANT_P2F_EXPIRYDATE 23/ A-N 15 CONDICIONAL CONDICIONAL
caducidad enlace MAIL,DS_MERCHANT_ El valor del campo podrá ser el
PayGold CUSTOMER_SMS_ número de minutos desde la
operación o la fecha y hora exacta
TEXT,DS_MERCHANT_
de caducidad con el siguiente
P2F_XMLDATA
formato: aaaa-mm-dd-HH:MM:[Link]
(por ejemplo
2014-08-06-[Link])
Personalización de los mensajes
SMS enviados al usuario. Este
campo contendrá una cadena de
texto con los campos relevantes
Obligatorio si se
entre arrobas, es obligatorio
envían DS_MERCHANT_
incluir siempre la URL (@URL@).
CUSTOMER_MOBILE,DS_
Los campos soportados son
Texto del SMS de DS_MERCHANT_CUSTOMER_SMS_ MERCHANT_CUSTOMER_
160/A-N 15 CONDICIONAL CONDICIONAL @COMERCIO@, @IMPORTE@, @MONEDA@ y
PayGold TEXT MAIL,DS_MERCHANT_
@URL@. Se
P2F_EXPIRYDATE,DS_
sustituirán dichos campos por los
MERCHANT_P2F_
valores correspondientes. Es
XMLDATA
recomendable limitar la longitud
del texto (máximo 160 caracteres)
para que se envíe en un único SMS.
Mensaje de ejemplo:
“Esto es un SMS personalizado del
comercio @COMERCIO@. Debe pagar
@IMPORTE@ @ MONEDA@ en la
siguiente url: @URL@”
Personalización de los mensajes de
correo enviados. Dicho campo
permite pasar TAGs para la
personalización. Es importante
escapar los símbolos < > y / como
Obligatorio si se
&lt; &gt; y &#47; así como dejarlos
envían DS_MERCHANT_
dentro del CDATA.
CUSTOMER_MOBILE,DS_
Cualquier error aquí podría
Texto del Mail de MERCHANT_CUSTOMER_
DS_MERCHANT_P2F_XMLDATA 1000/A-N 15 CONDICIONAL CONDICIONAL ocasionar que el XML no esté bien
PayGold MAIL,DS_MERCHANT_
formado y que la petición falle
P2F_EXPIRYDATE,DS_
por lo que es obligatorio escapar
MERCHANT_
también los caracteres especiales
CUSTOMER_SMS_TEXT
como acentos etc.
Los campos que incluye este
parámetro son:
ª nombreComprador: El nombre
del comprador. Sin limitación
de caracteres.
ª direccionComprador: La
dirección del comprador. Sin
limitación de caracteres.
ª textoLibre1: El texto que se

Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o
comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

49
PARÁMETROS DE ENTRADA

incluirá describiendo la
compra. Sin limitación de
carácteres.

Campo
Enviar Y o N para la solicitud de
indicador
DS_MERCHANT_DCC JSON 0 OPCIONAL OPCIONAL iniciaPetición. Para mandar
para la información de DCC ver hoja
solicitud de DS_MERCHANT_DCC
DCC y envio
de
información
DCC
Marzo 2020. Para
iniciaPeticion: Enviar Y o N
Exenciones
para la solicitud de ver las
para PDS2 DS_MERCHANT_EXCEP_SCA 3/A-N 0,1,7 OPCIONAL OPCIONAL OPCIONAL
exenciones posibles. Para
(Marzo 2020)
trataPetición, marcar la
excepción con los siguientes
valores posibles: MIT , LWV, TRA,
COR y ATD. Requiere
activación por parte de la
Entidad.
Marzo 2020. Valor: S (petición
Petición inicial
DS_MERCHANT_OTA 1/N. 7 OPCIONAL OPCIONAL OPCIONAL inicial OTA SI). Petición de
de OTA (Marzo
2020) operación inicial de Autenticación
de Viajes Online (OTA)

Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o
comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

50
PARÁMETROS DE SALIDA

DATO PARAMETRO DE SALIDA Long. / Tipo REALIZAR PAGO WEBSERVICE SOAP REST COMENTARIOS

Fecha DS_DATE dd/mm/yyyy OBLIGATORIO Fecha de la transacción

Hora DS_HOUR HH:mm OBLIGATORIO Hora de la transacción

Importe DS_AMOUNT 12 / Núm. OBLIGATORIO OBLIGATORIO OBLIGATORIO Mismo valor que en la petición.

Moneda DS_CURRENCY 4 / Núm. OBLIGATORIO OBLIGATORIO OBLIGATORIO Mismo valor que en la petición. 4 se considera su longitud máxima.

Número de pedido DS_ORDER 12 / A-N. OBLIGATORIO OBLIGATORIO OBLIGATORIO Mismo valor que en la petición.

Identificación de
DS_MERCHANTCODE 9 / N. OBLIGATORIO OBLIGATORIO OBLIGATORIO Mismo valor que en la petición.
comercio: código FUC

Terminal DS_TERMINAL 3 / Núm. OBLIGATORIO OBLIGATORIO OBLIGATORIO Número de terminal que le asignará su banco. 3 se considera su longitud
máxima.
Valor que indica el resultado de la operación. Indicará si ha sido
Código de respuesta DS_RESPONSE 4 / Núm. OBLIGATORIO OBLIGATORIO OBLIGATORIO
autorizada o no. Ver hoja DS_RESPONSE

Datos del comercio DS_MERCHANTDATA 1024 / A-N OBLIGATORIO OBLIGATORIO OBLIGATORIO Información opcional enviada por el comercio en el formulario de pago.

0 – Si el pago NO es
seguro 1 – Si el pago
Pago Seguro DS_SECUREPAYMENT 1 / Núm. OBLIGATORIO
es seguro
(Si el comercio tiene habilitada la opción de más información: recibirá
los siguientes valores 0 (No seguro), 1(Attems), 2 ( pago seguro)

0 – Si el pago NO es seguro
Pago Seguro DS_SECUREPAYMENT 1 / Núm. OBLIGATORIO OBLIGATORIO 1 – Si el pago attems ( Comercio seguro -
Titular no seguro) 2 – Si el pago es seguro

Tipo de operación DS_TRANSACTIONTYPE 1 / A-N OBLIGATORIO OBLIGATORIO OBLIGATORIO Tipo de operación que se envió en el formulario de pago

Opcional: País de emisión de la tarjeta con la que se ha intentado


País del titular DS_CARD_COUNTRY 3/Núm OPCIONAL OPCIONAL OPCIONAL realizar el pago. En el siguiente enlace es posible consultar los
códigos de país y su correspondencia: [Link]
[Link]/unsd/methods/m49/[Link]

Código alfanumérico de autorización asignado a la aprobación de la


Código de autorización DS_AUTHORISATIONCODE 6/ A-N OPCIONAL OPCIONAL OPCIONAL
transacción por la institu- ción autorizadora.

Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o
comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

51
PARÁMETROS DE SALIDA

Idioma del titular DS_CONSUMERLANGUAGE 3 / Núm OPCIONAL El valor 0, indicará que no se ha determinado el idioma del cliente.

Valores
Tipo de Tarjeta DS_CARD_TYPE 1 / A-N OPCIONAL OPCIONAL OPCIONAL posibles:
C – Crédito
D – Débito
No se debe hacer una validación cerrada sobre estos valores, pues
pueden variar y/o añadirse nuevos. Valores posibles:
1 – VISA
2 –MASTERCARD
Marca de Tarjeta DS_CARD_BRAND 2 / Núm OPCIONAL OPCIONAL OPCIONAL 8 – AMEX
9 – JCB
22 – UPI
6 – DINERS
22 – CUP
7 - PRIVADA

Número de tarjeta DS_CARDNUMBER 19/N OPCIONAL OPCIONAL Tarjeta. Su longitud depende del tipo de tarjeta.

Caducidad de la tarjeta. Su formato es AAMM, siendo AA los dos últimos


Fecha caducidad de la DS_EXPITYDATE 4/N OPCIONAL OPCIONAL
tarjeta dígitos del año y MM los dos dígitos del mes.

Referencia de la tarjeta DS_MERCHANT_IDENTIFIER 8/N OPCIONAL OPCIONAL Este parámetro indica la referencia de la tarjeta a utilizar

Código de error DS_ERRORCODE 7/A-N OPCIONAL Código de error

Código de error CODIGO 7/A-N OBLIGATORIO Código de error

Código de error ERRORCODE 7/A-N OPCIONAL Código de error

Enlace de pago Paygold DS_URLPAGO2FASES Max 80 /A-N OPCIONAL OPCIONAL Código de error

Firma DS_SIGNATURE 44 / A-N OBLIGATORIO Firma de la petición de respuesta

Información sobre DCC DS_DCC Json OPCIONAL OPCIONAL Información sobre DCC, ver campo DS_DCC

Información sobre pago DS_EMV3DS Json OPCIONAL OPCIONAL OPCIONAL Ver Hoja DS_EMV3DS
seguro
Tarjeta afectada por PSD2 DS_CARD_PSD2 1/A-N OBLIGATORIO OBLIGATORIO Parámetro de respuesta en iniciaPeticion. Valores posibles: Y (Si
afectada) o N (no afectada)
Parámetro de respuesta en iniciaPeticion. Valores posibles un
Excepciones permitidas Ds_Excep_SCA Max 40 /A-N OPCIONAL OPCIONAL OPCIONAL
subconjunto de: LWV; TRA [30.0]; COR; MIT; ATD; WHL

Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o
comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

52
ERRORES SIS

Código Respuesta2 Error SIS0XXX Descripción

9001 SIS0001 Error genérico. Consulte con Soporte

9002 SIS0002 Error genérico. Consulte con Soporte

9003 SIS0003 Error genérico. Consulte con Soporte

9004 SIS0004 Error genérico. Consulte con Soporte

9005 SIS0005 Error genérico. Consulte con Soporte

9006 SIS0006 Error genérico. Consulte con Soporte

9007 SIS0007 El mensaje enviado por el comercio no es correcto

9008 SIS0008 falta Ds_Merchant_MerchantCode

9009 SIS0009 Error de formato en Ds_Merchant_MerchantCode

9010 SIS0010 Error falta Ds_Merchant_Terminal

9011 SIS0011 Error de formato en Ds_Merchant_Terminal

9012 SIS0012 Error genérico. Consulte con Soporte

9013 SIS0013 Error genérico. Consulte con Soporte

9014 SIS0014 Error de formato en Ds_Merchant_Order

9015 SIS0015 Falta Ds_Merchant_Currency

9016 SIS0016 Error de formato en Ds_Merchant_Currency

9018 SIS0018 Falta Ds_Merchant_Amount

9019 SIS0019 Falta Ds_Merchant_Amount

9020 SIS0020 Falta Ds_Merchant_MerchantSignature

9021 SIS0021 Ds_Merchant_MerchantSignature viene vacía

9022 SIS0022 Error de formato en Ds_Merchant_TransactionType

9023 SIS0023 Ds_Merchant_TransactionType desconocido

9024 SIS0024 Error Ds_Merchant_ConsumerLanguage tiene mas de 3 posiciones

9025 SIS0025 Error de formato en Ds_Merchant_ConsumerLanguage

9026 SIS0026 No existe el comercio / terminal enviado

9027 SIS0027 Error Moneda enviada por el comercio

9028 SIS0028 Comercio / terminal está dado de baja

9029 SIS0029 Error genérico. Consulte con Soporte

9030 SIS0030 tipo de operación errónea

9031 SIS0031 método de pago erróneo

9032 SIS0032 Error al montar el mensaje para una devolución

9033 SIS0033 tipo de operación es erróneo

9034 SIS0034 Error en el acceso a la BBDD

9035 SIS0035 Error genérico. Consulte con Soporte

9037 SIS0037 El número de teléfono no es válido

Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier
medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

53
ERRORES SIS

9038 SIS0038 Error genérico. Consulte con Soporte

9039 SIS0039 Error genérico. Consulte con Soporte

9040 SIS0040 El comercio / terminal no tiene ningún método de pago asignado

9041 SIS0041 Error en el cálculo de la firma

9042 SIS0042 Error en el cálculo de la firma

9043 SIS0043 Error genérico. Consulte con Soporte

9044 SIS0044 Error genérico. Consulte con Soporte

9046 SIS0046 El bin de la tarjeta no está dado de alta en FINANET

9047 SIS0047 Error genérico. Consulte con Soporte

9048 SIS0048 Error genérico. Consulte con Soporte

9049 SIS0049 Error genérico. Consulte con Soporte

9050 SIS0050 Error genérico. Consulte con Soporte

9051 SIS0051 Número de pedido repetido

9052 SIS0052 Error genérico. Consulte con Soporte


9053 SIS0053 Error genérico. Consulte con Soporte

9054 SIS0054 No existe operación sobre la que realizar la devolución

9055 SIS0055 existe más de un pago con el mismo número de pedido

9056 SIS0056 La operación sobre la que se desea devolver no está autorizada

9057 SIS0057 El importe a devolver supera el permitido

9058 SIS0058 Los datos de la validación son erróneos

9059 SIS0059 No existe operación sobre la que realizar la confirmación

9060 SIS0060 Ya existe una confirmación asociada a la preautorización

9061 SIS0061 La preautorización sobre la que se desea confirmar no está autorizada

9062 SIS0062 El importe a confirmar supera el permitido

9063 SIS0063 Número de tarjeta no valido.

9064 SIS0064 Número de posiciones de la tarjeta incorrecto

9065 SIS0065 El número de tarjeta no es numérico

9066 SIS0066 Error en el mes de caducidad

9067 SIS0067 El mes de la caducidad no es numérico

9068 SIS0068 El mes de la caducidad no es válido

9069 SIS0069 Año de caducidad no valido

9070 SIS0070 El Año de la caducidad no es numérico

9071 SIS0071 Tarjeta caducada

9072 SIS0072 Operación no anulable

9073 SIS0073 Error en la anulación

9074 SIS0074 Falta Ds_Merchant_Order ( Pedido)

Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier
medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

54
ERRORES SIS

9075 SIS0075 El “Ds_Merchant_Order” tiene menos de 4 o más de 12 posiciones .

9077 SIS0077 Error de formato en Ds_Merchant_Order

9078 SIS0078 Tipo de operación no permitida para esa tarjeta

9079 SIS0079 Error genérico. Consulte con Soporte

9080 SIS0080 Error genérico. Consulte con Soporte

9081 SIS0081 Se han perdido los datos de la sesión

9082 SIS0082 Error genérico. Consulte con Soporte

9083 SIS0083 Error genérico. Consulte con Soporte

9084 SIS0084 El valor de Ds_Merchant_Conciliation es nulo

9085 SIS0085 El valor de Ds_Merchant_Conciliation no es numérico

9086 SIS0086 El valor de Ds_Merchant_Conciliation no ocupa 6 posiciones

9087 SIS0087 El valor de Ds_Merchant_Session es nulo

9088 SIS0088 El valor de Ds_Merchant_Session no es numérico

9089 SIS0089 El valor de caducidad no ocupa 4 posiciones


9090 SIS0090 Error genérico. Consulte con Soporte

9091 SIS0091 Error genérico. Consulte con Soporte

9092 SIS0092 El valor de caducidad es nulo

9093 SIS0093 Denegación emisor

9094 SIS0094 Denegación emisor

9095 SIS0095 Denegación emisor

9097 SIS0097 Valor del campo Ds_Merchant_CComercio no válido

9098 SIS0098 Valor del campo Ds_Merchant_CVentana no válido

9098 SIS0099 Error genérico. Consulte con Soporte

9103 SIS0103 Error genérico. Consulte con Soporte

9104 SIS0104 Comercio con “titular seguro” y titular sin clave de compra segura

9112 SIS0112 El tipo de transacción especificado en Ds_Merchant_Transaction_Type no está


permitido
9113 SIS0113 Error genérico. Consulte con Soporte

9114 SIS0114 Se está realizando la llamada por GET, la tiene que realizar por POST

9115 SIS0115 No existe operación sobre la que realizar el pago de la cuota

9116 SIS0116 La operación sobre la que se desea pagar una cuota no es una operación válida

9117 SIS0117 La operación sobre la que se desea pagar una cuota no está autorizada

9118 SIS0118 Se ha excedido el importe total de las cuotas

9119 SIS0119 Valor del campo Ds_Merchant_DateFrecuency no válido

9120 SIS0120 Valor del campo Ds_Merchant_ChargeExpiryDate no válido

9121 SIS0121 Valor del campo Ds_Merchant_SumTotal no válido

9122 SIS0122 Formato incorrecto del campo Ds_Merchant_DateFrecuency o Ds_Merchant_SumTotal

Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier
medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

55
ERRORES SIS

9123 SIS0123 Se ha excedido la fecha tope para realiza la Transacción

9124 SIS0124 No ha transcurrido la frecuencia mínima en un pago recurrente sucesivo

9125 SIS0125 Error genérico. Consulte con Soporte

9126 SIS0126 Operación Duplicada

9127 SIS0127 Error genérico. Consulte con Soporte

9128 SIS0128 Error genérico. Consulte con Soporte

9130 SIS0130 Error genérico. Consulte con Soporte

9131 SIS0131 Error genérico. Consulte con Soporte

9132 SIS0132 La fecha de Confirmación de Autorización no puede superar en más de 7 dias a


la de Preautorización.
9133 SIS0133 La fecha de Confirmación de Autenticación no puede superar en más de 45 días a la
de Autenticación Previa
9134 SIS0134 El valor del Ds_MerchantCiers enviado no es válido

9139 SIS0139 El pago recurrente inicial está duplicado

9140 SIS0140 Error genérico. Consulte con Soporte

9142 SIS0142 Tiempo excedido para el pago


9151 SIS0151 Error genérico. Consulte con Soporte

9169 SIS0169 Valor PUCE Ds_Merchant_MatchingData no válido

9170 SIS0170 Valor PUCE Ds_Acquirer_Identifier no válido

9171 SIS0171 Valor PUCE Ds_Merchant_Csb no válido

9172 SIS0172 El valor del campo PUCE Ds_Merchant_MerchantCode no es válido

9173 SIS0173 El valor del campo PUCE Ds_Merchant_UrlOK no válido

9174 SIS0174 Error genérico. Consulte con Soporte

9175 SIS0175 Error genérico. Consulte con Soporte

9181 SIS0181 Error genérico. Consulte con Soporte

9182 SIS0182 Error genérico. Consulte con Soporte

9183 SIS0183 Error genérico. Consulte con Soporte

9184 SIS0184 Error genérico. Consulte con Soporte

9186 SIS0186 Faltan datos para operación

9187 SIS0187 Error genérico. Consulte con Soporte

9197 SIS0197 Error al obtener los datos de cesta de la compra

9214 SIS0214 El comercio no permite devoluciones. Se requiere usar firma ampliada.

9216 SIS0216 El CVV2 tiene más de 3 posiciones

9217 SIS0217 Error de formato en el CVV2

9218 SIS0218 El comercio no permite operaciones seguras por entradas Host to Host

9219 SIS0219 El número de operaciones de la tarjeta supera el límite permitido para el


comercio
9220 SIS0220 El importe acumulado de la tarjeta supera el límite permitido para el
comercio
9221 SIS0221 El CVV2 es obligatorio

Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier
medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

56
ERRORES SIS

9222 SIS0222 Ya existe una anulación asociada a la preautorización

9223 SIS0223 La preautorización que se desea anular no está autorizada

9224 SIS0224 El comercio no permite anulaciones por no tener firma ampliada

9225 SIS0225 No existe operación sobre la que realizar la anulación

9226 SIS0226 Error en los datos de la anulación

9227 SIS0227 Valor del campo Ds_Merchant_TransactionDate no válido

9228 SIS0228 Sólo se puede hacer pago aplazado con tarjeta de crédito On-us

9229 SIS0229 No existe el código de pago aplazado solicitado

9230 SIS0230 El comercio no está configurado para aceptar pago fraccionado o el código
de fraccionamiento que nos envía no está dado de alta.

9231 SIS0231 No hay forma de pago aplicable

9232 SIS0232 Forma de pago no disponible

9233 SIS0233 Forma de pago desconocida


9234 SIS0234 Nombre del titular de la cuenta no disponible

9235 SIS0235 Campo Sis_Numero_Entidad no disponible

9236 SIS0236 El valor del campo Sis_Numero_Entidad no tiene la longitud requerida

9237 SIS0237 El valor del campo Sis_Numero_Entidad no es numérico

9238 SIS0238 El valor del Campo Sis_Numero_Oficina no está disponible

9239 SIS0239 El valor del campo Sis_Numero_Oficina no tiene la longitud requerida

9240 SIS0240 El Valor del campo Sis_Numero_Oficina no es numérico

9241 SIS0241 Campo Sis_Numero_DC no disponible

9242 SIS0242 El valor del campo Sis_Numero_DC no tiene la longitud requerida

9243 SIS0243 El Valor del campo Sis_Numero_DC no es numérico

9244 SIS0244 Campo Sis_Numero_Cuenta no disponible

9245 SIS0245 El Valor del campo Sis_Numero_Cuenta no tiene la longitud requerida

9246 SIS0246 El Valor del campo Sis_Numero_Cuenta no es numérico

9247 SIS0247 Dígito de Control de Cuenta Cliente no válido

9248 SIS0248 El comercio no permite pago por domiciliación

9249 SIS0249 Error genérico. Consulte con Soporte

9250 SIS0250 Error genérico. Consulte con Soporte

9251 SIS0251 El comercio no permite pago por transferencia

9252 SIS0252 Por su configuración no puede enviar la tarjeta

9253 SIS0253 Tarjeta no cumple check digit

9254 SIS0254 El número de operaciones de la IP supera el límite permitido por el comercio

9255 SIS0255 El importe acumulado por la IP supera el límite permitido por el comercio

9256 SIS0256 El comercio no permite operativa de preautorización

Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier
medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

57
ERRORES SIS

9257 SIS0257 La tarjeta no permite operativa de preautorización

9258 SIS0258 No se tiene el IDETRA emisor necesario para realizar la confirmación

9259 SIS0259 No existe la operación original para notificar o consultar

9260 SIS0260 Entrada incorrecta al SIS

9261 SIS0261 Restricciones superadas

9262 SIS0262 Moneda no permitida para operación de transferencia o domiciliación

9263 SIS0263 Error calculando datos para procesar operación

9264 SIS0264 Error procesando datos de respuesta recibidos

9265 SIS0265 Error de firma en los datos recibidos

9266 SIS0266 No se pueden recuperar los datos de la operación recibida

9267 SIS0267 La operación no se puede procesar por no existir Código Cuenta Cliente

9268 SIS0268 La devolución no se puede procesar por WebService

No se pueden realizar devoluciones de operaciones de domiciliación no


9269 SIS0269
descargadas

9270 SIS0270 El comercio no puede realizar preautorizaciones en diferido

9274 SIS0274 Tipo de operación desconocida o no permitida por esta entrada al SIS

9275 SIS0275 Premio sin IdPremio

9276 SIS0276 Unidades del Premio no numéricas.

9277 SIS0277 Error genérico. Consulte con Soporte

9278 SIS0278 Error en el proceso de consulta de premios

9279 SIS0279 El comercio no tiene activada la operativa de fidelización

9280 SIS0280 Bloqueo por control de Seguridad

9281 SIS0281 Bloqueo por control de Seguridad

9282 SIS0282 Bloqueo por control de Seguridad

9283 SIS0283 Bloqueo por control de Seguridad

9284 SIS0284 No existe operación sobre la que realizar el Pago Adicional

9285 SIS0285 No existe operación sobre la que realizar el Pago Adicional


La operación sobre la que se quiere hacer la operación adicional no está
9286 SIS0286
Aceptada
9287 SIS0287 la Operación ha sobrepasado el importe para el Pago Adicional

9288 SIS0288 No se puede realizar otro pago Adicional. se ha superado el número de pagos

9289 SIS0289 El importe del pago Adicional supera el máximo días permitido

9290 SIS0290 Bloqueo por control de Seguridad

9291 SIS0291 Bloqueo por control de Seguridad

9292 SIS0292 Bloqueo por control de Seguridad

9293 SIS0293 Bloqueo por control de Seguridad

9294 SIS0294 La tarjeta no es Privada

9295 SIS0295 Error de duplicidad de operación. Se puede intentar de nuevo

Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier
medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

58
ERRORES SIS

9296 SIS0296 No se encuentra la operación Tarjeta en Archivo inicial

9297 SIS0297 Número de operaciones sucesivas de Tarjeta en Archivo superado

9298 SIS0298 El comercio no permite realizar operaciones de Tarjeta en Archivo

9299 SIS0299 Error en pago con PayPal

9300 SIS0300 Error en pago con PayPal

9301 SIS0301 Error en pago con PayPal

9302 SIS0302 Moneda no válida para pago con PayPal

9304 SIS0304 No se permite pago fraccionado si la tarjeta no es de FINCONSUM

9305 SIS0305 No se permite pago fraccionado FINCONSUM en moneda diferente de euro

9306 SIS0306 Valor del campo Ds_Merchant_PrepaidCard no válido

9307 SIS0307 Operativa de tarjeta regalo no permitida

9308 SIS0308 Tiempo límite para recarga de tarjeta regalo superado

9309 SIS0309 Faltan datos adicionales para realizar la recarga de tarjeta prepago

9310 SIS0310 Valor del campo Ds_Merchant_Prepaid_Expiry no válido

9311 SIS0311 Error genérico. Consulte con Soporte

9319 SIS0319 El comercio no pertenece al grupo enviado en Ds_Merchant_Group

9320 SIS0320 Error generando la referencia


El identificador indicado en Ds_Merchant_Identifier no está asociado al
9321 SIS0321
comercio
9322 SIS0322 Error de formato en Ds_Merchant_Group

9323 SIS0323 Es necesario el campo Ds_Merchant_Customer_Mobile o Ds_Merchant_Customer_Mail

9324 SIS0324 Imposible enviar link al titular

9326 SIS0326 Se han enviado datos de tarjeta en fase primera de un pago con dos fases

9327 SIS0327 No se ha enviado ni móvil ni email en fase primera de un pago con dos fases

9328 SIS0328 Token de pago en dos fases inválido

9329 SIS0329 No se puede recuperar el Token de pago en dos fases

9330 SIS0330 Fechas incorrectas de pago dos fases

9331 SIS0331 La operación no tiene un estado válido o no existe.

9332 SIS0332 El importe de la operación original y de la devolución debe ser idéntico

9333 SIS0333 Error en una petición a MasterPass Wallet

9334 SIS0334 Bloqueo por control de Seguridad

9334 SIS0334 Bloqueo por control de Seguridad

9335 SIS0335 El valor del campo Ds_Merchant_Recharge_Commission no es válido

9336 SIS0336 Error genérico. Consulte con Soporte

9337 SIS0337 Error genérico. Consulte con Soporte

9338 SIS0338 No se encuentra la operación iUPAY

9339 SIS0339 El comercio no dispone de pago iUPAY

Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier
medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

59
ERRORES SIS

9340 SIS0340 Respuesta recibida desde iUPAY no válida

9341 SIS0341 Error genérico. Consulte con Soporte

9342 SIS0342 El comercio no permite realizar operaciones de pago de tributos

9343 SIS0343 Falta o es incorrecto el parámetro Ds_Merchant_Tax_Reference

9344 SIS0344 No se han aceptado las condiciones de las cuotas

9345 SIS0345 Se ha elegido un número de plazos incorrecto

9346 SIS0346 Error en el formato del campo DS_MERCHANT_PAY_TYPE

9347 SIS0347 El comercio no está configurado para realizar la consulta de BIN.

9348 SIS0348 El BIN indicado en la consulta no se reconoce

9349 SIS0349 Los datos de importe y DCC enviados no coinciden con los registrados en SIS

9350 SIS0350 No hay datos DCC registrados en SIS para este número de pedido

9351 SIS0351 Autenticación prepago incorrecta

9352 SIS0352 El tipo de firma del comercio no permite ésta operativa

9353 SIS0353 El comercio no tiene definida una clave 3DES válida

9354 SIS0354 Error descifrando petición


El comercio-terminal enviado en los datos cifrados no coincide con el enviado
9355 SIS0355
en la petición
Existen datos de entrada para control de fraude y el comercio no tiene activo
9356 SIS0356
control de fraude
El comercio tiene activo control de fraude y no existe campo
9357 SIS0357
ds_merchant_merchantscf
9358 SIS0358 La entidad no dispone de pago iUPAY

9370 SIS0370 Error en formato Scf_Merchant_Nif. Longitud máxima 16

9371 SIS0371 Error en formato Scf_Merchant_Name. Longitud máxima 30

9372 SIS0372 Error en formato Scf_Merchant_First_Name. Longitud máxima 30

9373 SIS0373 Error en formato Scf_Merchant_Last_Name. Longitud máxima 30

9374 SIS0374 Error en formato Scf_Merchant_User. Longitud máxima 45


Error en formato Scf_Affinity_Card. Valores posibles ‘S’ o ‘N’. Longitud
9375 SIS0375
máxima 1
Error en formato Scf_Payment_Financed. Valores posibles ‘S’ o ‘N’. Longitud
9376 SIS0376
máxima 1
9377 SIS0377 Error en formato Scf_Ticket_Departure_Point. Longitud máxima 30

9378 SIS0378 Error en formato Scf_Ticket_Destination. Longitud máxima 30


Error en formato Scf_Ticket_Departure_Date. Debe tener formato
9379 SIS0379
yyyyMMddHHmmss.
9380 SIS0380 Error en formato Scf_Ticket_Num_Passengers. Longitud máxima 1.

9381 SIS0381 Error en formato Scf_Passenger_Dni. Longitud máxima 16.

9382 SIS0382 Error en formato Scf_Passenger_Name. Longitud máxima 30.

9383 SIS0383 Error en formato Scf_Passenger_First_Name. Longitud máxima 30.

9384 SIS0384 Error en formato Scf_Passenger_Last_Name. Longitud máxima 30.


Error en formato Scf_Passenger_Check_Luggage. Valores posibles ‘S’ o ‘N’.
9385 SIS0385
Longitud máxima 1.
Error en formato Scf_Passenger_Special_luggage. Valores posibles ‘S’ o ‘N’.
9386 SIS0386
Longitud máxima 1.
Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier
medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

60
ERRORES SIS

Error en formato Scf_Passenger_Insurance_Trip. Valores posibles ‘S’ o ‘N’.


9387 SIS0387
Longitud máxima 1.
Error en formato Scf_Passenger_Type_Trip. Valores posibles ‘N’ o ‘I’.
9388 SIS0388
Longitud máxima 1.
Error en formato Scf_Passenger_Pet. Valores posibles ‘S’ o ‘N’. Longitud
9389 SIS0389
máxima 1.
Error en formato Scf_Order_Channel. Valores posibles ‘M’(móvil), ‘P’(PC) o
9390 SIS0390
‘T’(Tablet)
Error en formato Scf_Order_Total_Products. Debe tener formato numérico y
9391 SIS0391
longitud máxima de 3.
Error en formato Scf_Order_Different_Products. Debe tener formato numérico y
9392 SIS0392
longitud máxima de 3.
Error en formato Scf_Order_Amount. Debe tener formato numérico y longitud
9393 SIS0393
máxima de 19.
Error en formato Scf_Order_Max_Amount. Debe tener formato numérico y longitud
9394 SIS0394
máxima de 19.

9395 SIS0395 Error en formato Scf_Order_Coupon. Valores posibles ‘S’ o ‘N’

9396 SIS0396 Error en formato Scf_Order_Show_Type. Debe longitud máxima de 30.

9397 SIS0397 Error en formato Scf_Wallet_Identifier

9398 SIS0398 Error en formato Scf_Wallet_Client_Identifier

9399 SIS0399 Error en formato Scf_Merchant_Ip_Address

9400 SIS0400 Error en formato Scf_Merchant_Proxy


Error en formato Ds_Merchant_Mail_Phone_Number. Debe ser numérico y de
9401 SIS0401
longitud máxima 19
9402 SIS0402 Error en llamada a SafetyPay para solicitar token url

9403 SIS0403 Error en proceso de solicitud de token url a SafetyPay

9404 SIS0404 Error en una petición a SafetyPay

9405 SIS0405 Solicitud de token url denegada SAFETYPAY


El sector del comercio no está permitido para realizar un pago de premio de
9406 SIS0406
apuesta (Gambling)
El importe de la operación supera el máximo permitido para realizar un pago
9407 SIS0407
de premio de apuesta (Gambling)
La tarjeta debe de haber operado durante el último año para poder realizar un
9408 SIS0408
pago de premio de apuesta (Gambling)
La tarjeta debe ser una Visa o MasterCard nacional para realizar un pago de premio
9409 SIS0409
de apuesta (Gambling)
Bloqueo por Operación con Tarjeta Privada del Cajamar, en comercio que no es
9410 SIS0410
de Cajamar
9411 SIS0411 No existe el comercio en la tabla de datos adicionales de RSI Directo

9412 SIS0412 La firma enviada no es correcta


9413 SIS0413 La operación ha sido denegada por Lynx

9414 SIS0414 El plan de ventas no es correcto

9415 SIS0415 El tipo de producto no es correcto

9416 SIS0416 Importe no permitido en devolución

9417 SIS0417 Fecha de devolución no permitida

9418 SIS0418 No existe plan de ventas vigente

9419 SIS0419 Tipo de cuenta no permitida

9420 SIS0420 El comercio no dispone de formas de pago para esta operación

Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier
medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

61
ERRORES SIS

9421 SIS0421 Tarjeta no permitida. No es producto Agro

9422 SIS0422 Faltan datos para operación Agro

9423 SIS0423 CNPJ del comercio incorrecto

9424 SIS0424 No se ha encontrado el establecimiento

9425 SIS0425 No se ha encontrado la tarjeta

9426 SIS0426 Enrutamiento no valido para el comercio

9427 SIS0427 La conexión con CECA no ha sido posible

9428 SIS0428 Operación debito no segura

9429 SIS0429 Error en la versión (Ds_SignatureVersion)

9430 SIS0430 Error al decodificar el parámetro Ds_MerchantParameters

Error del objeto JSON que se envía codificado en el parámetro


9431 SIS0431
Ds_MerchantParameters

9432 SIS0432 FUC del comercio erróneo

9433 SIS0433 Terminal del comercio erróneo

9434 SIS0434 Formato de pedido no válido

9435 SIS0435 Error genérico. Consulte con Soporte

9436 SIS0436 Error en la construcción del elemento <REQUEST>

9437 SIS0437 Error en la construcción del elemento <DS_SIGNATUREVERSION>

9438 SIS0438 Error en la construcción del elemento <DATOSENTRADA>

9439 SIS0439 Error en la construcción del elemento <DS_SIGNATURE>

9440 SIS0440 Error genérico. Consulte con Soporte

9442 SIS0442 Error genérico. Consulte con Soporte

9443 SIS0443 No se permite pago en terminales ONEY con tarjetas ajenas


Se está intentando acceder usando firmas antiguas y el comercio está configurado
9444 SIS0444
como HMAC SHA256
9445 SIS0445 Error genérico. Consulte con Soporte

9446 SIS0446 Para terminales Oney es obligatorio indicar la forma de pago

9448 SIS0448 El comercio no tiene el método de Pago Diners

9449 SIS0449 El comercio tiene configurado “Prohibir Pago A”

9450 SIS0450 El comercio tiene configurado Prohibir Pago A AMEX”

9451 SIS0451 El comercio tiene el método de pago “Prohibir Pago A”

9453 SIS0453 El comercio no tiene configurado método de pago “Pago JCB”

9454 SIS0454 El comercio no tiene configurado método de pago “Pago Amex”

9455 SIS0455 El comercio no tiene el método de pago “Tarjetas Propias”

9456 SIS0456 El comercio no tiene configurado Segundo Intento

9459 SIS0459 El comercio no tiene configurado el método de pago “Pago JCB”

9460 SIS0460 El comercio no tiene el método de pago “Pago AMEX”

9461 SIS0461 El comercio no tiene el método de pago “Pago AMEX”

Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier
medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

62
ERRORES SIS

9462 SIS0462 Método de pago Seguro no disponible por la entrada Host to Host

El comercio está intentando realizar una operación no segura sin método de


9463 SIS0463
pago No seguro

9464 SIS0464 El comercio no tiene el método de pago “MasterCard Comercial”

9465 SIS0465 El comercio no tiene el método de pago “Tradicional Mundial”

9466 SIS0466 La referencia que se está utilizando no existe.

9467 SIS0467 La referencia que se está utilizando está dada de baja

Se está utilizando una referencia que se generó con un adquirente distinto al


9468 SIS0468
adquirente que la utiliza.

9469 SIS0469 No se ha superado el proceso de fraude MR

9470 SIS0470 La solicitud del primer factor ha [Link]

9471 SIS0471 Error en la URL de redirección de solicitud del primer [Link]

9472 SIS0472 Error al montar la petición de Autenticación de PPII

9473 SIS0473 La respuesta de la petición de Autenticación de PPII es nula.

9474 SIS0474 El statusCode de la respuesta de la petición de Autenticación de PPII es nulo

El idOperación de la respuesta de la petición de Autenticación de PPII es


9475 SIS0475
nulo
9476 SIS0476 Error tratando la respuesta de la Autenticación de PPII

9477 SIS0477 Se ha superado el tiempo definido entre el paso 1 y 2 de PPI

9478 SIS0478 Error tratando la respuesta de la Autorización de PPII

9479 SIS0479 La respuesta de la petición de Autorización de PPII es nula

9480 SIS0480 El statusCode de la respuesta de la petición de Autorización de PPII es nulo.

9481 SIS0481 El comercio no es Payment Facilitator


El idOperación de la respuesta de una Autorización OK es nulo o no coincide
9482 SIS0482
con el idOp. de la Auth.
9483 SIS0483 La respuesta de la petición de devolución de PPII es nula.
El statusCode o el idPetición de la respuesta de la petición de Devolución de
9484 SIS0484
PPII es nulo.
9485 SIS0485 BIZUM ha devuelto un KO en la devolución

9486 SIS0486 La respuesta a la consulta PPII es nula

9487 SIS0487 El comercio no tiene habilitado el método de pago Paygold

9488 SIS0488 El comercio no tiene el método de pago “Pago MOTO/Manual”

9489 SIS0489 Operación MPI Externo no permitida

9490 SIS0490 Se reciben parámetros MPI Soporte en operación MPI Externo

9491 SIS0491 SecLevel no permitido en operación MPI Externo

9492 SIS0492 Se reciben parámetros MPI Externo en operación MPI Soporte


9493 SIS0493 Se reciben parámetros de MPI en operación no segura
9494 SIS0494 Firma Obsoleta

9495 SIS0495 Configuración incorrecta ApplePay o AndroidPay

9496 SIS0496 No tiene dado de alta el método de pago AndroidPay

9497 SIS0497 No tiene dado de alta el método de pago ApplePay

Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier
medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

63
ERRORES SIS

9498 SIS0498 moneda / importe de la operación de ApplePay no coinciden

9499 SIS0499 Error obteniendo claves del comercio en Android/Apple Pay

9500 SIS0500 Error en el DCC Dinámico, se ha modificado la tarjeta.

9501 SIS0501 Error en La validación de datos enviados para genera el Id operación

9502 SIS0502 Error al validar Id Oper

9503 SIS0503 Error al validar el pedido

9504 SIS0504 Error al validar tipo de transacción

9505 SIS0505 Error al validar moneda

9506 SIS0506 Error al validar el importe

9507 SIS0507 Id Oper no tiene vigencia

9508 SIS0508 Error al validar Id Oper

9510 SIS0510 No se permite el envío de datos de tarjeta si se envía ID de operación

9511 SIS0511 Error en la respuesta de consulta de BINES

9515 SIS0515 El comercio tiene activado pago Amex en Perfil.

9516 SIS0516 Error al montar el mensaje de China Union Pay

9517 SIS0517 Error al establecer la clave para China Union Pay

9518 SIS0518 Error al grabar los datos para pago China Union Pay

9519 SIS0519 Mensaje de autenticación erróneo

9520 SIS0520 El mensaje SecurePlus de sesión está vacío

9521 SIS0521 El xml de respuesta viene vacío

9522 SIS0522 No se han recibido parámetros en datosentrada

9523 SIS0523 La firma calculada no coincide con la recibida en la respuesta

el resultado de la autenticación 3DSecure MasterCard es PARes=”A” o


9524 SIS0524
VERes=”N” y no recibimos CAVV del emisor

9525 SIS0525 No se puede utilizar la tarjeta privada en este comercio

9526 SIS0526 La tarjeta no es china

9527 SIS0527 Falta el parámetro obligatorio DS_MERCHANT_BUYERID

9528 SIS0528 Formato erróneo del parámetro DS_MERCHANT_BUYERID en operación Sodexo Brasil

9529 SIS0529 No se permite operación recurrente en pagos con tarjeta Voucher


La fecha de Anulación no puede superar en más de 7 días a la de
9530 SIS0530
Preautorización.
La fecha de Anulación no puede superar en más de 72 horas a la de
9531 SIS0531
Preautorización diferida
9532 SIS0532 La moneda de la petición no coincide con la devuelta

9533 SIS0533 El importe de la petición no coincide con el devuelto

9534 SIS0534 No se recibe recaudación emisora o referencia del recibo/tributo

9535 SIS0535 Pago de recibo/tributo fuera de plazo

9536 SIS0536 Recibo/tributo ya pagado

Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier
medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

64
ERRORES SIS

9537 SIS0537 Pago de recibo/tributo denegado por la entidad

9538 SIS0538 Rechazo en el pago de recibo/tributo

9539 SIS0539 Error en el envío de SMS

9540 SIS0540 El móvil enviado es demasiado largo (más de 12 posiciones)

9541 SIS0541 La referencia enviada es demasiada larga (más de 40 posiciones)

9542 SIS0542 Error genérico. Consulte con Soporte

Error, la tarjeta de la operación es DINERS y el comercio no tiene el método


9543 SIS0543
de pago “Pago DINERS” o “Pago Discover No Seguro”

Error, la tarjeta de la operación es DINERS y el comercio no tiene el


9544 SIS0544
método de pago “Pago Discover No Seguro”

9545 SIS0545 Error DISCOVER

9546 SIS0546 Error DISCOVER

9547 SIS0547 Error DISCOVER

9548 SIS0548 Error DISCOVER

9549 SIS0549 Error DISCOVER

9550 SIS0550 ERROR en el gestor de envío de los SMS. Consulte con Soporte

9551 SIS0551 ERROR en el proceso de autenticación.

9552 SIS0552 ERROR el resultado de la autenticación PARes = ‘U’


ERROR se ha intentado hacer un pago con el método de pago UPI y la tarjeta no
9553 SIS0553
es china
ERROR el resultado de la autenticación para UPI es PARes = ‘U’ y el
9554 SIS0554
comercio no tiene métodos de pago no seguros UPI EXPRESSPAY

ERROR la IP de conexión del módulo de administración no está entre las


9555 SIS0555
permitidas.
Se envía pago Tradicional y el comercio no tiene pago Tradicional mundial ni
9556 SIS0556
Tradicional UE.
Se envía pago Tarjeta en Archivo y el comercio no tiene pago Tradicional
9557 SIS0557
mundial ni Tradicional UE.
9558 SIS0558 ERROR, el formato de la fecha dsMerchantP2FExpiryDate es incorrecto

ERROR el id Operación de la respuesta en la autenticación PPII es nulo o no


9559 SIS0559
se ha obtenido de la autenticación final

9560 SIS0560 ERROR al enviar la notificación de autenticación al comercio

ERROR el idOperacion de la respuesta de una confirmación separada OK es nulo


9561 SIS0561
o no coincide con el idOp. de la Confirmación.

9562 SIS0562 ERROR la respuesta de la petición de confirmación separada de PPII es nula.

9563 SIS0563 ERROR tratando la respuesta de la confirmación separada de PPII.

9564 SIS0564 ERROR En la operación de DCC

9565 SIS0565 Formato del importe del campo Ds_Merchant_Amount excede del límite permitido.

9566 SIS0566 Error de acceso al nuevo Servidor Criptográfico.

ERROR se ha intentado hacer un pago con una tarjeta china UPI y el comercio
9567 SIS0567
no tiene método de pago UPI

9568 SIS0568 Operación de Inicia Petición rechazada, tipo de transacción erróneo

Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier
medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

65
ERRORES SIS

9569 SIS0569 Operación de Inicia Petición rechazada, no se ha informado la tarjeta

9570 SIS0570 Operación de Inicia Petición rechazada, se ha enviado tarjeta y referencia

9571 SIS0571 Operación de autenticación EMV3DS rechazada, protocolVersion no indicado

9572 SIS0572 Operación de autenticación EMV3DS rechazada, protocolVersion no reconocido

9573 SIS0573 Operación de autenticación EMV3DS rechazada, browserAcceptHeader no indicado

9574 SIS0574 Operación de autenticación EMV3DS rechazada, browserUserAgent no indicado

9575 SIS0575 Operación de autenticación EMV3DS rechazada, browserJavaEnabled no indicado

9576 SIS0576 Operación de autenticación EMV3DS rechazada, browserLanguage no indicado

9577 SIS0577 Operación de autenticación EMV3DS rechazada, browserColorDepth no indicado

9578 SIS0578 Operación de autenticación EMV3DS rechazada, browserScreenHeight no indicado

9579 SIS0579 Operación de autenticación EMV3DS rechazada, browserScreenWidth no indicado

9580 SIS0580 Operación de autenticación EMV3DS rechazada, browserTZ no indicado

Operación de autenticación EMV3DS rechazada, datos DS_MERCHANT_EMV3DS no está


9581 SIS0581
indicado o es demasiado grande y no se puede convertir en JSON

9582 SIS0582 Operación de autenticación EMV3DS rechazada, threeDSServerTransID no indicado

9583 SIS0583 Operación de autenticación EMV3DS rechazada, threeDSCompInd no indicado

9584 SIS0584 Operación de autenticación EMV3DS rechazada, notificationURL no indicado

9585 SIS0585 Operación de autenticación EMV3DS rechazada

9586 SIS0586 Operación de autenticación EMV3DS rechazada, PARes no indicado

9587 SIS0587 Operación de autenticación EMV3DS rechazada, MD no indicado

Operación de autenticación EMV3DS rechazada, la versión no coincide entre los


9588 SIS0588
mensajes AuthenticationData y ChallengeResponse

9589 SIS0589 Operación de autenticación EMV3DS rechazada, respuesta sin CRes


Operación de autenticación EMV3DS rechazada, error al desmontar la respuesta
9590 SIS0590
CRes
Operación de autenticación EMV3DS rechazada, error la respuesta CRes viene
9591 SIS0591
sin threeDSServerTransID

9592 SIS0592 Error en la operación de autenticación EMV3DS

9593 SIS0593 Error en la operación de autenticación EMV3DS

9594 SIS0594 Operación de autenticación EMV3DS rechazada, CRes no indicado

9595 SIS0595 El comercio indicado no tiene métodos de pago seguros permitidos en EMV3DS V2

9596 SIS0596 Operación de inicia petición rechazada,moneda errónea

9597 SIS0597 Operación de inicia petición rechazada,importe erróneo

9598 SIS0598 Error en la operación de autenticación EMV3DS

9599 SIS0599 Error en la operación de autenticación EMV3DS

9600 SIS0600 Error en el proceso de autenticación 3DSecure v2 - Respuesta Areq N

9601 SIS0601 Error en el proceso de autenticación 3DSecure v2 - Respuesta Areq R

9602 SIS0602 Error en el proceso de autenticación 3DSecure v2 - Respuesta Areq U

Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier
medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

66
ERRORES SIS

Error en el proceso de autenticación 3DSecure v2 - Se envían datos de la


9644 SIS0644
entrada IniciaPetición a la entrada TrataPetición

Error en el parámetro DS_MERCHANT_DCC de DCC enviado en operación H2H (REST y


9603 SIS0603
SOAP)

Error en los datos de DCC enviados en el parámetro DS_MERCHANT_DCC en


9604 SIS0604
operación H2H (REST y SOAP)

Error en el parámetro DS_MERCHANT_MPIEXTERNAL enviado en operación H2H (REST


9605 SIS0605
y SOAP)

Error en los datos de MPI enviados en el parámetro DS_MERCHANT_MPIEXTERNAL


9606 SIS0606
en operación H2H (REST y SOAP)

Error del parámetro TXID de MPI enviado en el parámetro


9607 SIS0607
DS_MERCHANT_MPIEXTERNAL en operación H2H (REST y SOAP) es erróneo

Error del parámetro CAVV de MPI enviado en el parámetro


9608 SIS0608
DS_MERCHANT_MPIEXTERNAL en operación H2H (REST y SOAP) es erróneo

Error del parámetro ECI de MPI enviado en el parámetro


9609 SIS0609
DS_MERCHANT_MPIEXTERNAL en operación H2H (REST y SOAP) es erróneo

Error del parámetro threeDSServerTransID de MPI enviado en el parámetro


9610 SIS0610
DS_MERCHANT_ MPIEXTERNAL en operación H2H (REST y SOAP) es erróneo

Error del parámetro dsTransID de MPI enviado en el parámetro


9611 SIS0611
DS_MERCHANT_MPIEXTERNAL en operación H2H (REST y SOAP) es erróneo

Error del parámetro authenticacionValue de MPI enviado en el parámetro


9612 SIS0612
DS_MERCHANT_ MPIEXTERNAL en operación H2H (REST y SOAP) es erróneo

Error del parámetro protocolVersion de MPI enviado en el parámetro


9613 SIS0613
DS_MERCHANT_ MPIEXTERNAL en operación H2H (REST y SOAP) es erróneo

Error del parámetro Eci de MPI enviado en el parámetro


9614 SIS0614
DS_MERCHANT_MPIEXTERNAL en operación H2H (REST y SOAP) es erróneo

9615 SIS0615 Error en MPI Externo, marca de tarjeta no permitida

9616 SIS0616 Error del parámetro DS_MERCHANT_EXCEP_SCA tiene un valor erróneo

Error del parámetro DS_MERCHANT_EXCEP_SCA es de tipo MIT y no vienen datos de


9617 SIS0617
COF o de pago por referencia
Error la exención enviada no está permitida y el comercio no está preparado
9618 SIS0618
para autenticar
9619 SIS0619 El comercio no tiene el método de pago Amazon
9620 SIS0620 Error DCC por importe más alto del permitido

9621 SIS0621 El amazonOrderReferenceId no es válido

9622 SIS0622 Error al realizar los cálculos de DCC en la operación

9623 SIS0623 Error al realizar los cálculos de DCC en la operación

9624 SIS0624 Error al realizar los cálculos de DCC en la operación

Error en la anulación del pago, porque ya existe una devolución asociada a


9625 SIS0625
ese pago
Error en la devolución del pago, ya existe una anulación de la operación que
9626 SIS0626
se desea devolver

9627 SIS0627 El número de referencia o solicitud enviada por CRTM no válida.

Error la operación de viene con datos de 3DSecure y viene por la entrada


9628 SIS0628
SERMEPA
Error no existe la operación de confirmación separada sobre la que realizar
9629 SIS0629
la anulación
Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier
medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

67
ERRORES SIS

Error en la anulación de confirmación separada, ya existe una devolución


9630 SIS0630
asociada a la confirmación separada

Error en la anulación de confirmación separada, ya existe una anulación


9631 SIS0631
asociada a la confirmación separada

Error la confirmación separada sobre la que se desea anular no está


9632 SIS0632
autorizada
La fecha de Anulación no puede superar en los días configurados a la
9633 SIS0633
confirmación separada.

9634 SIS0634 Error no existe la operación de pago sobre la que realizar la anulación

9635 SIS0635 Error en la anulación del pago, ya existe una anulación asociada al pago

9636 SIS0636 Error el pago que se desea anular no está autorizado

9637 SIS0637 La fecha de Anulación no puede superar en los días configurados al pago.

Error existe más de una devolución que se quiere anular y no se ha


9638 SIS0638
especificado cual.

9639 SIS0639 Error no existe la operación de devolución sobre la que realizar la anulación
Error la confirmación separada sobre la que se desea anular no está
9640 SIS0640
autorizada o ya está anulada
La fecha de Anulación no puede superar en los días configurados a la
9641 SIS0641
devolución.
La fecha de la preautorización que se desea reemplazar no puede superar los
9642 SIS0642
30 días de antigüedad
9643 SIS0643 Error al obtener la personalización del comercio

9650 SIS0650 Error, la MAC no es correcta en la mensajería de pago de tributos

9651 SIS0651 Error la exención exige SCA y el comercio no está preparado para autenticar

Error la exención y la configuración del comercio exigen no SCA y el


9652 SIS0652
comercio no está configurado para autorizar con dicha marca de tarjeta

9653 SIS0653 Operación de autenticación rechazada, browserJavascriptEnabled no indicado

9654 SIS0654 Error, solo se permite usar Ds_MerchantOTA


Error, se indican datos de 3RI-Recurring y la versión que se envía en el
9655 SIS0655
trataPetición no es 2.2
Error, se indican datos de 3RI-Recurring y el campo
9656 SIS0656
threeDSRequestorPriorAuthenticationInfo en el trataPetición es vacío
Error, se indican datos de 3RI-OTA y la versión que se envía en el
9657 SIS0657
trataPetición no es 2.2
Error, se indican datos de 3RI-OTA y el campo
9658 SIS0658
threeDSRequestorPriorAuthenticationInfo en el trataPetición es vacío
Error, se indican datos de 3RI-OTA para Master y el campo
9659 SIS0659 threeDSReqPriorRef del campo threeDSRequestorPriorAuthenticationInfo
en el trataPetición es vacío
Error, se indican datos de 3RI-OTA para Master y el campo authenticationValue en
9660 SIS0660
el trataPetición es vacío
Error, se indican datos de 3RI-OTA para Master y el campo Eci en el
9661 SIS0661
trataPetición es vacío
Error, el comercio no está entre los permitidos para realizar confirmaciones
9662 SIS0662
parciales.
101 101 Tarjeta caducada

106 106 Tarjeta bloqueada, exceso de pin erróneo

129 129 CVV Incorrecto


Denegada no repetir. La tarjeta no es válida. El comercio deberá recuperar de
172 172 su cliente nuevo método de pago ya que esta operación no va a prosperar con
esta tarjeta.

Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier
medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

68
ERRORES SIS
Denegada, no repetir sin actualizar datos de la [Link] tarjeta es correcta,
173 173
pero el comercio deberá actualizar algunos datos asociadas a la tarjeta.
Denegada, no repetir antes de 72 horas. El comercio deberá esperar plazo
174 174
recomendado antes de repetir la operación.
180 180 Tarjeta no válida o (LinX)

184 184 el cliente no se ha autenticado

Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier
medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

69
ERRORES SIS

190 190 Denegación emisor

904 904 Problema con la configuración del comercio

915 915 El titular ha cancelado la operación de pago.

8102 8102 Operación que ha sido redirigida al emisor a autenticar EMV3DS V1 (para H2H)

8210 8210 Operación que ha sido redirigida al emisor a autenticar EMV3DS V2 (para H2H)

9700 9700 PayPal a devuelto un KO

9801 9801 Denegada por iUPAY

9850 9850 Error en operación realizada con Amazon Pay

9860 9860 Error en operación realizada con Amazon Pay. Se puede reintentar la operación

9899 9899 Los datos en Ds_Merchant_Data y no estaban correctamente firmados

9900 9900 SafetyPay ha devuelto un KO

9909 9909 Error genérico. Consulte con Soporte

La operación ha tenido algún problema y se ha de generar una anulación


9912 9912
automática

9913 9913 Error en el envío notificación SOAP

9914 9914 Respuesta KO por el comercio en la notificación SOAP

9915 9915 A petición del usuario se cancela el pago

9928 9928 A petición del usuario se cancela la preautorización

9929 9929 El titular ha cancelado la operación

9930 9930 La transferencia está pendiente

9931 9931 Denegada (LINX)


9932 9932 Denegada (LINX)
9933 9933 Denegada (LINX)
9934 9934 Denegada (LINX)
9935 9935 Denegada (LINX)

9966 9966 BIZUM ha devuelto un KO en la autorización

9992 9992 Solicitud de PAE

9994 9994 No se ha seleccionado ninguna tarjeta de la cartera.

9995 9995 Recarga de prepago denegada

9996 9996 No permite la recarga de tarjeta prepago

9997 9997 Con la misma tarjeta hay varios pagos en “vuelo”

9998 9998 Operación en proceso de solicitud de datos de tarjeta

9999 9999 Operación que ha sido redirigida al emisor a autenticar

XML0000 Errores en el proceso del XML-String recibido


Error en la generación del DOM a partir del XML-String recibido y la DTD
XML0001
definida
XML0002 No existe el elemento “Message” en el XML-String recibido
El tipo de “Message” en el XML-String recibido tiene un valor desconocido o
XML0003
inválido en la petición

Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier
medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

70
ERRORES SIS

XML0004 No existe el elemento “Ds_MerchantCode” en el XML-String recibido

XML0005 El elemento “Ds_MerchantCode” viene vacío en el XML-String recibido

El elemento “Ds_MerchantCode” tiene una longitud incorrecta en el XML-String


XML0006
recibido
El elemento “Ds_MerchantCode” no tiene formato numérico en el XML-String
XML0007
recibido

XML0008 No existe el elemento “Ds_Terminal” en el XML-String recibido

XML0009 El elemento “Ds_Terminal” viene vacío en el XML-String recibido

El elemento “Ds_Terminal” tiene una longitud incorrecta en el XML-String


XML0010
recibido

XML0011 El elemento “Ds_Terminal” no tiene formato numérico en el XML-String recibido

XML0012 No existe el elemento “Ds_Order” en el XML-String recibido

XML0013 El elemento “Ds_Order” viene vacío en el XML-String recibido

El elemento “Ds_Order” tiene una longitud incorrecta en el XML-String


XML0014
recibido
El elemento “Ds_Order” no tiene sus 4 primeras posiciones numéricas en el
XML0015
XML-String recibido

XML0016 No existe el elemento “Ds_TransactionType” en el XML-String recibido

XML0017 El elemento “Ds_TransactionType” viene vacío en el XML-String recibido


El elemento “Ds_TransactionType” tiene una longitud incorrecta en el XML-
XML0018
String recibido
El elemento “Ds_TransactionType” no tiene formato numérico en el XML-String
XML0019
recibido
El elemento “Ds_TransactionType” tiene un valor desconocido o inválido en un
XML0020
mensaje Transaction
XML0021 No existe el elemento “Signature” en el XML-String recibido

XML0022 El elemento “Signature” viene vacío en el XML-String recibido

XML0023 La firma no es correcta

XML0024 No existen operaciones para los datos solicitados

XML0025 El XML de respuesta está mal formado

XML0026 No existe el elemento “Ds_fecha_inicio” en el XML-String recibido

XML0027 No existe el elemento “Ds_fecha_fin” en el XML-String recibido

XML0028 El comercio-terminal está dado de baja

XML0029 El elemento “SignatureVersion” viene vacío en el XML-String recibido


El elemento “SignatureVersion” viene con un valor erróneo en el XML-String
XML0030
recibido
El elemento “Entrada” viene con un valor no permitido en el XML-String
XML0031
recibido
El elemento “Autorizada” viene con un valor no permitido en el XML-String
XML0032
recibido
El elemento “ImporteMayor” viene con un valor no permitido en el XML-String
XML0033
recibido
El elemento “ImporteMenor” viene con un valor no permitido en el XML-String
XML0034
recibido
El elemento “Autenticada” viene con un valor no permitido en el XML-String
XML0035
recibido
XML0036 El elemento “DCC” viene con un valor no permitido en el XML-String recibido
El elemento “Paymethod” viene con un valor no permitido en el XML-String
XML0037
recibido

Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier
medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

71
MONEDAS

Código ISO Moneda

840 DOLAR U.S.A. USD

826 POUND STERLING GBP

392 YEN JPY

32 ARGENTINE AUSTRAL ARP

36 AUSTRALIAN DOLLAR AUD

124 CANADIAN DOLLAR CAD

152 CHILEAN PESO CLP

170 COLOMBIAN PESO COP

188 COSTA RICA COLON CRC

356 INDIAN RUPEE INR

484 MEXICAN PESO MXP

604 PERU INTI PEI

756 SWISS FRANC CHF

858 URUGUAYAN PESO UYP

986 BRAZILIAN REAL BRL

949 TURKISH LIRA TRY

8 LEK ALL

12 ALGERIAN DINAR DZD

24 ANGOLA KWANZA AOK

30 PROBANDO DESA MON

31 AZERBAIJANIAN MANAT AZM

32 ARGENTINE AUSTRAL ARP

36 AUSTRALIAN DOLLAR AUD

44 BAHAMIAN DOLLAR BSD

48 BAHRAINI DINAR BHD

50 TAKA BDT

51 ARMENIAN DRAM AMD

52 BARBADOS DOLLAR BBD

60 BERMUDAN DOLLAR BMD

64 NGULTRUM BTN

68 BOLIVIAN PESO BOP

70 DINAR BAD

72 PULA BWP

76 CRUZEIRO BRC

84 BELIZE DOLLAR 084

Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier
medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

71
MONEDAS

90 SOLOMON ISLANDS DOLL SBD

96 BRUNEI DOLLAR BND

100 LEV BGL

104 KYAT BUK

108 BURUNDI FRANC BIF

112 BELARUSSIAN RUBLE BYB

116 RIEL KHR

124 CANADIAN DOLLAR CAD

132 CAPE VERDE ESCUDO CVE

136 CAYMAN ISLANDS DOLLA KYD

144 SRI LANKA RUPEE LKR

152 CHILEAN PESO CLP

156 YUAN RENMINBI CNY

157 CHINESE RENMIMBI CNH

158 CHINESE RENMINBI CNX

170 COLOMBIAN PESO COP

174 COMOROS FRANC KMF

180 ZAIRE ZRZ

188 COSTA RICA COLON CRC

191 CROATIAN KUNA HRK

192 CUBAN PESO CUP

196 CYPRUS POUND CYP

200 KORUNA CSK

203 CZECH KORUNA CZK

208 DANISH KRONE DKK

214 DOMINICAN PESO DOP

218 SUCRE ECS

222 EL SALVADOR COLON SVC

226 EKWELE GQE

230 ETHIOPIAN BIRR ETB

232 ERITREAN NAKTAN ERN

233 ESTONIAN KROON EEK

238 FALKLAND ISLANDS FKP

242 FIJI DOLLAR FJD

262 DJIBOUTI FRANC DJF

268 GEORGIAN LARI GEL

Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier
medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

72
MONEDAS

270 DALASI GMD

278 MARK DER DDR DDM

288 GHANA CEDI GHC

292 GIBRALTAR POUND GIP

320 QUETZAL GTQ

324 SYLI GNS

328 GUYANA DOLLAR GYD

332 GOURDE HTG

340 LEMPIRA HNL

344 HONG KONG DOLLAR HKD

348 FORINT HUF

352 ICELAND KRONA ISK

356 INDIAN RUPEE INR

360 RUPIAH IDR

364 IRANIAL RIAL IRR

365 IRANIAN AIRLINE RATE IRA

368 IRAQI DINAR IQD

376 ISRAEL SHEKEL ILS

388 JAMAICAN DOLLAR JMD

392 YEN JPY

398 TENGE KZT

400 JORDANIAN DINAR JOD

404 KENYAN SHILLING KES

408 NORTH KOREAN WON KPW

410 KOREAN WON KRW

414 KUWAITI DINAR KWD

417 KYRGYZSTAN SON KGS

418 KIP LAK

422 LEBANESE POUND LBP

426 LESOTHO LOTI LSM

428 LATVIAN LAT LVL

430 LIBERIAN DOLLAR LRD

434 LIBYAN DINAR LYD

440 LITHUANIAN LITAS LTL

446 PATACA MOP

450 MALAGASY FRANC MGF

Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier
medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

73
MONEDAS

454 MALAWI KWACHA MWK

458 MALASYAN RINGGIT MYR

462 MALDIVE RUPEE MVR

466 MALI MLF

470 MALTESE LIRA MTL

478 OUGUIYA MRO

480 MAURITIUS RUPEE MUR

484 MEXICAN PESO MXP

496 TUGRIK MNT

498 MOLDOVIAN LEU MDL

504 MORROCAN DIRHAM MAD

508 METICAL MZM

512 RIAL OMANI OMR

516 NAMIBIAN DOLLAR NAD

524 NEPALESE RUPEE NPR

532 NETHERLANDS ANTILLIA ANG

533 ARUBA AWG

536 YUGOSLAVIAN NEW DIAN NTZ

548 VANUATU VATU VUV

554 NEW ZEALAND DOLLAR NZD

556 NAIRA 566

558 CORDOBA NIC

566 NAIRA NGN

578 NORWEGIAN KRONE NOK

582 PACIFIC ISLAND PCI

586 PAKISTAN RUPEE PKR

590 BALBOA PAB

598 KINA PGK

600 GUARANI PYG

604 PERU INTI PEI

608 PHILIPPINE PESO PHP

616 ZLOTY PLZ

624 GUINEA

626 TIMOR ESCUDO TPE

634 QATARI RIAL QAR

642 LEU ROL

Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier
medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

74
MONEDAS

643 RUSSIAN ROUBLE RUB

646 RWANDA FRANC RWF

654 [Link] POUND SHP

678 DOBRA STD

682 SAUDI RIYAL SAR

690 SEYCHELLES RUPEE SCR

694 LEONE SLL

702 SINGAPORE DOLLAR SGD

703 SLOVAK KORUNA SKK

704 DONG VND

705 SLOVENIAN TOLAR SIT

706 SOMALI SHILLING SOS

710 RAND ZAR

716 ZIMBABWE DOLLAR ZWD

720 YEMENI DINAR YDD

728 SOUTH SUDANESE POUND SSP

736 SUDANESE POUND SDP

737 SUDAN AIRLINES SDA

740 SURINAM GUILDER SRG

748 LILANGENI SZL

752 SWEDISH KRONA SEK

756 SWISS FRANC CHF

760 SYRIAN POUND SYP

762 TAJIK RUBLE TJR

764 BAHT THB

776 PA’ANGA TOP

780 TRINIDAD Y TOBAGO DO TTD

784 UAE DIRHAM AED

788 TUNISIAN DINAR TND

792 TURKISH LIRA TRL

793 PSEUDO TURKISH LIRA PTL

795 MANAT TMM

800 UGANDA SHILLING UGS

804 KARBOVANET UAK

807 MACEDONIAN DENAR MKD

810 RUSSIAN ROUBLE RUR

Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier
medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

75
MONEDAS

818 EGYPTIAN POUND EGP

826 POUND STERLING GBP

834 TANZANIAN SHILLING TZS

840 DOLAR U.S.A. USD

858 URUGUAYAN PESO UYP

860 UZBEKISTAN SUM UZS

862 BOLIVAR VEB

882 TALA WST

886 YEMINI RIAL YER

890 NEW YUGOSLAVIAN DOLL YUD

891 NEW DINAR YUG

894 KWACHA ZMK

901 NEW TAIWAN DOLLAR TWD

934 NEW MANAT TMT

936 GHANA CEDI GHS

941 DINAR SERBIO RSD

943 MOZAMBIQUE METICAL MZN

944 AZERBAIJANIAN MANAT AZN

946 NEW LEU RON

949 TURKISH LIRA TRY

950 CFA FRANC BEAC XAF

951 EAST CARIBBEAN DOLLA XCD

952 CFA FRANC BCEAO XOF

953 CFP FRANC XPF

954 E.C.U. EUROPEAN CUR XEU

967 KWACHA ZMW

968 SURINAME DOLLAR SRD

969 ARIARY MGA

971 AFGHANISTAN AFGHANI AFN

972 TAJIKISTAN SOMONI TJS

973 KWANZA ANGOLA AOA

974 BELARUSSIAN RUBLE BYR

975 NEW LEV BGN

976 FRANCO DEL CONGO CDF

977 BOSNIAN MARKA BAM

978 EURO EUR

Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier
medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

76
MONEDAS

980 HRYVNIA UAH

981 GEORGIAN LARI GEL

985 NEW POLISH ZLOTY PLN

986 BRAZILIAN REAL BRL

991 RAND FINANCIER ZAL

Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier
medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

77
IDIOMAS

Código Idioma

0 Por defecto - Español

1 Español

2 English - Ingles

3 Català

4 Français - Frances

5 Deutsch - Aleman

6 Nederlands - Holandes

7 Italiano

8 Svenska - Sueco

9 Português

10 Valencià

11 Polski - Polaco

12 Galego

13 Euskara

100 български език - Bulgaro

156 Chino

191 Hrvatski - Croata

203 Čeština - Checo

208 Dansk - Danes

233 Eesti keel - Estonio

246 Suomi - Finlandes

300 ελληνικά - Griego

348 Magyar - Hungaro

392 Japonés

428 Latviešu valoda - Leton

440 Lietuvių kalba - Lituano

470 Malti - Maltés

642 Română - Rumano

643 ру́сский язы́ к – Ruso

703 Slovenský jazyk - Eslovaco

705 Slovenski jezik - Esloveno

792 Türkçe - Turco

Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier
medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

78
DS_RESPONSE

Código Significado

0000 a 0099 Transacción autorizada para pagos y preautorizaciones

900 Transacción autorizada para devoluciones y confirmaciones

400 Transacción autorizada para anulaciones

101 Tarjeta caducada

102 Tarjeta en excepción transitoria o bajo sospecha de fraude

106 Intentos de PIN excedidos

125 Tarjeta no efectiva

129 Código de seguridad (CVV2/CVC2) incorrecto

180 Tarjeta ajena al servicio

184 Error en la autenticación del titular

190 Denegación del emisor sin especificar motivo

191 Fecha de caducidad errónea

195 Requiere autenticación SCA


Tarjeta en excepción transitoria o bajo sospecha de fraude con retirada de
202
tarjeta
904 Comercio no registrado en FUC

909 Error de sistema

913 Pedido repetido

944 Sesión Incorrecta

950 Operación de devolución no permitida

9912/912 Emisor no disponible

9064 Número de posiciones de la tarjeta incorrecto

9078 Tipo de operación no permitida para esa tarjeta

9093 Tarjeta no existente

9094 Rechazo servidores internacionales

9104 Comercio con “titular seguro” y titular sin clave de compra segura

9218 El comercio no permite op. seguras por entrada /operaciones

9253 Tarjeta no cumple el check-digit

9256 El comercio no puede realizar preautorizaciones

9257 Esta tarjeta no permite operativa de preautorizaciones

9261 Operación detenida por superar el control de restricciones en la entrada al SIS

9915 A petición del usuario se ha cancelado el pago

9997 Se está procesando otra transacción en SIS con la misma tarjeta

9998 Operación en proceso de solicitud de datos de tarjeta

9999 Operación que ha sido redirigida al emisor a autenticar

Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier
medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

79
DS_MERCHANT_TRANSACTIONTYPE

TIPO DE OPERACIÓN DS_MERCHANT_TRANSACTIONTYPE ENTRADAS


Realizar Pago, Webservices
Autorización 0
SOAP, REST
Realizar Pago, Webservices
Preautorización 1
SOAP, REST
Realizar Pago, Webservices
Confirmación 2
SOAP, REST
Realizar Pago, Webservices
Devolución 3
SOAP, REST
Realizar Pago, Webservices
Preautorización Separada 7
SOAP, REST
Realizar Pago, Webservices
Confirmación Separada 8
SOAP, REST
Realizar Pago, Webservices
Anulación 9
SOAP, REST
Paygold 15 Webservices SOAP, REST

Autenticación Puce 17 REST


Realizar Pago, Webservices
Devolución sin original 34
SOAP, REST
Premio de apuestas 37 Webservices SOAP, REST

Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier
medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

80
DS_MERCHANT_EMV3DS

OPCION DEL
DATO NOMBRE DEL COMENTARIOS
Long. / Tipo PARÁMETRO CONDICIONALES
DATO
Información acctID Variable, máximo 64 / OPCIONAL Información adicional sobre la
adicional de la A-N cuenta
cuenta del cliene
Información de la acctInfo JSON Data Type Object OPCIONAL Parámetro altamente recomendable el
cuenta del envío de esta información.
titular Información adicional de la cuenta
de usuario en el establecimiento.
Ver hoja acctInfo
Indicador de addrMatch 1/A-N OPCIONAL Indica si la dirección de envío es
coincidencia de la misma qu la dirección de
dirección facturación
Y = La dirección de envío es la
misma que la de facturación
N = Las direcciones de envío y
facturación son diferentes
Ciudad de la billAddrCity Variable, máximo 50 / OPCIONAL (*) Definido como Conditional por el La ciudad de la dirección de
dirección de A-N estándar EMV 3DS, podría ser facturación del titular de la
facturación requerido según el emisor de la tarjeta asociada a la compra
tarjeta. Altamente recomendado para
permitir autenticaciones basadas en
análisis del riesgo (Risk Based
Analisys) y facilitar
una experiencia de compra sin
fricción (frictionless). Igualmente
recomendable si se solicita la
aplicación de exenciones SCA (PSD2).
País de la billAddrCountr 3 / N CONDICIONAL Obligatorio si se envía el Corresponde al código numérico (ISO
dirección de y billAddrState. 3166-1) del país de la dirección de
facturación facturación del titular de la
tarjeta asociada asociado a la
compra

Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o
comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

81
DS_MERCHANT_EMV3DS

Dirección de billAddrLine1 Variable, máximo 50 / OPCIONAL (*) Definido como Conditional por el Primera línea de la dirección de
facturación A-N estándar EMV 3DS, podría ser facturación del titular de la
(línea 1) requerido según el emisor de la tarjeta asociada a la compra
tarjeta. Altamente recomendado para
permitir autenticaciones basadas en
análisis del riesgo (Risk Based
Analisys) y facilitar
una experiencia de compra sin
fricción (frictionless). Igualmente
recomendable si se solicita la
aplicación de exenciones SCA (PSD2).
Dirección de billAddrLine2 Variable, máximo 50 / OPCIONAL (*) Definido como Conditional por el Segunda línea de la dirección de
facturación A-N estándar EMV 3DS, podría ser facturación del titular de la
(línea 2) requerido según el emisor de la tarjeta asociada a la compra.
tarjeta. Altamente recomendado para
permitir autenticaciones basadas en
análisis del riesgo (Risk Based
Analisys) y facilitar
una experiencia de compra sin
fricción (frictionless). Igualmente
recomendable si se solicita la
aplicación de exenciones SCA (PSD2).
Dirección de billAddrLine3 Longitud: Variable, OPCIONAL (*) Definido como Conditional por el Tercera línea de la dirección de
facturación máximo 50 / A-N estándar EMV 3DS, podría ser facturación del titular de la
(línea 3) requerido según el emisor de la tarjeta asociada a la compra.
tarjeta. Altamente recomendado para
permitir autenticaciones basadas en
análisis del riesgo (Risk Based
Analisys) y facilitar
una experiencia de compra sin
fricción (frictionless). Igualmente
recomendable si se solicita la
aplicación de exenciones SCA (PSD2).
Código postal de billAddrPostCo Variable, máximo 16 / OPCIONAL (*) Definido como Conditional por el Código postal de la dirección de
la dirección de de A-N estándar EMV 3DS, podría ser facturación del titular de la
facturación requerido según el emisor de la tarjeta asociada a la compra.
tarjeta. Altamente recomendado para
permitir autenticaciones basadas en
análisis del riesgo (Risk Based
Analisys) y facilitar
una experiencia de compra sin
fricción (frictionless). Igualmente
recomendable si se solicita la
aplicación de exenciones SCA (PSD2).

Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o
comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

82
DS_MERCHANT_EMV3DS

Estado o billAddrState Variable, máximo 3 / OPCIONAL (*) Definido como Conditional por el El estado o provincia de la
provincia de la A-N estándar EMV 3DS, podría ser dirección de facturación del titular
dirección de requerido según el emisor de la de la tarjeta asociada a esta
facturación tarjeta. Altamente recomendado para compra.
permitir autenticaciones basadas en Corresponde al código de subdivisión
análisis del riesgo (Risk Based ISO 3166-2
Analisys) y facilitar
una experiencia de compra sin
fricción (frictionless). Igualmente
recomendable si se solicita la
aplicación de exenciones SCA (PSD2).
No enviar en caso de que el estado
no aplique en este pais.
Browser Accept browserAcceptH Variable, máximo 2048 CONDICIONAL REALIZAR PAGO: Parámetro recogido HTTP accept headers enviado desde el
Headers eader / A-N automáticamente por el TPV-Virtual, navegador .
no es necesario enviarlo.
REST: Parámetro Obligatorio
Webservice SOAP: Parámetro
Obligatorio
Browser Screen browserColorDe 1-2 /A-N CONDICIONAL REALIZAR PAGO: Parámetro recogido Valor que representa la profundidad
Color Depth pth automáticamente por el TPV-Virtual, de bits de la paleta de colores para
no es necesario enviarlo. mostrar imágenes, en bits por píxel.
REST: Parámetro Obligatorio Obtenido desde el navegador del
Webservice SOAP: Parámetro titular de la tarjeta utilizando la
Obligatorio propiedad [Link].
Valores aceptados:
1 = 1 bit
4 = 4 bits
8 = 8 bits
15 = 15 bits
16 = 16 bits
24 = 24 bits
32 = 32 bits
48 = 48 bits
Enviar 1 en el caso que no tenga
hablitado javascript (versión
3DS2.1.0)

Browser IP browserIP Variable, máximo 45 / CONDICIONAL REALIZAR PAGO: Parámetro recogido IP del navegador. Value accepted:
Address A-N automáticamente por el TPV-Virtual, IPv4 address Ejemplo: [Link]
no es necesario enviarlo. IPv6 address.
REST: Parámetro Obligatorio Ejemplo:2011:0db8:85a3:0101:0101:8a2
Webservice SOAP: Parámetro [Link]
Obligatorio

Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o
comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

83
DS_MERCHANT_EMV3DS

Browser Java browserJavaEna Boolean CONDICIONAL REALIZAR PAGO: Parámetro recogido Indicador de capacidad del navegador
Enabled bled automáticamente por el TPV-Virtual, de ejecutar Java. Valores aceptados:
no es necesario enviarlo. true , false.
REST: Parámetro Obligatorio si
browserJavascriptEnabled=true
Webservice SOAP: Parámetro
Obligatorio si
browserJavascriptEnabled=true
Browser browserJavascr Boolean CONDICIONAL REALIZAR PAGO: Parámetro recogido Indicador de capacidad del navegador
JavaScript iptEnabled automáticamente por el TPV-Virtual, de ejecutar JavaScript. Valores
Enabled no es necesario enviarlo. aceptados: true , false
REST: Parámetro Obligatorio
Webservice SOAP: Parámetro
Obligatorio
Browser Language browserLanguag Variable, 1–8 / A-N CONDICIONAL REALIZAR PAGO: Parámetro recogido Idioma del navegador definido en
e automáticamente por el TPV-Virtual, IETF BCP47 . Es el valor retornado
no es necesario enviarlo. por la propiedad [Link]
REST: Parámetro Obligatorio
Webservice SOAP: Parámetro
Obligatorio
Browser Screen browserScreenH Variable, 1–6 / A-N CONDICIONAL REALIZAR PAGO: Parámetro recogido Altura total de la pantalla en
Height eight automáticamente por el TPV-Virtual, píxeles
no es necesario enviarlo. El valor se devuelve de la propiedad
REST: Parámetro Obligatorio [Link]
Webservice SOAP: Parámetro Enviar 0 en el caso que no tenga
Obligatorio hablitado javascript (versión
3DS2.1.0)
Browser Screen browserScreenW Variable, 1–6 / A-N CONDICIONAL REALIZAR PAGO: Parámetro recogido Ancho total de la pantalla en
Width idth automáticamente por el TPV-Virtual, píxeles.
no es necesario enviarlo. El valor se devuelve de la propiedad
REST: Parámetro Obligatorio [Link]
Webservice SOAP: Parámetro Enviar 0 en el caso que no tenga
Obligatorio hablitado javascript (versión
3DS2.1.0)
Browser Time Zone browserTZ 1-5 / A-N CONDICIONAL REALIZAR PAGO: Parámetro recogido Diferencia horaria entre la hora UTC
automáticamente por el TPV-Virtual, y la hora local del navegador, en
no es necesario enviarlo. minutos
REST: Parámetro Obligatorio Value accepted:
Webservice SOAP: Parámetro Value is returned from the
Obligatorio getTimezoneOffset() method.
Enviar 0 en el caso que no tenga
hablitado javascript (versión
3DS2.1.0)

Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o
comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

84
DS_MERCHANT_EMV3DS

Browser User- browserUserAge Variable, máximo 2048 CONDICIONAL REALIZAR PAGO: Parámetro recogido Http user-agent header
Agent nt / A-N automáticamente por el TPV-Virtual, Si la longitud total del User-Agent
no es necesario enviarlo. enviado por el navegador supera los
REST: Parámetro Obligatorio 2048 caracteres, el valor será
Webservice SOAP: Parámetro truncado
Obligatorio
Nombre del cardholderName Variable, 2–45 / A-N OPCIONAL (*) Definido como Conditional por el Nombre del titular
titular estándar EMV 3DS, podría ser
requerido según el emisor de la
tarjeta. Altamente recomendado para
permitir autenticaciones basadas en
análisis del riesgo (Risk Based
Analisys) y facilitar
una experiencia de compra sin
fricción (frictionless). Igualmente
recomendable si se solicita la
aplicación de exenciones SCA (PSD2).
Tamaño de ventana challengeWindo 2 / A-N OPCIONAL Dimensión de ventana de challenge
del challenge wSize que el banco emisor presentará al
cliente para realizar la
autenticación
Valores posibles (tamaño en
píxeles):
01 = 250 x 400
02 = 390 x 400
03 = 500 x 600
04 = 600 x 400
05 = Full screen (Valor por
defecto)
El tamaño precondigurado es el ancho
x alto en píxeles de la ventana del
navegador
Dirección de Email Variable, máximo 254 OPCIONAL (*) Definido como Conditional por el La dirección de correo electrónico
correo / A-N estándar EMV 3DS, podría ser asociada con la cuenta del titular
electrónico del requerido según el emisor de la de la tarjeta
titular tarjeta. Altamente recomendado para
permitir autenticaciones basadas en
análisis del riesgo (Risk Based
Analisys) y facilitar
una experiencia de compra sin
fricción (frictionless). Igualmente
recomendable si se solicita la
aplicación de exenciones SCA (PSD2).

Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o
comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

85
DS_MERCHANT_EMV3DS

Número de homePhone JSON Data Type: OPCIONAL (*) Definido como Conditional por el Número de teléfono del domicilio del
teléfono del Object estándar EMV 3DS, podría ser titular. Ver hoja Phone
domicilio requerido según el emisor de la
tarjeta. Altamente recomendado para
permitir autenticaciones basadas en
análisis del riesgo (Risk Based
Analisys) y facilitar
una experiencia de compra sin
fricción (frictionless). Igualmente
recomendable si se solicita la
aplicación de exenciones SCA (PSD2).
Indicador de merchantRiskIn JSON Data Type: OPCIONAL Altamente recomendable el envío de
riesgo del dicator Object esta información. Información
comerciante adicional del comercio que
representa la evaluación del nivel
de riesgo de fraude para la
autenticación. Ver hoja
merchantRiskIndicator
Número de móvil mobilePhone JSON Data Type: OPCIONAL (*) Definido como Conditional por el Número de teléfono móvil del
del titular Object estándar EMV 3DS, podría ser titular. Ver hoja Phone
requerido según el emisor de la
tarjeta. Altamente recomendado para
permitir autenticaciones basadas en
análisis del riesgo (Risk Based
Analisys) y facilitar
una experiencia de compra sin
fricción (frictionless). Igualmente
recomendable si se solicita la
aplicación de exenciones SCA (PSD2).
URL de notificationUR Variable, máximo 256 CONDICIONAL REALIZAR PAGO: Parámetro recogido Url del comercio que recibirá la
notificación de L / A-N automáticamente por el TPV-Virtual, notificación con el mensaje CRes al
respuesta del no es necesario enviarlo. finaliza el challenge
challenge REST: Parámetro Obligatorio
Webservice SOAP: Parámetro
Obligatorio
Versión del protocolVersio Variable 5-8 / A-N CONDICIONAL REALIZAR PAGO: Parámetro recogido Versión de protocolo 3DSecure
protocolo n automáticamente por el TPV-Virtual, Valores posibles :
3DSecure no es necesario enviarlo. - 1.0.2
REST: Parámetro Obligatorio - 2.1.0
Webservice SOAP: Parámetro
Obligatorio
Datos de pago purchaseInstal Variable, máximo 3 / CONDICIONAL Obligatorio para operaciones Especifica Indica el número máximo de
aplazado Data N Instalment. ciones COF autorizaciones en pago aplazado
ECom Valores aceptados: El valor debe ser
[Link] mayor que 1

Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o
comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

86
DS_MERCHANT_EMV3DS

Finalización de recurringExpir 8 / A-N CONDICIONAL Obligatorio para operaciones Especifica La fecha a partir de la cual no se
pago recurrente y Recurring e Instalment. ciones COF harán más autorizaciones Formato
ECom aceptado: YYYYMMDD
[Link]
Frecuencia de recurringFrequ Variable, máximo 4 / CONDICIONAL Obligatorio para operaciones Especifica Indica el mínimo número de días
pagos recurrentes ency A-N Recurring e Instalment. ciones COF entre autorizaciones
ECom
[Link]
Ciudad de la shipAddrCity Variable, máximo 50 / OPCIONAL (*) Definido como Conditional por el Ciudad de la dirección de envío
dirección de A-N estándar EMV 3DS, podría ser solicitada por el titular de la
envío requerido según el emisor de la tarjeta
tarjeta. Altamente recomendado para
permitir autenticaciones basadas en
análisis del riesgo (Risk Based
Analisys) y facilitar
una experiencia de compra sin
fricción (frictionless). Igualmente
recomendable si se solicita la
aplicación de exenciones SCA (PSD2).
País de la shipAddrCountr 3 / N CONDICIONAL Obligatorio si se envía el Corresponde al código numérico (ISO
dirección de y shipAddrState . 3166-1) del país de la dirección de
envío envío solicitada por el titular de
la tarjeta
Dirección de shipAddrLine1 Variable, máximo 50 / OPCIONAL (*) Definido como Conditional por el Primera línea de la dirección de
envío (línea 1) A-N estándar EMV 3DS, podría ser envío solicitada por el titular de
requerido según el emisor de la la tarjeta.
tarjeta. Altamente recomendado para
permitir autenticaciones basadas en
análisis del riesgo (Risk Based
Analisys) y facilitar
una experiencia de compra sin
fricción (frictionless). Igualmente
recomendable si se solicita la
aplicación de exenciones SCA (PSD2).
Dirección de shipAddrLine2 Variable, máximo 50 / OPCIONAL (*) Definido como Conditional por el Segunda línea de la dirección de
envío (línea 2) A-N estándar EMV 3DS, podría ser envío solicitada por el titular de
requerido según el emisor de la la tarjeta.
tarjeta. Altamente recomendado para
permitir autenticaciones basadas en
análisis del riesgo (Risk Based
Analisys) y facilitar
una experiencia de compra sin
fricción (frictionless). Igualmente
recomendable si se solicita la
aplicación de exenciones SCA (PSD2).

Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o
comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

87
DS_MERCHANT_EMV3DS

Dirección de shipAddrLine3 Variable, máximo 50 / OPCIONAL (*) Definido como Conditional por el Tercera línea de la dirección de
envío (línea 3) A-N estándar EMV 3DS, podría ser envío solicitada por el titular de
requerido según el emisor de la la tarjeta
tarjeta. Altamente recomendado para
permitir autenticaciones basadas en
análisis del riesgo (Risk Based
Analisys) y facilitar
una experiencia de compra sin
fricción (frictionless). Igualmente
recomendable si se solicita la
aplicación de exenciones SCA (PSD2).
Código postal de shipAddrPostCo Variable, máximo 16 / OPCIONAL (*) Definido como Conditional por el El código postal de la dirección de
la dirección de de A-N estándar EMV 3DS, podría ser envío solicitada por el titular de
envío requerido según el emisor de la la tarjeta.
tarjeta. Altamente recomendado para
permitir autenticaciones basadas en
análisis del riesgo (Risk Based
Analisys) y facilitar
una experiencia de compra sin
fricción (frictionless). Igualmente
recomendable si se solicita la
aplicación de exenciones SCA (PSD2).
Estado o shipAddrState Variable, máximo 3 / OPCIONAL (*) Definido como Conditional por el El estado o provincia de la
provincia de la A-N estándar EMV 3DS, podría ser dirección de envío asociada con la
dirección de requerido según el emisor de la tarjeta utilizada para esta compra.
envío tarjeta. Altamente recomendado para Corresponde al código de subdivisión
permitir autenticaciones basadas en ISO 3166-2
análisis del riesgo (Risk Based
Analisys) y facilitar
una experiencia de compra sin
fricción (frictionless). Igualmente
recomendable si se solicita la
aplicación de exenciones SCA (PSD2).
Indicador del threeDSCompInd 1 / Y,N,U CONDICIONAL REALIZAR PAGO: Parámetro recogido Indica si el 3DSMethod se ha
resultado del automáticamente por el TPV-Virtual, ejecutado
3DSMethod no es necesario enviarlo. Values accepted:
REST: Parámetro Obligatorio Y = Completado correctamente
Webservice SOAP: Parámetro N = Completado con errores
Obligatorio U = 3DSMethod no ejecutado

Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o
comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

88
DS_MERCHANT_EMV3DS

Tipo de threeDSInfo Variable, máximo CONDICIONAL REALIZAR PAGO: Parámetro recogido Tipo de solicitud. Valores posibles:
información 32/A-N automáticamente por el TPV-Virtual, - CardData
3dSecure enviada no es necesario enviarlo. - AuthenticationData
REST: Parámetro Obligatorio - ChallengeResponse
Webservice SOAP: Parámetro - 3RI-Recurring
Obligatorio - 3RI-OTA

Información de threeDSRequest JSON Data Type: OPCIONAL Información adicional sobre como el
inicio de sesión orAuthenticati Object cliente se autenticó en el inicio de
en el onInfo sesión en la cuenta del comercio.
establecimiento Ver hoja
threeDSRequestorAuthenticationInfo
Identificador de threeDSServerT 36 / A-N CONDICIONAL REALIZAR PAGO: Parámetro recogido El mismo valor devuelto en la
transacción ransID automáticamente por el TPV-Virtual, consutla de tarjeta
3DSecure no es necesario enviarlo.
REST: Parámetro Obligatorio
Webservice SOAP: Parámetro
Obligatorio
Teléfono del workPhone JSON Data Type: OPCIONAL (*) Definido como Conditional por el Número de teléfono del [Link]
trabajo Object estándar EMV 3DS, podría ser hoja Phone
requerido según el emisor de la
tarjeta. Altamente recomendado para
permitir autenticaciones basadas en
análisis del riesgo (Risk Based
Analisys) y facilitar
una experiencia de compra sin
fricción (frictionless). Igualmente
recomendable si se solicita la
aplicación de exenciones SCA (PSD2).
Cres de respuesta cres Variable length, OPCIONAL Cres de respuesta del ACS, se deberá
del ACS al Base64url enviar de respuesta de la
Challenge autenticación.

Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o
comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

89
DS_MERCHANT_EMV3DS

Información de la threeDSRequest JSON Data Type: OPCIONAL Opcional Datos de la autenticación previa.
autenticación orPriorAuthent Object Estos datos pueden ser requeridos en
previa icationInfo determinadas operativas. Por
ejemplo, en recurrentes EMV 3DS
subsiguientes deberá enviarse en
este campo el json Object
threeDSRequestorPriorAuthenticationI
nfo de la recurrente inicial, es
decir, lo mismo que se devolvió en
el
threeDSRequestorPriorAuthenticationI
nfo (DS_EMV3DS) en la recurrente
inicial.
Para más información consultar el
apartado Funcionalidades Avanzadas
EMV3DS en las guías de integración

Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o
comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

90
DS_EMV3DS

DATO NOMBRE DEL DATO Long. / Tipo COMENTARIOS


Versión del protocolo 3DSecure protocolVersion Variable 5-8 / A-N Valores Posibles:
- NO_3DS_V2
- 2.1.0
- 2.2.0

Identificador de transacción threeDSServerTransID 36 / A-N Identificación de la transaccion EMV3DS, se debe mandar el mismo en todo
3DSecure el flujo EMV3DS
Tipo de información 3dSecure enviada threeDSInfo Variable, Tipo de solicitud. Valores posibles:
máximo 32/A-N - CardConfiguration
- ChallengeRequest
URL del ACS para ejecutar el threeDSMethodURL Variable, máximo URL del ACS para ejecutar el 3DSMethod
3DSMethod 256 characters
URL del ACS para la ejecución del acsURL Variable, máximo URL del ACS para la ejecución del Challenge
Challenge 2048 characters

Creq que se deberá enviar al ACS CReq Variable length, Creq que se deberá enviar al ACS para la ejecución del Challenge
para la ejecución del Challenge Base64url
Información adicional para el cardholderInfo Variable, Campo opcional que contiene información adicional para mostrar al titular
titular máximo 128/A- después de solicitar la autenticación
N
Información de la autenticación threeDSRequestorPriorAuthentication JSON Data Type: Contiene datos de la autenticación realizada. Estos datos pueden ser
Info Object requeridos en operaciones posteriores que necesiten vincularse a
ésta. Por ejemplo, el json Object
threeDSRequestorPriorAuthenticationInfo devuelto en una recurrente
EMV 3DS inicial será utilizado en las recurrentes subsiguientes
Para más información consultar el apartado Funcionalidades Avanzadas
EMV3DS en las guías
de integración
Información de la autenticación AuthenticacionValue 28 / A-N [Link] más información consultar el apartado Funcionalidades
Avanzadas EMV3DS en las guías de integración
Información de la autenticación ECI 2 / N Indicador de comercio electró[Link] más información consultar el
apartado Funcionalidades Avanzadas EMV3DS en las guías de integración
Información de la autenticación TraceId 16 / A-N Identificador de la operació[Link] más información consultar el apartado
Funcionalidades Avanzadas EMV3DS en las guías de integración

Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o
comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

91
PHONE

DATO NOMBRE DEL DATO Long. / Tipo COMENTARIOS

Prefijo cc 1–3 / N Indicativo del país correspondiente


al número de teléfono, según

Numeración subscriber máximo 15 / N Numeración correspondiente al número


de teléfono.

Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier
medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

92
MERCHANTRISKINDICATOR

DATO NOMBRE DEL DATO Long/Tipo COMENTARIOS

Dirección de entrega Para la entrega electrónica, la dirección de correo


deliveryEmailAddre máximo 254 / A-
electrónica ss N electrónico a la que se entregó la mercancía

Indica el plazo de entrega de la mercancía.


Valores aceptados: 01 = Electronic Delivery
Plazo de entrega deliveryTimeframe 2 / A-N 02 = Same day
shipping 03 =
Overnight shipping
04 = Two-day or more shipping
Para compras de tarjetas prepago o tarjetas regalo,
Importe en compras el importe total de la compra en unidades
giftCardAmount máximo 15 / A-N
de tarjetas prepago principales (por ejemplo, USD 123.45 es 123).
/ regalo
Recuento de tarjetas Para a compras de tarjeta prepago o tarjetas
prepago/regalo giftCardCount 2 / N regalo, recuento total de tarjetas prepago o
tarjetas/códigos regalo comprados.
Código de moneda de Para la compra de tarjeta prepago / regalo, el
tarjeta giftCardCurr 3 / N código ISO-4217 de moneda de la tarjeta
prepago/regalo
Fecha prevista de Para una compra preordenada, la fecha prevista de
compra preordenada preOrderDate 8 / N disponibilidad de la mercancía. Date format =
YYYYMMDD
Indica si el titular de la tarjeta realiza un
pedido con disponibilidad o fecha de lanzamiento
Indicador de
preOrderPurchaseIn 2 / A-N futuros. Valores aceptados:
disponibilidad del d 01 = Merchandise
pedido
available 02 = Future
availability

Indica si el titular de la tarjeta está reordenando


mercancía comprada previamente. Valores aceptados:
Indicador de reorderItemsInd 2 / A-N
recompra 01 = First time
ordered 02 =
Reordered

Indica el método de envío elegido para la


transacción. Los comercios deben elegir el código
del indicador de envío que describa con mayor
precisión la transacción específica del titular de
la tarjeta, no su actividad comercial en general.
Si se incluyen uno o más artículos en la venta,
utilice el código del Indicador de envío para los
bienes físicos, o si todos los productos son
digitales, utilice el código del Indicador de envío
que describe el artículo más caro.
Método de envío shipIndicator 2 / A-N
Valores aceptados:
01 = Ship to cardholder’s billing address
02 = Ship to another verified address on file with
merchant
03 = Ship to address that is different than the
cardholder’s billing address
04 = “Ship to Store” / Pick-up at local store
(Store address shall be populated in shipping
address fields)
05 = Digital goods (includes online services,
electronic gift cards and redemption codes)
06 = Travel and Event tickets, not shipped
07 = Other (for example, Gaming, digital services
not shipped, emedia subscriptions, etc.)

Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier
medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

93
THREEDSREQUESTORAUTHENTICATIONI

DATO NOMBRE DEL DATO Long/Tipo COMENTARIOS

Datos que documentan y soportan un


Datos de inicio Máximo 2048
threeDSReqAuthData proceso de autenticación específico. No
de sesión / A-N
está espeficado el contenido en la
versión actual del protocolo
Mecanismo utilizado por el titular para
autenticarse en el comercio. Valores
aceptados:
01 = No 3DS Requestor authentication
occurred (i.e. cardholder “logged in” as
guest)
02 = Login to the cardholder account at
Método de the 3DS Requestor system using 3DS
autenticación en threeDSReqAuthMethod 2 / A-N Requestor’s own credentials
el inicio de 03 = Login to the cardholder account at
sesión the 3DS Requestor system using federated
ID
04 = Login to the cardholder account at
the 3DS Requestor system using issuer
credentials
05 = Login to the cardholder account
at the 3DS Requestor system using
third-party authentication 06 = Login
to the cardholder account at the 3DS
Requestor system using FIDO
Authenticator 07–79 = Reserved
80–99 = Reserved
Fecha Hora de
Fecha y hora UTC de la autenticación Date
autenticación threeDSReqAuthTimestamp 12 / N
format = YYYYMMDDHHMM
(inicio de
sesión)

Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier
medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

94
THREEDSREQUESTORPRIORAUTHENTICA

DATO NOMBRE DEL DATO Long/Tipo COMENTARIOS

Información adicional
threeDSReqPriorAuthData Variable, máximo 2048
de la autenticación A/N
“Valores
aceptados: 01 =
Mecanismo de
threeDSReqPriorAuthMethod 2 A/N Frictionless
autenticación en la que
se autenticó el titular 02 = Challenge
03 =
Verificación AVS
04 = Otros
métodos”
Fecha y hora UTC de la “Formato
threeDSReqPriorAuthTimestamp 12 A/N
autenticación aceptado:
YYYYMMDDHHMM”
Referencia de la
threeDSReqPriorRef 36 A/N
autenticación

Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier
medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

95
ACCTINFO

DATO NOMBRE DEL DATO Long/Tipo COMENTARIOS

“Periodo de tiempo que el titular de la


tarjeta ha tenido la cuenta en el comercio.
Indicador de Valores posibles:
permanencia de chAccAgeInd 2 / A-N 01 = No account (guest
la cuenta check-out) 02 = Created
during this transaction 03 =
Less than 30 days
04 = 30-60 days
05 = More than 60 days “
Fecha en que se modificó por última vez la
Fecha de cuenta del titular de la tarjeta en el
chAccChange 8 / N
modificación de la comercio, incluida la dirección de
cuenta facturación o de envío, la nueva cuenta de
pago o los nuevos usuarios agregados. Date
format = YYYYMMDD
“Período de tiempo transcurrido desde que
se modificó por última vez la información
de la cuenta del titular
Indicador de de la tarjeta en el comercio, incluida la
modificación de chAccChangeInd 2 / A-N dirección de facturación o de envío, la
la cuenta nueva cuenta de pago o los nuevos usuarios
agregados. Valores aceptados:
01 = Modificado en esta
transacción 02 = Menos de 30
días
03 = 30-60 días
04 = Más de 60 días “
Fecha en que el titular de la tarjeta abrió
Fecha de alta chAccDate 9 / N
la cuenta en el comercio. Date format =
YYYYMMDD
Fecha en que el titular tuvo un cambio de
Fecha de cambio de
chAccPwChange 8 / N contraseña en la cuenta del comercio o un
contraseña
restablecimiento de la cuenta. Date format
= YYYYMMDD
“Indica el período de tiempo desde que
la cuenta del titular de la tarjeta en
el comercio tuvo un cambio de contraseña
o restablecimiento de cuenta. Valores
Indicador de cambio
chAccPwChangeInd 2 / A-N aceptados:
de contraseña
01 = No change
02 = Changed during this
transaction 03 = Less than 30
days
04 = 30-60 days
05 = More than 60 days “
Número de compras 6 Número de compras con esta cuenta durante
nbPurchaseAccount máximo 4 / N
meses los últimos seis meses

Intentos de agregar Número de intentos de agregar tarjeta en las


provisionAttemptsDa máximo 3 / N
tarjeta 24 h últimas 24 horas
y
Número de transacciones (exitosas y
Número de
txnActivityDay máximo 3 / N abandonadas) para esta cuenta del titular
transacciones 24 h
de la tarjeta en el comercio en todas las
cuentas de pago en las últimas 24 horas.
Número de Número de transacciones (exitosas y
transacciones año txnActivityYear máximo 3 / N abandonadas) para esta cuenta del titular
anterior de la tarjeta en el comercio en todas las

Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier
medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

96
ACCTINFO
cuentas de pago del año anterior

Fecha en que la cuenta de pago se inscribió


Alta de cuenta de paymentAccAge 8 / N en la cuenta del titular de la tarjeta en el
pago comercio. Date format = YYYYMMDD

Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier
medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

97
ACCTINFO

“Indica el período de tiempo que la


cuenta de pago se inscribió en la cuenta
del titular de la tarjeta en el comercio.
Indicador de Valores aceptados:
paymentAccInd 2 / A-N
creación de cuenta 01 = No account (guest check-
de pago out) 02 = During this
transaction
03 = Less than 30 days
04 = 30-60 days
05 = More than 60 days “
Fecha en que la dirección de envío
Fecha de primer uso
shipAddressUsage 8 / N utilizada para esta transacción se utilizó
de dirección de
por primera vez con el comercio. Date
envío
format = YYYYMMDD
“Indica cuándo la dirección de envío
utilizada para esta transacción se utilizó
Indicador de por primera vez con el comercio. Valores
primer uso de shipAddressUsageInd 2 / A-N aceptados:
dirección de 01 = This
envío transaction 02 =
Less than 30 days
03 = 30-60 days
04 = More than 60 days “
“Indica si el Nombre del titular de la
tarjeta en la cuenta es idéntico al Nombre
Indicador de
shipNameIndicator 2 / A-N de envío utilizado para esta transacción.
nombre de titular
Valores aceptados:
01 = Account Name identical to shipping Name
02 = Account Name different than shipping
Name “
“Indica si el comercio ha experimentado
actividad sospechosa (incluido fraude
Indicador de
suspiciousAccActivi 2 / A-N anterior) en la cuenta del titular de la
actividad
ty tarjeta. Valores aceptados:
sospechosa
01 = No suspicious activity has been
observed 02 = Suspicious activity has
been observed “

Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier
medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

98
DS_MERCHANT_DCC

DATO NOMBRE DEL DATO Long. / Tipo COMENTARIOS

Moneda DCC monedaDCC 4 / Núm. Se debe enviar el código numérico de la


moneda según el ISO-4217, ver hoja Monedas.

Importe DCC importeDCC 12 / N Las últimas posiciones hacen referencia a los


decimales de la moneda. Ejemplo: En el caso
del EURO 43,45 Euros habría que indicar 4345

Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier
medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

99
DS_MERCHANT_PAYMETHODS

DS_
FORMA DE DS_MERCHANT_
MERCHANT_ COMENTARIOS DOCUMENTACION ESPECIFICA
PAGO TRANSACTIONTYPE
PAYMETHODS

Se requiere
TPV-Virtual Guía de Integración
Bizum z 0,7,8 activación por
BIZUM comercios [Link]
parte de la
entidad.
Se requiere
PayPal p 0,1,15 activación por TPV-Virtual Manual Integración
parte de la [Link]
entidad.
Se requiere
Transferenci R 0,15, activación por TPV-Virtual [Link]
a parte de la
entidad.
Se requiere
Masterpass N 0,7,15, activación por TPV-Virtual [Link]
parte de la
entidad.
Con Tarjeta C TODAS

Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier
medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

100
DS_MERCHANT_MPIEXTERNAL

Long. / CONDICION DEL


NOMBRE DEL DATO VERSIÓN CONDICIONALES COMENTARIOS
Tipo PARÁMETRO

Identificador que
TXID 28 / A-N 1.0.2 OBLIGATORIO devuelve al
autenticador. Valor en
Base 64
Obligatorio
para Valor CAVV de campo
CAVV 28 / A-N 1.0.2 CONDICIONAL
valores del autenticado. Valor en
parámetro ECI: Base 64
01,
02, 05 o 06
Valor del ECI. Valores
ECI 2/N 1.0.2 OBLIGATORIO posibles: 02,01 o 00
(Master); y 05, 06 o 07
(Resto de Marcas).
threeDSServerTransID 36 / A-N 2.1.0 OBLIGATORIO Identificador de la
transacción
dsTransID 36 / A-N 2.1.0 OBLIGATORIO Identificador del DS

Obligatorio
para Valor CAVV de campo
authenticationValue 28 / A-N 2.1.0 CONDICIONAL
valores del autenticado. Valor en
parámetro Eci: Base 64
01,
02, 05 o 06
“Versión de protocolo
3DSecure 2 con la que
Variable
protocolVersion 2.1.0 OBLIGATORIO se ha autenticado la
5-8 / A-
operación.
N
Valores permitidos:
2.1.0”
Valor del ECI. Valores
Eci 2 / A-N 2.1.0 OBLIGATORIO posibles: 02,01 o 00
(Master); y 05, 06 o 07
(Resto de Marcas).
authenticationType 2 /A-N 2.1.0 OPCIONAL

“Valores
posibles: F =
authenticationFlow 1 / A-N 2.1.0 OPCIONAL Frictionless
C = Challenge (Valor
por defecto en caso de
no informarse este
campo)”

Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por cualquier
medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

101
DS_MERCHANT_MPIEXTERNAL

DATO NOMBRE DEL DATO Long. / Tipo COMENTARIOS PARÁMETROS DEL JSON

Información Información monedaDCC, litMonedaDCC,


de la moneda InfoMonedaTarjeta JSON adicional sobre la importeDCC, cambioDCC,
de la tarjeta moneda de la fechaCambioDCC, markUp
tarjeta
Información Información
monedaCome, litMonedaCome,
de la moneda InfoMonedaTitular JSON adicional sobre
importeCome
del titular la moneda del
titular

Manual TPV Virtual por Redirección

Banco Bilbao Vizcaya Argentaria, S.A. es titular de los derechos de propiedad intelectual sobre este documento. Queda prohibido modificar, copiar, reproducir, comunicar públicamente, transformar o distribuir, por
cualquier medio y bajo cualquier forma, la totalidad o parte de los contenidos aquí incluidos, para fines públicos o comerciales, sin la autorización previa, expresa y por escrito de Banco Bilbao Vizcaya Argentaria, S.A.

102

Common questions

Con tecnología de IA

Risk-based analysis plays a critical role in the EMV3DS authentication process by allowing transactions to be assessed based on their risk profile, which enables the system to decide whether full authentication is necessary or if a transaction can proceed frictionlessly. In the BBVA TPV Virtual, this process is enhanced by the provision of enriched transaction data, which helps issuing banks perform effective risk assessments, improving the likelihood of authorizing transactions without additional customer authentication steps .

The BBVA TPV Virtual system implements error management mechanisms that include various error codes (SIS codes) for identifying specific transaction issues, such as errors in signature calculation or invalid order numbers . These mechanisms enable quick diagnostics and resolution actions, thus enhancing transaction reliability and minimizing downtime or transaction failures. Merchants can consult support for generic issues or transaction-specific errors, ensuring more robust error handling and customer trust .

The 'Pago en 1 Clic' and tokenization feature benefits merchants by simplifying and speeding up the payment process for repeat customers. This feature allows customer card details to be securely stored as tokens, enabling merchants to request payments without needing customers to re-enter their card information for each transaction. Consequently, it eliminates compliance requirements with the PCI DSS for merchants and enhances the customer experience, especially in mobile environments .

Enriching transaction data facilitates a frictionless user experience under EMV3DS by providing the issuing bank with sufficient information to perform risk-based analysis and potentially bypass extensive security checks for trusted transactions. This enrichment supports the processing of authentication exemptions under PSD2 and enhances the likelihood of carrying out a frictionless authentication process, thereby improving user experience and transaction efficiency .

The implementation of EMV3DS 2.2 in the BBVA's virtual POS system aims to enhance customer authentication by reducing transaction friction. It allows merchants to request exceptions from the PSD2's two-factor authentication requirement with prior authorization from BBVA, improving user experience and potentially increasing conversion rates by providing a more frictionless transaction process . Furthermore, the enriched information provided by merchants for risk analysis supports a smoother authentication process .

The BBVA virtual POS system aligns with PSD2 regulation by incorporating the EMV3DS 2.2 protocol, which supports Strong Customer Authentication (SCA) while also allowing merchants to request SCA exemptions. This compliance framework helps balance the security requirements of PSD2 while optimizing for customer convenience by allowing frictionless transactions when sufficient transaction data is provided for risk assessment .

The BBVA TPV Virtual system ensures compliance with security standards by incorporating mandatory CVV2 verification as an anti-fraud measure and employing Velocity Checks to validate transaction parameters such as IP address and card number. These security filters are designed to prevent fraudulent activities and safeguard payment transactions . Additionally, the system's design ensures merchants do not directly handle sensitive card information, thus reducing the burden of PCI DSS compliance .

In the BBVA Virtual POS redirection model, the transaction flow involves the customer selecting products and proceeding to checkout, after which the merchant redirects the browser session to the virtual POS URL where card details are entered. This separation ensures security as the merchant does not handle card data, avoiding the need for PCI DSS compliance. The virtual POS processes the transaction, assesses risk, and then redirects the session back to the merchant, providing the operation results, thus ensuring efficient processing while safeguarding sensitive information .

The management of pre-authorizations allows merchants to secure funds without immediately debiting a customer's account, which can aid in managing inventory or guaranteeing payments for non-immediate services. This delay in fund settlement helps merchants plan their cash flow strategically by controlling the timing of actual fund collections, ensuring cash availability aligns with delivery schedules or after-service requirements .

The introduction of CVV2 verification serves as an immediate layer of security by ensuring that the cardholder physically possesses the card, which reduces the risk of card-not-present fraud. Velocity Checks further improve fraud prevention by analyzing transactional patterns such as IP address and transaction frequency to detect and block suspicious activities. Together, these mechanisms provide a comprehensive approach to fraud detection within the BBVA TPV Virtual system, enhancing overall transaction security .

También podría gustarte