3RI - Requestor-Initiated Authentication

Esta guía está destinada a los comerciantes PCI-DSS que utilizan nuestra API para realizar la autenticación.

La versión 2.2 del protocolo 3-D Secure introduce la autenticación iniciada por el comerciante o"3DS Requestor initiated (3RI) authentications".

3RI se utiliza sobre todo:

para pagar una de las cuotas de una suscripción
para pagar una de las cuotas de un pago en cuotas
con pagos MOTO

El caso de uso lo determina el valor de los campospaymentSource,useCaseYtransactionInitiator.

A continuación se muestran algunos ejemplos de cómo utilizarlo. 3RI :

Casos de uso	Etapa del pago	useCase	paymentSource	transactionInitiator
Suscripción con frecuencia y monto fijos.	Pago de una cuota determinada	`RECURRING_FIXED_TOTALAMOUNT`	`EC`	`MERCHANT`
Suscripción con frecuencias y/o montos fijos.	Pago de una cuota determinada	`RECURRING_ VARIABLE_TOTAL_AMOUNT`	`EC`	`MERCHANT`
Pago en vencimientos	Pago de una cuota determinada	`INSTALLMENT`	`EC`	`MERCHANT`
Pago por correo	Pago	`PAYMENT`	`MAIL_ORDER`	n/a
Pago por teléfono	Pago	`PAYMENT`	`TELEPHONE_ORDER`	n/a

Principio de funcionamiento

El principio general se aplica a las autenticaciones "3RI".
Una sola llamada al servicio WebPCI/Charge/AuthenticateEl vendedor no debe procesar ninguna instruccióndeviceni transmitir ningún objeto.

Lista de campos relativos a3RI:

APELLIDO Descripción

amount Entero| Longitud: 1-12 |OBLIGATORIO

Monto de la transacción expresado en la fracción más pequeña de la moneda (por ejemplo: 30050 por 300,50 EUR).

currency

Cadena| Longitud: 3 |OBLIGATORIO

Código del país según la norma ISO 4217-1 alpha-2 (por ejemplo: "EUR" por euro).

Valores posibles

Moneda	CODIFICACIÓN ISO 4217	Unidad fraccionaria
Dollar australien (036)	`AUD`	2
Dollar canadien (124)	`CAD`	2
Franc suisse (756)	`CHF`	2
Couronne danoise (208)	`DKK`	2
Euro (978)	`EUR`	2
Livre Sterling (826)	`GBP`	2
Yen (392)	`JPY`	0
Couronne norvégienne (578)	`NOK`	2
Couronne suédoise (752)	`SEK`	2
Dollar des États-Unis (840)	`USD`	2

productType

enumeración|Opcional

Tipo de producto correspondiente en la transacción.

Valores posibles

VALOR	Descripción
`ACCOUNT_FUNDING`	Depósito en una cuenta
`CHECK_ACCEPTANCE`	Verificación de la aceptación
`GOODS_OR_SERVICE_PURCHASE`	Compra de un bien o servicio. Valor predeterminado.
`PREPAID_ACTIVATION_AND_LOAD`	Activación y cargo de una tarjeta prepagada
`QUASI_CASH_TRANSACTION`	Transacciones en efectivo (por ejemplo: cheque de vacaciones, boleto de lotería, etc.)

transactionCategory enumeración|ignoré

Categoría de la transacción.

paymentSource

enumeración OBLIGATORIO

Origen del pago.

Valores posibles

VALOR	Descripción
`EC`	E-commerce. Casos de uso típicos. Pago iniciado por el comprador con ingreso de los datos de la tarjeta.
`MAIL_ORDER`	Pago de venta a distancia iniciado por el vendedor por correo o e-mail.
`TELEPHONE_ORDER`	Pago de venta a distancia iniciado por el vendedor por teléfono.

transactionInitiator

enumeración|Opcional

Iniciador de la transacción.

Valores posibles

</tbody>

VALOR	Descripción
`CUSTOMER`	Transacción iniciada por el comprador (CIT).
`MERCHANT`	Transacción iniciada por el vendedor (MIT).

useCase

enumeración|OBLIGATORIO

Casos de uso de la transacción.

Valores posibles

VALOR	Descripción
`INSTALLMENT`	Pago en vencimientos.
`MAINTAIN_CARD`	Se utiliza por ejemplo para confirmar el estado de la tarjeta con pagos recurrentes (suscripciones o pagos en cuotas).
`OTHER_USE_CASE`	Otros casos de uso.
`PAYMENT`	Pago al contado.
`RECURRING_VARIABLE_TOTALAMOUNT`	Suscripción con frecuencias y/o montos fijos.
`RECURRING_FIXED_TOTALAMOUNT`	Suscripción con frecuencia y monto fijos.
`REGISTER`	Se guarda la tarjeta.
`SHIPMENT_MULTIPLE_AUTHORISATION`	Pago al envío con autorizaciones múltiples.
`SHIPMENT_SINGLE_AUTHORISATION`	Pago al envío con autorización simple.
`TOP_UP`	Recargo de cuenta.
`TRUST_LIST_STATUS_CHECK`	Se utiliza para preguntarle al emisor si el vendedor figura en la lista de beneficiarios de confianza del comprador. En dicho caso, el vendedor puede solicitar una exención de la autentificación fuerte durante el pago.
`VERIFY_ONLY`	Se utiliza por ejemplo para confirmar el saldo de la tarjeta con pagos recurrentes (suscripciones o pagos en cuotas).

customer

objeto JSON|OBLIGATORIO

Objeto que contiene la información del comprador.

Detalles del objeto

APELLIDO Descripción

reference Cadena| Longitud: 0-80 |Opcional

Identificador del comprador en el sitio web comercial.

email Cadena| Longitud: 0-150 |Recomendado

E-mail

accountDetails

objeto JSON|Recomendado

Objeto que detalla la información de la cuenta del comprador en el sitio web comercial.

Detalles del objeto

APELLIDO Descripción

authenticationMethod

enumeración|Recomendado

Método de autentificación del comprador en el sitio web comercial.

Valores posibles

VALOR	Descripción
`GUEST`	Sin autentificación (invitado).
`PERSONAL_CREDENTIALS`	Uso de una cuenta creada en el sitio web comercial.
`FEDERATED_CREDENTIALS`	Uso de la autentificación federada.
`ISSUER_CREDENTIALS`	Uso de información de conexión entregada por el emisor.
`EXTERNAL_CREDENTIALS`	Autentificación realizada por un tercero.
`FIDO_CREDENTIALS`	Uso de la autentificación FIDO (Fast IDentity Online).

billingDetails

objeto JSON|Opcional

Objeto que contiene la información del comprador.

Detalles del objeto

APELLIDO Descripción

title

Cadena| Longitud: 0-63 |Opcional

Tratamiento del comprador.

Ejemplos de valores

Sr.
Sr.
Sra.

category

enumeración|Opcional

Tipo de cliente.

Valores posibles

VALOR	Descripción
`PRIVATE`	Cliente de tipo Particular.
`COMPANY`	Cliente de tipo "Empresa".

firstName Cadena| Longitud: 0-63 |Opcional

Nombre.

lastName Cadena| Longitud: 0-63 |Opcional

APELLIDO.

phonenumber

Cadena| Longitud: 0-32 |Opcional

Número de teléfono fijo.

Ejemplos de valores

0123456789
+33123456789
0033123456789
(00.571) 638.14.00
40 41 42 42

streetNumber Cadena| Longitud: 0-64 |Opcional

Número de calle.

address Cadena| Longitud: 0-255 |Opcional

Dirección de facturación.

address2 Cadena| Longitud: 0-255 |Opcional

Información adicional de la dirección.

district Cadena| Longitud: 0-127 |Opcional

Barrio.

zipCode Cadena| Longitud: 0-64 |Opcional

Código Postal.

city Cadena| Longitud: 0-128 |Opcional

Ciudad.

state Cadena| Longitud: 0-127 |Opcional

Región.

country

Cadena| Longitud: 2 |Opcional

Código del país (norma ISO 3166 alpha-2).

Ejemplos de valores

VALOR	Descripción
`AT`	AUSTRIA
`BE`	BÉLGICA
`FR`	CÓRCEGA
`CI`	COSTA DE MARFIL
`FR`	FRANCIA
`GP`	GUADALUPE
`MQ`	MARTINICA
`NC`	NUEVA CALEDONIA
`PM`	SAN PEDRO Y MIQUELÓN
`PF`	POLINESIA FRANCESA

language

Cadena| Longitud: 2 |Opcional

Código del idioma (norma ISO 639-1).

Ejemplos de valores

VALOR	Descripción
`DE`	Alemán (Alemania)
`EN`	Inglés (Reino Unido)
`EN`	Inglés (Estados Unidos)
`ZH`	Chino (tradicional)
`ES`	Español (España)
`ES`	Español (Chile)
`FR`	Francés (Francia)
`IT`	Italiano (Italia)
`JP`	Japonés (Japón)
`NL`	Holandés (Países Bajos)
`PL`	Polaco (Polonia)
`PT`	Portugués (Brasil)
`PT`	Portugués (Portugal)
`RU`	Ruso (Rusia)

cellPhonenumber

Cadena| Longitud: 0-32 |Opcional

Número de teléfono móvil.

Ejemplos de valores

0623456789
+33623456789
0033623456789
(+34) 824 65 43 21
87 77 12 34

identityCode Cadena| Longitud: 0-150 |Opcional

Identificación nacional.

identityType

Cadena| Longitud: 0-3 |Opcional

Tipo del documento de identidad.

Valores posibles

País	Tipo	Descripción
Argentina	`DNI`	Documento Nacional de Identidad.
Brasil	`CNPJ`	Cadastro Nacional da Pessoa Jurídica.
Brasil	`CPF`	Cadastro de Pessoas Físicas.
Colombia	`CC`	Cédula de ciudadania.
	`TI`	Tarjeta de Identidad.
	`CE`	Cédula de Extranjeria.
	`NI`	Número de Identificación Tributaria.
	`PS`	Pasaporte.
Peru	`DNI_PER`	Documento National de Identidad.
	`PAR`	Partida de Nacimiento.
	`PAS`	Pasaporte.
	`LMI`	Libreta Militar.
	`NAN`	Otro.

legalName Cadena| Longitud: 0-100 |Opcional

Razón social.

shippingDetails

objeto JSON|Opcional

Objeto que contiene la información de envío.

Detalles del objeto

APELLIDO Descripción

category

enumeración|Opcional

Tipo de cliente.

Valores posibles

VALOR	Descripción
`PRIVATE`	Cliente de tipo Particular.
`COMPANY`	Cliente de tipo "Empresa".

firstName Cadena| Longitud: 0-63 |Opcional

Nombre.

lastName Cadena| Longitud: 0-63 |Opcional

APELLIDO.

phonenumber

Cadena| Longitud: 0-32 |Opcional

Número de teléfono fijo.

Ejemplos de valores

0123456789
+33123456789
0033123456789
(00.571) 638.14.00
40 41 42 42

streetNumber Cadena| Longitud: 0-64 |Opcional

Número de calle.

address Cadena| Longitud: 0-255 |Opcional

Dirección de entrega.

address2 Cadena| Longitud: 0-255 |Opcional

Información adicional sobre la dirección de envío.

district Cadena| Longitud: 0-127 |Opcional

Barrio.

zipCode Cadena| Longitud: 0-64 |Opcional

Código Postal.

city Cadena| Longitud: 0-128 |Opcional

Ciudad.

state Cadena| Longitud: 0-127 |Opcional

Región.


country

Cadena| Longitud: 2 |Opcional

Código del país (norma ISO 3166 alpha-2).

Ejemplos de valores

VALOR	Descripción
`AT`	AUSTRIA
`BE`	BÉLGICA
`FR`	CÓRCEGA
`CI`	COSTA DE MARFIL
`FR`	FRANCIA
`GP`	GUADALUPE
`MQ`	MARTINICA
`NC`	NUEVA CALEDONIA
`PM`	SAN PEDRO Y MIQUELÓN
`PF`	POLINESIA FRANCESA

deliveryCompanyName Cadena| Longitud: 0-127 |Opcional

Nombre de la empresa de envío.


shippingSpeed

enumeración|Opcional

Plazo de entrega.

Valores posibles

VALOR	Descripción
`STANDARD`	Entrega estándar.
`EXPRESS`	Entrega en 24 horas.
`PRIORITY`	-MISSED-ON-SOURCE-af02ef0e65a667ccdb3eff3d5ff103dbb07e5a15f98a2182543ef8822ab9be09.


shippingMethod

enumeración|Opcional

Modo de entrega.

Valores posibles

VALOR	Descripción
`RECLAIM_IN_SHOP`	Retiro en tienda.
`RELAY_POINT`	Uso de una red de puntos de retiro de terceros (Kiala, Alveol, etc.).
`RECLAIM_IN_STATION`	Retiro en un aeropuerto, una estación o una agencia de viajes.
`PACKAGE_DELIVERY_COMPANY`	Entrega por transportista (Colissimo, UPS, etc.).
`ETICKET`	Emisión de un ticket electrónico, descarga de producto virtual.

Valores reservados para un uso futuro:

VALOR	Descripción
`CARD_HOLDER_ADDRESS`	Entrega al comprador.
`VERIFIED_ADDRESS`	Entrega a una dirección verificada.
`NOT_VERIFIED_ADDRESS`	Entrega a una dirección no verificada.
`SHIP_TO_STORE`	Entrega en tienda.
`DIGITAL_GOOD`	Entrega digital.
`ETRAVEL_OR_ETICKET`	Boleto electronico.
`OTHER`	Otro.
`PICKUP_POINT`	Retiro en un punto de relevo.
`AUTOMATED_PICKUP_POINT`	Recoger en el punto de relevo automático.

identityCode Cadena| Longitud: 0-150 |Opcional

Identificación nacional.

legalName Cadena| Longitud: 0-100 |Opcional

Razón social.

shoppingCart

objeto JSON|Opcional

Objeto que contiene la información del carrito.

Detalles del objeto

APELLIDO Descripción

insuranceAmount Entero| Longitud: 1-12 |Opcional

Monto del seguro de todo el pedido expresado en la fracción monetaria más pequeña de la moneda (ejemplo: 30050 por 300,50 EUR).

shippingAmount Entero| Longitud: 1-12 |Opcional

Monto de los gastos de envío de todo el pedido expresado en la fracción monetaria más pequeña de la moneda (ejemplo: 30050 por 300,50 EUR).

taxAmount Entero| Longitud: 1-12 |Opcional

Monto de los impuestos de todo el pedido expresado en la fracción monetaria más pequeña de la moneda (ejemplo: 30050 por 300,50 EUR).

cartItemInfo

tabla |Opcional

Lista de objetosCustomer/ShoppingCartItemque contiene la información de cada artículo del carrito.

Detalles del objeto

APELLIDO Descripción

productLabel Cadena| Longitud: 0-255 |Opcional

Nombre del producto.

productType

enumeración|Opcional

Tipo de producto.

Valores posibles

VALOR	Descripción
`FOOD_AND_GROCERY`	Alimentos y productos comestibles.
`AUTOMOTIVE`	Automotriz / Motocicleta.
`ENTERTAINMENT`	Entretenimiento / Cultura.
`HOME_AND_GARDEN`	Casa y jardín.
`HOME_APPLIANCE`	Equipamiento de la casa.
`AUCTION_AND_GROUP_BUYING`	Subastas y compras a granel.
`FLOWERS_AND_GIFTS`	Flores y regalos.
`COMPUTER_AND_SOFTWARE`	Computadoras y software.
`HEALTH_AND_BEAUTY`	Salud y belleza.
`SERVICE_FOR_INDIVIDUAL`	Servicios a domicilio.
`SERVICE_FOR_BUSINESS`	Servicios de negocios.
`SPORTS`	Deportes.
`CLOTHING_AND_ACCESSORIES`	Ropa y accesorios.
`TRAVEL`	Viajes.
`HOME_AUDIO_PHOTO_VIDEO`	Sonido, imagen y video.
`TELEPHONY`	Telefonía.

productRef Cadena| Longitud: 0-64 |Opcional

Referencia del producto.

productQty Entero| Longitud: 1-12 |Opcional

Cantidad del producto.

productAmount Entero| Longitud: 1-12 |Opcional

Monto del producto expresado en la fracción más pequeña de la moneda (por ejemplo: 30050 por 300,50 EUR).

productVat

Cadena| Longitud: 1-12 |Opcional

Monto del IVA del producto.

Tipos de valores posibles:

Un número entero
Para expresar un monto en céntimos aplicado al producto en cuestión.
Número decimal
Para expresar un porcentaje aplicado al monto del producto en cuestión con un máximo de 4 dígitos después del punto decimal.

El decimal es obligatorio para expresar un porcentaje. La posición decimal está marcada por el carácter ".".

previousAuthentication

objeto JSON|OBLIGATORIO

Objeto que contiene los datos del último método de autentificación utilizado.

Detalles del objeto

APELLIDO Descripción

dsTransID Cadena| Longitud: 36 |OBLIGATORIO

ID único de la transacción generado por el Directory Server (por ejemplo: 4317fdc3-ad24-5443-8000-000000000891).

acsTransID Cadena| Longitud: 36 |OBLIGATORIO

ID único de la transacción generado por el ACS (por ejemplo: d727ebfe-de4c-4682-85fa-e60ca00a9cff).

dateTime Cadena| Longitud: 25 |OBLIGATORIO

Fecha y hora de la autentificación en formato ISO 8601 y en huso horario UTC (por ejemplo: 2024-10-14T14:57:37+00:00).

effectiveAuthenticationType

enumeración|OBLIGATORIO

Último método de autentificación utilizado.

Valores posibles

VALOR	Descripción
`FRICTIONLESS`	Autentificación sin interacción del comprador.
`CHALLENGE`	Autentificación con interacción del comprador.
`DATA_ONLY`	Autentificación procesada por el DS sin interacción del comprador.

device objeto JSON|ignoré

Objeto que contiene la información del navegador.

paymentForm

objeto JSON|OBLIGATORIO

Objeto que contiene los datos de la tarjeta.

Detalles del objeto

APELLIDO Descripción

networkPreference

enumeración|OBLIGATORIO

Nombre de la red preferida recomendada por el vendedor.

Valores posibles

VALOR	Descripción
`AMEX`	Red American Express (Safekey)
`CB`	Red Carte Bancaire
`DINERS`	Red Diners
`DISCOVER`	Red Discover
`MASTERCARD`	Red Mastercard
`VISA`	Red Visa

accountType

enumeración|Opcional

Tipo de tarjeta.

Valores posibles

VALOR	Descripción
`CREDIT`	Tarjeta crédito
`DEBIT`	Tarjeta débito

pan Cadena| Longitud: 16-19 |OBLIGATORIO

Primary Account Number. Número de tarjeta.

expiryMonth Entero| Longitud: 2 |OBLIGATORIO

Mes de expiración escrito con dos dígitos. Ejemplo: "09" por septiembre.

expiryYear Entero| Longitud: 2 |OBLIGATORIO

Año de expiración escrito con dos dígitos. Ejemplo: "28" por 2028.

cardHolderName Cadena| Longitud: 0-45 |Opcional

Nombre completo del titular de la tarjeta.

installmentNumber Entero| Longitud: 3 |Opcional

Cantidad de cuotas.

protocolRequest

objeto JSON|OBLIGATORIO

Objeto que contiene la información del protocolo de autentificación.

Detalles del objeto

APELLIDO Descripción

name

enumeración|OBLIGATORIO

Nombre del protocolo de autentificación del titular de la tarjeta.

Valores posibles

VALOR	Descripción
`THREEDS`	Protocolo 3-D Secure

version

Cadena| Longitud: 1 |Opcional

Versión del protocolo de autentificación.

Valores posibles

VALOR	Descripción
`2`	Protocolo 3-D Secure 2

challengePreference enumeración|ignoré

Permite solicitar una autentificación con o sin interacción del comprador.

merchant

objeto JSON|OBLIGATORIO

Objeto que contiene los detalles del contrato.

Detalles del objeto

APELLIDO	Descripción
`mid`	Cadena\| Longitud: 1-128 \|OBLIGATORIO Merchant ID. Número de afiliación.
`tid`	Cadena\| Longitud: 0-128 \|Opcional Terminal ID. ID del punto de venta definido en el contrato. Este campo solo se utiliza en Colombia para elegir entre REDEBAN y CREDIBANCO.
`name`	Cadena\| Longitud: 0-25 \|Opcional Nombre del comercio.
`mcc`	Cadena\| Longitud: 10 \|Opcional Merchant Category Code. Código específico del DS del emisor y que describe el tipo de actividad, de producto o de servicio del vendedor.

recurring

objeto JSON|Opcional

Objeto que contiene la información de la suscripción.

Detalles del objeto

APELLIDO Descripción

expiryDate Cadena| Longitud: 10 |Opcional

Fecha de expiración de la suscripción (formato AAAA-MM-JJ).

frequency

objeto JSON| Longitud: 0-150 |Opcional

Objeto que contiene la información de la frecuencia de la suscripción.

Detalles del objeto

APELLIDO Descripción

value Entero| Longitud: 3 |Opcional

Cantidad mínima de unidades entre dos pagos (por ejemplo: 12). Consultar campounit.

unit

enumeración|Opcional

Unidad de frecuencia de la suscripción.

Valores posibles

VALOR	Descripción
`DAY`	En días.
`MONTH`	En meses.
`YEAR`	En años.

La respuesta contiene los datos de autentificación necesarios para realizar una petición de autorización en el futuro.

Casos de uso

Suscripciones

Etapa 1 - Contratación de la suscripción (titular presente)

Llamar al servicio webPCI/Cargar/Autenticar Para autenticar al comprador:

Frecuencia y montos fijos

{
  "amount":"9990",
  "currency":"EUR",
  "recurring":{
    "expiryDate": "2025-05-13",
    "frequency": {
        "unit": "DAY",
        "value": "30"
    }
  },
  "transactionCategory":"PAYMENT",
  "productType":"GOODS_OR_SERVICE_PURCHASE",
  "merchant": {
    "mid":"9876357"
  },
  "paymentForm": {
    "expiryMonth":"09",
    "expiryYear":"28",
    "networkPreference":"VISA",
    "pan":"4970110000000021"
  },
  "device": {
    "acceptHeader":"text/html",
    "colorDepth":"32",
    "deviceType":"BROWSER",
    "ip":"69.89.31.226",
    "javaEnabled": true,
    "language":"FR",
    "screenHeight":"768",
    "screenWidth":"1258",
    "timeZoneOffset":"-120",
    "userAgent":"Mozilla/5.0 (Windows NT 6.1; Win64; x64; rv:47.0) Gecko/20100101"
  },
  "protocolRequest": {
    "name":"THREEDS",
    "version":"2",
    "challengePreference":"NO_PREFERENCE"
  }
}

Frecuencia y/o montos variables

{
  "amount":"9990",
  "currency":"EUR",
  "recurring":{
    "expiryDate": "2025-05-13",
    "frequency": {
        "unit": "DAY",
        "value": "30"
    }
  },
  "transactionCategory":"PAYMENT",
  "productType":"GOODS_OR_SERVICE_PURCHASE",
  "merchant": {
    "mid":"9876357"
  },
  "paymentForm": {
    "expiryMonth":"09",
    "expiryYear":"28",
    "networkPreference":"VISA",
    "pan":"4970110000000021"
  },
  "device": {
    "acceptHeader":"text/html",
    "colorDepth":"32",
    "deviceType":"BROWSER",
    "ip":"69.89.31.226",
    "javaEnabled": true,
    "language":"FR",
    "screenHeight":"768",
    "screenWidth":"1258",
    "timeZoneOffset":"-120",
    "userAgent":"Mozilla/5.0 (Windows NT 6.1; Win64; x64; rv:47.0) Gecko/20100101"
  },
  "protocolRequest": {
    "name":"THREEDS",
    "version":"2",
    "challengePreference":"NO_PREFERENCE"
  }
}

El objeto recurring es obligatorio para definir la frecuencia de las cuotas y la fecha de término de la suscripción.

Siga la guía de integración de servicios webPCI/Cargar/Autenticar para procesar instrucciones y autenticar al portador.

Tras obtener el resultado final, puede proseguir con la petición de autorización.

Etapa 2 - Pago de las cuotas (titular ausente)

En cada fecha límite, llama al servicio webPCI/Cargar/Autenticar para solicitar autenticación 3RI .

El objeto recurring es obligatorio para definir la frecuencia de las cuotas y la fecha de término de la suscripción.

En el objeto previousAuthentication debe transmitir los datos de la autentificación obtenidos al contratar la suscripción.

Frecuencia y montos fijos

{
  "amount":"9990",
  "currency":"EUR",
  "transactionInitiator": "MERCHANT",
  "useCase": "RECURRING_FIXED_TOTALAMOUNT",
  "recurring":{
    "expiryDate": "2025-05-13",
    "frequency": {
        "unit": "DAY",
        "value": "30"
    }
  },
  "productType":"GOODS_OR_SERVICE_PURCHASE",
  "merchant": {
    "mid":"9876357"
  },
  "paymentForm": {
    "expiryMonth":"09",
    "expiryYear":"28",
    "networkPreference":"VISA",
    "pan":"4970110000000021"
  },
  "customer": {
    "previousAuthentication": {
        "dsTransID":"18e46ff7-b882-4102-9af4-aef9f40ee6a6",
        "acsTransID":"410d9fb4-8db1-483e-9a80-f94c3a79017e",
        "dateTime": "2024-10-09T06:37:22+00:00",
        "effectiveAuthenticationType": "CHALLENGE"
    }
  },
  "protocolRequest": {
    "name":"THREEDS",
    "version":"2"
  }
}

Frecuencia y/o montos variables

{
  "amount":"9990",
  "currency":"EUR",
  "transactionInitiator": "MERCHANT",
  "useCase": "RECURRING_VARIABLE_TOTAL_AMOUNT",
  "recurring":{
    "expiryDate": "2025-05-13",
    "frequency": {
        "unit": "DAY",
        "value": "30"
    }
  },
  "productType":"GOODS_OR_SERVICE_PURCHASE",
  "merchant": {
    "mid":"9876357"
  },
  "paymentForm": {
    "expiryMonth":"09",
    "expiryYear":"28",
    "networkPreference":"VISA",
    "pan":"4970110000000021"
  },
  "customer": {
    "previousAuthentication": {
        "dsTransID":"18e46ff7-b882-4102-9af4-aef9f40ee6a6",
        "acsTransID":"410d9fb4-8db1-483e-9a80-f94c3a79017e",
        "dateTime": "2024-10-09T06:37:22+00:00",
        "effectiveAuthenticationType": "CHALLENGE"
    }
  },
  "protocolRequest": {
    "name":"THREEDS",
    "version":"2"
  }
}

La respuesta incluye los datos de autentificación necesarios para la petición de autorización del pago de la cuota.

La siguiente tabla muestra las correspondencias entre los datos obtenidos en la etapa 1 y los datos obligatorios para la etapa 2:

Salida etapa 1 (titular presente)	Entrada etapa 2 (titular ausente)
`value.extension.dsTransID`	`customer.previousAuthentication.dsTransID`
`value.extension.acsTransID`	`customer.previousAuthentication.acsTransID`
`value.authenticationDateTime`	`customer.previousAuthentication.dateTime`
`value.authenticationType`	`customer.previousAuthentication.effectiveAuthenticationType`

Pago en cuotas

Etapa 1: Pago de la primera cuota (titular presente)

Llamar al servicio webPCI/Cargar/Autenticar Para autenticar al comprador. Se debe solicitar la autenticación del importe total de las cuotas.

{
  "amount":"12000",
  "currency":"EUR",
  "transactionCategory":"PAYMENT",
  "productType":"GOODS_OR_SERVICE_PURCHASE",
  "merchant": {
    "mid":"9876357"
  },
  "paymentForm": {
    "expiryMonth":"09",
    "expiryYear":"28",
    "networkPreference":"VISA",
    "pan":"4970110000000021",
    "installmentNumber": "3"
  },
  "device": {
    "acceptHeader":"text/html",
    "colorDepth":"32",
    "deviceType":"BROWSER",
    "ip":"69.89.31.226",
    "javaEnabled": true,
    "language":"FR",
    "screenHeight":"768",
    "screenWidth":"1258",
    "timeZoneOffset":"-120",
    "userAgent":"Mozilla/5.0 (Windows NT 6.1; Win64; x64; rv:47.0) Gecko/20100101"
  },
  "protocolRequest": {
    "name":"THREEDS",
    "version":"2",
    "challengePreference":"NO_PREFERENCE"
  }
}

En este ejemplo, el monto total de las cuotas es de 120,00 EUR.

El campo installmentNumber es obligatorio para indicar la cantidad de cuotas (ejemplo: "3" para un pago en 3 cuotas).

Siga la guía de integración de servicios webPCI/Cargar/Autenticar para procesar instrucciones y autenticar al portador.

Tras obtener el resultado final, puede proseguir con la petición de autorización por el monto de la primera cuota.

Etapa 2: Pago de una cuota determinada (titular ausente)

En cada fecha límite, llame al servicio webPCI/Cargar/Autenticar para solicitar autenticación 3RI por el importe de la cuota.

En el objeto previousAuthentication debe transmitir los datos de la autentificación obtenidos durante el pago de la primera cuota:

{
  "amount":"4000",
  "currency":"EUR",
  "transactionInitiator": "MERCHANT",
  "useCase": "INSTALLMENT",  
  "productType":"GOODS_OR_SERVICE_PURCHASE",
  "merchant": {
    "mid":"9876357"
  },
  "paymentForm": {
    "expiryMonth":"09",
    "expiryYear":"28",
    "networkPreference":"VISA",
    "pan":"4970110000000021",
    "installmentNumber": "3"
  },
  "customer": {
    "previousAuthentication": {
        "dsTransID":"18e46ff7-b882-4102-9af4-aef9f40ee6a6",
        "acsTransID":"410d9fb4-8db1-483e-9a80-f94c3a79017e",
        "dateTime": "2024-10-09T06:37:22+00:00",
        "effectiveAuthenticationType": "CHALLENGE"
    }
  },
  "protocolRequest": {
    "name":"THREEDS",
    "version":"2"
  }
}

En este ejemplo, la autentificación se realiza por un monto 40,00 EUR.

La respuesta incluye los datos de autentificación necesarios para la petición de autorización del pago de la cuota.

La siguiente tabla muestra las correspondencias entre los datos obtenidos en la etapa 1 y los datos obligatorios para la etapa 2:

Salida etapa 1 (titular presente)	Entrada etapa 2 (titular ausente)
`value.extension.dsTransID`	`customer.previousAuthentication.dsTransID`
`value.extension.acsTransID`	`customer.previousAuthentication.acsTransID`
`value.authenticationDateTime`	`customer.previousAuthentication.dateTime`
`value.authenticationType`	`customer.previousAuthentication.effectiveAuthenticationType`

Pago MOTO

Llamar al servicio webPCI/Cargar/Autenticar Para autenticar al comprador especificando su caso de uso:

Pago por teléfono

{
  "amount":"9990",
  "currency":"EUR",
  "paymentSource": "TELEPHONE_ORDER",
  "useCase": "PAYMENT",
  "productType":"GOODS_OR_SERVICE_PURCHASE",
  "merchant": {
    "mid":"9876357"
  },
  "paymentForm": {
    "expiryMonth":"09",
    "expiryYear":"28",
    "networkPreference":"VISA",
    "pan":"4970110000000021"
  },
  "protocolRequest": {
    "name":"THREEDS",
    "version":"2"
  }
}

Pago por correo

{
  "amount":"9990",
  "currency":"EUR",
  "paymentSource": "MAIL_ORDER",
  "useCase": "PAYMENT",
  "productType":"GOODS_OR_SERVICE_PURCHASE",
  "merchant": {
    "mid":"9876357"
  },
  "paymentForm": {
    "expiryMonth":"09",
    "expiryYear":"28",
    "networkPreference":"VISA",
    "pan":"4970110000000021"
  },
  "protocolRequest": {
    "name":"THREEDS",
    "version":"2"
  }
}

La respuesta contiene los datos de autentificación necesarios para realizar la petición de autorización.

Categoria

Tags

3RI - Requestor-Initiated Authentication

Principio de funcionamiento

Casos de uso