3-D Secure V2 parameters
1. Introducción
Esta lista contiene todos los parámetros importantes de 3-D Secure v2. Está dividida en tres secciones:
2. Parámetros obligatorios
Si estás utilizando nuestra Página Alojada Worldline Hosted Payment Page, somos nosotros los que capturamos esos parámetros por ti. Si estás procesando las transacciones a través de DirectLink, tendrás que añadirlos manualmente a tu solicitud.
Parametros |
Nombre / Descripción |
Formato |
---|---|---|
browserAcceptHeader |
Browser Accept Headers Contenido exacto de los encabezados HTTP Accept, tal como se envían al comerciante desde el navegador del titular de la tarjeta. * |
Tipo de datos: cadena Longitud: variable, máx. 2.048 caracteres |
browserColorDepth |
Browser Color Depth. Valor que representa la profundidad de bits de la paleta de colores para visualizar imágenes, en bits por píxel. La proporciona el navegador del titular de la tarjeta mediante la propiedad de profundidad de color de pantalla. |
Tipo de datos: cadena |
browserJavaEnabled |
Browser Java Enabled. Valor booleano que representa la capacidad del navegador del titular de la tarjeta para ejecutar Java. El valor es devuelto por la propiedad de Java Enabled del navegador. |
Tipo de datos: booleano |
browserLanguage |
Browser Language. Valor que representa el idioma del navegador, tal como se define en IETF BCP47. Lo devuelve la propiedad Language del navegador. (Por ejemplo: en, fr, en-US, fr-ca) No distingue entre mayúsculas y minúsculas. |
Tipo de datos: cadena xx, xxx, xx-XX o xx-xxxx-xx. |
browserScreenHeight |
Browser Screen Height. Altura total de la pantalla del titular de la tarjeta, en píxeles. El valor es devuelto por la propiedad Screen Height. |
Tipo de datos: Int |
browserScreenWidth |
Browser Screen Width. Anchura total de la pantalla del titular de la tarjeta, en píxeles. El valor es devuelto por la propiedad Screen Width. |
Tipo de datos: Int |
browserTimeZone |
Browser Time Zone. Diferencia horaria entre la hora UTC y la hora local del navegador del titular de la tarjeta, en minutos. |
Tipo de datos: Int |
browserUserAgent |
Browser User Agent. Contenido exacto del encabezado HTTP User-Agent. * |
Tipo de datos: cadena |
ACCEPTURL |
URL de la página web para mostrar al cliente cuando se autoriza el pago. (o se espera que se autorice). |
An máx. 200 caracteres |
DECLINEURL |
URL al que se redirecciona al cliente si se ha alcanzado el máximo número de intentos de autorización fallidos (10 de forma predeterminada, pero que puede cambiar en la página Información técnica, pestaña "Parámetros de transacción globales", sección "Reintento de pago"). |
An máx. 200 caracteres |
EXCEPTIONURL |
URL de la página web para mostrar al cliente cuando el resultado del pago es dudoso. |
An máx. 200 caracteres |
LANGUAGE |
Los idiomas actualmente disponibles para la página de pago ofrecidos al comprador (titular de la tarjeta/titular de la cuenta) El idioma predeterminado se utiliza si no se envía un valor de idioma o este valor no es válido: en_US (inglés) |
AN El formato es "idioma_país". |
FLAG3D |
Valor fijo: ‘Y’ Indica a nuestro sistema que lleve a cabo una identificación 3-D Secure si es necesario. |
An máx. 1 caracteres |
CN |
Nombre del titular de la tarjeta (cliente) |
Longitud: variable, máx. 35 |
Mpi.carteBancaire.Usecase |
Obligatoria para la Carta Bancaire Para todos os modos de integración Tipo de pago para el que se solicita autenticación |
Longitud: 2 caracteres Tipo de datos: cadena Valores aceptados:
|
REMOTE_ADDR |
Obligatoria para la Carta Bancaire Para solicitudes de DirectLink browserIP. Dirección IP del cliente (solo para el módulo de
|
212.23.45.96 |
If you process transactions for Visa, make sure to add the following mandatory parameters as well:
For all integration modes:
Mpi.WorkPhone.countryCode + Mpi.WorkPhone.subscriber
or
Mpi.MobilePhone.countryCode + Mpi.MobilePhone.subscriber
or
Mpi.HomePhone.countryCode + Mpi.HomePhone.subscriber
or
EMAIL
For DirectLink requests:
REMOTE_ADDR
3. Parámetros recomendados
Los principales esquemas de tarjetas recomiendan incluirlos fuertemente, ya que aumentarán la posibilidad de un flujo sin fricciones.
Parametros |
Nombre / Descripción | Formato |
---|---|---|
ECOM_BILLTO_POSTAL_CITY |
billAddrCity. Ciudad de facturación |
Longitud: variable, máx. 25 |
ECOM_BILLTO_POSTAL_COUNTRYCODE |
billAddrCountry. Código de país de facturación |
Longitud: máx. 2 |
ECOM_BILLTO_POSTAL_STREET_LINE1 |
billAddrLine1. Dirección de facturación, primera línea |
Longitud: variable, máx. 60 |
ECOM_BILLTO_POSTAL_STREET_LINE2 |
billAddrLine2. Dirección de facturación, segunda línea |
Longitud: variable, máx. 60 |
ECOM_BILLTO_POSTAL_POSTALCODE |
billAddrPostCode. Código postal de facturación |
Longitud: variable, máx. 10 |
Dirección de correo electrónico del cliente |
Longitud: variable, máx. 50 |
4. Parámetros opcionales
Adicionalmente puedes enviar tantos de estos parámetros como quieras. Cuantos más parámetros envíes, disminuirá la fricción en el flujo.
Parametros |
Nombre / Descripción |
Formato |
---|---|---|
Mpi.threeDSRequestorChallengeIndicator |
Usa este parámetro para solicitar exenciones al 3DS. Indicador de comprobación del comerciante. Indica si se requiere una comprobación para esta transacción. Por ejemplo: Para 01-PA, un comerciante puede dudar de la transacción y solicitar una |
Longitud: 2 caracteres
|
Mpi.merchantFraudRate |
Tasa de fraude para comerciantes La tasa de fraude para comerciantes en la zona EEE (el fraude total de tarjetas del EEE dividido por el volumen total de tarjetas del EEE) calculado según las PSD2 Normas Técnicas Reglamentarias (RTS). Es muy importante calcular la tasa según se estipula en la sección 19 de la directiva PSD2 del RTS; de lo contrario, ni MasterCard ni nosotros validaremos la puntuación. |
Longitud: máx. 2 caracteres |
Mpi.secureCorporatePayment |
Pago seguro para empresas Indica que se han utilizado procesos y procedimientos de pago específicos y que se aplica la posible exención de pago seguro para empresas. |
Longitud: máx. 1 carácter
|
Mpi.cardholderAccountChangeIndicator |
Indicador de antigüedad de la cuenta del titular de la tarjeta* Período de tiempo que el titular de la tarjeta tiene la cuenta con el comerciante. |
Longitud: 2 caracteres |
Mpi.cardholderAccountDate |
Fecha de la cuenta del titular de la tarjeta* Fecha en que el titular de la tarjeta abrió |
Longitud: 8 caracteres Tipo de datos: fecha Formato aceptado: Formato de fecha = AAAAMMDD |
Mpi.cardholderAccountPasswordChange |
Cambio de contraseña de la cuenta del titular de la tarjeta* Fecha en que se modificó la contraseña o |
Longitud: 8 caracteres Tipo de datos: cadena Formato aceptado: Formato de fecha = AAAAMMDD |
Mpi.cardholderAccountPasswordChangeIndicator |
Indicador de cambio de contraseña de la cuenta del titular de la tarjeta* Indica el período de tiempo desde que se cambió la contraseña de la cuenta del titular de la tarjeta con el comerciante, o se restableció la cuenta. |
Longitud: 2 caracteres Tipo de datos: cadena Valores aceptados: • 01 = Ningún cambio • 02 = Modificada durante esta transacción • 03 = Menos de 30 días • 04 = 30−60 días • 05 = Más de 60 días |
Mpi.numberOfPurchaseWithAccountInTheLastSixMonths |
Recuento de compras de la cuenta del titular de la tarjeta. Número de compras con esta cuenta de |
Tipo de datos: Int entre 0 y 9999 |
Mpi.paymentAccountAge |
Antigüedad de la cuenta de pago* Fecha en que la cuenta de pago se |
Longitud: 8 caracteres Tipo de datos: fecha Formato aceptado: Formato de fecha = AAAAMMDD |
Mpi.paymentAccountAgeIndicator |
Indicador de antigüedad de la cuenta de pago* Indica el período de tiempo que la cuenta de pago se suscribió a la cuenta del titular de la tarjeta con el comerciante. |
Longitud: 2 caracteres Tipo de datos: cadena Valores aceptados: • 01 = Ninguna cuenta (compra como invitado) • 02 = Creada durante esta transacción • 03 = Menos de 30 días • 04 = 30−60 días • 05 = Más de 60 días |
Mpi.provisionAttemptsInTheLast24Hours |
Número de intentos de aprovisionamiento al día. Número de intentos de añadir tarjeta en |
Tipo de datos: Int entre 0 y 9999 |
Mpi.shippingAddressUsage |
Uso de la dirección de envío. Indica cuándo se usó por primera vez la |
Longitud: 8 caracteres Tipo de datos: Fecha Formato aceptado: Formato de fecha = AAAAMMDD |
Mpi.shippingAddressWasFirstUsed |
Indicador del uso de la dirección de envío. Gibt an, wann diese Lieferadresse das erste Mal |
Longitud: 2 caracteres Tipo de datos: cadena Valores aceptados: • 01 = Esta transacción • 02 = Menos de 30 días • 03 = 30−60 días • 04 = Más de 60 días |
Mpi.shippingNameAndCardholderNameAreIdentical |
Indicador del nombre de envío. Indica si el nombre del titular de la tarjeta de la cuenta es idéntico al nombre de envío usado para esta transacción. |
Tipo de datos: Booleano Valores aceptados:
|
Mpi.suspiciousAccountActivityDetected |
Actividad de cuenta sospechosa. Indica si el comerciante ha observado |
Tipo de datos: Booleano |
Mpi.transactionActivityInTheLast24Hours |
Número de transacciones al día. Número de transacciones (correctas o |
Tipo de datos: Int entre 0 y 999 |
Mpi.transactionActivityLastYear |
Número de transacciones al año. Número de transacciones (correctas o |
Tipo de datos: Int entre 0 y 9999 |
Mpi.challengeWindowSize |
Tamaño de ventana de comprobación. Dimensiones de la ventana de |
Longitud: 2 caracteres Si no envía este parámetro, el valor predeterminado es 05 = Full screen |
Mpi.HomePhone.countryCode |
Código de país del número de teléfono particular. Código de país de un número de teléfono particular. |
Tipo de datos: cadena Longitud: 3 caracteres ITU-E.164 código de país. |
Mpi.HomePhone.subscriber |
Teléfono particular. Teléfono particular (sin código de país) |
Tipo de datos: cadena Longitud: 0 y 15 |
Mpi.deliveryEmailAddress |
Dirección de correo electrónico de entrega. En entregas electrónicas, la dirección de |
Longitud: máx. 254 caracteres Tipo de datos: cadena |
Mpi.deliveryTimeframe |
Período de tiempo de entrega. Indica el período de tiempo de entrega |
Longitud: 2 caracteres Tipo de datos: cadena Valores aceptados: • 01 = Entrega electrónica • 02 = Envío el mismo día • 03 = Envío al día siguiente • 04 = Envío en dos días o más |
Mpi.giftCardAmount |
Importe de tarjeta de regalo. En compras prepagadas o de tarjetas de regalo, el importe total del prepago o de la(s) tarjeta(s) de regalo en cifras |
Longitud: máx. 15 caracteres Tipo de datos: Int Entre 0 y 999999999999999 |
Mpi.giftCardCount |
Recuento de tarjeta de regalo. En compras prepagadas o de tarjetas de regalo, el número total de prepagos o tarjetas de regalo/códigos comprados. |
Tipo de datos: Int Entre 0 y 99 |
Mpi.giftCardCurrency |
Moneda de tarjeta de regalo. En compras prepagadas o de tarjetas de regalo, el código de moneda de la tarjeta, tal y como se define en ISO 4217. |
Longitud: 3 caracteres Tipo de datos: cadena |
Mpi.preOrderDate |
Fecha de pedido por adelantado. En compras de pedidos por adelantado, la fecha estimada en la que la mercancía estará disponible. |
Longitud: 8 caracteres Tipo de datos: Fecha Formato aceptado: Formato de fecha = AAAAMMDD |
Mpi.cardholderAccountChange |
Cambio de la cuenta del titular de la tarjeta* Fecha en que se modificó por última vez |
Longitud: 8 caracteres Tipo de datos: fecha Formato aceptado: Formato de fecha = AAAAMMDD |
Mpi.preOrderPurchaseIndicator |
Indicador de compra de pedido por adelantado. Indica si el titular de la tarjeta está |
Longitud: 2 caracteres Tipo de datos: cadena Valores aceptados: • 01 = Mercancía disponible • 02 = Disponibilidad futura |
Mpi.reorderItemsIndicator |
Indicador de repetición de pedido de artículos. Indica si el titular de la tarjeta está |
Longitud: 2 caracteres Tipo de datos: cadena Valores aceptados: • 01 = Primera vez que se hace el pedido • 02 = Se ha vuelto a pedir |
Mpi.shippingIndicator |
Indicador de envío. Indica el método de envío elegido para la transacción. Los comerciantes deben |
Longitud: 2 caracteres Tipo de datos: cadena Valores aceptados: • 01 = Enviar a la dirección de facturación del titular de la tarjeta • 02 = Enviar a otra dirección verificada registrada por el comerciante • 03 = Enviar a una dirección distinta de la dirección de facturación del titular de la tarjeta • 04 = “Enviar a tienda”/Recoger en tienda cercana (la dirección de la tienda se rellenará en los campos de dirección de envío) • 05 = Bienes digitales (incluye servicios en línea, tarjetas de regalo electrónicas y códigos de canje) • 06 = Billetes de transporte y entradas de eventos, no se envían • 07 = Otros (por ejemplo, juegos, servicios digitales no enviados, suscripciones electrónicas, etc.) |
Mpi.MobilePhone.countryCode |
Código de país del número de teléfono móvil. Código de país de un número de teléfono |
Tipo de datos: cadena Longitud: 3 caracteres ITU-E.164 código de país |
Mpi.MobilePhone.subscriber |
Teléfono móvil. Teléfono móvil (sin código de país) |
Tipo de datos: cadena Longitud: 0 y 15 |
Mpi.threeDSRequestorAuthenticationData |
Datos de autenticación del comerciante. Datos que documentan y apoyan un proceso de autenticación específico. En la versión actual de la especificación, este elemento de datos no se define en detalle; no obstante, la intención es que, para cada método de autenticación, este campo contenga los datos que el ACS pueda usar para verificar el proceso de autenticación. Por ejemplo, para el método: |
Longitud: máx. 2.048 bytes Tipo de datos: cadena Valor aceptado: cualquiera |
Mpi.threeDSRequestorAuthenticationMethod |
Método de autenticación del comerciante. Mecanismo empleado por el titular de la tarjeta para autenticarse con el |
Longitud: 2 caracteres Tipo de datos: cadena Valores aceptados: • 01 = Ninguna autenticación de comerciante (por ejemplo, el titular de la tarjeta ha “iniciado sesión” como invitado) • 02 = Inicio de sesión en la cuenta del titular de la tarjeta a través del sistema del comerciante con las propias credenciales del comerciante • 03 = Inicio de sesión en la cuenta del titular de la tarjeta a través del sistema del comerciante con un identificador federado • 04 = Inicio de sesión en la cuenta del titular de la tarjeta a través del sistema del comerciante con credenciales del emisor • 05 = Inicio de sesión en la cuenta del titular de la tarjeta a través del sistema del comerciante con autenticación de terceros • 06 = Inicio de sesión en la cuenta del titular de la tarjeta a través del sistema del comerciante con autenticador FIDO • 07–79 = Reservado para futuro uso de EMVCo (valores no válidos hasta que sean definidos por EMVCo) • 80–99 = Reservado para uso DS |
Mpi.threeDSRequestorAuthenticationTimestamp |
Marca de hora de autenticación del comerciante. Fecha y hora UTC de la autenticación del titular de la tarjeta. |
Longitud: 14 caracteres Tipo de datos: Fecha - Hora Formato aceptado: Formato de fecha = AAAAMMDDHHMMSS |
Mpi.threeDSRequestorPriorAuthenticationData |
Datos de autenticación de transacción previa del comerciante. Datos que documentan y apoyan un |
Longitud: máx. 2.048 bytes Formato: cualquiera |
Mpi.threeDSRequestorPriorAuthenticationMethod |
Métodos de autenticación de transacción previa del comerciante. Mecanismo empleado por el titular de la tarjeta para autenticarse previamente con el comerciante |
Longitud: 2 caracteres Tipo de datos: cadena Valores aceptados: • 01 = Autenticación sin problemas por el ACS • 02 = Comprobación del titular de la tarjeta por el ACS • 03 = Verificación AVS • 04 = Otros métodos del emisor • 05–79 = Reservado para futuro uso de EMVCo (valores no válidos hasta que sean definidos por EMVCo) • 80–99 = Reservado para uso DS |
Mpi.threeDSRequestorPriorAuthenticationTimestamp |
Marca de hora de autenticación de transacción previa del comerciante. Fecha y hora UTC de la autenticación |
Longitud: 14 caracteres Tipo de datos: Fecha - Hora Formato aceptado: Formato de fecha = AAAAMMDDHHMMSS |
Mpi.threeDSRequestorPriorReference |
Referencia de transacción previa del comerciante. Esta opción proporciona información |
Longitud: 36 caracteres Tipo de datos: cadena Valor aceptado: Esta opción contiene el identificador de transacción ACS de una transacción autenticada previamente (por ejemplo, la primera transacción recurrente autenticada con el titular de la tarjeta). |
Mpi.transactionType |
Tipo de transacción. Identifica el tipo de transacción que se |
Longitud: 2 caracteres Tipo de datos: cadena Valores aceptados: • 01 = Compra de bienes/servicios • 03 = Aceptación de cheques • 10 = Financiación de la cuenta • 11 = Transacción en cuasi efectivo • 28 = Activación de prepago y carga |
Mpi.WorkPhone.countryCode |
Código de país del número de teléfono de trabajo. Código de país de un número de teléfono de trabajo. |
Tipo de datos: cadena Longitud: 3 caracteres ITU-E.164 código de país |
Mpi.WorkPhone.subscriber |
Teléfono de trabajo. Teléfono utilizado con profesionales (sin código de país) |
Tipo de datos: cadena Longitud: 0 y 15 |
TP | Para cambiar el diseño de la página "order_A3DS", puede enviar un nombre/url de plantilla con este parámetro. (vaya a e-Commerce: Plantilla dinámica). | N/A |
WIN3DS | Forma de mostrar la página de identificación al cliente. Valores posibles:
|
An máx. 6 caracteres |
ADDRMATCH |
addrMatch. Indica si consideramos que la dirección de |
Longitud: 1 carácter Valores aceptados: · 1=sí · 0=no |
TRXDATE |
purchaseDate. Fecha de la transacción. |
MM/DD/AA |
ECOM_SHIPTO_POSTAL_CITY |
shipAddrCity. Ciudad de envío |
Longitud: variable, máx. 40 |
ECOM_SHIPTO_POSTAL_STREET_LINE1 |
shipAddrLine1. Dirección de envío, primera línea |
Longitud: variable, máx. 35 |
ECOM_SHIPTO_POSTAL_STREET_LINE2 |
shipAddrLine2. Dirección de envío, segunda línea |
Longitud: variable, máx. 35 |
ECOM_SHIPTO_POSTAL_POSTALCODE
|
Código postal de envío |
AN Longitud: 10 |
ECOM_SHIPTO_POSTAL_COUNTRYCODE |
shipAddrPostCode. Código postal de envío |
Longitud: máx. 2 |
Mpi.carteBancaire.AcquirerExemption |
Solicitud de aplicación de la exención del RTS Acquirer Transaction Risk Analysis |
Tipo de datos: booleano Valores aceptados: true false |
Mpi.carteBancaire.MerchantScore |
Tu puntuación calculada para esta transacción |
Tipo de datos: int Valores aceptados: puntuación suministrada por el comercio al DS, si está disponible, es decir: = any value e.g. "data" : {"value" : "Method 023 : A+"} |
Mpi.carteBancaire.NumberOfItems |
Número de artículos del pedido actual |
Tipo de datos: int Valores aceptados: entre 00 y 99 (99 para un número de artículos >= 99) |
Mpi.carteBancaire.Usecase |
Tipo de pago para el que se solicita autenticación |
Longitud: 2 caracteres Tipo de datos: cadena Valores aceptados:
|