diff --git a/src/assets/apis/three-d-s-server/en.yaml b/src/assets/apis/three-d-s-server/en.yaml index 85a1d56..5e9de38 100644 --- a/src/assets/apis/three-d-s-server/en.yaml +++ b/src/assets/apis/three-d-s-server/en.yaml @@ -1,6 +1,6 @@ openapi: 3.0.0 info: - title: 3DS Server (MPI) + title: 3DS Server version: '1.0' description: 'Este documento presenta el funcionamiento del servicio o la API del 3DS Server. Expone las rutas a consumir (/sessions y /transactions), la url, el método, parámetros y los tipos datos que recibe. Además, contiene ejemplos de respuestas para diferentes tipos de peticiones en el flujo de autenticación de un tarjetahabiente dentro del marco del protocolo 3-D Secure.' contact: diff --git a/src/assets/apis/three-d-s-server/es.yaml b/src/assets/apis/three-d-s-server/es.yaml index 85a1d56..5e9de38 100644 --- a/src/assets/apis/three-d-s-server/es.yaml +++ b/src/assets/apis/three-d-s-server/es.yaml @@ -1,6 +1,6 @@ openapi: 3.0.0 info: - title: 3DS Server (MPI) + title: 3DS Server version: '1.0' description: 'Este documento presenta el funcionamiento del servicio o la API del 3DS Server. Expone las rutas a consumir (/sessions y /transactions), la url, el método, parámetros y los tipos datos que recibe. Además, contiene ejemplos de respuestas para diferentes tipos de peticiones en el flujo de autenticación de un tarjetahabiente dentro del marco del protocolo 3-D Secure.' contact: diff --git a/src/constants/navigations.js b/src/constants/navigations.js index 02268e9..3b634b4 100644 --- a/src/constants/navigations.js +++ b/src/constants/navigations.js @@ -445,7 +445,7 @@ export const TAB_NAVIGATION = { href: '/three-d-s-server/api/sessions', }, { - title: 'Detalle de los campos del api', + title: 'Datos adicionales', href: '/three-d-s-server/api/sessions/detail-info', }, ], @@ -580,7 +580,7 @@ export const TAB_NAVIGATION = { href: '/three-d-s-server/api/sessions' }, { - title: 'Detail Info', + title: 'Additional data', href: '/three-d-s-server/api/sessions/detail-info', }, ], diff --git a/src/pages/acs/3-d-s-secure-protocol.mdx b/src/pages/acs/3-d-s-secure-protocol.mdx index 710e432..e4d7968 100644 --- a/src/pages/acs/3-d-s-secure-protocol.mdx +++ b/src/pages/acs/3-d-s-secure-protocol.mdx @@ -4,8 +4,6 @@ El protocolo 3-D Secure es un documento que describe la infraestructura y los co El protocolo de autenticación 3-D Secure se basa en un modelo de tres dominios, en el que el Dominio del Adquirente y el Dominio del Emisor están conectados por el Dominio de Interoperabilidad a través de una serie de mensajes, con el fin de autenticar a un tarjetahabiente durante una transacción de comercio electrónico (e-commerce) o para verificar la identidad o la cuenta del tarjetahabiente en autenticaciones de no pago. -El protocolo cuenta actualmente con dos versiones activas, la versión 2.1.0 y la versión 2.2.0. La principal diferencia entre ambas versiones es que en la 2.1.0, la autenticación del tarjetahabiente siempre va a requerir de un reto para comprobar su identidad, el cual consiste en aportar información personal adicional o en la verificación de un código o similares. Mientras que en la versión 2.2.0, además del flujo con reto, se implementó el flujo de autenticación sin reto, esto para los casos en los cuales el tarjetahabiente aporte datos completos y seguros o esté en listas blancas; además se creó para esta versión otro tipo de autenticación nombrada como desacoplada. - De esta forma, el proceso de autenticación puede darse mediante un flujo sin fricción o con fricción, entendiendo la fricción como el reto para autenticarse. Siendo el componente de ACS, quien decide cual de estos flujos es el adecuado para completar una autenticación, dependiendo del nivel de legitimidad evaluado en la información provista por el tarjetabiente y de la versión utilizada del protocolo. # Dominios y Componentes diff --git a/src/pages/acs/authentication-status.mdx b/src/pages/acs/authentication-status.mdx index 317613e..565112c 100644 --- a/src/pages/acs/authentication-status.mdx +++ b/src/pages/acs/authentication-status.mdx @@ -18,7 +18,7 @@ Estado | Descripción Los siguientes son las razones de los estados anteriormente presentados, estas razones proporcionan más información del por qué una transacción puede presentar un estado específico. -### Razones de estados de autenticación para versiones 2.1.0 y 2.2.0 del protocolo 3DS: +### Razones de estados de autenticación para la version 2.2.0 del protocolo 3DS: Indicador | Razón | ------------|-------------------------------------------------------------------------------------------------------| @@ -65,13 +65,6 @@ Indicador | Razón 88 | Petición no soportada por ACS. | 89 | CAVV incluído en la respuesta. | -### Razones adicionales de estados de autenticación para versión 2.1.0 del protocolo 3DS: - -Indicador | Razón | -------------|-------------------------------------------------------------------------------------------------------| - 81 | Acepta la excepción de SCA (Estado válido para Mastercard). | - - ### Razones adicionales de estados de autenticación para versión 2.2.0 del protocolo 3DS: Indicador | Razón | diff --git a/src/pages/acs/issuer-configuration.mdx b/src/pages/acs/issuer-configuration.mdx index 0992d60..7d211a9 100644 --- a/src/pages/acs/issuer-configuration.mdx +++ b/src/pages/acs/issuer-configuration.mdx @@ -61,7 +61,7 @@ Se requiere que exista una relación entre emisor, adquiriente y comercio y que Importante tener en cuenta habilitar todos los campos de configuración del menú *Campos de configuración* de la aplicación, antes de crear el emisor, ya que todos estos campos son requeridos para el funcionamiento básico de un emisor. -En este punto es importante recordar que la aplicación de **MPI** también implementa y pertenece al flujo propuesto por el protocolo 3-D Secure para autenticar un tarjetahabiente. Pertenece al dominio el adquiriente y entre sus funciones principales están: +En este punto es importante recordar que la aplicación de **3DSS** también implementa y pertenece al flujo propuesto por el protocolo 3-D Secure para autenticar un tarjetahabiente. Pertenece al dominio el adquiriente y entre sus funciones principales están: - Recibir y responder la petición de autenticación enviada por el comercio o pasarela de pagos. - Solicitar al emisor la autorización del pago. - Responder al comercio o pasarela de pagos el estado final de la autenticación. diff --git a/src/pages/en/acs/3-d-s-secure-protocol.mdx b/src/pages/en/acs/3-d-s-secure-protocol.mdx index 24b168a..7ae75d8 100644 --- a/src/pages/en/acs/3-d-s-secure-protocol.mdx +++ b/src/pages/en/acs/3-d-s-secure-protocol.mdx @@ -6,8 +6,6 @@ El protocolo 3-D Secure es un documento que describe la infraestructura y los co El protocolo de autenticación 3-D Secure se basa en un modelo de tres dominios, en el que el Dominio del Adquirente y el Dominio del Emisor están conectados por el Dominio de Interoperabilidad a través de una serie de mensajes, con el fin de autenticar a un tarjetahabiente durante una transacción de comercio electrónico (e-commerce) o para verificar la identidad o la cuenta del tarjetahabiente en autenticaciones de no pago. -El protocolo cuenta actualmente con dos versiones activas, la versión 2.1.0 y la versión 2.2.0. La principal diferencia entre ambas versiones es que en la 2.1.0, la autenticación del tarjetahabiente siempre va a requerir de un reto para comprobar su identidad, el cual consiste en aportar información personal adicional o en la verificación de un código o similares. Mientras que en la versión 2.2.0, además del flujo con reto, se implementó el flujo de autenticación sin reto, esto para los casos en los cuales el tarjetahabiente aporte datos completos y seguros o esté en listas blancas; además se creó para esta versión otro tipo de autenticación nombrada como desacoplada. - De esta forma, el proceso de autenticación puede darse mediante un flujo sin fricción o con fricción, entendiendo la fricción como el reto para autenticarse. Siendo el componente de ACS, quien decide cual de estos flujos es el adecuado para completar una autenticación, dependiendo del nivel de legitimidad evaluado en la información provista por el tarjetabiente y de la versión utilizada del protocolo. # Dominios y Componentes diff --git a/src/pages/en/acs/a-c-s-general-configuration.mdx b/src/pages/en/acs/a-c-s-general-configuration.mdx index 68a0fb6..ebf6337 100644 --- a/src/pages/en/acs/a-c-s-general-configuration.mdx +++ b/src/pages/en/acs/a-c-s-general-configuration.mdx @@ -41,7 +41,7 @@ En este módulo se encuentran los componentes que permiten configurar ACS y gest - Listado y funcionalidades de las configuraciones para los emisores. - Listado y funcionalidades de los importes creados en la aplicación. - Estos módulos y sus funcionalidades, se revisan y explican detalladamente en la presente sección de *Configuración* y en los artículos que la componen. + Estos módulos y sus funcionalidades, se revisan y explican detalladamente en la presente sección de *Configuración* y en los artículos que la componen. #### Seguridad: En este módulo se encuentran los componentes que gestionan los accesos, registros de movimientos, permisos y módulos de seguridad para ACS. diff --git a/src/pages/en/acs/authentication-status.mdx b/src/pages/en/acs/authentication-status.mdx index 7959256..5ab184b 100644 --- a/src/pages/en/acs/authentication-status.mdx +++ b/src/pages/en/acs/authentication-status.mdx @@ -4,23 +4,23 @@ Los siguientes son los estados posibles que pueden obtenerse en un proceso de autenticación. Se presenta el indicador del estado y la descripción del mismo. -Estado | Descripción | --------|-----------------------------------------------------------------------------------------------------------| - Y | Autenticación satisfactoria. | - N | Autenticación fallida. Se rechazó la autenticación sin embargo el comercio puede aprobar la transacción asociada. | - U | Autenticación no realizada. Se presentó un error técnico durante el proceso. | - A | Se ejecutó un intento de autenticación. | - C | Se requiere desafío para continuar el proceso de autenticación. | - R | Autenticación rechazada. Una transacción cuya autenticación resulte en estado R no debería ser procesada debido al riesgo. | - D | La autenticación requiere un desafío desacoplado, este es responsabilidad del emisor. | - I | Autenticación de tipo informativa, no soporta pago. Utilizada para verificar cuentas. | +| Estado | Descripción | +|--------|----------------------------------------------------------------------------------------------------------------------------| +| Y | Autenticación satisfactoria. | +| N | Autenticación fallida. Se rechazó la autenticación sin embargo el comercio puede aprobar la transacción asociada. | +| U | Autenticación no realizada. Se presentó un error técnico durante el proceso. | +| A | Se ejecutó un intento de autenticación. | +| C | Se requiere desafío para continuar el proceso de autenticación. | +| R | Autenticación rechazada. Una transacción cuya autenticación resulte en estado R no debería ser procesada debido al riesgo. | +| D | La autenticación requiere un desafío desacoplado, este es responsabilidad del emisor. | +| I | Autenticación de tipo informativa, no soporta pago. Utilizada para verificar cuentas. | ## Razones de los estados del proceso de autenticación Los siguientes son las razones de los estados anteriormente presentados, estas razones proporcionan más información del por qué una transacción puede presentar un estado específico. -### Razones de estados de autenticación para versiones 2.1.0 y 2.2.0 del protocolo 3DS: +### Razones de estados de autenticación para la version 2.2.0 del protocolo 3DS: Indicador | Razón | ------------|-------------------------------------------------------------------------------------------------------| @@ -54,32 +54,26 @@ Indicador | Razón ### Razones de estados para VISA: -Indicador | Razón | -------------|-------------------------------------------------------------------------------------------------------| - 80 | Error de conexión con ACS. | - 81 | Agotado tiempo de espera. | - 82 | Respuesta inválida dada por el ACS. | - 83 | Error del sistema desde ACS. | - 84 | Error interno mientras se generaba el CAVV. | - 85 | VMID no elegible por la petición solicitada. | - 86 | Versión del protocolo no soportada por ACS. | - 87 | Transacción excluída por número de intentos de procesamiento. | - 88 | Petición no soportada por ACS. | - 89 | CAVV incluído en la respuesta. | - -### Razones adicionales de estados de autenticación para versión 2.1.0 del protocolo 3DS: - -Indicador | Razón | -------------|-------------------------------------------------------------------------------------------------------| - 81 | Acepta la excepción de SCA (Estado válido para Mastercard). | +| Indicador | Razón | +|-----------|---------------------------------------------------------------| +| 80 | Error de conexión con ACS. | +| 81 | Agotado tiempo de espera. | +| 82 | Respuesta inválida dada por el ACS. | +| 83 | Error del sistema desde ACS. | +| 84 | Error interno mientras se generaba el CAVV. | +| 85 | VMID no elegible por la petición solicitada. | +| 86 | Versión del protocolo no soportada por ACS. | +| 87 | Transacción excluída por número de intentos de procesamiento. | +| 88 | Petición no soportada por ACS. | +| 89 | CAVV incluído en la respuesta. | ### Razones adicionales de estados de autenticación para versión 2.2.0 del protocolo 3DS: -Indicador | Razón | -------------|-------------------------------------------------------------------------------------------------------| - 22 | Asunto técnico en ACS. | - 23 | Autenticación desacoplada requerida por ACS pero no solicitada por 3DS Requestor. | - 24 | Se superó el tiempo máximo de espera del solicitante 3DS desacoplado. | - 25 | La autenticación desacoplada no tuvo tiempo suficiente para autenticar al tarjetahabiente. ACS no hará más intentos. | - 26 | Autenticación intentada pero no realizada por el tarjetahabiente. | +| Indicador | Razón | +|-----------|----------------------------------------------------------------------------------------------------------------------| +| 22 | Asunto técnico en ACS. | +| 23 | Autenticación desacoplada requerida por ACS pero no solicitada por 3DS Requestor. | +| 24 | Se superó el tiempo máximo de espera del solicitante 3DS desacoplado. | +| 25 | La autenticación desacoplada no tuvo tiempo suficiente para autenticar al tarjetahabiente. ACS no hará más intentos. | +| 26 | Autenticación intentada pero no realizada por el tarjetahabiente. | diff --git a/src/pages/en/acs/issuer-configuration.mdx b/src/pages/en/acs/issuer-configuration.mdx index 71dba9a..49c6842 100644 --- a/src/pages/en/acs/issuer-configuration.mdx +++ b/src/pages/en/acs/issuer-configuration.mdx @@ -63,7 +63,7 @@ Se requiere que exista una relación entre emisor, adquiriente y comercio y que Importante tener en cuenta habilitar todos los campos de configuración del menú *Campos de configuración* de la aplicación, antes de crear el emisor, ya que todos estos campos son requeridos para el funcionamiento básico de un emisor. -En este punto es importante recordar que la aplicación de **MPI** también implementa y pertenece al flujo propuesto por el protocolo 3-D Secure para autenticar un tarjetahabiente. Pertenece al dominio el adquiriente y entre sus funciones principales están: +En este punto es importante recordar que la aplicación de **3DSS** también implementa y pertenece al flujo propuesto por el protocolo 3-D Secure para autenticar un tarjetahabiente. Pertenece al dominio el adquiriente y entre sus funciones principales están: - Recibir y responder la petición de autenticación enviada por el comercio o pasarela de pagos. - Solicitar al emisor la autorización del pago. - Responder al comercio o pasarela de pagos el estado final de la autenticación. diff --git a/src/pages/en/three-d-s-server/api/client-requirements.mdx b/src/pages/en/three-d-s-server/api/client-requirements.mdx index 2fcf389..45dd2b0 100644 --- a/src/pages/en/three-d-s-server/api/client-requirements.mdx +++ b/src/pages/en/three-d-s-server/api/client-requirements.mdx @@ -2,7 +2,7 @@ # Requerimientos para el cliente que va a integrarse -Para integrarse al servicio de 3DS Server o 3DS Secure Merchant Plugin (MPI) de Evertec, el comercio o pasarela deberá cumplir con los siguientes requisitos, necesarios para garantizar la compatibilidad en la conexión: +Para integrarse al servicio de 3DS Server o 3DS Secure de Evertec, el comercio o pasarela deberá cumplir con los siguientes requisitos, necesarios para garantizar la compatibilidad en la conexión: - **Encabezados HTTP:** Los encabezados HTTP deben estar parametrizados con los siguientes valores: @@ -15,6 +15,6 @@ Para integrarse al servicio de 3DS Server o 3DS Secure Merchant Plugin (MPI) de Authorization:"Bearer 1c6b2cda415f40f6f9f82e24d31d3fa6deb3cbcdd1def686fef7ed721a8abf83" - > Este token se crea en el módulo de **Tokens**, ubicado en el menú **Funcionamiento de MPI** -> **Seguridad**. + > Este token es proporcionado por el administrador de seguridad transaccional. - **Comunicaciones seguras:** Para establecer los enlaces asegurados por Transport Layer Security (TLS), entre el servicio y los clientes conectados, el número de versión debe ser 1.2 o superior. Las claves RSA deben tener una longitud mínima de 2048 bits. \ No newline at end of file diff --git a/src/pages/en/three-d-s-server/api/index.mdx b/src/pages/en/three-d-s-server/api/index.mdx index 23547bc..ab88407 100644 --- a/src/pages/en/three-d-s-server/api/index.mdx +++ b/src/pages/en/three-d-s-server/api/index.mdx @@ -10,7 +10,7 @@ En el dinámico mundo del comercio electrónico, donde la seguridad y la confian #### ¿Por qué Integrarse con nuestra API de 3DS? -Nuestra API de **3DS Server** le permite implementar de manera rápida y eficaz las funcionalidades del protocolo **3DS** en sus sistemas. Al integrarse con nuestra API, su empresa podrá aprovechar las últimas características de las últimas versiones activas del protocolo, como **EMV® 3DS 2.1.0, 2.2.0** y **2.3.1**. +Nuestra API de **3DS Server** le permite implementar de manera rápida y eficaz las funcionalidades del protocolo **3DS** en sus sistemas. Al integrarse con nuestra API, su empresa podrá aprovechar las últimas características de las últimas versiones activas del protocolo, como **EMV® 3DS 2.2.0** y **2.3.1**. La integración con nuestra API ofrece: diff --git a/src/pages/en/three-d-s-server/api/integration/authorization.mdx b/src/pages/en/three-d-s-server/api/integration/authorization.mdx index f426562..e7af561 100644 --- a/src/pages/en/three-d-s-server/api/integration/authorization.mdx +++ b/src/pages/en/three-d-s-server/api/integration/authorization.mdx @@ -5,7 +5,7 @@ Para interactuar con la API del 3DS Server, es necesario generar un token desde Dicho token se enviará en el encabezado HTTP como un "Bearer Token", conforme al [RFC 6750](https://datatracker.ietf.org/doc/html/rfc6750). -> Es importante destacar que el token es exclusivo del comercio y debe ser tratado con seguridad. No se debe compartir en áreas de acceso público ni en otros lugares de fácil acceso para terceros. +***Es importante destacar que el token es exclusivo del comercio y debe ser tratado con seguridad. No se debe compartir en áreas de acceso público ni en otros lugares de fácil acceso para terceros.*** Ejemplo de un Bearer Token: @@ -13,16 +13,6 @@ Ejemplo de un Bearer Token: Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiIxIiwianRpIjoiMjAzNjNkNDNhYjk0YzRhOGFkZmVlZTg1MzZlOGZjZTljM2M4MGI5YWYxNDk2YWRmNWJlNGE1NjkwNDk4YjcwNDllNTAwZDBjYWFjMjNjMDMiLCJpYXQiOjE2NzE0NjY2OTkuMTUyMjA2LCJuYmYiOjE2NzE0NjY2OTkuMTUyMjA3LCJleHAiOjE3NjYxNjEwOTkuMTM0ODkzLCJzdWIiOiIxIiwic2NvcGVzIjpbXX0.NzKTueFRgUyq_X9x0UmQeejlFWMw1yfImmpcRQUhMDDYE4p6torwzUCDkuKWz2AoelYTIWVqwPKot5kmG8zF9U8uqXYHttSc6VxbcgaTyx0NIFrkeZOReOLwommo-iJtIv9neLZoCU0GrCtg-nV7W2t1Yt1d9drAYbg6lOpH5Wc ``` -## ¿Cómo generar el token? +Este token es de uso personal y se mostrará únicamente en esta ocasión. Guárdalo en un lugar seguro y **¡asegúrate de no perderlo!** -Para generar el token, es imprescindible iniciar sesión en el panel administrativo. Una vez que haya accedido, deberá dirigirse a la vista de Comercio. Esto se puede realizar siguiendo la ruta en el menú: seleccione *Configuración*, a continuación, haga clic en *Comercios* e ingrese a la vista detallada del comercio seleccionado. Una vez dentro, proceda a la sección denominada *Tokens* y haga clic en el botón **"Crear Token"**. Complete los datos del formulario y finaliza con guardar. - -![Mpi_create_token.png](/3DS_server/Mpi_create_token.png) - -#### Datos del formulario: -- Nombre que es la información que identifica el Token. -- Duración del token. - -> Este token es de uso personal y se mostrará únicamente en esta ocasión. Guárdalo en un lugar seguro y **¡asegúrate de no perderlo!** - -> Si se llega a perder el token, será necesario generar uno nuevo. +***Si se llega a perder el token, será necesario generar uno nuevo.*** diff --git a/src/pages/en/three-d-s-server/api/integration/session.mdx b/src/pages/en/three-d-s-server/api/integration/session.mdx index d6ed156..c97b19f 100644 --- a/src/pages/en/three-d-s-server/api/integration/session.mdx +++ b/src/pages/en/three-d-s-server/api/integration/session.mdx @@ -4,9 +4,7 @@ export const sectionMode = 'nav'; # Sesión -El término **"Sesión"** Se refiere a la solicitud de autenticación en el contexto de 3DS. Para llevar a cabo una solicitud de autenticación exitosa, es esencial crear una sesión que se ajuste a las especificaciones y necesidades del protocolo 3DS. Puedes encontrar los detalles en [API - Iniciar Sesión](/three-d-s-server/api/sessions) y en [Reglas a tener en cuenta de la session API](/en/three-d-s-server/api/sessions/rules) - - +El término **"Sesión"** Se refiere a la solicitud de autenticación en el contexto de 3DS. Para llevar a cabo una solicitud de autenticación exitosa, es esencial crear una sesión que se ajuste a las especificaciones y necesidades del protocolo 3DS. Puedes encontrar los detalles en [API - Iniciar Sesión](/three-d-s-server/api/sessions) y en [Reglas a tener en cuenta de la session API](/three-d-s-server/api/sessions/rules) **Autorización:** Hace referencia al método indispensable de autorización con nuestra API para realizar peticiones. Dicho método se basa en **Bearer Token**. Para más información, consulta [Autorización](/three-d-s-server/api/integration/authorization). @@ -87,7 +85,7 @@ Este mensaje se puede presentar cuando en los siguientes casos: --- -## Sesión con Digital Authentication Framework +## Sesión con Digital Authentication Framework (DAF) Visa Digital Authentication Framework DAF es una extensión de mensaje del protocolo 3DS que le permite a Visa identificar a titulares de tarjetas que superaron el flujo de autenticación con desafío en un determinado comercio - adquirente, para así otorgarles un estado de confiabilidad al determinarlos como credencial de pago autenticada **authenticated credential payment**, esto permite que las siguientes transacciones que ejecute el tarjetahabiente en el mismo comercio sean autenticadas de inmediato. El objetivo principal es reducir el fraude y la fricción. @@ -195,13 +193,13 @@ Este método es especialmente relevante para casos de uso como las suscripciones ### Campos: - ***Los valores son opcionales si no se envía será el ACS quien tome la decisión si realiza la autenticación por desafío desacoplado y cuanto tiempo debe tomar.*** +***Los valores son opcionales si no se envía será el ACS quien tome la decisión si realiza la autenticación por desafío desacoplado y cuanto tiempo debe tomar.*** - **threeDSRequestorDecReqInd:** Indica si el Solicitante 3DS solicita al ACS que utilice la Autenticación desacoplada y acepta utilizar la Autenticación desacoplada si el ACS confirma su uso. Opciones **Y** si es preferido el desafío desacoplado y **N** para no usar la autenticación desacoplada. - **threeDSRequestorDecMaxTime:** Indica la cantidad máxima de tiempo que el solicitante 3DS esperará a que un ACS proporcione los resultados de una transacción de autenticación desacoplada **en minutos**. - ***El valor de **threeDSRequestorDecMaxTime** debe estar entre 1 y 10080*** +***El valor de **threeDSRequestorDecMaxTime** debe estar entre 1 y 10080*** ### Ejemplo: @@ -361,7 +359,7 @@ Este tipo de sesiones se presentan cuando el comerciante está iniciando una tra -## Sesión transacción con Bridging Message Extension: +## Sesión transacción con Bridging Message Extension (BME) El 3DS **v2.3** introduce elementos de datos en la extensión del mensaje que pueden duplicar aquellos presentes en las versiones 3DS **v2.1 y v2.2**, pero con valores nuevos o diferentes. De acuerdo con la Especificación Básica **v2.3**, estos valores se establecen en la extensión del mensaje, mientras que en las versiones **v2.1 y v2.2** se encuentran en la parte central de los mensajes 3DS. En estos casos, el valor del elemento de datos en la extensión del mensaje prevalece sobre el valor correspondiente en la parte central del mensaje 3DS. Además, el Servidor 3DS genera el mensaje AReq **v2.1** o **v2.2** bajo la suposición de que el ACS no soporta la Extensión del Mensaje de Puente, y posteriormente, proporciona la información adicional a través de dicha extensión. Si se soporta la Extensión del Mensaje de Puente, el componente 3DS deberá ser compatible al menos con uno de los objetos de datos ***como datos recurrentes, datos de desafío, datos adicionales o datos de URL de archivo*** de la extensión del mensaje e implementar los requisitos correspondientes de la Especificación Básica **v2.3**. @@ -380,16 +378,17 @@ En esta versión, pondremos a disposición en la API de sesión varios elementos **cardSecurityCode:** Código de seguridad asociado a las tarjetas de crédito o débito. -**bridgingMessageExtension.data.addData.threeDSRequestorAuthenticationInd:** Indicador de autenticación solicitado por el 3DS. -| -**bridgingMessageExtension.data.addData.threeRIInd:** Indica el tipo de **3RI** pedido. Este elemento de datos proporciona adicional información al ACS para determinar el mejor enfoque para entregar una solicitud 3RI. +**threeDSRequestorAuthenticationInd:** Indicador de autenticación solicitado por el 3DS. -**bridgingMessageExtension.data.addData.transChar:** Indica a la ACS transacciones específicas identificadas por el Comerciante. +**threeRIInd:** Indica el tipo de **3RI** pedido. Este elemento de datos proporciona adicional información al ACS para determinar el mejor enfoque para entregar una solicitud 3RI. + +**transChar:** Indica a la ACS transacciones específicas identificadas por el Comerciante. Ver más detalle en [Reglas a tener en cuenta de la session API](/en/three-d-s-server/api/sessions/rules) ***La Extension solo se creara si es enviada en la session request bridgingMessageExtension*** + ### Ejemplo de los datos en el request ```json @@ -422,11 +421,11 @@ Ver más detalle en [Reglas a tener en cuenta de la session API](/en/three-d-s-s ``` -### Ejemplo De la extención creada por MPI +### Ejemplo De la extención creada por 3DSS ```json { - "1": { + { "id": "A000000802-004", "data": { "addData": { @@ -443,71 +442,8 @@ Ver más detalle en [Reglas a tener en cuenta de la session API](/en/three-d-s-s "criticalityIndicator": false } } -``` - ---- - -## Transacción iniciada por el Titular de la Tarjeta (CIT) - -Cualquier transacción en la que el titular de la tarjeta participa activamente en la transacción. Las transacciones pueden realizarse con base en las credenciales proporcionadas por el titular de la tarjeta en el momento de la transacción o una credencial almacenada de una interacción previa. Las transacciones pueden ocurrir como una transacción en punto de venta (POS) en tienda, una transacción de comercio electrónico, una orden por correo/teléfono, o en un cajero automático **ATM**. - ---- - -## Transacción Iniciada por el Comerciante (MIT) - -Una transacción donde el titular de la tarjeta no participa activamente en la transacción. Las **MIT** a menudo pueden ser precedidas por una CIT **que involucre una PA - Payment Authentication** o una Consulta de Estado de Cuenta **ASI, por sus siglas en inglés**. - -**Payment Authentication (PA):** Implica monto de autenticación - -**Non Payment Authentication (NPA):** No implica monto - - ---- - -## Pago Recurrente / Cuotas - -Una transacción que surge de un acuerdo entre el titular de la tarjeta y el comerciante mediante el cual el titular de la tarjeta acepta que el comerciante almacene la credencial del titular de la tarjeta y utilice esa credencial almacenada para una compra subsiguiente de bienes o servicios. Estas transacciones pueden clasificarse como: - -* Orden permanente -* Suscripción -* Cuota (pagos diferidos) -* CREDENCIAL-ON-FILE no programada - ---- - -## Práctica de la Industria MIT - -Una transacción iniciada por el comerciante para cumplir con una práctica comercial que ocurre más a menudo después de una interacción inicial con el titular de la tarjeta. Las transacciones pueden realizarse con credenciales que están almacenadas en archivo, o credenciales que no están almacenadas en archivo, sino que son temporalmente retenidas por el comerciante según lo acordado por el consumidor. Estas MIT de práctica de la industria pueden clasificarse como: - -* Envíos parciales -* Entregas parciales o retrasadas -* No presentación (Tarjetahabiente no está presente para tomar el servicio) -* Reenvío - ---- - -## Tipos de mensajes 3RI admitidos - -La funcionalidad 3RI abarca varios casos de uso técnicos y comerciales diferentes que son principalmente definidos por los siguientes campos EMV 3DS: - -• **Canal de dispositivo (deviceChannel)** = '03' - -• **Campo Indicador 3RI (tresRIInd)** en la solicitud de autenticación **AReq** que define el tipo de Transacción 3RI. No todos los valores de campo del indicador 3RI documentados en la especificación EMV 3DS actualmente son compatibles con las marcas -| 3RI Indicador (threeRIInd) | Marcas | Pago (PA) | No Pago (NPA) | -|-----------------------------------------|------------------|-----------|---------------| -| **(01)** Recurring Transaction | Visa, Mastercard | SI | NO | -| **(02)** Installment Transaction | Visa, Mastercard | SI | NO | -| **(03)** Add Card | Visa, Mastercard | NO | SI | -| **(04)** Maintain Card Information | Visa, Mastercard | NO | SI | -| **(05)** Account Verification | Visa, Mastercard | NO | SI | -| **(06)** Split/Delayed Shipment | Visa, Mastercard | SI | NO | -| **(07)** Top-up | Visa, Mastercard | NO | NO | -| **(08)** Mail Order | Visa, Mastercard | NO | NO | -| **(09)** Telephone Order | Visa, Mastercard | NO | NO | -| **(10)** Whitelist Status Check | Visa, Mastercard | NO | SI | -| **(11)** Other Payment | Visa, Mastercard | SI | NO | -| **(81)** Unscheduled Credential-on-File | Visa | SI | NO | +``` --- @@ -515,7 +451,7 @@ La funcionalidad 3RI abarca varios casos de uso técnicos y comerciales diferent ### Opción PA -Por ejemplo, cuando durante el proceso de pago se tiene disponible la casilla que dice ***Guardar tarjeta para pagos futuros*** y se quiere verificar los fondos de la cuenta. +Durante el proceso de pago se tiene disponible la casilla que dice ***Guardar tarjeta para pagos futuros*** y se quiere verificar los fondos de la cuenta. `POST` https://3dss-dev.placetopay.ws/api/threeds/v2x/sessions @@ -538,7 +474,7 @@ Por ejemplo, cuando durante el proceso de pago se tiene disponible la casilla qu **deviceChannel:** 02 - Navegador. -**threeDSChallengeInd**, indica si se solicita desafío o no, las opciones recomendables son: +**threeDSChallengeInd:** indica si se solicita desafío o no, las opciones recomendables son: * **03:** el requestor tiene la preferencia de que se aplique desafío. * **04:** el desafío es obligatorio. @@ -611,7 +547,8 @@ Esta opción no require verificar fondos de la cuenta. ## Pagos recurrentes (Suscripción mensual a una plataforma) -Una transacción recurrente es aquella en la que se realiza un cargo periódico al titular de la tarjeta de forma programada. Estas transacciones son comunes en servicios de suscripción, como membresías, suscripciones a servicios de streaming, pagos de facturas recurrentes, etc. +Una transacción recurrente es aquella en la que se realiza un cargo periódico al titular de la tarjeta de forma programada. +Estas transacciones son comunes en servicios de suscripción, como membresías, suscripciones a servicios de streaming, pagos de facturas recurrentes, etc. `POST` https://3dss-dev.placetopay.ws/api/threeds/v2x/sessions @@ -634,7 +571,7 @@ Antes de realizar una solicitud 3RI, debe haberse realizado una autenticación E ```json { "deviceChannel": "02", - "threeDSAuthenticationInd": "03", + "threeDSAuthenticationInd": "02", "threeDSChallengeInd": "04", "recurringExpiry": "20250101", "recurringFrequency": "2", @@ -651,7 +588,7 @@ Antes de realizar una solicitud 3RI, debe haberse realizado una autenticación E **deviceChannel:** 02 - Navegador -**threeDSAuthenticationInd:** 03 indica que la transacción es a plazos +**threeDSAuthenticationInd:** 02 indica que la transacción es una recurrencia **threeDSChallengeInd:** 04: el desafío es obligatorio @@ -666,9 +603,9 @@ Antes de realizar una solicitud 3RI, debe haberse realizado una autenticación E ```json { "action": "redirect", - "sessionToken": "ae30396c70e0ee6c23324f7c5b0390960df2b9ebeb70996a1fc9315cc34bcb6c", - "redirectURL": "https://3dss-dev.placetopay.ws/threeds/v2x/sessions/1262/ae30396c70e0ee6c23324f7c5b0390960df2b9ebeb70996a1fc9315cc34bcb6c", - "transactionID": 1306 + "sessionToken": "398864c1e4c8217283b67f0312a2d8ee14e3814c0e000a92d4532bc406f65d2f", + "redirectURL": "https://3dss-test.placetopay.com/threeds/v2x/sessions/86036/398864c1e4c8217283b67f0312a2d8ee14e3814c0e000a92d4532bc406f65d2f", + "transactionID": 248002 } ``` @@ -701,11 +638,10 @@ Datos requeridos en la petición API ```json { "deviceChannel": "02", - "threeDSAuthenticationInd": "03", + "threeDSAuthenticationInd": "02", "threeDSChallengeInd": "04", "recurringExpiry": "20260101", "recurringFrequency": "2", - "purchaseInstalData": "2", "acctNumber": "4931119220729333", "cardExpiryDate": "2902", "purchaseAmount": "1.02", @@ -728,7 +664,7 @@ Datos requeridos en la petición API **deviceChannel:** 02 - Navegador -**threeDSAuthenticationInd:** 03 indica que la transacción es a plazos +**threeDSAuthenticationInd:** 02 indica que la transacción es recurrente **threeDSChallengeInd:** 04: el desafío es obligatorio @@ -752,9 +688,9 @@ Datos requeridos en la petición API ```json { "action": "redirect", - "sessionToken": "b3a0ce35a97aa1417f666c1f10151983a9bdb7b3f81966f721b290f1862b27a3", - "redirectURL": "https://3dss-dev.placetopay.ws/threeds/v2x/sessions/1265/b3a0ce35a97aa1417f666c1f10151983a9bdb7b3f81966f721b290f1862b27a3", - "transactionID": 1309 + "sessionToken": "c56d238b35d23b8cf564f2b6b641ed0e8a3056fb639d9df245d4bec825e4b74a", + "redirectURL": "https://3dss-test.placetopay.com/threeds/v2x/sessions/86039/c56d238b35d23b8cf564f2b6b641ed0e8a3056fb639d9df245d4bec825e4b74a", + "transactionID": 248005 } ``` @@ -762,7 +698,7 @@ Datos requeridos en la petición API **Autenticaciones posteriores** -Envíe una solicitud 3RI por el valor del segundo bien/servicio. +Envíe una solicitud 3RI por el valor de la recurrencia ### MASTERCARD @@ -774,8 +710,8 @@ Envíe una solicitud 3RI por el valor del segundo bien/servicio. "threeRIInd": "01", "threeDSRequestorPriorAuthenticationInfo": { "threeDSReqPriorAuthMethod": "CARDHOLDER_CHALLENGE_OCCURRED", - "threeDSReqPriorAuthTimestamp": "2024-08-22T13:16:01+00:00", - "threeDSReqPriorRef": "1192ffe6-6691-45e2-8ac9-a611cf122a9a" + "threeDSReqPriorAuthTimestamp": "2024-09-09T19:48:20+00:00", + "threeDSReqPriorRef": "fa4544ea-9002-444a-a891-5fd126735c41" }, "acctNumber": "5107000000010018", "cardExpiryDate": "2902", @@ -791,13 +727,17 @@ Envíe una solicitud 3RI por el valor del segundo bien/servicio. **threeRIInd:** 01 indica que la transacción es recurrente -**threeDSReqPriorAuthMethod:** Método que fue usado por el tarjetahabiente para la autenticación. 01 sin fricción, 02 con fricción, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo +**threeDSReqPriorAuthMethod:** Método que fue usado por el tarjetahabiente para la autenticación. 01 sin fricción, +02 con fricción, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo -**threeDSReqPriorAuthTimestamp:** Fecha y hora en formato UTC de la autenticación previa. El formato es C, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo +**threeDSReqPriorAuthTimestamp:** Fecha y hora en formato UTC de la autenticación previa. El formato es C, +consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo -**threeDSReqPriorRef:** El ID otorgado por el ACS en la transacción previa ***primera autenticación***, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo +**threeDSReqPriorRef:** El ID otorgado por el ACS en la transacción previa ***primera autenticación***, +consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo -**threeDSReqPriorAuthData:** El ID otorgado por el DS en la transacción previa ***primera autenticación***, si este dato no es enviado MPI lo asigna, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo +**threeDSReqPriorAuthData:** El ID otorgado por el DS en la transacción previa ***primera autenticación***, +si este dato no es enviado 3DSS lo asigna, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo ***Response Lookup*** @@ -805,26 +745,43 @@ Envíe una solicitud 3RI por el valor del segundo bien/servicio. { "action": "continue", "messageType": "ARes", - "threeDSServerTransID": "c03e0003-ef69-4ee9-8938-3083ba2f2839", - "acsReferenceNumber": "PTOPID", - "acsTransID": "766dbd1d-9736-408c-b7c6-7a6ba352e5b2", + "threeDSServerTransID": "2e6bd601-7a61-4fa5-accc-10a30e0d66db", + "acsReferenceNumber": "3DS_LOA_ACS_EISF_020200_00539", + "acsTransID": "80fb86d5-35e7-4249-b6df-6905d9c6ba4f", "dsReferenceNumber": "3DS_LOA_DIS_PPFU_020100_00010", - "dsTransID": "cf2735c9-c4d1-4cc1-869d-6901c8f9f58f", + "dsTransID": "3a961497-8ac7-447d-9926-06bf4c1fa1a9", "messageVersion": "2.2.0", - "authenticationValue": "xgSo/jtXAAAAAAAAAAAAAAAAAAA=", + "acsOperatorID": "ACS-V210-ACS-PLACETOPAY-11174", + "authenticationValue": "xgQiqOYmAAAAAAAAAAAAAAAAAAA=", "eci": "07", + "messageExtension": [ + { + "name": "ACS RBA", + "id": "A000000004-acsRBA", + "criticalityIndicator": false, + "data": { + "A000000004-acsRBA": { + "status": "success", + "score": "500", + "decision": "Low Risk", + "reasonCode1": "H", + "reasonCode2": "GG" + } + } + } + ], "transStatus": "Y", "whiteListStatusSource": "03", "whiteListStatus": "Y", "deviceChannel": "03", "messageCategory": "PA", - "authMethod": "FRICTIONLESS_AUTHENTICATION", - "authTimestamp": "2024-05-09T16:06:56+00:00", - "transactionID": 1318 + "authMethod": "01", + "authTimestamp": "2024-09-09T19:52:20+00:00", + "transactionID": 248003 } ``` -**Actión:** continue indica que la API retornara la información de la autenticación, y por ende no es necesario consumir endpoints adicionales para continuar con el flujo +**Actión:** continue indica que la API retornara la información de la autenticación,y por ende no es necesario consumir endpoints adicionales para continuar con el flujo ### VISA @@ -853,11 +810,11 @@ Datos requeridos en la petición API ```json { "deviceChannel": "03", - "threeRIInd": "02", + "threeRIInd": "01", "threeDSRequestorPriorAuthenticationInfo": { "threeDSReqPriorAuthMethod": "CARDHOLDER_CHALLENGE_OCCURRED", - "threeDSReqPriorAuthTimestamp": "2024-05-03T22:44:18+00:00", - "threeDSReqPriorRef": "052cd8e3-5678-4464-8787-8d1fa9758356" + "threeDSReqPriorAuthTimestamp": "2024-09-09T20:06:30+00:00", + "threeDSReqPriorRef": "3b632ce4-26ea-407d-a2a0-4a7b27c91c14" }, "acctNumber": "4931119220729333", "cardExpiryDate": "2902", @@ -881,7 +838,7 @@ Datos requeridos en la petición API **deviceChannel:** 03 indica que el canal es 3RI -**threeRIInd:** 02 indica que la transacción es a plazos +**threeRIInd:** 01 indica que la transacción es recurrente **threeDSReqPriorAuthMethod:** Método que fue usado por el tarjetahabiente para la autenticación. 01 sin fricción, 02 con fricción, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo @@ -889,7 +846,7 @@ Datos requeridos en la petición API **threeDSReqPriorRef:** El ID otorgado por el ACS en la transacción previa **primera autenticación**, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo -**threeDSReqPriorAuthData:** El ID otorgado por el DS en la transacción previa ***primera autenticación***, si este dato no es enviado MPI lo asigna, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo +**threeDSReqPriorAuthData:** El ID otorgado por el DS en la transacción previa ***primera autenticación***, si este dato no es enviado 3DSS lo asigna, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo **Datos DAF:** las llaves adicionales que se deberán enviar para que se aplique el DAF con VISA son los siguientes @@ -908,14 +865,14 @@ Datos requeridos en la petición API { "action": "continue", "messageType": "ARes", - "threeDSServerTransID": "a2de0e4d-fee5-4ac3-a5ec-8f763d73456b", - "acsReferenceNumber": "PTOPID", - "acsTransID": "6e56cb8c-c9a5-4e3c-aa16-21f29cd962f6", + "threeDSServerTransID": "0e0ee43c-9601-4e29-9c8d-32b893ded4db", + "acsReferenceNumber": "3DS_LOA_ACS_EISF_020200_00539V3", + "acsTransID": "ab8b1aec-2cf9-4d60-a45f-8d499894dae5", "dsReferenceNumber": "3DS_LOA_DIS_PPFU_020100_00010", - "dsTransID": "8be55ee3-dc8d-4dd2-ba46-656d569fca35", + "dsTransID": "072b329b-ca7f-47ff-a6b0-ff5a3d6321cb", "messageVersion": "2.2.0", - "acsOperatorID": "CAS_OPERD_DR", - "authenticationValue": "BpkCBkMndAAAAABkhAEkdYR0cUU=", + "acsOperatorID": "10078025", + "authenticationValue": "BpkCBIU4VgAAAABkhAJTdYknEmE=", "eci": "05", "messageExtension": [ { @@ -923,7 +880,7 @@ Datos requeridos en la petición API "id": "A000000003-003", "criticalityIndicator": false, "data": { - "chAccReqID": "PZFPk0jJzA/4p5cWcAufzU0vPnEWCABOuPE4vLp/FNk=", + "chAccReqID": "MUHZx0nojuVVAZJwPD4CWps0RuxUPxepI8sk57Yd/s4=", "authPayProcessReqInd": "01", "version": "1.0", "authPayCredStatus": "Y", @@ -936,8 +893,9 @@ Datos requeridos en la petición API "whiteListStatus": "Y", "deviceChannel": "03", "messageCategory": "PA", - "authMethod": "FRICTIONLESS_AUTHENTICATION", - "authTimestamp": "2024-05-03T22:46:20+00:00" + "authMethod": "01", + "authTimestamp": "2024-09-09T20:52:36+00:00", + "transactionID": 248013 } ``` @@ -945,8 +903,6 @@ Datos requeridos en la petición API --- - - ## Pagos a Plazos Una transacción a plazos es aquella en la que el monto total de la compra se divide en pagos periódicos más pequeños a lo largo de un período de tiempo determinado. Estos pagos pueden incluir intereses u otras tarifas asociadas con la financiación de la compra. @@ -961,27 +917,11 @@ A diferencia de una transacción recurrente, en una transacción a plazos, el ti * **Financiación de productos o servicios:** Como la compra de muebles para el hogar, equipos electrónicos, o servicios médicos que ofrecen opciones de financiación a plazos. * **Planes de pago de vacaciones:** Agencias de viajes que ofrecen la opción de pagar las vacaciones en varios pagos antes de la fecha del viaje -Aplica también para: - -* **Pago al finalizar el servicio:** el monto es desconocido o indefinido antes de la compra. -* **Pago a un clic:** pago recurrente con cantidades fijas/frecuencia fija -* **Tarjeta Guardada en una Wallet Digital:** pago recurrente combinado con compra única -* Modelo de Agente (AN 7792 dice que se envía 85) -* Cantidad final desconocida o indefinida antes de la compra (AN 7792 dice que se envía 86) -* Pago recurrente con cantidades fijas/frecuencia fija -* Pago recurrente con cantidades fijas/frecuencia fija y prueba gratuita -* Pago recurrente con cantidades fijas/frecuencia variable -* Pago recurrente con cantidades variables/frecuencia fija -* Pago recurrente con cantidades variables/frecuencia variable -* Pago recurrente combinado con compra única -* Pago recurrente con límite fijo o umbral - - -***Para VISA está disponible el flujo de pago recurrente a través del DAF*** +***Para VISA está disponible el flujo de pagos a plazo a través del DAF*** **Primera Autenticación** -Antes de realizar una solicitud 3RI, debe haberse realizado una autenticación EMV 3DS donde el titular de la tarjeta esté disponible para autenticarse. Esta autenticación inicial puede utilizarse para la autorización asociada a la primera entrega de los bienes/servicios. +Antes de realizar una solicitud 3RI, debe haberse realizado una autenticación EMV 3DS donde el titular de la tarjeta esté disponible para autenticarse. ### MASTERCARD @@ -998,7 +938,7 @@ Antes de realizar una solicitud 3RI, debe haberse realizado una autenticación E "acctNumber": "5107000000010018", "cardExpiryDate": "2902", "redirectURI": "https://www.placetopay.com/web", - "purchaseAmount": "10", + "purchaseAmount": "1000", "purchaseCurrency": "USD", "reference": "Enero 2024", "messageVersion": "2.2.0" @@ -1023,9 +963,9 @@ Antes de realizar una solicitud 3RI, debe haberse realizado una autenticación E ```json { "action": "redirect", - "sessionToken": "ae30396c70e0ee6c23324f7c5b0390960df2b9ebeb70996a1fc9315cc34bcb6c", - "redirectURL": "https://3dss-dev.placetopay.ws/threeds/v2x/sessions/1262/ae30396c70e0ee6c23324f7c5b0390960df2b9ebeb70996a1fc9315cc34bcb6c", - "transactionID": 1306 + "sessionToken": "d6aa0439b5f0e29e6a9413321962cf962593130717098cbcde322b6bb50808fb", + "redirectURL": "https://3dss-test.placetopay.com/threeds/v2x/sessions/86048/d6aa0439b5f0e29e6a9413321962cf962593130717098cbcde322b6bb50808fb", + "transactionID": 248014 } ``` @@ -1034,25 +974,6 @@ Antes de realizar una solicitud 3RI, debe haberse realizado una autenticación E ### VISA -***Para Visa está disponible el flujo de pago dividido a través del DAF a partir de Abríl de 2024. Consultar para más detalle sobre VISA DAF*** - -**Prerrequisitos:** - -1. El identificador de comercio de ***Visa Merchant ID VMID*** deberá estar disponible en la subscripción. -2. El rango de tarjetas debe soportar el procesamiento con DAF - -Datos requeridos en la petición API - -**Datos DAF:** las llaves adicionales que se deberán enviar para que se aplique el DAF con VISA son los siguientes - -* billAddrCity -* billAddrCountry -* billAddrLine1 -* billAddrPostCode -* billAddrState -* email -* mobilePhone - ***Request Lookup*** ```json @@ -1065,7 +986,7 @@ Datos requeridos en la petición API "purchaseInstalData": "2", "acctNumber": "4931119220729333", "cardExpiryDate": "2902", - "purchaseAmount": "1.02", + "purchaseAmount": "1000", "redirectURI": "https://www.placetopay.com/web", "purchaseCurrency": "USD", "reference": "Enero 2024", @@ -1109,9 +1030,9 @@ Datos requeridos en la petición API ```json { "action": "redirect", - "sessionToken": "b3a0ce35a97aa1417f666c1f10151983a9bdb7b3f81966f721b290f1862b27a3", - "redirectURL": "https://3dss-dev.placetopay.ws/threeds/v2x/sessions/1265/b3a0ce35a97aa1417f666c1f10151983a9bdb7b3f81966f721b290f1862b27a3", - "transactionID": 1309 + "sessionToken": "96c03fe78346d11024057dfccbc8eed58b736de36631c8ff25e5c154386ade1f", + "redirectURL": "https://3dss-test.placetopay.com/threeds/v2x/sessions/86104/96c03fe78346d11024057dfccbc8eed58b736de36631c8ff25e5c154386ade1f", + "transactionID": 248070 } ``` @@ -1120,7 +1041,7 @@ Datos requeridos en la petición API **Autenticaciones posteriores** -Envíe una solicitud 3RI por el valor del segundo bien/servicio. +Envíe una solicitud 3RI por el valor del pago a plazos ### MASTERCARD @@ -1129,15 +1050,18 @@ Envíe una solicitud 3RI por el valor del segundo bien/servicio. ```json { "deviceChannel": "03", - "threeRIInd": "01", + "threeRIInd": "02", + "recurringExpiry": "20250101", + "recurringFrequency": "2", + "purchaseInstalData": "2", "threeDSRequestorPriorAuthenticationInfo": { "threeDSReqPriorAuthMethod": "CARDHOLDER_CHALLENGE_OCCURRED", - "threeDSReqPriorAuthTimestamp": "2024-08-22T13:16:01+00:00", - "threeDSReqPriorRef": "1192ffe6-6691-45e2-8ac9-a611cf122a9a" + "threeDSReqPriorAuthTimestamp": "2024-09-10T16:12:47+00:00", + "threeDSReqPriorRef": "51bbcd10-0c31-4efc-ad49-ba9bdea2f413" }, "acctNumber": "5107000000010018", "cardExpiryDate": "2902", - "purchaseAmount": "5", + "purchaseAmount": "500", "redirectURI": "https://www.placetopay.com/web", "purchaseCurrency": "USD", "reference": "Febrero 2024", @@ -1147,7 +1071,7 @@ Envíe una solicitud 3RI por el valor del segundo bien/servicio. **deviceChannel:** 03 indica que el canal es 3RI -**threeRIInd:** 01 indica que la transacción es recurrente +**threeRIInd:** 02 indica que la transacción es a plazos **threeDSReqPriorAuthMethod:** Método que fue usado por el tarjetahabiente para la autenticación. 01 sin fricción, 02 con fricción, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo @@ -1155,7 +1079,7 @@ Envíe una solicitud 3RI por el valor del segundo bien/servicio. **threeDSReqPriorRef:** El ID otorgado por el ACS en la transacción previa ***primera autenticación***, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo -**threeDSReqPriorAuthData:** El ID otorgado por el DS en la transacción previa ***primera autenticación***, si este dato no es enviado MPI lo asigna, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo +**threeDSReqPriorAuthData:** El ID otorgado por el DS en la transacción previa ***primera autenticación***, si este dato no es enviado 3DSS lo asigna, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo ***Response Lookup*** @@ -1164,22 +1088,23 @@ Envíe una solicitud 3RI por el valor del segundo bien/servicio. { "action": "continue", "messageType": "ARes", - "threeDSServerTransID": "c03e0003-ef69-4ee9-8938-3083ba2f2839", - "acsReferenceNumber": "PTOPID", - "acsTransID": "766dbd1d-9736-408c-b7c6-7a6ba352e5b2", + "threeDSServerTransID": "f5e8b9c4-5cfd-461d-9115-e51fe7d5c42a", + "acsReferenceNumber": "3DS_LOA_ACS_EISF_020200_00539", + "acsTransID": "98d5739a-c623-4512-9f87-a48368848d44", "dsReferenceNumber": "3DS_LOA_DIS_PPFU_020100_00010", - "dsTransID": "cf2735c9-c4d1-4cc1-869d-6901c8f9f58f", + "dsTransID": "def67c44-653a-4879-b500-935d8429b4a4", "messageVersion": "2.2.0", - "authenticationValue": "xgSo/jtXAAAAAAAAAAAAAAAAAAA=", + "acsOperatorID": "ACS-V210-ACS-PLACETOPAY-11174", + "authenticationValue": "xgRKM8pzAAAAAAAAAAAAAAAAAAA=", "eci": "07", "transStatus": "Y", "whiteListStatusSource": "03", "whiteListStatus": "Y", "deviceChannel": "03", "messageCategory": "PA", - "authMethod": "FRICTIONLESS_AUTHENTICATION", - "authTimestamp": "2024-05-09T16:06:56+00:00", - "transactionID": 1318 + "authMethod": "01", + "authTimestamp": "2024-09-10T16:16:19+00:00", + "transactionID": 248067 } ``` @@ -1214,12 +1139,12 @@ Datos requeridos en la petición API "threeRIInd": "02", "threeDSRequestorPriorAuthenticationInfo": { "threeDSReqPriorAuthMethod": "CARDHOLDER_CHALLENGE_OCCURRED", - "threeDSReqPriorAuthTimestamp": "2024-05-03T22:44:18+00:00", - "threeDSReqPriorRef": "052cd8e3-5678-4464-8787-8d1fa9758356" + "threeDSReqPriorAuthTimestamp": "2024-09-10T16:35:31+00:00", + "threeDSReqPriorRef": "f0bb9172-018d-42ae-b2ad-715e274bddef" }, "acctNumber": "4931119220729333", "cardExpiryDate": "2902", - "purchaseAmount": "1.00", + "purchaseAmount": "500", "redirectURI": "https://www.placetopay.com/web", "purchaseCurrency": "USD", "reference": "Febrero 2024", @@ -1247,7 +1172,7 @@ Datos requeridos en la petición API **threeDSReqPriorRef:** El ID otorgado por el ACS en la transacción previa ***primera autenticación***, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo -**threeDSReqPriorAuthData:** El ID otorgado por el DS en la transacción previa **primera autenticación**, si este dato no es enviado MPI lo asigna, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo +**threeDSReqPriorAuthData:** El ID otorgado por el DS en la transacción previa **primera autenticación**, si este dato no es enviado 3DSS lo asigna, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo **Datos DAF:** las llaves adicionales que se deberán enviar para que se aplique el DAF con VISA son los siguientes @@ -1266,14 +1191,14 @@ Datos requeridos en la petición API { "action": "continue", "messageType": "ARes", - "threeDSServerTransID": "a2de0e4d-fee5-4ac3-a5ec-8f763d73456b", - "acsReferenceNumber": "PTOPID", - "acsTransID": "6e56cb8c-c9a5-4e3c-aa16-21f29cd962f6", + "threeDSServerTransID": "50709e2a-4dad-4c60-acaa-c5d3e1ede924", + "acsReferenceNumber": "3DS_LOA_ACS_EISF_020200_00539V3", + "acsTransID": "3cdfa009-4018-4230-a72b-658587a5794c", "dsReferenceNumber": "3DS_LOA_DIS_PPFU_020100_00010", - "dsTransID": "8be55ee3-dc8d-4dd2-ba46-656d569fca35", + "dsTransID": "72455b8f-5a57-4716-93fe-b72d3878805b", "messageVersion": "2.2.0", - "acsOperatorID": "CAS_OPERD_DR", - "authenticationValue": "BpkCBkMndAAAAABkhAEkdYR0cUU=", + "acsOperatorID": "10078025", + "authenticationValue": "BpkCBSMnAAAAAMNQhAJUdYknEmE=", "eci": "05", "messageExtension": [ { @@ -1281,7 +1206,7 @@ Datos requeridos en la petición API "id": "A000000003-003", "criticalityIndicator": false, "data": { - "chAccReqID": "PZFPk0jJzA/4p5cWcAufzU0vPnEWCABOuPE4vLp/FNk=", + "chAccReqID": "MUHZx0nojuVVAZJwPD4CWps0RuxUPxepI8sk57Yd/s4=", "authPayProcessReqInd": "01", "version": "1.0", "authPayCredStatus": "Y", @@ -1294,8 +1219,9 @@ Datos requeridos en la petición API "whiteListStatus": "Y", "deviceChannel": "03", "messageCategory": "PA", - "authMethod": "FRICTIONLESS_AUTHENTICATION", - "authTimestamp": "2024-05-03T22:46:20+00:00" + "authMethod": "01", + "authTimestamp": "2024-09-10T19:45:25+00:00", + "transactionID": 248109 } ``` @@ -1322,8 +1248,8 @@ Los Envíos divididos permiten a los comerciantes solicitar un nuevo CAVV para o ***Casos de Uso:*** -* Pedidos con múltiples artículos: un cliente realiza un pedido de varios productos que no están todos disponibles en el almacén al mismo tiempo. Por lo tanto, el comerciante decide enviar los artículos en varias entregas, dependiendo de la disponibilidad. -* Reserva de un paquete de viaje: un cliente reserva un paquete de viaje completo a través de una agencia de viajes en línea. El paquete incluye: un vuelo internacional, una estadía en un hotel y un tour guiado. Sin embargo, cada componente del paquete se confirma y cobra en diferentes momentos debido a las políticas de reserva de la agencia. +* **Pedidos con múltiples artículos:** un cliente realiza un pedido de varios productos que no están todos disponibles en el almacén al mismo tiempo. +Por lo tanto, el comerciante decide enviar los artículos en varias entregas, dependiendo de la disponibilidad. | Evento | Valor | Descripción | @@ -1341,11 +1267,10 @@ Los Envíos divididos permiten a los comerciantes solicitar un nuevo CAVV para o **Primera Autenticación** -Autenticación inicial por el importe total de la orden. +***Autenticación inicial por el importe total de la orden.*** Antes de realizar una solicitud 3RI, debe haberse realizado una autenticación EMV 3DS donde el titular de la tarjeta esté disponible para autenticarse por el valor total del pedido. Esta autenticación inicial puede utilizarse para la autorización asociada a la primera entrega de los bienes/servicios. - ### MASTERCARD ***Request Lookup*** @@ -1378,9 +1303,9 @@ Antes de realizar una solicitud 3RI, debe haberse realizado una autenticación E ```json { "action": "redirect", - "sessionToken": "db1c9baee5a5191aeda5845046ff7eb816b1fc7295d718787aa7f5a00750d607", - "redirectURL": "https://3dss-dev.placetopay.ws/threeds/v2x/sessions/1768/db1c9baee5a5191aeda5845046ff7eb816b1fc7295d718787aa7f5a00750d607", - "transactionID": 1812 + "sessionToken": "dc6c2a30c763d7ce640dcf0a98b5d172e3f86c62c3dea3ea1175469d0e6befae", + "redirectURL": "https://3dss-test.placetopay.com/threeds/v2x/sessions/86152/dc6c2a30c763d7ce640dcf0a98b5d172e3f86c62c3dea3ea1175469d0e6befae", + "transactionID": 248118 } ``` @@ -1388,25 +1313,6 @@ Antes de realizar una solicitud 3RI, debe haberse realizado una autenticación E ### VISA -***Para Visa está disponible el flujo de pago dividido a través del DAF a partir de Abríl de 2024. Consultar para más detalle sobre VISA DAF*** - -**Prerrequisitos:** - -1. El identificador de comercio de **Visa Merchant ID VMID** deberá estar disponible en la subscripción. -2. El rango de tarjetas debe soportar el procesamiento con DAF - -Datos requeridos en la petición API - -**Datos DAF:** las llaves adicionales que se deberán enviar para que se aplique el DAF con VISA son los siguientes - -* billAddrCity -* billAddrCountry -* billAddrLine1 -* billAddrPostCode -* billAddrState -* email -* mobilePhone - ***Request Lookup*** ```json @@ -1414,24 +1320,12 @@ Datos requeridos en la petición API "deviceChannel": "02", "threeDSAuthenticationInd": "01", "threeDSChallengeInd": "04", - "recurringExpiry": "20260101", - "recurringFrequency": "2", "acctNumber": "4931119220729333", "cardExpiryDate": "2902", "purchaseAmount": "167", "redirectURI": "https://www.placetopay.com/web", "purchaseCurrency": "USD", "reference": "Enero 2024", - "billAddrCity": "Medellín", - "billAddrCountry": "COL", - "billAddrLine1": "Carrera 65 # 45 - 20", - "billAddrPostCode": "050004", - "billAddrState": "ANT", - "email": "john.doe@evertecinc.com", - "mobilePhone": { - "cc": "57", - "subscriber": "30011122333" - }, "messageVersion": "2.2.0" } ``` @@ -1442,25 +1336,15 @@ Datos requeridos en la petición API **threeDSChallengeInd:** 04: el desafío es obligatorio -**Datos DAF:** las llaves adicionales que se deberán enviar para que se aplique el DAF con VISA son los siguientes - -* billAddrCity -* billAddrCountry -* billAddrLine1 -* billAddrPostCode -* billAddrState -* email -* mobilePhone - ***Response Lookup*** ```json { "action": "redirect", - "sessionToken": "db1c9baee5a5191aeda5845046ff7eb816b1fc7295d718787aa7f5a00750d607", - "redirectURL": "https://3dss-dev.placetopay.ws/threeds/v2x/sessions/1768/db1c9baee5a5191aeda5845046ff7eb816b1fc7295d718787aa7f5a00750d607", - "transactionID": 1900 + "sessionToken": "1e7c2e6f2516a07020f30f8e5ef63bca7de42e16ac9498b61f2a8efd5ba52968", + "redirectURL": "https://3dss-test.placetopay.com/threeds/v2x/sessions/86160/1e7c2e6f2516a07020f30f8e5ef63bca7de42e16ac9498b61f2a8efd5ba52968", + "transactionID": 248126 } ``` **Actión:** redirect indica que la API retornara un redirectURL que deberá ser consumido para continuar con el flujo @@ -1502,7 +1386,7 @@ Envíe una solicitud 3RI por el valor del segundo bien/servicio. **threeDSReqPriorRef:** El ID otorgado por el ACS en la transacción previa ***primera autenticación***, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo -**threeDSReqPriorAuthData:** El ID otorgado por el DS en la transacción previa ***primera autenticación***, si este dato no es enviado MPI lo asigna, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo +**threeDSReqPriorAuthData:** El ID otorgado por el DS en la transacción previa ***primera autenticación***, si este dato no es enviado 3DSS lo asigna, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo ***Response Lookup*** @@ -1511,22 +1395,23 @@ Envíe una solicitud 3RI por el valor del segundo bien/servicio. { "action": "continue", "messageType": "ARes", - "threeDSServerTransID": "26a0f527-c4ba-4543-a1f3-784df8f9044b", - "acsReferenceNumber": "DS_LOA_DIS_PPFU_020100_00010", - "acsTransID": "69dbc0bf-2675-4ea8-8117-015fdd2b8809", + "threeDSServerTransID": "4159591c-bb88-4321-a295-0e6397377d3b", + "acsReferenceNumber": "3DS_LOA_ACS_EISF_020200_00539", + "acsTransID": "b4ec2f82-106b-469b-897d-f2aa37bbf25f", "dsReferenceNumber": "3DS_LOA_DIS_PPFU_020100_00010", - "dsTransID": "85e4c318-1639-4af8-ba25-5684c7df21a0", + "dsTransID": "dc477252-ff8d-433d-b44a-4f8edbb0cae8", "messageVersion": "2.2.0", - "authenticationValue": "AAAAAAAAAAAAAAAAAAAAAAAAAAA=", + "acsOperatorID": "ACS-V210-ACS-PLACETOPAY-11174", + "authenticationValue": "xgTkbC8MAAAAAAAAAAAAAAAAAAA=", "eci": "07", "transStatus": "Y", "whiteListStatusSource": "03", "whiteListStatus": "Y", "deviceChannel": "03", "messageCategory": "PA", - "authMethod": "FRICTIONLESS_AUTHENTICATION", - "authTimestamp": "2024-08-14T16:17:52+00:00", - "transactionID": 1813 + "authMethod": "01", + "authTimestamp": "2024-09-10T20:19:30+00:00", + "transactionID": 248121 } ``` @@ -1534,25 +1419,6 @@ Envíe una solicitud 3RI por el valor del segundo bien/servicio. ### VISA -***Para Visa está disponible el flujo de pago dividido a través del DAF a partir de Abríl de 2024. Consultar para más detalle sobre VISA DAF*** - -**Prerrequicitos:** - -1. El identificador de comercio de ***Visa Merchant ID VMID*** deberá estar disponible en la subscripción. -2. El rango de tarjetas debe soportar el procesamiento con DAF - -Datos requeridos en la petición API - -**Datos DAF:** las llaves adicionales que se deberán enviar para que se aplique el DAF con VISA son los siguientes - -* billAddrCity -* billAddrCountry -* billAddrLine1 -* billAddrPostCode -* billAddrState -* email -* mobilePhone - ***Request Lookup*** ```json @@ -1561,8 +1427,8 @@ Datos requeridos en la petición API "threeRIInd": "06", "threeDSRequestorPriorAuthenticationInfo": { "threeDSReqPriorAuthMethod": "CARDHOLDER_CHALLENGE_OCCURRED", - "threeDSReqPriorAuthTimestamp": "2024-08-16T19:27:01+00:00", - "threeDSReqPriorRef": "59dd1fe3-1b7a-416c-93f4-fdc5b81836c5" + "threeDSReqPriorAuthTimestamp": "2024-09-10T20:33:55+00:00", + "threeDSReqPriorRef": "68ea3861-fa27-429b-8633-ff3f6a288f71" }, "acctNumber": "4931119220729333", "cardExpiryDate": "2902", @@ -1570,16 +1436,6 @@ Datos requeridos en la petición API "redirectURI": "https://www.placetopay.com/web", "purchaseCurrency": "USD", "reference": "Febrero 2024", - "billAddrCity": "Medellín", - "billAddrCountry": "COL", - "billAddrLine1": "Carrera 65 # 45 - 20", - "billAddrPostCode": "050004", - "billAddrState": "ANT", - "email": "john.doe@evertecinc.com", - "mobilePhone": { - "cc": "57", - "subscriber": "30011122333" - }, "messageVersion": "2.2.0" } ``` @@ -1594,17 +1450,7 @@ Datos requeridos en la petición API **threeDSReqPriorRef:** El ID otorgado por el ACS en la transacción previa ***primera autenticación***, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo -**threeDSReqPriorAuthData:** El ID otorgado por el DS en la transacción previa ***primera autenticación***, si este dato no es enviado MPI lo asigna, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo - -**Datos DAF:** las llaves adicionales que se deberán enviar para que se aplique el DAF con VISA son los siguientes - -* billAddrCity -* billAddrCountry -* billAddrLine1 -* billAddrPostCode -* billAddrState -* email -* mobilePhone +**threeDSReqPriorAuthData:** El ID otorgado por el DS en la transacción previa ***primera autenticación***, si este dato no es enviado 3DSS lo asigna, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo ***Response Lookup*** @@ -1613,36 +1459,23 @@ Datos requeridos en la petición API { "action": "continue", "messageType": "ARes", - "threeDSServerTransID": "4cda716a-fd92-4ee6-8ff2-7b5763468c5d", - "acsReferenceNumber": "DS_LOA_DIS_PPFU_020100_00010", - "acsTransID": "0dc71cc9-d64b-44fb-9388-12db4ae1e6f7", + "threeDSServerTransID": "87b8930d-8523-4083-8780-67adf3aeca96", + "acsReferenceNumber": "3DS_LOA_ACS_EISF_020200_00539V3", + "acsTransID": "b02b97b8-6748-4ecb-9f42-441b7d83d9cd", "dsReferenceNumber": "3DS_LOA_DIS_PPFU_020100_00010", - "dsTransID": "b5d81f03-d1e5-45ae-a9da-e9668f8e4c67", + "dsTransID": "26281147-cee2-4683-a538-c70fad690a08", "messageVersion": "2.2.0", - "authenticationValue": "AAAAAAAAAAAAAAAAAAAAAAAAAAA=", + "acsOperatorID": "10078025", + "authenticationValue": "AJkCBxaRcQAAAASwhAJUdYknEmE=", "eci": "05", - "messageExtension": [ - { - "name": "DAF Extension", - "id": "A000000003-003", - "criticalityIndicator": false, - "data": { - "chAccReqID": "uOQxQ7h7IQXWsmbrLh/46ikEVrRUXCwi8uGjMTUAIfQ=", - "authPayProcessReqInd": "01", - "version": "1.0", - "authPayCredStatus": "Y", - "dafAdvice": "01" - } - } - ], "transStatus": "Y", "whiteListStatusSource": "03", "whiteListStatus": "Y", "deviceChannel": "03", "messageCategory": "PA", - "authMethod": "FRICTIONLESS_AUTHENTICATION", - "authTimestamp": "2024-08-16T19:30:21+00:00", - "transactionID": 1901 + "authMethod": "01", + "authTimestamp": "2024-09-10T20:35:17+00:00", + "transactionID": 248127 } ``` @@ -1662,8 +1495,8 @@ Enviar una solicitud 3RI por el valor del tercer y último bien/servicio. "threeRIInd": "06", "threeDSRequestorPriorAuthenticationInfo": { "threeDSReqPriorAuthMethod": "CARDHOLDER_CHALLENGE_OCCURRED", - "threeDSReqPriorAuthTimestamp": "2024-08-14T16:16:01+00:00", - "threeDSReqPriorRef": "bd8571cb-f4f3-4ec6-ac23-d7ec11038c1c" + "threeDSReqPriorAuthTimestamp": "2024-09-10T20:16:01+00:00", + "threeDSReqPriorRef": "49c34627-aa6b-41dc-bdc8-e21c0276d9ce" }, "acctNumber": "5107000000010018", "cardExpiryDate": "2902", @@ -1685,7 +1518,7 @@ Enviar una solicitud 3RI por el valor del tercer y último bien/servicio. **threeDSReqPriorRef:** El ID otorgado por el ACS en la transacción previa ***primera autenticación***, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo -**threeDSReqPriorAuthData:** El ID otorgado por el DS en la transacción previa ***primera autenticación***, si este dato no es enviado MPI lo asigna, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo +**threeDSReqPriorAuthData:** El ID otorgado por el DS en la transacción previa ***primera autenticación***, si este dato no es enviado 3DSS lo asigna, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo ***Response Lookup*** @@ -1694,22 +1527,23 @@ Enviar una solicitud 3RI por el valor del tercer y último bien/servicio. { "action": "continue", "messageType": "ARes", - "threeDSServerTransID": "38744bb5-9f72-400d-8aaa-0d555afbd165", - "acsReferenceNumber": "DS_LOA_DIS_PPFU_020100_00010", - "acsTransID": "917f6e12-4b15-4553-906a-a9bc272aaf39", + "threeDSServerTransID": "bc925646-c654-4ba2-9e0a-9afaaa5684cc", + "acsReferenceNumber": "3DS_LOA_ACS_EISF_020200_00539", + "acsTransID": "187648b7-ae15-4da6-a5df-f7298db768d9", "dsReferenceNumber": "3DS_LOA_DIS_PPFU_020100_00010", - "dsTransID": "3c3cf1e4-3806-4e9c-b7ca-f2f6577d8440", + "dsTransID": "a0a446cd-0767-4fa7-942b-e94571f1f37c", "messageVersion": "2.2.0", - "authenticationValue": "AAAAAAAAAAAAAAAAAAAAAAAAAAA=", + "acsOperatorID": "ACS-V210-ACS-PLACETOPAY-11174", + "authenticationValue": "xgSlHx+5AAAAAAAAAAAAAAAAAAA=", "eci": "07", "transStatus": "Y", "whiteListStatusSource": "03", "whiteListStatus": "Y", "deviceChannel": "03", "messageCategory": "PA", - "authMethod": "FRICTIONLESS_AUTHENTICATION", - "authTimestamp": "2024-08-14T16:31:27+00:00", - "transactionID": 1814 + "authMethod": "01", + "authTimestamp": "2024-09-10T20:23:36+00:00", + "transactionID": 248122 } ``` @@ -1718,24 +1552,6 @@ Enviar una solicitud 3RI por el valor del tercer y último bien/servicio. ### VISA -***Para Visa está disponible el flujo de pago dividido a través del DAF a partir de Abríl de 2024. Consultar para más detalle sobre VISA DAF*** - -**Prerequicitos:** - -1. El identificador de comercio de **Visa Merchant ID VMID** deberá estar disponible en la subscripción. -2. El rango de tarjetas debe soportar el procesamiento con DAF - -Datos requeridos en la petición API - -**Datos DAF:** las llaves adicionales que se deberán enviar para que se aplique el DAF con VISA son los siguientes - -* billAddrCity -* billAddrCountry -* billAddrLine1 -* billAddrPostCode -* billAddrState -* email -* mobilePhone ***Request Lookup*** @@ -1745,8 +1561,8 @@ Datos requeridos en la petición API "threeRIInd": "06", "threeDSRequestorPriorAuthenticationInfo": { "threeDSReqPriorAuthMethod": "CARDHOLDER_CHALLENGE_OCCURRED", - "threeDSReqPriorAuthTimestamp": "2024-08-16T19:27:01+00:00", - "threeDSReqPriorRef": "59dd1fe3-1b7a-416c-93f4-fdc5b81836c5" + "threeDSReqPriorAuthTimestamp": "2024-09-10T20:33:55+00:00", + "threeDSReqPriorRef": "68ea3861-fa27-429b-8633-ff3f6a288f71" }, "acctNumber": "4931119220729333", "cardExpiryDate": "2902", @@ -1754,16 +1570,6 @@ Datos requeridos en la petición API "redirectURI": "https://www.placetopay.com/web", "purchaseCurrency": "USD", "reference": "Febrero 2024", - "billAddrCity": "Medellín", - "billAddrCountry": "COL", - "billAddrLine1": "Carrera 65 # 45 - 20", - "billAddrPostCode": "050004", - "billAddrState": "ANT", - "email": "john.doe@evertecinc.com", - "mobilePhone": { - "cc": "57", - "subscriber": "30011122333" - }, "messageVersion": "2.2.0" } @@ -1782,56 +1588,46 @@ Datos requeridos en la petición API { "action": "continue", "messageType": "ARes", - "threeDSServerTransID": "5fda716a-fd92-4ee6-8gg4-7b5763468a6b", - "acsReferenceNumber": "DS_LOA_DIS_PPFU_020100_00010", - "acsTransID": "b0c71cc9-d64b-44fb-9388-12db4ae1a5g6", + "threeDSServerTransID": "2f9f285a-f876-4744-adaa-9c1cedf97271", + "acsReferenceNumber": "3DS_LOA_ACS_EISF_020200_00539V3", + "acsTransID": "14f3123b-d769-4a14-afea-d6bd5719d332", "dsReferenceNumber": "3DS_LOA_DIS_PPFU_020100_00010", - "dsTransID": "b5d81f04-d1e5-45ad-a9de-e9668f8e5a87", + "dsTransID": "f1ca5639-b587-4cd1-894e-fa14b97b9fdf", "messageVersion": "2.2.0", - "authenticationValue": "AAAAAAAAAAAAAAAAAAAAAAAAAAA=", + "acsOperatorID": "10078025", + "authenticationValue": "AJkCAWCXJgAAADLIhAJUdYknEmE=", "eci": "05", - "messageExtension": [ - { - "name": "DAF Extension", - "id": "A000000003-003", - "criticalityIndicator": false, - "data": { - "chAccReqID": "uOQxQ7h7IQXWsmbrLh/46ikEVrRUXCwi8uGjMTUAIfQ=", - "authPayProcessReqInd": "01", - "version": "1.0", - "authPayCredStatus": "Y", - "dafAdvice": "01" - } - } - ], "transStatus": "Y", "whiteListStatusSource": "03", "whiteListStatus": "Y", "deviceChannel": "03", "messageCategory": "PA", - "authMethod": "FRICTIONLESS_AUTHENTICATION", - "authTimestamp": "2024-08-16T19:30:21+00:00", - "transactionID": 1902 + "authMethod": "01", + "authTimestamp": "2024-09-10T20:38:23+00:00", + "transactionID": 248129 } ``` -**Actión:** redirect indica que la API retornara un redirectURL que deberá ser consumido para continuar con el flujo +**Actión:** continue indica que la API retornara la información de la autenticación, y por ende no es necesario consumir endpoints adicionales para continuar con el flujo --- - - - ## Envío retrasado -Permite a los comerciantes mantener la protección de responsabilidad más allá de los 90 días después de una autenticación inicial. Los comerciantes pueden utilizar esta funcionalidad cuando, por ejemplo, un envío/servicio se retrasa más de 90 días. Si la solicitud 3RI tiene éxito, se generará un nuevo CAVV para el comerciante, otorgando otros 90 días de protección de responsabilidad. +Permite a los comerciantes mantener la protección de responsabilidad más allá de los 90 días después de una autenticación inicial. +Los comerciantes pueden utilizar esta funcionalidad cuando, por ejemplo, un envío/servicio se retrasa más de 90 días. +Si la solicitud 3RI tiene éxito, se generará un nuevo CAVV para el comerciante, otorgando otros 90 días de protección de responsabilidad. -Cuando los comerciantes soliciten un nuevo CAVV a través de una autenticación de 3RI, deben hacerlo dentro de los 90 días posteriores a la fecha de la autenticación inicial. Los comerciantes solo deben enviar este tipo de solicitudes si necesitan protección de responsabilidad más allá de los 90 días desde la autenticación inicial. Deberían retrasar la solicitud de un nuevo CAVV tanto como sea posible dentro del período de 90 días. Si el CAVV inicial ha expirado, aunque ya no proporciona protección de responsabilidad, los emisores deben considerar que aún puede ser utilizado por el comerciante como prueba de que se realizó la autenticación. +Cuando los comerciantes soliciten un nuevo CAVV a través de una autenticación de 3RI, deben hacerlo dentro de los 90 +días posteriores a la fecha de la autenticación inicial. Los comerciantes solo deben enviar este tipo de solicitudes si necesitan protección +de responsabilidad más allá de los 90 días desde la autenticación inicial. Deberían retrasar la solicitud de un nuevo CAVV tanto como sea posible +dentro del período de 90 días. Si el CAVV inicial ha expirado, aunque ya no proporciona protección de responsabilidad, los emisores deben considerar +que aún puede ser utilizado por el comerciante como prueba de que se realizó la autenticación. ***Datos a considerar al procesar envíos divididos:*** -* El nombre del solicitante 3DS **threeDSRequestorName** y el nombre del comerciante (merchantName) deben ser los mismos en la solicitud de autenticación inicial y en cada una de las solicitudes 3RI asociadas +* El nombre del solicitante 3DS **threeDSRequestorName** y el nombre del comerciante **merchantName** deben ser los mismos en la solicitud de autenticación inicial y en cada una de las solicitudes 3RI asociadas * El valor total de todas las solicitudes 3RI no debe sumar un monto mayor que el monto de la solicitud de autenticación inicial y del total de los montos ya autorizados `POST` https://3dss-dev.placetopay.ws/api/threeds/v2x/sessions @@ -1839,9 +1635,9 @@ Cuando los comerciantes soliciten un nuevo CAVV a través de una autenticación ***Casos de Uso:*** -* Preventa de productos: un cliente compra un producto en preventa, como un libro o un dispositivo electrónico que aún no está disponible. La tarjeta se carga cuando se realiza la compra, pero el producto se enviará semanas o meses después cuando esté disponible. -* Productos fuera de stock: un cliente compra un producto que no está en stock en ese momento, pero que será enviado una vez que esté disponible. La tarjeta se carga al hacer el pedido, y el producto se envía cuando el inventario se repone. -* Pedidos con envíos programados: un cliente compra varios productos, pero solicita que el envío se realice en una fecha futura específica. El pago se procesa de inmediato, pero el envío se retrasa hasta la fecha solicitada. +* **Preventa de productos:** un cliente compra un producto en preventa, como un libro o un dispositivo electrónico que aún no está disponible. La tarjeta se carga cuando se realiza la compra, pero el producto se enviará semanas o meses después cuando esté disponible. +* **Productos fuera de stock:** un cliente compra un producto que no está en stock en ese momento, pero que será enviado una vez que esté disponible. La tarjeta se carga al hacer el pedido, y el producto se envía cuando el inventario se repone. +* **Pedidos con envíos programados:** un cliente compra varios productos, pero solicita que el envío se realice en una fecha futura específica. El pago se procesa de inmediato, pero el envío se retrasa hasta la fecha solicitada. | Evento | Valor | Descripción | @@ -1891,9 +1687,9 @@ Antes de realizar una solicitud 3RI, debe haberse realizado una autenticación E ```json { "action": "redirect", - "sessionToken": "db1c9baee5a5191aeda5845046ff7eb816b1fc7295d718787aa7f5a00750d607", - "redirectURL": "https://3dss-dev.placetopay.ws/threeds/v2x/sessions/1768/db1c9baee5a5191aeda5845046ff7eb816b1fc7295d718787aa7f5a00750d607", - "transactionID": 1812 + "sessionToken": "c793365493edc34b17a7097ea8a33fdb5853d8e0da62d39ca9e49e6c021a641f", + "redirectURL": "https://3dss-test.placetopay.com/threeds/v2x/sessions/86167/c793365493edc34b17a7097ea8a33fdb5853d8e0da62d39ca9e49e6c021a641f", + "transactionID": 248133 } ``` @@ -1902,90 +1698,521 @@ Antes de realizar una solicitud 3RI, debe haberse realizado una autenticación E ### VISA -***Para Visa está disponible el flujo de pago dividido a través del DAF a partir de Abríl de 2024. Consultar para más detalle sobre VISA DAF*** - -**Prerrequisitos:** +***Request Lookup*** -1. El identificador de comercio de **Visa Merchant ID VMID** deberá estar disponible en la subscripción. -2. El rango de tarjetas debe soportar el procesamiento con DAF +```json +{ + "deviceChannel": "02", + "threeDSAuthenticationInd": "01", + "threeDSChallengeInd": "04", + "acctNumber": "4931119220729333", + "cardExpiryDate": "2902", + "purchaseAmount": "112", + "redirectURI": "https://www.placetopay.com/web", + "purchaseCurrency": "USD", + "reference": "Enero 2024", + "messageVersion": "2.2.0" +} +``` -Datos requeridos en la petición API +**deviceChannel:** 02 - Navegador -**Datos DAF:** las llaves adicionales que se deberán enviar para que se aplique el DAF con VISA son los siguientes +**threeDSAuthenticationInd:** 01 indica que la transacción es de pago -* billAddrCity -* billAddrCountry -* billAddrLine1 -* billAddrPostCode -* billAddrState -* email -* mobilePhone +**threeDSChallengeInd:** 04: el desafío es obligatorio + +***Response Lookup*** + + +```json +{ + "action": "redirect", + "sessionToken": "3dcdb5b0d1403b0b1e14348037a3c74f202bf18d73233597a07a38963721b18e", + "redirectURL": "https://3dss-test.placetopay.com/threeds/v2x/sessions/86170/3dcdb5b0d1403b0b1e14348037a3c74f202bf18d73233597a07a38963721b18e", + "transactionID": 248136 +} +``` + +**Actión:** redirect indica que la API retornara un redirectURL que deberá ser consumido para continuar con el flujo + + +**Solicitud 3RI de un bien/servicio retrasado.** + +Envíe una solicitud 3RI por el valor del segundo bien/servicio + +### MASTERCARD + +***Request Lookup*** + +```json +{ + "deviceChannel": "03", + "threeRIInd": "06", + "threeDSRequestorPriorAuthenticationInfo": { + "threeDSReqPriorAuthMethod": "CARDHOLDER_CHALLENGE_OCCURRED", + "threeDSReqPriorAuthTimestamp": "2024-09-10T21:06:02+00:00", + "threeDSReqPriorRef": "2dd8d5d0-8563-4ae5-aa9e-23d31fa6fb85" + }, + "acctNumber": "5107000000010018", + "cardExpiryDate": "2902", + "purchaseAmount": "112", + "redirectURI": "https://www.placetopay.com/web", + "purchaseCurrency": "USD", + "reference": "Febrero 2024", + "messageVersion": "2.2.0" +} +``` + +**deviceChannel:** 03 indica que el canal es 3RI + +**threeRIInd:** 06 indica que la transacción es un envío dividido o retrasado + +**threeDSReqPriorAuthMethod:** Método que fue usado por el tarjetahabiente para la autenticación. 01 sin fricción, 02 con fricción, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo + +**threeDSReqPriorAuthTimestamp:** Fecha y hora en formato UTC de la autenticación previa. El formato es C, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo + +**threeDSReqPriorRef:** El ID otorgado por el ACS en la transacción previa ***primera autenticación***, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo + +**threeDSReqPriorAuthData:** El ID otorgado por el DS en la transacción previa ***primera autenticación***, si este dato no es enviado 3DSS lo asigna, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo + +***Response Lookup*** + + +```json +{ + "action": "continue", + "messageType": "ARes", + "threeDSServerTransID": "f91b89a9-7924-48de-97ab-8cc58bc5fcc2", + "acsReferenceNumber": "3DS_LOA_ACS_EISF_020200_00539", + "acsTransID": "cc3b5ff3-9dd7-44ae-bfa0-472de466f449", + "dsReferenceNumber": "3DS_LOA_DIS_PPFU_020100_00010", + "dsTransID": "a730d64c-ddb1-4f99-8f2c-4591d00021e3", + "messageVersion": "2.2.0", + "acsOperatorID": "ACS-V210-ACS-PLACETOPAY-11174", + "authenticationValue": "xgQkuJ5tAAAAAAAAAAAAAAAAAAA=", + "eci": "07", + "transStatus": "Y", + "whiteListStatusSource": "03", + "whiteListStatus": "Y", + "deviceChannel": "03", + "messageCategory": "PA", + "authMethod": "01", + "authTimestamp": "2024-09-10T21:07:09+00:00", + "transactionID": 248135 +} +``` + +**Actión:** continue indica que la API retornara la información de la autenticación, y por ende no es necesario consumir endpoints adicionales para continuar con el flujo + +### VISA + +***Request Lookup*** + +```json +{ + "deviceChannel": "03", + "threeRIInd": "06", + "threeDSRequestorPriorAuthenticationInfo": { + "threeDSReqPriorAuthMethod": "CARDHOLDER_CHALLENGE_OCCURRED", + "threeDSReqPriorAuthTimestamp": "2024-09-10T21:10:29+00:00", + "threeDSReqPriorRef": "7f7c0594-7e0f-4b13-bd45-6d180c35ffb0" + }, + "acctNumber": "4931119220729333", + "cardExpiryDate": "2902", + "purchaseAmount": "112", + "redirectURI": "https://www.placetopay.com/web", + "purchaseCurrency": "USD", + "reference": "Febrero 2024", + "messageVersion": "2.2.0" +} +``` + +**deviceChannel:** 03 indica que el canal es 3RI + +**threeRIInd:** 06 indica que la transacción es un envío dividido o retrasado + +**threeDSReqPriorAuthMethod:** Método que fue usado por el tarjetahabiente para la autenticación. 01 sin fricción, 02 con fricción, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo + +**threeDSReqPriorAuthTimestamp:** Fecha y hora en formato UTC de la autenticación previa. El formato es C, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo + +**threeDSReqPriorRef:** El ID otorgado por el ACS en la transacción previa ***primera autenticación***, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo + +**threeDSReqPriorAuthData:** El ID otorgado por el DS en la transacción previa **primera autenticación**, si este dato no es enviado 3DSS lo asigna, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo + +***Response Lookup*** + + +```json + { + "action": "continue", + "messageType": "ARes", + "threeDSServerTransID": "0ec3a36a-3c91-4864-bfc0-730300027805", + "acsReferenceNumber": "3DS_LOA_ACS_EISF_020200_00539V3", + "acsTransID": "4483ff06-0f36-45a2-aa13-b7f88564910b", + "dsReferenceNumber": "3DS_LOA_DIS_PPFU_020100_00010", + "dsTransID": "8360727e-22ff-4c23-bef8-ba2510eaf59b", + "messageVersion": "2.2.0", + "acsOperatorID": "10078025", + "authenticationValue": "AJkCAREXeQAAACvAhAJUdYknEmE=", + "eci": "05", + "transStatus": "Y", + "whiteListStatusSource": "03", + "whiteListStatus": "Y", + "deviceChannel": "03", + "messageCategory": "PA", + "authMethod": "01", + "authTimestamp": "2024-09-10T21:12:29+00:00", + "transactionID": 248138 +} +``` + +**Actión:** redirect indica que la API retornara un redirectURL que deberá ser consumido para continuar con el flujo + +--- + +## Otros pagos/comercio entre múltiples partes + +**Otros pagos** es la categoría reservada para los escenarios de **comercio entre múltiples partes** que pueden tener lugar cuando varias partes están involucradas en el procesamiento de múltiples autorizaciones asociadas con una única reserva de viaje o cuando varias partes en sectores distintos al de viajes están involucradas en el procesamiento de múltiples autorizaciones asociadas con un único pago desde el punto de vista del titular de la tarjeta. + +En la solicitud de autenticación inicial y las solicitudes 3RI asociadas, los agentes de reservas/proveedores de servicios comerciales también deben usar las convenciones de nomenclatura y los identificadores apropiados para el caso de uso para el que están autenticando: + +* Autenticación solo en nombre de un solo comerciante +* Autenticación en nombre de varios comerciantes +* Autenticarse a sí mismos y en nombre de otro comerciante + + +De manera similar a los envíos divididos, los emisores deben realizar un seguimiento del valor total utilizando los datos de transacción tanto de autorización como de autenticación. Esto es necesario ya que el agente de reservas/proveedor de servicios del comerciante no puede realizar una solicitud 3RI para todas las partes involucradas en la transacción y, como tal, el emisor no puede asumir que la suma de todas las solicitudes 3RI será igual al total del monto de autenticación inicial, pero los montos 3RI no deben exceder el monto autenticado original. + +Agente de reservas que realiza la autenticación en nombre de un único comerciante + +El titular de una tarjeta ha reservado un artículo en el sitio web de un agente de viajes, por ejemplo, un vuelo +por valor de $395, que se debe pagar al vendedor (es decir, la aerolínea, que será el comerciante en el +sistema de autorización) o cobrar por él en el momento de la reserva, pero el agente de viajes se encarga de la autenticación. + + +| **Evento** | **Parte** | **Valor** | **Descripción** | +|--------------------------------------------------------|-------------------------|-----------|-----------------------------------------------------------------------------------------------------------------------------------------------------| +| Autenticación inicial por parte del agente de reservas | Agente de reservas | $395 | Autenticación inicial por el importe total del pedido por parte del agente de reservas | +| Autorización para bienes/servicios | Comerciante de viajes 1 | $395 | El agente de reservas proporciona el CAVV de la autenticación inicial al vendedor, lo que le permite realizar una autorización por el importe total | + + + + +**Autenticación inicial por parte del agente de reservas** + +Autenticación inicial por el importe total del pedido por parte del agente de reservas + +### MASTERCARD + +***Request Lookup*** + +```json +{ + "deviceChannel": "02", + "threeDSAuthenticationInd": "85", + "threeDSChallengeInd": "04", + "acctNumber": "5107000000010018", + "cardExpiryDate": "2902", + "redirectURI": "https://www.placetopay.com/web", + "purchaseAmount": "395", + "purchaseCurrency": "USD", + "reference": "Enero 2024", + "messageVersion": "2.2.0" +} + +``` + +**deviceChannel:** 02 - Navegador + +**threeDSAuthenticationInd:** 01 indica que la transacción es de pago + +**threeDSChallengeInd:** 04: el desafío es obligatorio + + +***Response Lookup*** + +```json +{ + "action": "redirect", + "sessionToken": "cf980dc8f7bc550243c9aa49e36902474b36dfcddd0d5671f78a924311c8bdc0", + "redirectURL": "https://3dss-test.placetopay.com/threeds/v2x/sessions/86177/cf980dc8f7bc550243c9aa49e36902474b36dfcddd0d5671f78a924311c8bdc0", + "transactionID": 248143 +} +``` + +**Actión:** redirect indica que la API retornara un redirectURL que deberá ser consumido para continuar con el flujo + + +### VISA + +***Request Lookup*** + +```json +{ + "deviceChannel": "02", + "threeDSAuthenticationInd": "01", + "threeDSChallengeInd": "04", + "acctNumber": "4931119220729333", + "cardExpiryDate": "2902", + "redirectURI": "https://www.placetopay.com/web", + "purchaseAmount": "395", + "purchaseCurrency": "USD", + "reference": "Enero 2024", + "messageVersion": "2.2.0" +} +``` + +**deviceChannel:** 02 - Navegador + +**threeDSAuthenticationInd:** 01 indica que la transacción es de pago + +**threeDSChallengeInd:** 04: el desafío es obligatorio + + +***Response Lookup*** + + +```json +{ + "action": "redirect", + "sessionToken": "c7bf55043c2d0403e87eaff8895951f70067e48a12a3d46203fd82df3da0a7c1", + "redirectURL": "https://3dss-test.placetopay.com/threeds/v2x/sessions/86180/c7bf55043c2d0403e87eaff8895951f70067e48a12a3d46203fd82df3da0a7c1", + "transactionID": 248146 +} +``` + +**Actión:** redirect indica que la API retornara un redirectURL que deberá ser consumido para continuar con el flujo + + + + +### Agente de reservas que realiza la autenticación en nombre de varios comerciantes + +Un titular de tarjeta ha reservado en un sitio web de viajes **agente de reservas** tres artículos pagaderos a cada proveedor de viajes individual **comerciante 1, 2 y 3 en el sistema de autorización**. El sitio web de viajes no está recaudando fondos, sino que realiza la autenticación en nombre de los 3 proveedores de viajes: + +* Un vuelo por $170 pagadero a la aerolínea **proveedor/comerciante 1** en el momento de la reserva +* Un hotel para el cual no se debe realizar un depósito en el momento de la reserva (el hotel **proveedor/comerciante 2 toma los datos de la tarjeta en caso de que se requiera un pago por no presentarse** +* Un alquiler de automóvil para el cual se debe realizar un depósito de $50 a la compañía de alquiler **vendedor/comerciante 3** en el momento de la reserva + + +| **Evento** | **Parte** | **Valor** | **Descripción** | +|------------------------------------------------------------|---------------------------------|-----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| Autenticación inicial por parte del agente de reservas | Agente de reservas | $220 | Autenticación inicial por parte del agente de reservas por el monto adeudado por el pedido | +| El agente de reservas realiza tres transacciones 3RI | Agente de reservas | $220 | El agente de reservas realiza tres transacciones 3RI para obtener tres CAVV independientes: Aerolínea $170, Hotel $0, Alquiler de automóvil $50 | +| Autorización para bienes/servicios (Vuelo) | Comerciante de viajes 1 | $170 | El comerciante de la aerolínea utiliza el CAVV de la transacción 3RI con un valor de 170 (y su nombre en el CAVV) para realizar la autorización del boleto de avión. | +| Autorización para bienes/servicios (Alojamiento) | Comerciante de viajes 2 (hotel) | $0 | El comerciante de alojamiento utiliza el CAVV de la transacción 3RI con un valor de 0 (y su nombre en el CAVV) para realizar la autorización para configurar un MIT. | +| Autorización para bienes/servicios (Alquiler de automóvil) | Comerciante de viajes 3 | $50 | El comerciante de alquiler de automóviles utiliza el CAVV de la transacción 3RI con un valor de 50 (y su nombre en el CAVV) para realizar la autorización del depósito. | + + + +**Autenticación inicial por parte del agente de reservas** + +Autenticación inicial por parte del agente de reservas por el monto adeudado por el pedido. + +### MASTERCARD + +***Request Lookup*** + +```json +{ + "deviceChannel": "02", + "threeDSAuthenticationInd": "85", + "threeDSChallengeInd": "04", + "acctNumber": "5107000000010018", + "cardExpiryDate": "2806", + "purchaseAmount": "220", + "redirectURI": "https://www.placetopay.com/web", + "purchaseCurrency": "USD", + "messageVersion": "2.2.0" +} +``` + +**deviceChannel:** 02 - Navegador + +**threeDSAuthenticationInd:** 85 indica que la transacción es de otros pagos + +**threeDSChallengeInd: 04:** el desafío es obligatorio + +***Response Lookup*** + +```json +{ + "action": "redirect", + "sessionToken": "a52df573f6a0a8071714958671d018030c90fc1e6cdc00ac4b7b50a35403da53", + "redirectURL": "https://3dss-test.placetopay.com/threeds/v2x/sessions/86184/a52df573f6a0a8071714958671d018030c90fc1e6cdc00ac4b7b50a35403da53", + "transactionID": 248150 +} +``` + +**Actión:** redirect indica que la API retornara un redirectURL que deberá ser consumido para continuar con el flujo + + +### VISA + +***Request Lookup*** + +```json +{ + "deviceChannel": "02", + "threeDSAuthenticationInd": "01", + "threeDSChallengeInd": "04", + "recurringExpiry": "20260101", + "recurringFrequency": "2", + "acctNumber": "4931119220729333", + "cardExpiryDate": "2902", + "purchaseAmount": "220", + "redirectURI": "https://www.placetopay.com/web", + "purchaseCurrency": "USD", + "reference": "Enero 2024", + "messageVersion": "2.2.0" +} + +``` + +**deviceChannel:** 02 - Navegador + +**threeDSAuthenticationInd:** 01 indica que la transacción es de pago + +**threeDSChallengeInd:** 04 el desafío es obligatorio + +***Response Lookup*** + +```json +{ + "action": "redirect", + "sessionToken": "e672a6977da87394e43b3da848a754f0fc0c3f73153e4adb781fc54db1e80525", + "redirectURL": "https://3dss-test.placetopay.com/threeds/v2x/sessions/86196/e672a6977da87394e43b3da848a754f0fc0c3f73153e4adb781fc54db1e80525", + "transactionID": 248162 +} +``` + +**Actión:** redirect indica que la API retornara un redirectURL que deberá ser consumido para continuar con el flujo + +**Transacciones 3RI aerolínea** +El agente de reservas realiza la transaccion 3RI para obtener el CAVV y proporcionarlo al comerciante de viajes 1 (aerolínea) + +### MASTERCARD ***Request Lookup*** ```json { - "deviceChannel": "02", - "threeDSAuthenticationInd": "01", - "threeDSChallengeInd": "04", - "recurringExpiry": "20260101", - "recurringFrequency": "2", - "acctNumber": "4931119220729333", + "deviceChannel": "03", + "threeRIInd": "85", + "threeDSRequestorPriorAuthenticationInfo": { + "threeDSReqPriorAuthMethod": "CARDHOLDER_CHALLENGE_OCCURRED", + "threeDSReqPriorAuthTimestamp": "2024-09-10T22:21:27+00:00", + "threeDSReqPriorRef": "c524216d-a19e-4a6b-ae1c-40b82c59fe38" + }, + "acctNumber": "5107000000010018", "cardExpiryDate": "2902", - "purchaseAmount": "102", + "purchaseAmount": "170", "redirectURI": "https://www.placetopay.com/web", "purchaseCurrency": "USD", - "reference": "Enero 2024", - "billAddrCity": "Medellín", - "billAddrCountry": "COL", - "billAddrLine1": "Carrera 65 # 45 - 20", - "billAddrPostCode": "050004", - "billAddrState": "ANT", - "email": "john.doe@evertecinc.com", - "mobilePhone": { - "cc": "57", - "subscriber": "30011122333" - }, + "reference": "Marzo 2024", "messageVersion": "2.2.0" } ``` -**deviceChannel:** 02 - Navegador +**deviceChannel:** 03 indica que el canal es 3RI -**threeDSAuthenticationInd:** 01 indica que la transacción es de pago +**threeRIInd:** 85 indica que la transacción de tipo otros pagos -**threeDSChallengeInd:** 04: el desafío es obligatorio +**threeDSReqPriorAuthMethod:** Método que fue usado por el tarjetahabiente para la autenticación. 01 sin fricción, 02 con fricción, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo -**Datos DAF:** las llaves adicionales que se deberán enviar para que se aplique el DAF con VISA son los siguientes +**threeDSReqPriorAuthTimestamp:** Fecha y hora en formato UTC de la autenticación previa. El formato es C, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo -* billAddrCity -* billAddrCountry -* billAddrLine1 -* billAddrPostCode -* billAddrState -* email -* mobilePhone +**threeDSReqPriorRef:** El ID otorgado por el ACS en la transacción previa (primera autenticación), consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo + +**threeDSReqPriorAuthData:** El ID otorgado por el DS en la transacción previa (primera autenticación), si este dato no es enviado 3DSS lo asigna, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo ***Response Lookup*** +```json +{ + "action": "continue", + "messageType": "ARes", + "threeDSServerTransID": "1045a464-161f-4538-a769-9a0f84e27a3d", + "acsReferenceNumber": "3DS_LOA_ACS_EISF_020200_00539", + "acsTransID": "f31f4da1-7ac1-4be4-b37a-9e28d8e4eb9e", + "dsReferenceNumber": "3DS_LOA_DIS_PPFU_020100_00010", + "dsTransID": "a0dca8a6-5fc5-49f9-96b2-8ee5c9e51508", + "messageVersion": "2.2.0", + "acsOperatorID": "ACS-V210-ACS-PLACETOPAY-11174", + "authenticationValue": "xgSFPEJIAAAAAAAAAAAAAAAAAAA=", + "eci": "07", + "transStatus": "Y", + "whiteListStatusSource": "03", + "whiteListStatus": "Y", + "deviceChannel": "03", + "messageCategory": "PA", + "authMethod": "01", + "authTimestamp": "2024-09-10T22:34:13+00:00", + "transactionID": 248159 +} +``` +**Actión:** continue indica que la API retornara la información de la autenticación, y por ende no es necesario consumir endpoints adicionales para continuar con el flujo + + +### VISA + +***Request Lookup*** ```json { - "action": "redirect", - "sessionToken": "db1c9baee5a5191aeda5845046ff7eb816b1fc7295d718787aa7f5a00750d607", - "redirectURL": "https://3dss-dev.placetopay.ws/threeds/v2x/sessions/1768/db1c9baee5a5191aeda5845046ff7eb816b1fc7295d718787aa7f5a00750d607", - "transactionID": 1900 + "deviceChannel": "03", + "threeRIInd": "11", + "threeDSRequestorPriorAuthenticationInfo": { + "threeDSReqPriorAuthMethod": "CARDHOLDER_CHALLENGE_OCCURRED", + "threeDSReqPriorAuthTimestamp": "2024-09-10T22:44:39+00:00", + "threeDSReqPriorRef": "9e4c13a7-0813-4402-9c53-687a01303f78" + }, + "acctNumber": "4931119220729333", + "cardExpiryDate": "2902", + "purchaseAmount": "170", + "redirectURI": "https://www.placetopay.com/web", + "purchaseCurrency": "USD", + "reference": "Febrero 2024", + "messageVersion": "2.2.0" } ``` -**Actión:** redirect indica que la API retornara un redirectURL que deberá ser consumido para continuar con el flujo +**deviceChannel:** 03 indica que el canal es 3RI +**threeRIInd:** 11 indica que la transacción de tipo otro pago -**Solicitud 3RI de un bien/servicio retrasado.** +***Response Lookup*** -Envíe una solicitud 3RI por el valor del segundo bien/servicio +```json + { + "action": "continue", + "messageType": "ARes", + "threeDSServerTransID": "1a53d143-230f-47b9-b886-a201ee867489", + "acsReferenceNumber": "3DS_LOA_ACS_EISF_020200_00539V3", + "acsTransID": "179f6511-b042-41f3-939d-7f862a527751", + "dsReferenceNumber": "3DS_LOA_DIS_PPFU_020100_00010", + "dsTransID": "f5eb0bae-dccf-498e-b639-4abf5e86b162", + "messageVersion": "2.2.0", + "acsOperatorID": "10078025", + "authenticationValue": "AJkCAhAyeQAAAEJohAJUdYknEmE=", + "eci": "05", + "transStatus": "Y", + "whiteListStatusSource": "03", + "whiteListStatus": "Y", + "deviceChannel": "03", + "messageCategory": "PA", + "authMethod": "01", + "authTimestamp": "2024-09-10T22:46:32+00:00", + "transactionID": 248164 +} +``` + +**Actión:** continue indica que la API retornara la información de la autenticación, y por ende no es necesario consumir endpoints adicionales para continuar con el flujo + + +**Transacciones 3RI hotel** ### MASTERCARD @@ -1994,180 +2221,257 @@ Envíe una solicitud 3RI por el valor del segundo bien/servicio ```json { "deviceChannel": "03", - "threeRIInd": "06", + "threeRIInd": "85", "threeDSRequestorPriorAuthenticationInfo": { "threeDSReqPriorAuthMethod": "CARDHOLDER_CHALLENGE_OCCURRED", - "threeDSReqPriorAuthTimestamp": "2024-08-21T16:30:35+00:00", - "threeDSReqPriorRef": "6775467f-4109-4a5b-a308-c2e628bfc289" + "threeDSReqPriorAuthTimestamp": "2024-09-10T22:21:27+00:00", + "threeDSReqPriorRef": "c524216d-a19e-4a6b-ae1c-40b82c59fe38" }, "acctNumber": "5107000000010018", "cardExpiryDate": "2902", - "purchaseAmount": "12", + "purchaseAmount": "0", "redirectURI": "https://www.placetopay.com/web", "purchaseCurrency": "USD", - "reference": "Febrero 2024", + "reference": "Abril 2024", "messageVersion": "2.2.0" } ``` **deviceChannel:** 03 indica que el canal es 3RI -**threeRIInd:** 06 indica que la transacción es un envío dividido o retrasado +**threeRIInd:** 85 indica que la transacción de tipo otros pagos -**threeDSReqPriorAuthMethod:** Método que fue usado por el tarjetahabiente para la autenticación. 01 sin fricción, 02 con fricción, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo +**threeDSReqPriorAuthMethod:** Método que fue usado por el tarjetahabiente para la autenticación. 01 sin fricción, 02 con fricción, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo **threeDSReqPriorAuthTimestamp:** Fecha y hora en formato UTC de la autenticación previa. El formato es C, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo -**threeDSReqPriorRef:** El ID otorgado por el ACS en la transacción previa ***primera autenticación***, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo +**threeDSReqPriorRef:** El ID otorgado por el ACS en la transacción previa (primera autenticación), consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo -**threeDSReqPriorAuthData:** El ID otorgado por el DS en la transacción previa ***primera autenticación***, si este dato no es enviado MPI lo asigna, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo +**threeDSReqPriorAuthData:** El ID otorgado por el DS en la transacción previa (primera autenticación), si este dato no es enviado 3DSS lo asigna, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo ***Response Lookup*** - ```json { "action": "continue", "messageType": "ARes", - "threeDSServerTransID": "f8c761e2-40a2-4a2d-91bb-189bb768a76e", - "acsReferenceNumber": "DS_LOA_DIS_PPFU_020100_00010", - "acsTransID": "967ba08b-28fb-4ad1-8181-0613a62d384e", + "threeDSServerTransID": "32c88ea6-7841-4c8b-9067-b84c99b20784", + "acsReferenceNumber": "3DS_LOA_ACS_EISF_020200_00539", + "acsTransID": "fa92fe01-84f7-4ae7-a3f1-1dd50f97ebef", "dsReferenceNumber": "3DS_LOA_DIS_PPFU_020100_00010", - "dsTransID": "1710f87d-d7ef-4ddb-a041-bb05156ca732", + "dsTransID": "634b8dc1-aa5b-48c3-b367-022156663c81", "messageVersion": "2.2.0", - "authenticationValue": "AAAAAAAAAAAAAAAAAAAAAAAAAAA=", + "acsOperatorID": "ACS-V210-ACS-PLACETOPAY-11174", + "authenticationValue": "xgRTaR2SAAAAAAAAAAAAAAAAAAA=", "eci": "07", "transStatus": "Y", "whiteListStatusSource": "03", "whiteListStatus": "Y", "deviceChannel": "03", "messageCategory": "PA", - "authMethod": "FRICTIONLESS_AUTHENTICATION", - "authTimestamp": "2024-08-21T16:32:14+00:00", - "transactionID": 163420 + "authMethod": "01", + "authTimestamp": "2024-09-10T22:36:05+00:00", + "transactionID": 248160 } ``` - **Actión:** continue indica que la API retornara la información de la autenticación, y por ende no es necesario consumir endpoints adicionales para continuar con el flujo ### VISA -***Para Visa está disponible el flujo de pago dividido a través del DAF a partir de Abríl de 2024. Consultar para más detalle sobre VISA DAF*** +***Request Lookup*** -**Prerrequicitos:** +```json +{ + "deviceChannel": "03", + "threeRIInd": "11", + "threeDSRequestorPriorAuthenticationInfo": { + "threeDSReqPriorAuthMethod": "CARDHOLDER_CHALLENGE_OCCURRED", + "threeDSReqPriorAuthTimestamp": "2024-09-10T22:44:39+00:00", + "threeDSReqPriorRef": "9e4c13a7-0813-4402-9c53-687a01303f78" + }, + "acctNumber": "4931119220729333", + "cardExpiryDate": "2902", + "purchaseAmount": "0", + "redirectURI": "https://www.placetopay.com/web", + "purchaseCurrency": "USD", + "reference": "Marzo 2024", + "messageVersion": "2.2.0" +} +``` -1. El identificador de comercio de **Visa Merchant ID VMID** deberá estar disponible en la subscripción. -2. El rango de tarjetas debe soportar el procesamiento con DAF +**deviceChannel:** 03 indica que el canal es 3RI -Datos requeridos en la petición API +**threeRIInd:** 11 indica que la transacción de tipo otros pagos -**Datos DAF:** las llaves adicionales que se deberán enviar para que se aplique el DAF con VISA son los siguientes +**threeDSReqPriorAuthMethod:** Método que fue usado por el tarjetahabiente para la autenticación. 01 sin fricción, 02 con fricción, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo -* billAddrCity -* billAddrCountry -* billAddrLine1 -* billAddrPostCode -* billAddrState -* email -* mobilePhone +**threeDSReqPriorAuthTimestamp:** Fecha y hora en formato UTC de la autenticación previa. El formato es C, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo + +**threeDSReqPriorRef:** El ID otorgado por el ACS en la transacción previa (primera autenticación), consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo + +**threeDSReqPriorAuthData:** El ID otorgado por el DS en la transacción previa (primera autenticación), si este dato no es enviado 3DSS lo asigna, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo + +***Response Lookup*** + +```json +{ + "action": "continue", + "messageType": "ARes", + "threeDSServerTransID": "b9913d5d-4980-4103-b77c-5daf0c7054b0", + "acsReferenceNumber": "3DS_LOA_ACS_EISF_020200_00539V3", + "acsTransID": "e9b7726c-6f9a-4606-afe3-09dce49f49a2", + "dsReferenceNumber": "3DS_LOA_DIS_PPFU_020100_00010", + "dsTransID": "6f9c449a-0ff3-4438-8c47-e3009ded9cd1", + "messageVersion": "2.2.0", + "acsOperatorID": "10078025", + "authenticationValue": "AJkCB4EjdQAAAAAAhAJUdYknEmE=", + "eci": "05", + "transStatus": "Y", + "whiteListStatusSource": "03", + "whiteListStatus": "Y", + "deviceChannel": "03", + "messageCategory": "PA", + "authMethod": "01", + "authTimestamp": "2024-09-10T22:48:07+00:00", + "transactionID": 248165 +} +``` + +**Actión:** continue indica que la API retornara la información de la autenticación, y por ende no es necesario consumir endpoints adicionales para continuar con el flujo + +**Transacciones 3RI alquiler de automóvil** + +El agente de reservas realiza la transacción 3RI para obtener el CAVV y proporcionarlo al comerciante de viajes 3 (alquiler automóvil) + +### MASTERCARD ***Request Lookup*** ```json { "deviceChannel": "03", - "threeRIInd": "06", + "threeRIInd": "85", "threeDSRequestorPriorAuthenticationInfo": { "threeDSReqPriorAuthMethod": "CARDHOLDER_CHALLENGE_OCCURRED", - "threeDSReqPriorAuthTimestamp": "2024-08-21T21:09:12+00:00", - "threeDSReqPriorRef": "e9c03914-1f35-49b7-b261-b26077bcaf8f" + "threeDSReqPriorAuthTimestamp": "2024-09-10T22:21:27+00:00", + "threeDSReqPriorRef": "c524216d-a19e-4a6b-ae1c-40b82c59fe38" }, - "acctNumber": "4931119220729333", + "acctNumber": "5107000000010018", "cardExpiryDate": "2902", - "purchaseAmount": "102", + "purchaseAmount": "50", "redirectURI": "https://www.placetopay.com/web", "purchaseCurrency": "USD", - "reference": "Febrero 2024", - "billAddrCity": "Medellín", - "billAddrCountry": "COL", - "billAddrLine1": "Carrera 65 # 45 - 20", - "billAddrPostCode": "050004", - "billAddrState": "ANT", - "email": "john.doe@evertecinc.com", - "mobilePhone": { - "cc": "57", - "subscriber": "30011122333" - }, + "reference": "Marzo 2024", "messageVersion": "2.2.0" } ``` **deviceChannel:** 03 indica que el canal es 3RI -**threeRIInd:** 06 indica que la transacción es un envío dividido o retrasado +**threeRIInd:** 85 indica que la transacción de tipo otros pagos **threeDSReqPriorAuthMethod:** Método que fue usado por el tarjetahabiente para la autenticación. 01 sin fricción, 02 con fricción, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo **threeDSReqPriorAuthTimestamp:** Fecha y hora en formato UTC de la autenticación previa. El formato es C, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo -**threeDSReqPriorRef:** El ID otorgado por el ACS en la transacción previa ***primera autenticación***, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo +**threeDSReqPriorRef:** El ID otorgado por el ACS en la transacción previa (primera autenticación), consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo -**threeDSReqPriorAuthData:** El ID otorgado por el DS en la transacción previa **primera autenticación**, si este dato no es enviado MPI lo asigna, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo +**threeDSReqPriorAuthData:** El ID otorgado por el DS en la transacción previa (primera autenticación), si este dato no es enviado 3DSS lo asigna, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo -**Datos DAF:** las llaves adicionales que se deberán enviar para que se aplique el DAF con VISA son los siguientes +***Response Lookup*** -* billAddrCity -* billAddrCountry -* billAddrLine1 -* billAddrPostCode -* billAddrState -* email -* mobilePhone +```json +{ + "action": "continue", + "messageType": "ARes", + "threeDSServerTransID": "c34f67dc-7a25-4977-97f7-ca1f961946be", + "acsReferenceNumber": "3DS_LOA_ACS_EISF_020200_00539", + "acsTransID": "fd189ecf-c65e-4a7d-9640-89662b850038", + "dsReferenceNumber": "3DS_LOA_DIS_PPFU_020100_00010", + "dsTransID": "4680679e-d6ed-48d2-89d2-b73de0828a57", + "messageVersion": "2.2.0", + "acsOperatorID": "ACS-V210-ACS-PLACETOPAY-11174", + "authenticationValue": "xgSELtLrAAAAAAAAAAAAAAAAAAA=", + "eci": "07", + "transStatus": "Y", + "whiteListStatusSource": "03", + "whiteListStatus": "Y", + "deviceChannel": "03", + "messageCategory": "PA", + "authMethod": "01", + "authTimestamp": "2024-09-10T22:38:11+00:00", + "transactionID": 248161 +} +``` -***Response Lookup*** +**Actión:** continue indica que la API retornara la información de la autenticación, y por ende no es necesario consumir endpoints adicionales para continuar con el flujo +### VISA + +***Request Lookup*** + ```json { + "deviceChannel": "03", + "threeRIInd": "11", + "threeDSRequestorPriorAuthenticationInfo": { + "threeDSReqPriorAuthMethod": "CARDHOLDER_CHALLENGE_OCCURRED", + "threeDSReqPriorAuthTimestamp": "2024-09-10T22:44:39+00:00", + "threeDSReqPriorRef": "9e4c13a7-0813-4402-9c53-687a01303f78" + }, + "acctNumber": "4931119220729333", + "cardExpiryDate": "2902", + "purchaseAmount": "50", + "redirectURI": "https://www.placetopay.com/web", + "purchaseCurrency": "USD", + "reference": "Mayo 2024", + "messageVersion": "2.2.0" +} +``` + +***deviceChannel:*** 03 indica que el canal es 3RI + +***threeRIInd:*** 11 indica que la transacción de tipo otros pagos + +***threeDSReqPriorAuthMethod:*** Método que fue usado por el tarjetahabiente para la autenticación. 01 sin fricción, 02 con fricción, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo + +***threeDSReqPriorAuthTimestamp:*** Fecha y hora en formato UTC de la autenticación previa. El formato es C, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo + +***threeDSReqPriorRef:*** El ID otorgado por el ACS en la transacción previa (primera autenticación), consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo + +***threeDSReqPriorAuthData:*** El ID otorgado por el DS en la transacción previa (primera autenticación), si este dato no es enviado 3DSS lo asigna, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo + +***Response Lookup*** + +```json + { "action": "continue", "messageType": "ARes", - "threeDSServerTransID": "cfa09f6a-3c1c-4847-9409-996b59d1afb2", - "acsReferenceNumber": "DS_LOA_DIS_PPFU_020100_00010", - "acsTransID": "b6f9145b-436f-4a9d-adad-42833f2f0e03", + "threeDSServerTransID": "7a64778d-45de-48ae-8c78-ec688775315d", + "acsReferenceNumber": "3DS_LOA_ACS_EISF_020200_00539V3", + "acsTransID": "d4b3bbae-5594-4c89-9cf8-ae2ac3499223", "dsReferenceNumber": "3DS_LOA_DIS_PPFU_020100_00010", - "dsTransID": "9f9c5743-952a-4fc9-bd0a-16be21996737", + "dsTransID": "5c4c3ec0-d31b-442d-81e8-86025c08cb9d", "messageVersion": "2.2.0", - "authenticationValue": "AAAAAAAAAAAAAAAAAAAAAAAAAAA=", + "acsOperatorID": "10078025", + "authenticationValue": "AJkCByOJNAAAABOIhAJUdYknEmE=", "eci": "05", - "messageExtension": [ - { - "name": "DAF Extension", - "id": "A000000003-003", - "criticalityIndicator": false, - "data": { - "chAccReqID": "uOQxQ7h7IQXWsmbrLh/46ikEVrRUXCwi8uGjMTUAIfQ=", - "authPayProcessReqInd": "01", - "version": "1.0", - "authPayCredStatus": "N" - } - } - ], "transStatus": "Y", "whiteListStatusSource": "03", "whiteListStatus": "Y", "deviceChannel": "03", "messageCategory": "PA", - "authMethod": "FRICTIONLESS_AUTHENTICATION", - "authTimestamp": "2024-08-21T21:14:38+00:00", - "transactionID": 163429 + "authMethod": "01", + "authTimestamp": "2024-09-10T22:49:54+00:00", + "transactionID": 248166 } ``` -**Actión:** redirect indica que la API retornara un redirectURL que deberá ser consumido para continuar con el flujo - ---- +**Actión:** continue indica que la API retornara la información de la autenticación, y por ende no es necesario consumir endpoints adicionales para continuar con el flujo +--- ## Transacciones con tarjeta registrada no programadas @@ -2188,7 +2492,7 @@ Las transacciones UCOF **Unscheduled card-on-file** se producen cuando un comerc ### VISA con DAF -Opción NPA: esta opción no require verificar fondos de la cuenta. +**Opción NPA:** esta opción no require verificar fondos de la cuenta. ***Request Lookup*** @@ -2296,7 +2600,7 @@ Opción NPA: esta opción no require verificar fondos de la cuenta. **threeDSReqPriorRef:** El ID otorgado por el ACS en la transacción previa ***primera autenticación***, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo -**threeDSReqPriorAuthData:** El ID otorgado por el DS en la transacción previa **primera autenticación**, si este dato no es enviado MPI lo asigna, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo +**threeDSReqPriorAuthData:** El ID otorgado por el DS en la transacción previa **primera autenticación**, si este dato no es enviado 3DSS lo asigna, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo **Datos DAF:** las llaves adicionales que se deberán enviar para que se aplique el DAF con VISA son los siguientes @@ -2383,37 +2687,19 @@ Para obtener los datos requeridos se deberá de lanzar la transacción tipo CIT } ``` +--- + ## Otros casos * Delayed Shipment **threeDSAuthenticationInd 09, threeRIInd 15** aplica par EMV 3DS 2.2 with Bridging Message Extension o par la versión EMV 3DS 2.3.1 * Split Shipment **threeDSAuthenticationInd 08, threeRIInd 06** aplica par EMV 3DS 2.2 with Bridging Message Extension o par la versión EMV 3DS 2.3.1 * Split Payment **threeDSAuthenticationInd 10, threeRIInd 16** aplica par EMV 3DS 2.2 with Bridging Message Extension o par la versión EMV 3DS 2.3.1 -## Preguntas frecuentes - -* **¿Es posible Agregar Tarjeta ***"threeDSAuthenticationInd": "04"*** y hacer la Autenticación de un Pago (PA) al mismo tiempo?** - - No es posible. En el proceso de Agregar Tarjeta a un comercio para validar la identidad de la tarjeta habiente, es permitido enviar un monto, en cuyo caso se descontará el monto para la verificación de fondos y DEBE ser reembolsado posteriormente por el comercio, lo cual no representa una Autenticación Pago en sí mismo. - - Es necesario enviar posterior al proceso de Agregar Tarjeta otra autenticación con el monto a Autenticacior - -* **¿Se puede usar una CIT NPA como PriorInformation para una MIT PA?** - - Es posible UNICAMENTE en el escenario de un pago único, en este caso, se podrá utilizar una CIT NPA de tipo “Agregar Tarjeta” **este es el único caso confirmado para este uso**. La transacción MIT deberá mandarse con el indicativo threeRIInd=81 **Unscheduled Credential-on-File**, este tipo de transacción no requiere ningún valor de recurrencia **recurringExpiry, recurringFrequency** únicamente el monto que se va a pagar. Eventualmente otros casos de uso pueden ser agregados en versiones del Protocolo. Esto aplica exclusivamente para VISA usando la extensión DAF - - La razón principal es que estas dos categorías de transacciones tienen naturalezas diferentes y propósitos distintos: - - 1. **MIT (Merchant Initiated Transaction):** Una MIT es iniciada por el comerciante en lugar del titular de la tarjeta. Por lo general, las MIT se utilizan para pagos recurrentes, como suscripciones mensuales o anuales, donde el comerciante tiene la autorización del titular de la tarjeta para cargar periódicamente el monto acordado en su tarjeta. En las MIT, la autenticación suele ser realizada por el comerciante y no requiere la interacción activa del titular de la tarjeta en el momento de la transacción. - 2. **CIT NPA ***Customer Initiated Transaction - Non Payment Authentication***:** Una CIT NPA es una transacción iniciada por el titular de la tarjeta que no implica un pago directo, sino que se utiliza para otros fines, como la verificación de la tarjeta o la consulta de saldo. En una CIT NPA, se puede realizar una autenticación sin que se realice una transferencia de fondos directa. - - Dado que una MIT implica un pago por parte del comerciante y una CIT NPA no implica un pago directo, no tendría sentido lanzar una transacción MIT junto con una CIT NPA. Cada tipo de transacción tiene su propio propósito y aplicación específica en el contexto del protocolo **3D Secure**. - - En pocas palabras: es posible unsar una CIT NPA en una MIT PA si el pago es único **no recurrente**. - - Unscheduled card-on-file transactions **UCOF**: A transaction using a stored credential for a fixed or variable amount that does not occur on a scheduled or regularly occurring transaction date, where the cardholder has provided consent for the merchant to initiate one or more future transactions - -* **Visa Digital Authentication Framework DAF** +--- +## Mejora la tasa de autenticaciones con datos adicionales +Nos complace invitarles a visitar el apartado de [Adicional Data](/three-d-s-server/api/sessions/detail-info) en nuestra documentación del API. Este apartado ofrece información crucial para optimizar el proceso de autenticación 3DS. - Visa Digital Authentication Framework DAF es una extensión de mensaje del protocolo 3DS que le permite a Visa identificar a titulares de tarjetas que superaron el flujo de autenticación con desafío en un determinado comercio - adquirente, para así otorgarles un estado de confiabilidad al determinarlos como credencial de pago autenticada ***Authenticated Credential Payment - ACP***, esto permite que las siguientes transacciones que ejecute el tarjetahabiente en el mismo comercio sean autenticadas de inmediato. +La inclusión de estos datos adicionales en sus solicitudes permite a los emisores realizar una evaluación más precisa, lo que puede mejorar considerablemente la tasa de autenticaciones exitosas. +Les recomendamos revisar estas pautas para aprovechar al máximo las funcionalidades del API y así ofrecer una experiencia más segura y eficiente a sus usuarios. diff --git a/src/pages/en/three-d-s-server/api/merchants/create.mdx b/src/pages/en/three-d-s-server/api/merchants/create.mdx index d78e0e7..168fbbf 100644 --- a/src/pages/en/three-d-s-server/api/merchants/create.mdx +++ b/src/pages/en/three-d-s-server/api/merchants/create.mdx @@ -112,18 +112,22 @@ export const apiRefs = ['/v1/merchants']; "merchant": { "id":2, "name":"Evertec Placetopay S.A.S.", - "token":"eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiIxIiwianRpIj..........." + "token":"eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiIxIiwianRpIj...........", + "expires_at": "2024-09-16 15:30:45" }, "branches":[ { "id":1, "name":"Oficina principal", - "token":"eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWMWIyNDkyNmU4............." + "token":"eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWMWIyNDkyNmU4.............", + "expires_at": "2024-09-16 15:30:45" }, { "id":2, "name":"Test name 5622", - "token":"eyJ0eXAiOiJKV19.eyJhdWQiOiIxIiwianRpIjoiMWIyNjgk867nh..............." + "token":"eyJ0eXAiOiJKV19.eyJhdWQiOiIxIiwianRpIjoiMWIyNjgk867nh...............", + "expires_at": "2024-09-16 15:30:45" + } ] } diff --git a/src/pages/en/three-d-s-server/api/sessions/detail-info.mdx b/src/pages/en/three-d-s-server/api/sessions/detail-info.mdx index 9c9a6e2..de41353 100644 --- a/src/pages/en/three-d-s-server/api/sessions/detail-info.mdx +++ b/src/pages/en/three-d-s-server/api/sessions/detail-info.mdx @@ -2,19 +2,56 @@ export const sectionMode = 'nav'; + +# Datos adicionales para mejorar la tasa de autenticación +--- + +En este proceso, enviar **data adicional** es crucial para mejorar la experiencia del usuario y garantizar la seguridad. +Aquí algunas razones para enviar información adicional: + +1. **Evaluación del riesgo mejorada:** +Proporcionar más datos sobre la transacción y el cliente permite que el emisor y los sistemas de autenticación realicen una evaluación del riesgo más precisa. +Datos como el historial de compras, la ubicación geográfica, y la información del dispositivo device info ayudan a los emisores a determinar si se puede proceder con una autenticación basada en el riesgo, +lo que podría evitar pasos adicionales de autenticación como introducir un OTP. + +2. **Minimizar fricción para el usuario:** +Enviar información como el número de teléfono, correo electrónico, historial de autenticación previo y detalles de envío puede ayudar a autenticar la transacción sin pedir intervención directa del cliente. +Si la evaluación de riesgo determina que la transacción es de bajo riesgo, el usuario podría no necesitar autenticarse activamente, +lo que mejora la experiencia del usuario conocido como "frictionless flow". + +3. **Reducir la probabilidad de rechazos:** +Cuanta más información útil se proporcione en la solicitud de autenticación, menos probable será que el banco emisor rechace la transacción por falta de datos suficientes para evaluar la autenticidad del comprador. +Esto puede mejorar las tasas de aprobación de transacciones. + +4. **Prevenir el fraude:** +Enviar datos adicionales, como la geolocalización del dispositivo, la dirección IP, el comportamiento del navegador y detalles sobre autenticaciones anteriores, +ayuda a los emisores a identificar transacciones fraudulentas con mayor eficacia. + +5. **Experiencia personalizada para autenticaciones repetidas:** +En escenarios donde se están procesando varias transacciones para el mismo usuario o cuando un usuario ha realizado autenticaciones previas, +enviar información sobre la autenticación previa como se ve en el campo threeDSRequestorPriorAuthenticationInfo permite que el emisor ajuste el proceso de autenticación en función +del historial del usuario. + + +Para optimizar el uso de la data adicional, le invitamos a consultar el apartado de [Casos de Uso](/en/three-d-s-server/api/integration/session), donde encontrará ejemplos claros sobre cuándo y cómo enviar estos datos en sus integraciones. Estos casos detallan situaciones específicas en las que se recomienda o requiere el uso de información adicional para mejorar la tasa de autenticaciones exitosas. + +--- + ## AcctInfoProperties +Cardholder Account Identifier + ### Descripción `acctInfoProperties` es un objeto que proporciona información adicional sobre la cuenta del titular de la tarjeta. ### Descripción del Objeto -| Campo | Descripción | -|----------------|-------------------------------------------------------| -| **title** | `acctInfo` | -| **type** | `object` | -| **description**| Información adicional sobre la cuenta del titular de la tarjeta. | +| Campo | Descripción | +|-----------------|------------------------------------------------------------------| +| **title** | `acctInfo` | +| **type** | `object` | +| **description** | Información adicional sobre la cuenta del titular de la tarjeta. | ### Propiedades del Objeto @@ -223,23 +260,33 @@ export const sectionMode = 'nav'; ```json { - "chAccAgeInd": "01", - "chAccChange": "20210310", - "chAccChangeInd": "02", - "chAccDate": "20210310", - "chAccPwChange": "20210310", - "chAccPwChangeInd": "03", - "nbPurchaseAccount": "1234", - "provisionAttemptsDay": "002", - "txnActivityDay": "02", - "txnActivityYear": "2", - "paymentAccAge": "20210307", - "paymentAccInd": "01", - "shipAddressUsage": "20210305", - "shipAddressUsageInd": "02", - "shipNameIndicator": "01", - "suspiciousAccActivity": "02" + "acctNumber": "4005580000000040", + "cardExpiryDate": "2506", + "purchaseAmount": "20.5", + "purchaseCurrency": "USD", + "redirectURI": "https://www.placetopay.com", + "threeDSAuthenticationInd": "01", + "reference": "12345", + "acctInfo": { + "chAccAgeInd": "05", + "chAccDate": "20170101", + "chAccChangeInd": "04", + "chAccChange": "20170101", + "chAccPwChangeInd": "05", + "chAccPwChange": "20170101", + "shipAddressUsageInd": "04", + "shipAddressUsage": "20170101", + "txnActivityDay": "1", + "txnActivityYear": "1", + "provisionAttemptsDay": "0", + "nbPurchaseAccount": "1", + "suspiciousAccActivity": "01", + "shipNameIndicator": "01", + "paymentAccInd": "05", + "paymentAccAge": "20170101" + } } + ``` --- @@ -282,10 +329,28 @@ export const sectionMode = 'nav'; ```json { - "cc": "1", - "subscriber": "1234567899" + "acctNumber": "4005580000000040", + "cardExpiryDate": "2506", + "purchaseAmount": "20.5", + "purchaseCurrency": "USD", + "redirectURI": "https://www.placetopay.com", + "threeDSAuthenticationInd": "01", + "reference": "12345", + "homePhone": { + "cc": "123", + "subscriber": "123456789" + }, + "mobilePhone": { + "cc": "123", + "subscriber": "123456789" + }, + "workPhone": { + "cc": "123", + "subscriber": "123456789" + } } + ``` --- @@ -349,12 +414,41 @@ export const sectionMode = 'nav'; ### Ejemplo de Petición ```json + { - "threeDSReqPriorAuthMethod": "01", - "threeDSReqPriorAuthTimestamp": "202401011212", - "threeDSReqPriorRef": "c83f3f5d-1a47-4eff-9fd0-6b63090a89c6", - "threeDSReqPriorAuthData": "f234f3f5d-1a47-4eff-9fd4-1b62190a89f3" + "email": "john.doe@example.com", + "mobilePhone": { + "cc": "1", + "subscriber": "5551234567" + }, + "deviceChannel": "RI", + "acctNumber": "4111111111111111", + "cardExpiryDate": "2411", + "purchaseAmount": "8.25", + "redirectURI": "http://www.placetopay.com", + "purchaseCurrency": "USD", + "messageCategory": "NPA", + "messageVersion": "2.1.0", + "threeRIInd": "80", + "threeDSRequestorPriorAuthenticationInfo": { + "threeDSReqPriorAuthMethod": "01", + "threeDSReqPriorAuthTimestamp": "202401011212", + "threeDSReqPriorRef": "c83f3f5d-1a47-4eff-9fd0-6b63090a89c6", + "threeDSReqPriorAuthData": "f234f3f5d-1a47-4eff-9fd4-1b62190a89f3" + }, + "billAddrState": "NY", + "billAddrLine2": "Apt 4B", + "billAddrCity": "New York", + "billAddrPostCode": "10001", + "billAddrLine3": "", + "billAddrLine1": "123 Main St", + "billAddrCountry": "USA", + "threeDSRequestorID": "MERAESK00100090796", + "threeDSRequestorName": "EMVCo 3DS Test Requestor", + "threeDSRequestorURL": "http://ul.com/aa5c3035-0b61-4e3c-8290-44bb1b4ce643" } + + ``` --- @@ -490,15 +584,24 @@ export const sectionMode = 'nav'; ```json { - "deliveryEmailAddress": "example@example.com", - "deliveryTimeframe": "02", - "giftCardAmount": "123", - "giftCardCount": "05", - "giftCardCurr": "USD", - "preOrderDate": "20250601", - "preOrderPurchaseInd": "02", - "reorderItemsInd": "01", - "shipIndicator": "01" + "acctNumber": "4005580000000040", + "cardExpiryDate": "2506", + "purchaseAmount": "20.5", + "purchaseCurrency": "USD", + "redirectURI": "https://www.placetopay.com", + "threeDSAuthenticationInd": "01", + "reference": "12345", + "merchantRiskIndicator": { + "shipIndicator": "01", + "deliveryTimeframe": "02", + "deliveryEmailAddress": "example@example.com", + "reorderItemsInd": "01", + "preOrderPurchaseInd": "02", + "preOrderDate": "20300101", + "giftCardAmount": "1", + "giftCardCurr": "840", + "giftCardCount": "01" + } } ``` @@ -562,11 +665,27 @@ export const sectionMode = 'nav'; ```json { - "threeDSReqAuthData": "28401b9d217ef8731f0dbee99c73c5902c183c5b1428d572ef63a4fe26586548", - "threeDSReqAuthMethod": "01", - "threeDSReqAuthTimestamp": "202103051200" + "acctNumber": "4005580000000040", + "cardExpiryDate": "2506", + "purchaseAmount": "20.5", + "purchaseCurrency": "USD", + "redirectURI": "https://www.placetopay.com", + "threeDSAuthenticationInd": "01", + "reference": "12345", + "threeDSRequestorAuthenticationInfo": { + "threeDSReqAuthData": "28401b9d217ef8731f0dbee99c73c5902c183c5b1428d572ef63a4fe26586548", + "threeDSReqAuthMethod": "01", + "threeDSReqAuthTimestamp": "202103051200" + } } ``` +--- + +## BridgingMessageExtension + +Para obtener más detalles sobre cómo utilizar esta extensión y mejorar la tasa de autenticación aprovechando las ventajas de la versión 2.3.1, +consulte [Sesión transacción con Bridging Message Extension](/en/three-d-s-server/api/integration/session#sesion-transaccion-con-bridging-message-extension) + diff --git a/src/pages/en/three-d-s-server/api/sessions/index.mdx b/src/pages/en/three-d-s-server/api/sessions/index.mdx index 0f0ae1f..6b530a3 100644 --- a/src/pages/en/three-d-s-server/api/sessions/index.mdx +++ b/src/pages/en/three-d-s-server/api/sessions/index.mdx @@ -2,7 +2,7 @@ export const apiRefs = ['/threeds/v2x/sessions'] -**Este es el servicio para iniciar una sesión en el flujo de autenticación de 3DS Server.** +# Servicio para iniciar una sesión en el flujo de autenticación de 3DS Server. Los siguientes pasos le darán una guía en la utilización del mismo: @@ -28,7 +28,7 @@ Los siguientes pasos le darán una guía en la utilización del mismo: > Para obtener estados en la autenticación diferentes al "Y", puede modificar el campo "acctNumber" de la petición, con los números de tarjetas de prueba dados en esta documentación. --- -# Implementación del Contrato v2x +## Implementación del Contrato v2x Se recomienda la implementación de un nuevo contrato que proporciona el siguiente conjunto de resultados: @@ -42,6 +42,13 @@ Para más detalles sobre la acción "redirect" y su implementación, puedes cons --- +## Mejora la tasa de autenticaciones con datos adicionales +Nos complace invitarles a visitar el apartado de [Adicional Data](/en/three-d-s-server/api/sessions/detail-info) en nuestra documentación del API. Este apartado ofrece información crucial para optimizar el proceso de autenticación 3DS. + +La inclusión de estos datos adicionales en sus solicitudes permite a los emisores realizar una evaluación más precisa, lo que puede mejorar considerablemente la tasa de autenticaciones exitosas. + +Les recomendamos revisar estas pautas para aprovechar al máximo las funcionalidades del API y así ofrecer una experiencia más segura y eficiente a sus usuarios. + --- ## Crear una sesión BRW o RI {{ id: 'create-a-session', tag: 'POST', label: '/threeds/v2x/sessions' }} diff --git a/src/pages/en/three-d-s-server/api/sessions/rules.mdx b/src/pages/en/three-d-s-server/api/sessions/rules.mdx index f7e27ee..ababefd 100644 --- a/src/pages/en/three-d-s-server/api/sessions/rules.mdx +++ b/src/pages/en/three-d-s-server/api/sessions/rules.mdx @@ -60,7 +60,7 @@ Esta tabla te ayudará a verificar los requisitos y valores aceptados para cada | **acctInfo.shipAddressUsage**
Shipping Address Usage | Opcional
Formato de fecha: **Ymd** | Fecha en la que se usa la dirección de envío.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **20230801** (1 de agosto de 2023) | | **acctInfo.shipNameIndicator**
Shipping Name Indicator | Opcional
Valores aceptados:
**01** (Nombre de cuenta idéntico al nombre de envío)
**02** (Nombre de cuenta diferente al nombre de envío) | Indicador del nombre de envío.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **01** | | **acctInfo.suspiciousAccActivity**
Suspicious Account Activity | Opcional
Valores aceptados:
**01** (No se observó actividad sospechosa)
**02** (Actividad sospechosa observada) | Indicador de actividad sospechosa en la cuenta.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **01** | -| **browserLanguage**
Browser Language | Opcional
Tipo: String
Longitud máxima:8 caracteres
Formatos aceptados:
[ISO 639-1](https://es.wikipedia.org/wiki/ISO_639-1) | El parámetro browserLanguage se usa para enviar el idioma de preferencia. Si el idioma enviado no es compatible con ACS o MPI, se mostrará el idioma configurado en el navegador. Si el idioma del navegador no es compatible con ACS o MPI, se mostrará el idioma configurado por defecto en cada aplicación (en).
**Device Channel:** BRW
**Message Category:** PA, NPA | es | +| **browserLanguage**
Browser Language | Opcional
Tipo: String
Longitud máxima:8 caracteres
Formatos aceptados:
[ISO 639-1](https://es.wikipedia.org/wiki/ISO_639-1) | El parámetro browserLanguage se usa para enviar el idioma de preferencia. Si el idioma enviado no es compatible con ACS o 3DSS, se mostrará el idioma configurado en el navegador. Si el idioma del navegador no es compatible con ACS o 3DSS, se mostrará el idioma configurado por defecto en cada aplicación (en).
**Device Channel:** BRW
**Message Category:** PA, NPA | es | | **homePhone**
Cardholder Home Phone Number | Requerido si se proporciona el número de teléfono.
Tipo: Array
[ITU-E.164](https://www.itu.int/rec/dologin_pub.asp?lang=e&id=T-REC-E.164-201011-I!!PDF-S&type=items) | Número de teléfono de hogar.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | ```json {"cc": "01","subscriber": "20240808T153000"}``` | | **homePhone.cc**
| Requerido con **homePhone**
Entre 1 y 3 dígitos | Código de país para el número de teléfono de hogar.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **01** | | **homePhone.subscriber**
| Requerido con **homePhone**
Entre 1 15 dígitos | Número de suscriptor para el número de teléfono de hogar.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **1234567899** | @@ -82,7 +82,7 @@ Esta tabla te ayudará a verificar los requisitos y valores aceptados para cada | **merchantRiskIndicator.shipIndicator**
Shipping Indicator | Opcional
Valores aceptados:
**01:** (Enviar a la dirección de facturación del titular)
**02:** (Enviar a otra dirección verificada del comerciante)
**03:** (Enviar a una dirección diferente a la del titular)
**04:** (Recoger en tienda / Recoger en una tienda local (la dirección de la tienda debe ser proporcionada 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:** (Tickets de viaje y eventos, no enviados)
**07:** Otro (por ejemplo, servicios digitales no enviados, suscripciones a medios electrónicos, etc.) | Indicador de envío.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **01** | | **threeDSRequestorDecReqInd**
| Opcional
Tipo: String
Longitud máxima: 1
Valores aceptados: **Y**, **N** | Indicador de solicitud de decisión del solicitante 3DS.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **Y** | | **acctID**
Cardholder Account Identifier | Condicional
Tipo: String
Longitud máxima: 64 caracteres | Identificador de cuenta.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **ABC1234567890** | -| **messageVersion**
Message Version Number | Opcional
Tipo: String
Valores aceptados
**2.1.0** y **2.2.0** | Versión del mensaje. **Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **2.2.0** | +| **messageVersion**
Message Version Number | Opcional
Tipo: String
Valores aceptados
**2.2.0** | Versión del mensaje. **Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **2.2.0** | | **messageCategory**
Message Category | Requerido
Valores aceptados
**01** (PA)
**02** (NPA)
| Categoría del mensaje. **Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **01** | | **addPriorInformation**
| Opcional
Tipo: String
Longitud máxima: 1
Valores aceptados:
**Y**, **N**
Prohibido cuando **threeDSRequestorPriorAuthenticationInfo** | Información adicional previa. **Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **Y** | | **threeDSRequestorPriorAuthenticationInfo**
3DS Requestor Prior Transaction
Authentication Information | Condicional
Tipo: Array
Prohibico cuando **addPriorInformation** | Información previa de autenticación del solicitante 3DS. **Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | | diff --git a/src/pages/en/three-d-s-server/api/terms-and-definitions.mdx b/src/pages/en/three-d-s-server/api/terms-and-definitions.mdx index e08faea..b08d8e3 100644 --- a/src/pages/en/three-d-s-server/api/terms-and-definitions.mdx +++ b/src/pages/en/three-d-s-server/api/terms-and-definitions.mdx @@ -1,6 +1,9 @@ +export const sectionMode = 'nav'; + + -# Términos y Definiciones +## Términos generales Las siguientes definiciones pretenden dar claridad sobre la información presentada a lo largo de este documento. @@ -50,4 +53,85 @@ Las siguientes definiciones pretenden dar claridad sobre la información present - **Titular de la Tarjeta:** Una persona a quien se le emite una tarjeta o que está autorizada para usar dicha tarjeta. - **Token de autenticación:** Es una cadena de texto que no pretende tener un significado alguno y representa un acceso de autorización que es emitido al cliente. El token permite reemplazar las credenciales de autenticación del propietario directamente, con el fin de proteger la información. - **Valor de autenticación - AV:** Un valor criptográfico generado por el ACS para proporcionar una forma, durante el procesamiento de autorización, para que el sistema de autorización valide la integridad del resultado de la autenticación. El algoritmo AV es definido por cada Sistema de Pago. -- **Versión del Mensaje:** Se refiere a la versión del protocolo que será utilizada por todos los componentes para procesar la transacción 3-D Secure. La versión del mensaje siempre es consistente en todos los mensajes del protocolo 3-D Secure para una transacción específica. \ No newline at end of file +- **Versión del Mensaje:** Se refiere a la versión del protocolo que será utilizada por todos los componentes para procesar la transacción 3-D Secure. La versión del mensaje siempre es consistente en todos los mensajes del protocolo 3-D Secure para una transacción específica. +- **Transacción iniciada por el Titular de la Tarjeta (CIT):** Cualquier transacción en la que el titular de la tarjeta participa activamente en la transacción. Las transacciones pueden realizarse con base en las credenciales proporcionadas por el titular de la tarjeta en el momento de la transacción o una credencial almacenada de una interacción previa. Las transacciones pueden ocurrir como una transacción en punto de venta **POS** en tienda, una transacción de comercio electrónico, una orden por correo/teléfono, o en un cajero automático **ATM**. +- **Transacción Iniciada por el Comerciante (MIT):** Una transacción donde el titular de la tarjeta no participa activamente en la transacción. Las **MIT** a menudo pueden ser precedidas por una CIT **que involucre una PA - Payment Authentication** o una Consulta de Estado de Cuenta **ASI, por sus siglas en inglés**. +- **Payment Authentication (PA):** Implica monto de autenticación +- **Not Payment Authentication (NPA):** No implica monto + + +--- + +## Pago Recurrente / Cuotas + +Una transacción que surge de un acuerdo entre el titular de la tarjeta y el comerciante mediante el cual el titular de la tarjeta acepta que el comerciante almacene la credencial del titular de la tarjeta y utilice esa credencial almacenada para una compra subsiguiente de bienes o servicios. Estas transacciones pueden clasificarse como: + +* Orden permanente +* Suscripción +* Cuota pagos diferidos +* CREDENCIAL-ON-FILE no programada + +--- + +## Práctica de la Industria MIT + +Una transacción iniciada por el comerciante para cumplir con una práctica comercial que ocurre más a menudo después de una interacción inicial con el titular de la tarjeta. Las transacciones pueden realizarse con credenciales que están almacenadas en archivo, o credenciales que no están almacenadas en archivo, sino que son temporalmente retenidas por el comerciante según lo acordado por el consumidor. Estas MIT de práctica de la industria pueden clasificarse como: + +* Envíos parciales +* Entregas parciales o retrasadas +* No presentación (Tarjetahabiente no está presente para tomar el servicio) +* Reenvío + +--- + +## Tipos de mensajes 3RI admitidos + +La funcionalidad 3RI abarca varios casos de uso técnicos y comerciales diferentes que son principalmente definidos por los siguientes campos EMV 3DS: + +• **Canal de dispositivo (deviceChannel)** = '03' + +• **Campo Indicador 3RI (tresRIInd)** en la solicitud de autenticación **AReq** que define el tipo de Transacción 3RI. No todos los valores de campo del indicador 3RI documentados en la especificación EMV 3DS actualmente son compatibles con las marcas + +| 3RI Indicador (threeRIInd) | Marcas | Pago (PA) | No Pago (NPA) | +|-----------------------------------------|------------------|-----------|---------------| +| **(01)** Recurring Transaction | Visa, Mastercard | SI | NO | +| **(02)** Installment Transaction | Visa, Mastercard | SI | NO | +| **(03)** Add Card | Visa, Mastercard | NO | SI | +| **(04)** Maintain Card Information | Visa, Mastercard | NO | SI | +| **(05)** Account Verification | Visa, Mastercard | NO | SI | +| **(06)** Split/Delayed Shipment | Visa, Mastercard | SI | NO | +| **(07)** Top-up | Visa, Mastercard | NO | NO | +| **(08)** Mail Order | Visa, Mastercard | NO | NO | +| **(09)** Telephone Order | Visa, Mastercard | NO | NO | +| **(10)** Whitelist Status Check | Visa, Mastercard | NO | SI | +| **(11)** Other Payment | Visa, Mastercard | SI | NO | +| **(81)** Unscheduled Credential-on-File | Visa | SI | NO | + +--- + +## Preguntas frecuentes + +* **¿Es posible Agregar Tarjeta ***"threeDSAuthenticationInd": "04"*** y hacer la Autenticación de un Pago (PA) al mismo tiempo?** + +No es posible. En el proceso de Agregar Tarjeta a un comercio para validar la identidad de la tarjeta habiente, es permitido enviar un monto, en cuyo caso se descontará el monto para la verificación de fondos y DEBE ser reembolsado posteriormente por el comercio, lo cual no representa una Autenticación Pago en sí mismo. + +Es necesario enviar posterior al proceso de Agregar Tarjeta otra autenticación con el monto a Autenticacior + +* **¿Se puede usar una CIT NPA como PriorInformation para una MIT PA?** + +Es posible UNICAMENTE en el escenario de un pago único, en este caso, se podrá utilizar una CIT NPA de tipo “Agregar Tarjeta” **este es el único caso confirmado para este uso**. La transacción MIT deberá mandarse con el indicativo threeRIInd=81 **Unscheduled Credential-on-File**, este tipo de transacción no requiere ningún valor de recurrencia **recurringExpiry, recurringFrequency** únicamente el monto que se va a pagar. Eventualmente otros casos de uso pueden ser agregados en versiones del Protocolo. Esto aplica exclusivamente para VISA usando la extensión DAF + +La razón principal es que estas dos categorías de transacciones tienen naturalezas diferentes y propósitos distintos: + + 1. **MIT (Merchant Initiated Transaction):** Una MIT es iniciada por el comerciante en lugar del titular de la tarjeta. Por lo general, las MIT se utilizan para pagos recurrentes, como suscripciones mensuales o anuales, donde el comerciante tiene la autorización del titular de la tarjeta para cargar periódicamente el monto acordado en su tarjeta. En las MIT, la autenticación suele ser realizada por el comerciante y no requiere la interacción activa del titular de la tarjeta en el momento de la transacción. + 2. **CIT NPA ***Customer Initiated Transaction - Non Payment Authentication***:** Una CIT NPA es una transacción iniciada por el titular de la tarjeta que no implica un pago directo, sino que se utiliza para otros fines, como la verificación de la tarjeta o la consulta de saldo. En una CIT NPA, se puede realizar una autenticación sin que se realice una transferencia de fondos directa. + +Dado que una MIT implica un pago por parte del comerciante y una CIT NPA no implica un pago directo, no tendría sentido lanzar una transacción MIT junto con una CIT NPA. Cada tipo de transacción tiene su propio propósito y aplicación específica en el contexto del protocolo **3D Secure**. + +En pocas palabras: es posible unsar una CIT NPA en una MIT PA si el pago es único **no recurrente**. + +Unscheduled card-on-file transactions **UCOF**: A transaction using a stored credential for a fixed or variable amount that does not occur on a scheduled or regularly occurring transaction date, where the cardholder has provided consent for the merchant to initiate one or more future transactions + +* **Visa Digital Authentication Framework DAF** + +Visa Digital Authentication Framework DAF es una extensión de mensaje del protocolo 3DS que le permite a Visa identificar a titulares de tarjetas que superaron el flujo de autenticación con desafío en un determinado comercio - adquirente, para así otorgarles un estado de confiabilidad al determinarlos como credencial de pago autenticada ***Authenticated Credential Payment - ACP***, esto permite que las siguientes transacciones que ejecute el tarjetahabiente en el mismo comercio sean autenticadas de inmediato. diff --git a/src/pages/en/three-d-s-server/api/transactions/index.mdx b/src/pages/en/three-d-s-server/api/transactions/index.mdx index 7affb9e..c89fb5c 100644 --- a/src/pages/en/three-d-s-server/api/transactions/index.mdx +++ b/src/pages/en/three-d-s-server/api/transactions/index.mdx @@ -84,7 +84,7 @@ Los siguientes pasos le darán una guía para la utilización del mismo: "threeDSServerTransID":"1ed95a50eee5-48a8-91fa-6a1ee6378dba", "sdkTransID":null, "authenticationValue":"AJkBAmBANQAAACcPhAI0dAJBQVk=", - "messageVersion":"2.1.0", + "messageVersion":"2.2.0", "authMethod":"FRICTIONLESS_AUTHENTICATION", "authTimestamp":"2020-04-21T01:44:54+00:00", "enrolled":null, diff --git a/src/pages/en/three-d-s-server/faq.mdx b/src/pages/en/three-d-s-server/faq.mdx index ba50f0c..b91c01c 100644 --- a/src/pages/en/three-d-s-server/faq.mdx +++ b/src/pages/en/three-d-s-server/faq.mdx @@ -1,14 +1,14 @@ -# Preguntas frecuentes sobre el funcionamiento MPI +# Preguntas frecuentes sobre el funcionamiento 3DSS API -En esta sección podrá encontrar respuestas a preguntas o solución a problemas que puede encontrarse en MPI. +En esta sección podrá encontrar respuestas a preguntas o solución a problemas que puede encontrarse en 3DSS. -## ¿Qué significan las siglas MPI? +## ¿Qué significan las siglas 3DSS? -3DSS traduce en inglés Merchant Server Plugin o en español, Complemento del Servidor de Comercio. +Las siglas 3DSS en el protocolo 3DS (3D Secure) de EMVCo se refieren a Three-Domain Secure Server o 3D Secure Server. Este servidor es uno de los componentes clave dentro del ecosistema del protocolo 3D Secure, que se utiliza para autenticar de manera segura a los titulares de tarjetas en transacciones de pago en línea. -## ¿Para qué es necesario MPI? +## ¿Para qué es necesario 3DSS? La aplicación de 3DSS permite la comunicación entre el solicitante de la autenticación, que puede ser la pasarela de pagos, y el servidor de directorio que comunica a su vez con el otro componente del 3-D Secure (ACS). De tal forma, 3DSS es necesario porque es el componente que inicia el flujo de autenticación y envía la petición de autenticación a procesar, para obtener posteriormente una respuesta de autenticación y devolverla al solicitante. @@ -20,108 +20,13 @@ El proceso de autenticación permite reducir el riesgo de fraude en las transacc El Protocolo 3-D Secure es quien define y describe la infraestructura y las pautas para la autenticación del tarjetahabiente durante una transacción de comercio electrónico. - Recomendamos leer la documentación en su totalidad, ya que en cada una de las secciones se describen situaciones particulares que se pueden experimentar y sus respectivas soluciones - -## ¿Cómo acceder a MPI? - -Para acceder a la consola de MPI, se requiere de un usuario registrado, con permisos y cuyo acceso haya sido autorizado mediante una invitación, con el cual procederá a iniciar sesión. - -### Usuario: -Para obtener el usuario de MPI, se debe hacer mediante una invitación que creará un usuario registrado y autenticado actualmente en la aplicación. - - Para obtener más información de las invitaciones, diríjase a la sección de **Seguridad** y luego **Invitaciones**, de esta documentación. - -### Activación de usuario: - -Posterior a la creación de una invitación, será enviado un correo electrónico al correo registrado en el formulario de creación, con el cual podrá activar el usuario. -Para activar el usuario, haga clic en el botón **Activar Registro** y se redireccionará a la página de inicio de sesión de MPI. - -### Inicio de sesión: - -En este formulario de inicio de sesión, ingrese el correo electrónico con el cual fue creada la invitación y la contraseña. - -### Restablecimiento de contraseña: - -Si olvidó la contraseña de inicio de sesión, puede hacer clic en la opción **¿Olvidaste tu contraseña?** y se redireccionará a un formalario para ingresar su correo electrónico y enviar una solicitud de cambio de contraseña. - - -## ¿Cómo mostrar datos en las diferentes métricas? - -Cuando accede a la sección de métricas puede preguntarse ¿cómo obtener información a partir de las gráficas?, la respuesta a esta pregunta es que debe hacer un filtrado de datos en primer lugar, para ello haga clic en el botón **Filtrar** como lo ilustra la siguiente imagen y posteriormente seleccione los datos con los cuales desea que se grafiquen y se muestren estadísticas de funcionamiento de la aplicación. - - - Para obtener información más detallada del funcionamiento de las métricas, diríjase al menú **Funcionamiento de MPI** -> **Funcionalidades**. - -## ¿Puedo acceder a registros de cambios e interacciones realizadas en la aplicación? - -La aplicación de 3DSS contiene un módulo ubicado en el menú **Seguridad** -> **Logs**, donde se registran los movimientos realizados en la aplicación, con el detalle del número de registro, la fecha, hora, usuario, descripción del movimiento y datos del equipo desde el cual se realizó. - -## ¿Cómo se validan los datos que ingresan los usuarios en los diferentes formularios de la aplicación? - -### Validación de datos: - -Para todos los formularios de la aplicación, se dispone de la funcionalidad de validación de los datos ingresados, lo cual permite asegurar la integridad y veracidad de éstos. - -De esta forma, al diligenciar el formulario puede encontrar y verificar dos tipos de validaciones: - -1. **Validaciones de lado del cliente:** - - Estas validaciones se realizan cuando un dato no cumple las reglas mínimas de aceptación y no hay necesidad de enviar la respuesta al servidor si se ha validado previamente que está errónea la información. Se visualizan con mensajes en rojo para el campo erróneo y le ofrece al usuario una ayuda de cómo debe diligenciar el campo en cuestión para ser aceptado. Si hay errores en estas validaciones, la aplicación no permite el envío del formulario. - - -1. **Validaciones de lado del servidor:** - - Estas validaciones se aplican cuando se envía un formulario o unos datos al servidor y estos no cumplen con las validaciones requeridas, por lo cual se genera un error,se deniega la solicitud y posteriormente, se muestra al usuario el error encontrado. Estas validaciones se ejecutan cuando no se han registrado como validaciones del lado del cliente, o son complicadas de validar del lado del cliente o el usuario logra por algún medio pasar el primer filtro de validaciones del cliente con la información errónea, sin embargo, este filtro de validaciones detiene una solicitud con datos inválidos. - - -## ¿Cómo funciona el paginador que se encuentra en los módulos de la aplicación? - -En la vista principal de cada módulo, donde se presenta el listado de datos, se encuentra un paginador en la parte inferior de la pantalla. Este paginador permite obtener listas de datos agrupadas más fáciles de visualizar. - -El paginador contiene varias funcionalidades dentro de sí: - - 1. **Seleccionar cantidad de registros:** Puede seleccionar la cantidad de registros a visualizar en la opción **Mostrar** ubicada en la parte izquierda, despliegue el campo y seleccione la cantidad de registros que desea mostrar por página. - -2. **Cambiar de página:** Puede cambiar de página en dos partes. En la parte central puede hacer clic en el número de la página que desea mostrar y en la parte lateral derecha, puede aumentar o disminuir la página a mostrar, haciendo uso de las flechas de arriba y abajo del campo. - -3. **Mostrar cantidad de registros:** El paginador muestra la cantidad de registros en dos partes. En la parte central muestra el rango de datos iniciales y finales dependiendo de la página seleccionada y muestra el total de registros. Además, en la parte lateral derecha muestra cuántas páginas tiene el listado de registros. - -# Eventos frecuentes y soluciones - -## ¿Cómo ocultar la pestaña de selección de filtros? - -Cuando accede a módulos de la aplicación que contienen la funcionalidad de filtros (para hacer búsquedas específicas de información). Puede encontrarse con la necesidad de ocultar la pestaña de filtros para tener mayor acceso y visualización a la información mostrada. - -Para ocultar la pestaña o sección, lo único que debe hacer es dar clic nuevamente en el botón de filtros. - -## ¿Qué hacer cuando el token de acceso ha expirado? - -Al generar una petición de autenticación, podrá obtener el mensaje **"No Autenticado"**, lo cual indica que el token de acceso para hacer solicitudes a un comercio específico ha expirado. - -Para solucionar este error, diríjase al detalle del comercio con el cual desea procesar la autenticación, posteriormente deslice la barra del detalle hacia abajo hasta encontrar la sección **Tokens**. - -Allí podrá visualizar el token que estaba utilizando y corroborar la fecha de expiración, además de que podrá crear uno nuevo para continuar con el proceso de autenticación. - -#### Crear nuevo token: - -Para crear el nuevo token, haga clic en el botón **Crear token**, asigne un nombre que le permita identificarlo y haga clic en el botón **Guardar**. Luego es importante que copie el bloque de texto que se asignó para el token, ya que este solo se muestra en esta ocasión y si lo pierde, debe proceder a crear uno nuevo. - -## ¿El número de tarjeta no está en el rango? - -Cuando procese una petición de autenticación, es probable que pueda ocurrirle el error **"La longitud del número de tarjeta no coincide con los valores esperados"**, el cual -indica que el número de tarjeta con el cual está intentando ejecutar una petición de autenticación, no está en el rango de tarjetas ingresadas para esa franquicia. - -Para solucionar este error debe dirigirse a la franquicia con la cual está intentando procesar la autenticación, ir al detalle de esta, luego a la sección servidores de directorio y luego seleccione el servidor de directorio encargado de la autenticación y diríjase al detalle de este. - -Luego en el detalle del servidor de directorio, podrá visualizar los rangos de tarjeta disponibles y corroborar que la tarjeta que está intentando autenticar, no está en los rangos dados. - -Los rangos de tarjetas se sincronizan con los servidores de directorio a partir de los bines registrados en cada adquirente. De esta forma, si un rango de tarjeta no se encuentra disponible, debe de proceder a comunicarse con el servidor de directorio para que haga el respectivo proceso de sincronización de rangos de tarjeta. +Recomendamos leer la documentación en su totalidad, ya que en cada una de las secciones se describen situaciones particulares que se pueden experimentar y sus respectivas soluciones # Contacto y soporte Si existe alguna duda o la solución al problema que posee no está contenida en esta documentación, puede acceder al servicio de posventa que brinda la compañía para atender su requerimiento. -Tenga en cuenta que para brindar un excelente servicio de soporte, es necesario que provea todos los detalles de la incidencia. +Tenga en cuenta que para brindar un excelente servicio de soporte, es necesario que provea todos los detalles de la incidencia. Para acceder a este servicio, puede contactarse por alguno de los siguientes medios y le atenderemos con gusto. diff --git a/src/pages/en/three-d-s-server/index.mdx b/src/pages/en/three-d-s-server/index.mdx index 12faead..0a7b077 100644 --- a/src/pages/en/three-d-s-server/index.mdx +++ b/src/pages/en/three-d-s-server/index.mdx @@ -13,16 +13,16 @@ Esta documentación está diseñada para ofrecer una comprensión completa del p ## Redes Soportadas -3DS Placetopay se encuentra certificado en las versiones **EMV® 3DS 2.1.0 y 2.2.0** en los siguientes programas: - -| | EMV® 3DS 2.1.0 | EMV® 3DS 2.2.0 | -|---------------------------|----------------|----------------| -| Visa Secure | **Soportado** | **Soportado** | -| Mastercard Identity Check | **Soportado** | **Soportado** | -| American Express SafeKey® | **Soportado** | **Soportado** | -| Discover ProtectBuy | **Soportado** | **Soportado** | -| Diners ProtectBuy | **Soportado** | **Soportado** | -| ELO (Brasil) | En progreso | En progreso | +3DSS Placetopay se encuentra certificado en los siguientes programas: + +| | EMV® 3DS 2.2.0 | +|---------------------------|----------------| +| Visa Secure | **Soportado** | +| Mastercard Identity Check | **Soportado** | +| American Express SafeKey® | **Soportado** | +| Discover ProtectBuy | **Soportado** | +| Diners ProtectBuy | **Soportado** | +| ELO (Brasil) | **Soportado** | **Nota:** "Soportado" significa que la red ya está completamente integrada y funcional. "En progreso" indica que estamos trabajando en la integración y se espera que esté disponible próximamente. diff --git a/src/pages/en/three-d-s-server/panel/configurations.mdx b/src/pages/en/three-d-s-server/panel/configurations.mdx index fd0173f..634b925 100644 --- a/src/pages/en/three-d-s-server/panel/configurations.mdx +++ b/src/pages/en/three-d-s-server/panel/configurations.mdx @@ -88,7 +88,7 @@ Un adquiriente es una institución financiera que tiene relación con un comerci ## Índice de adquirientes: -En esta sección se visualiza el índice o listado de los adquirientes registrados en MPI. +En esta sección se visualiza el índice o listado de los adquirientes registrados en 3DSS. ## Buscador de adquirientes: @@ -162,7 +162,7 @@ Para acceder al módulo de certificados, diríjase al menú lateral izquierdo, d En esta sección se crean los certificados SSL, los cuales son títulos digitales que vinculan digitalmente una clave criptográfica con los datos de una organización. Los certificados SSL permiten autenticar la identidad de un sitio web y cifrar la información que se envía al servidor. -El certificado permite que cuando un usuario intente enviar información de las credenciales al servidor web, el navegador del usuario procederá a acceder al certificado digital del servidor para establecer una conexión segura. De esta forma, estos certificados proveen seguridad a los datos manejados en MPI. +El certificado permite que cuando un usuario intente enviar información de las credenciales al servidor web, el navegador del usuario procederá a acceder al certificado digital del servidor para establecer una conexión segura. De esta forma, estos certificados proveen seguridad a los datos manejados en 3DSS. ## Índice de certificados: @@ -190,7 +190,7 @@ Puede eliminar un certificado, haciendo clic en la opción *Eliminar*.. ### Creación del CSR (Solicitud de firma para un certificado): -Para crear un nuevo certificado en MPI, haga clic en el botón **Crear** ubicado en la parte lateral derecha del índice de certificados. +Para crear un nuevo certificado en 3DSS, haga clic en el botón **Crear** ubicado en la parte lateral derecha del índice de certificados. Visualizará un formulario similar al siguiente: @@ -250,7 +250,7 @@ Para acceder a este módulo, diríjase al menú lateral izquierdo, despliegue la ## Índice de los tipos de contactos: -En esta sección se visualiza el índice o listado de los tipos de contacto registrados en MPI. +En esta sección se visualiza el índice o listado de los tipos de contacto registrados en 3DSS. Un ejemplo de este índice es el siguiente: @@ -295,7 +295,7 @@ Para acceder a este módulo, diríjase al menú lateral izquierdo, despliegue la ## Índice de los consultores comerciales: -En esta sección se visualiza el índice o listado de los consultores comerciales registrados en MPI. +En esta sección se visualiza el índice o listado de los consultores comerciales registrados en 3DSS. Un ejemplo de este índice es el siguiente: @@ -358,7 +358,7 @@ El índice de códigos de categoría tiene la funcionalidad del buscador, está ## Función del módulo: -Este módulo se pone a disposición del cliente a modo informativo y aclaratorio, ya que este listado de códigos va a facilitar la aclaración del tipo de comercio y la descripción a la cual hace referencia el código cuando se presenta en alguna traza de una transacción. Además, al momento de registrar un comercio en MPI, es necesario conocer el MCC del comercio a registrar. +Este módulo se pone a disposición del cliente a modo informativo y aclaratorio, ya que este listado de códigos va a facilitar la aclaración del tipo de comercio y la descripción a la cual hace referencia el código cuando se presenta en alguna traza de una transacción. Además, al momento de registrar un comercio en 3DSS, es necesario conocer el MCC del comercio a registrar. ## Acciones de los códigos de categoría del comercio: @@ -389,7 +389,7 @@ Para acceder a este módulo, diríjase al menú lateral izquierdo, despliegue la ## Índice de aliados comerciales: -En esta sección se visualiza el índice o listado de los aliados comerciales registrados en MPI. +En esta sección se visualiza el índice o listado de los aliados comerciales registrados en 3DSS. Un ejemplo de este índice es el siguiente: @@ -434,7 +434,7 @@ Para acceder a este módulo, diríjase al menú lateral izquierdo, despliegue la ## Índice de tipos de adjuntos: -En esta sección se visualiza el índice o listado de los tipos de adjuntos registrados en MPI. +En esta sección se visualiza el índice o listado de los tipos de adjuntos registrados en 3DSS. ## Acciones para el módulo de tipos de adjuntos: @@ -466,7 +466,7 @@ Para acceder al menú de idiomas, ubíquese en la parte superior derecha de la a ## Cambio de idioma: -Para cambiar el idioma con el que se imprimen los datos y los menús de MPI, haga clic en el botón *English*, para el idioma inglés. +Para cambiar el idioma con el que se imprimen los datos y los menús de 3DSS, haga clic en el botón *English*, para el idioma inglés. ## Idiomas disponibles: diff --git a/src/pages/en/three-d-s-server/panel/franchise-configuration.mdx b/src/pages/en/three-d-s-server/panel/franchise-configuration.mdx index 6b056f6..06f6967 100644 --- a/src/pages/en/three-d-s-server/panel/franchise-configuration.mdx +++ b/src/pages/en/three-d-s-server/panel/franchise-configuration.mdx @@ -1,12 +1,12 @@ -# Franquicias en MPI +# Franquicias en 3DSS ## ¿Qué es una franquicia? Una franquicia de una tarjeta de crédito, es una compañía aliada con los bancos emisores de tarjetas de crédito. Tienen como función proveer diversos beneficios bancarios a sus clientes (tarjetabientes) y gestionar el uso de las tarjetas. -## ¿Cómo acceder a la gestión de franquicias de MPI? +## ¿Cómo acceder a la gestión de franquicias de 3DSS? Para acceder al listado de franquicias de la aplicación siga los siguientes pasos: @@ -15,7 +15,7 @@ Para acceder al listado de franquicias de la aplicación siga los siguientes pas 2. Visualizará una pantalla con el listado de franquicias organizadas en una tabla, la cual corresponde al índice de franquicias: -# ¿Cómo crear una franquicia en MPI? +# ¿Cómo crear una franquicia en 3DSS? Para crear una franquicia, haga clic en el botón **Crear** ubicado en la parte lateral derecha del índice de franquicias, posteriormente diligencie los datos del formulario teniendo en cuenta la siguiente información: diff --git a/src/pages/en/three-d-s-server/panel/functionalities.mdx b/src/pages/en/three-d-s-server/panel/functionalities.mdx index 97999fe..9a65fad 100644 --- a/src/pages/en/three-d-s-server/panel/functionalities.mdx +++ b/src/pages/en/three-d-s-server/panel/functionalities.mdx @@ -116,7 +116,7 @@ Para acceder a la gestión de transacciones, vaya al menú lateral izquierdo, se ## Índice de transacciones: -En este módulo se registra la información de todas las transacciones procesadas por MPI. En este índice se encuentra el listado de las transacciones con fecha, país, comercio, referencia, monto de la transacción, categoría, versión y resumen de la traza. +En este módulo se registra la información de todas las transacciones procesadas por 3DSS. En este índice se encuentra el listado de las transacciones con fecha, país, comercio, referencia, monto de la transacción, categoría, versión y resumen de la traza. El índice de transacciones se visualiza como en la siguiente imagen: @@ -230,7 +230,7 @@ Para acceder al módulo de reportes, diríjase al menú lateral izquierdo, despl ## Índice de reportes: -Los reportes son archivos que contienen registros de las transacciones procesadas por MPI. +Los reportes son archivos que contienen registros de las transacciones procesadas por 3DSS. La siguiente imagen muestra un ejemplo de la vista con el índice de reportes generados. diff --git a/src/pages/en/three-d-s-server/panel/general-configuration.mdx b/src/pages/en/three-d-s-server/panel/general-configuration.mdx index 1bd7469..8e78fd1 100644 --- a/src/pages/en/three-d-s-server/panel/general-configuration.mdx +++ b/src/pages/en/three-d-s-server/panel/general-configuration.mdx @@ -1,8 +1,8 @@ -# ¿Cómo configurar MPI? +# ¿Cómo configurar 3DSS? -Para obtener un óptimo funcionamiento de la aplicación, esta se debe configurar adecuadamente, con el fin de que pueda pueda hacer las peticiones y dar respuestas a los componentes del 3-D Secure con los cuales tiene relación, de forma efectiva. +Para obtener un óptimo funcionamiento de la aplicación, esta se debe configurar adecuadamente, con el fin de que pueda hacer las peticiones y dar respuestas a los componentes del 3-D Secure con los cuales tiene relación, de forma efectiva. ## Pasos para la configuración: @@ -16,7 +16,7 @@ Seleccione el **idioma** con el cual desea que se presente toda la información Ubique y **familiarícese con los módulos** en los cuales se divide la aplicación y las funcionalidades que cada uno contiene. Estos se encuentran en el menú ubicado en la parte lateral izquierda de la aplicación. #### Tablero: -En este módulo se encuentran las principales funcionalidades de MPI, conformando el tablero principal con el cual el usuario se va a relacionar de forma frecuente. +En este módulo se encuentran las principales funcionalidades de 3DSS, conformando el tablero principal con el cual el usuario se va a relacionar de forma frecuente. Se encuentran en el menú: @@ -24,7 +24,7 @@ En este módulo se encuentran las principales funcionalidades de MPI, conformand - Listado, detalles y funcionalidades para las transacciones procesadas por el componente 3DS Server. - Listado, detalles y funcionalidades para los reportes gestionados en diferentes módulos de la aplicación, como reportes de transacciones. -> Este módulo y sus funcionalidades, se revisan y explican detalladamente en la sección de **Funcionamiento de MPI** -> **Funcionalidades**, en esta esta documentación. +> Este módulo y sus funcionalidades, se revisan y explican detalladamente en la sección de **Funcionamiento de 3DSS** -> **Funcionalidades**, en esta esta documentación. #### Configuración: @@ -42,11 +42,11 @@ En este módulo se encuentran los componentes que permiten configurar 3DSS y ges - Listado, detalles y funcionalidades para los aliados comerciales. - Listado, detalles y funcionalidades para los tipos de adjuntos. -> Este módulo y sus funcionalidades, se revisan y explican detalladamente en la sección de **Funcionamiento de MPI** -> **Configuración**, de esta documentación. +> Este módulo y sus funcionalidades, se revisan y explican detalladamente en la sección de **Funcionamiento de 3DSS** -> **Configuración**, de esta documentación. #### Seguridad: -En este módulo se encuentran los componentes que gestionan los registros de movimientos, los accesos y la seguridad para MPI. +En este módulo se encuentran los componentes que gestionan los registros de movimientos, los accesos y la seguridad para 3DSS. Se encuentran en el menú: @@ -54,40 +54,40 @@ En este módulo se encuentran los componentes que gestionan los registros de mov - Listado, detalles y funcionalidades para los usuarios registrados en la aplicación. - Listado, detalles y funcionalidades relacionadas con los roles creados en la aplicación. - Listado, detalles y funcionalidades de las invitaciones creadas para gestionar los usuarios de la aplicación. - - Listado, detalles y funcionalidades de los perfiles para usuarios de MPI. - - Listado y gestión de los registros de movimientos realizados por los diferentes usuarios de MPI. + - Listado, detalles y funcionalidades de los perfiles para usuarios de 3DSS. + - Listado y gestión de los registros de movimientos realizados por los diferentes usuarios de 3DSS. - > Este módulo y sus funcionalidades, se revisan y explican detalladamente en la sección de **Funcionamiento de MPI** -> **Seguridad**, de esta documentación. + > Este módulo y sus funcionalidades, se revisan y explican detalladamente en la sección de **Funcionamiento de 3DSS** -> **Seguridad**, de esta documentación. ### Paso 4: -Cree los ***aliados comerciales***. Siga la guía dada en el menú de **Funcionamiento de MPI** -> **Configuración** -> **Otras configuraciones** -> **Aliados comerciales** de la presente documentación, y habílitelos según los requiera. +Cree los ***aliados comerciales***. Siga la guía dada en el menú de **Funcionamiento de 3DSS** -> **Configuración** -> **Otras configuraciones** -> **Aliados comerciales** de la presente documentación, y habílitelos según los requiera. ### Paso 5: -Cree los ***consultores comerciales***. Siga la guía dada en el menú de **Funcionamiento de MPI** -> **Configuración** -> **Otras configuraciones** -> **Consultores comerciales**, de la presente documentación, y habílitelos según los requiera. +Cree los ***consultores comerciales***. Siga la guía dada en el menú de **Funcionamiento de 3DSS** -> **Configuración** -> **Otras configuraciones** -> **Consultores comerciales**, de la presente documentación, y habílitelos según los requiera. ### Paso 6: -Cree los ***comercios*** con los cuales tiene convenio. Siga la guía dada en el menú de **Funcionamiento de MPI** -> **Configuración** -> **Configuración de comercios**, de la presente documentación, y habílitelos según los requiera. +Cree los ***comercios*** con los cuales tiene convenio. Siga la guía dada en el menú de **Funcionamiento de 3DSS** -> **Configuración** -> **Configuración de comercios**, de la presente documentación, y habílitelos según los requiera. ### Paso 7: -Cree las ***franquicias*** con las cuales esté certificada MPI. Siga la guía dada en el menú de **Funcionamiento de MPI** -> **Configuración** -> **Configuración de franquicias**, de la presente documentación, y habílitelas según las requiera. +Cree las ***franquicias*** con las cuales esté certificada 3DSS. Siga la guía dada en el menú de **Funcionamiento de 3DSS** -> **Configuración** -> **Configuración de franquicias**, de la presente documentación, y habílitelas según las requiera. ### Paso 8: -Cree los ***servidores de directorio*** (DS), respectivos para cada franquicia. Para ello vaya al detalle de cada franquicia, a la sección *Servidores de directorio*. Para obtener más detalles, siga la guía dada en el menú de **Funcionamiento de MPI** -> **Configuración** -> **Configuración de franquicias**, de la presente documentación, y habílitelos según los requiera. +Cree los ***servidores de directorio*** (DS), respectivos para cada franquicia. Para ello vaya al detalle de cada franquicia, a la sección *Servidores de directorio*. Para obtener más detalles, siga la guía dada en el menú de **Funcionamiento de 3DSS** -> **Configuración** -> **Configuración de franquicias**, de la presente documentación, y habílitelos según los requiera. ### Paso 9: -Cree ***configuraciones para cada servidor de directorio*** (DS). Para ello vaya al detalle de cada franquicia, luego a la sección *Servidores de directorio*, y luego al detalle de cada servidor de directorio y a la sección *Configuraciones*. Para obtener más detalles, siga la guía dada en el menú de **Funcionamiento de MPI** -> **Configuración** -> **Configuración de franquicias**, de la presente documentación. +Cree ***configuraciones para cada servidor de directorio*** (DS). Para ello vaya al detalle de cada franquicia, luego a la sección *Servidores de directorio*, y luego al detalle de cada servidor de directorio y a la sección *Configuraciones*. Para obtener más detalles, siga la guía dada en el menú de **Funcionamiento de 3DSS** -> **Configuración** -> **Configuración de franquicias**, de la presente documentación. ### Paso 10: -Cree los ***adquirientes*** con los cuales tiene convenio. Siga la guía dada en el menú de **Funcionamiento de MPI** -> **Configuración** **Otras configuraciones** -> **Adquirientes**, de la presente documentación, y habílitelos según los requiera. +Cree los ***adquirientes*** con los cuales tiene convenio. Siga la guía dada en el menú de **Funcionamiento de 3DSS** -> **Configuración** **Otras configuraciones** -> **Adquirientes**, de la presente documentación, y habílitelos según los requiera. ### Paso 11: -Cree los ***bines*** que requiera para cada adquiriente creado. Los bines hacen referencia a los primeros 6 dígitos de las tarjetas que pueden procesar las franquicias de cada adquieriente. Para ello vaya al detalle de cada adquiriente, a la sección *Bines*. Para obtener más detalles, siga la guía dada en el menú de **Funcionamiento de MPI** -> **Configuración** **Otras configuraciones** -> **Adquirientes**, de la presente documentación. +Cree los ***bines*** que requiera para cada adquiriente creado. Los bines hacen referencia a los primeros 6 dígitos de las tarjetas que pueden procesar las franquicias de cada adquieriente. Para ello vaya al detalle de cada adquiriente, a la sección *Bines*. Para obtener más detalles, siga la guía dada en el menú de **Funcionamiento de 3DSS** -> **Configuración** **Otras configuraciones** -> **Adquirientes**, de la presente documentación. ### Paso 12: -Cree el ***certificado SSL*** para cada comercio, y fírmelo. Para más detalle de este proceso siga la guía dada en el menú de **Funcionamiento de MPI** -> **Configuración** **Otras configuraciones** -> **Certificados**, de la presente documentación. +Cree el ***certificado SSL*** para cada comercio, y fírmelo. Para más detalle de este proceso siga la guía dada en el menú de **Funcionamiento de 3DSS** -> **Configuración** **Otras configuraciones** -> **Certificados**, de la presente documentación. ### Paso 13: ***Suscriba adquirientes*** por franquicia y versión del protocolo para cada comercio. Para ello diríjase al detalle de cada comercio, a la sección *Adquirientes suscritos*, haga clic en el botón *Suscribir adquiriente*, diligencie el formulario y luego en el listado de *Adquirientes suscritos*, haga clic en el ícono con forma de probeta, para validar la suscripción, esta debe arrojarle un mensaje de éxito, además el certificado debe aparecer como "OK" y con el estado "Disponible*, en el listado de adquirientes suscritos. ### Paso 14: -Cree un ***token de acceso*** y autentiquese con este en la API para comenzar a procesar transacciones. Para ello vaya al detalle de cada comercio, a la sección *Tokens*. Para obtener más detalles, siga la guía dada en el menú de **Funcionamiento de MPI** -> **Configuración** **Otras configuraciones** -> **Certificados**, de la presente documentación. \ No newline at end of file +Cree un ***token de acceso*** y autentiquese con este en la API para comenzar a procesar transacciones. Para ello vaya al detalle de cada comercio, a la sección *Tokens*. Para obtener más detalles, siga la guía dada en el menú de **Funcionamiento de 3DSS** -> **Configuración** **Otras configuraciones** -> **Certificados**, de la presente documentación. \ No newline at end of file diff --git a/src/pages/en/three-d-s-server/panel/merchant-configuration.mdx b/src/pages/en/three-d-s-server/panel/merchant-configuration.mdx index 3cd1888..6e12626 100644 --- a/src/pages/en/three-d-s-server/panel/merchant-configuration.mdx +++ b/src/pages/en/three-d-s-server/panel/merchant-configuration.mdx @@ -1,18 +1,18 @@ -# Comercios en MPI +# Comercios en 3DSS ## ¿Qué es un comercio? Un comercio en 3DSS son todas aquellas organizaciones establecidas legalmente y con convenio con Evertec Placetopay, que permiten la compra y venta de bienes o servicios de forma virtual, utilizando los productos que ofrece la compañía en cuanto a soluciones transaccionales y de seguridad. -## ¿Cómo acceder a la gestión de comercios de MPI? +## ¿Cómo acceder a la gestión de comercios de 3DSS? Para acceder al listado de comercios de la aplicación siga los siguientes pasos: Remítase al menú lateral izquierdo dónde visualizará tres opciones, "Tablero", "Configuración" y "Seguridad", seleccione **Configuración** y luego **Comercios**: -# ¿Cómo crear un comercio en MPI? +# ¿Cómo crear un comercio en 3DSS? Para crear un comercio, haga clic en el botón **Crear** ubicado en la parte lateral derecha del índice de comercios. @@ -28,26 +28,26 @@ Para diligenciarlo tenga en cuenta los siguientes datos: - **Moneda:** Seleccione de la lista desplegable la moneda con la cual procesa las transacciones el comercio. -- **Clase CIIU:** Seleccione de la lista desplegable la clase de categoría de actividad económica del comercio, para ello guíese con el indicador numérico que precede a la descripción de la actividad. Para más información de este campo, puede dirigirse al módulo de esta documentación en la siguiente ruta: **Funcionamiento de MPI** -> **Configuración** -> **Otras configuraciones** -> **Clases CIIU**. +- **Clase CIIU:** Seleccione de la lista desplegable la clase de categoría de actividad económica del comercio, para ello guíese con el indicador numérico que precede a la descripción de la actividad. Para más información de este campo, puede dirigirse al módulo de esta documentación en la siguiente ruta: **Funcionamiento de 3DSS** -> **Configuración** -> **Otras configuraciones** -> **Clases CIIU**. -- **Código de categoría del comerciante:** Seleccione de la lista desplegable el código de categoría del comerciante correspondiente al comercio a registrar, para ello guíese con el indicador numérico que precede a la descripción de la actividad. Para más información de este campo, puede dirigirse al módulo de esta documentación en la siguiente ruta: **Funcionamiento de MPI** -> **Configuración** -> **Otras configuraciones** -> **Códigos del comercio**. +- **Código de categoría del comerciante:** Seleccione de la lista desplegable el código de categoría del comerciante correspondiente al comercio a registrar, para ello guíese con el indicador numérico que precede a la descripción de la actividad. Para más información de este campo, puede dirigirse al módulo de esta documentación en la siguiente ruta: **Funcionamiento de 3DSS** -> **Configuración** -> **Otras configuraciones** -> **Códigos del comercio**. - **Consultor comercial:** Seleccione de la lista desplegable el consultor comercial que opera para el comercio en el país seleccionado. - **Aliado comercial:** Seleccione de la lista desplegable el aliado comercial que opera para el comercio en el país seleccionado. -- **Url:** Ingrese una URL válida que funcionará para conectar el comercio con MPI. A esta URL se redirigirá el usuario al procesar una autenticación. +- **Url:** Ingrese una URL válida que funcionará para conectar el comercio con 3DSS. A esta URL se redirigirá el usuario al procesar una autenticación. - **Habilitar/Deshabilitar:** Puede habilitar o deshabilitar un comercio, deslizando el botón tipo switch con nombre *Habilitar* cuando está deshabilitado el comercio, o con nombre *Deshabilitar* cuando está habilitado y desea deshabilitarlo. -## ¿Cuáles son los requerimientos para crear un comercio en MPI? +## ¿Cuáles son los requerimientos para crear un comercio en 3DSS? -Para crear y configurar un comercio en MPI, se requiere inicialmente que tenga un convenio y esté certificado con Evertec Placetopay, también que el país y el idioma con el cual opera el comercio, estén disponibles para MPI. +Para crear y configurar un comercio en 3DSS, se requiere inicialmente que tenga un convenio y esté certificado con Evertec Placetopay, también que el país y el idioma con el cual opera el comercio, estén disponibles para 3DSS. Se requiere que exista una relación entre emisor, adquiriente y comercio y que estos estén registrados en las aplicaciones de ACS y de 3DSS de Evertec Placetopay, para lograr un proceso de autenticación exitosa utilizando el protocolo 3-D Secure. -Importante tener en cuenta que previo a la creación del comercio, debe haber creado previamente en MPI, el consultor y el aliado comercial con los cuales operarán el comercio. +Importante tener en cuenta que previo a la creación del comercio, debe haber creado previamente en 3DSS, el consultor y el aliado comercial con los cuales operarán el comercio. # Índice de comercios @@ -158,7 +158,7 @@ Para diligenciarlo tenga en cuenta los siguientes datos: - **Moneda:** Seleccione de la lista desplegable la moneda con la cual procesa las transacciones la sucursal. -- **Url:** Ingrese una URL válida que funcionará para conectar la sucursal con MPI. A esta URL se redirigirá el usuario al procesar una autenticación. +- **Url:** Ingrese una URL válida que funcionará para conectar la sucursal con 3DSS. A esta URL se redirigirá el usuario al procesar una autenticación. - **Habilitar/Deshabilitar:** Puede habilitar o deshabilitar la sucursal, deslizando el botón tipo switch con nombre *Habilitar* cuando está deshabilitada la sucursal, o con nombre *Deshabilitar* cuando está habilitada y desea deshabilitarla. @@ -242,7 +242,7 @@ En esta sección se listan todos los tokens de acceso creados para el comercio e ### ¿Cómo crear un nuevo token? -Para crear un nuevo token para un comercio, que le permite el acceso para procesar una autenticación con la aplicación de MPI, deberá hacer clic en el botón **Crear token**. +Para crear un nuevo token para un comercio, que le permite el acceso para procesar una autenticación con la aplicación de 3DSS, deberá hacer clic en el botón **Crear token**. Se mostrará un formulario como el siguiente, donde únicamente le pedirá ingresar un nombre para identificar al nuevo token a crear. diff --git a/src/pages/en/three-d-s-server/panel/security.mdx b/src/pages/en/three-d-s-server/panel/security.mdx index 66fd425..790e840 100644 --- a/src/pages/en/three-d-s-server/panel/security.mdx +++ b/src/pages/en/three-d-s-server/panel/security.mdx @@ -24,7 +24,7 @@ Las acciones disponibles son: - **Eliminar:** Puede eliminar el token seleccionado. -> Es importante recordar que los tokens se crean a través del módulo **Comercios**, en el detalle de cada comercio y luego en la sección **Tokens**. Para obtener más detalles de este proceso, diríjase a la sección de la documentación **Funcionamiento de MPI** -> **Configuración** -> **Configuración de comercios**. +> Es importante recordar que los tokens se crean a través del módulo **Comercios**, en el detalle de cada comercio y luego en la sección **Tokens**. Para obtener más detalles de este proceso, diríjase a la sección de la documentación **Funcionamiento de 3DSS** -> **Configuración** -> **Configuración de comercios**. # Usuarios @@ -33,9 +33,9 @@ Para acceder al módulo de usuarios, diríjase al menú lateral izquierdo, despl ## Listado de usuarios: -En este módulo se puede visualizar el listado de usuarios con acceso a MPI. El listado contiene el nombre, el correo electrónico asociado al usuario y el estado de habilitación en el que se encuentra. +En este módulo se puede visualizar el listado de usuarios con acceso a 3DSS. El listado contiene el nombre, el correo electrónico asociado al usuario y el estado de habilitación en el que se encuentra. -> Es importante recordar que los usuarios se crean a través del módulo invitaciones. Además, un usuario solo aparece en este módulo, cuando haya aceptado la invitación para unirse a MPI, haya creado el usuario y haya iniciado sesión sin conflicto alguno. +> Es importante recordar que los usuarios se crean a través del módulo invitaciones. Además, un usuario solo aparece en este módulo, cuando haya aceptado la invitación para unirse a 3DSS, haya creado el usuario y haya iniciado sesión sin conflicto alguno. ### Buscador de usuarios: @@ -95,7 +95,7 @@ Al seleccionar esta opción en el menú, se desplegará un formulario como el si Describa en el formulario con la descripción del conflicto con detalle y pantallazos, para ser solucionado efectivamente por el equipo de soporte de Evertec. -## ¿Cómo cerrar sesión en MPI?: +## ¿Cómo cerrar sesión en 3DSS?: Para cerrar sesión cuando desea finalizar la actividad en la aplicación, diríjase al menú desplegable que se encuentra al lado derecho del avatar de usuario. @@ -196,9 +196,9 @@ Las invitaciones poseen dos estados: > Cuando la invitación fue enviada a varios usuarios, el estado se muestra con un indicador similar al siguiente, el cual muestra cuantas de las invitaciones enviadas, están en el estado específico. -## Invitaciones para crear nuevos usuarios en MPI: +## Invitaciones para crear nuevos usuarios en 3DSS: -Es a través de una invitación que se pueden crear nuevos usuarios. Una invitación se envía a uno o varios correos electrónicos y allí redirecciona al usuario a la aplicación de Accounts de PlacetoPay. En esta redirección, el usuario podrá registrar sus datos personales y contraseña para acceder posteriormente a MPI. +Es a través de una invitación que se pueden crear nuevos usuarios. Una invitación se envía a uno o varios correos electrónicos y allí redirecciona al usuario a la aplicación de Accounts de PlacetoPay. En esta redirección, el usuario podrá registrar sus datos personales y contraseña para acceder posteriormente a 3DSS. > Los datos que registre deben ser los mismos que se utilizaron para enviar la invitación. @@ -212,7 +212,7 @@ Datos a diligenciar: - **Correo electrónico:** Debe ingresar un correo válido porque allí es dónde se enviará la invitación. Puede ingresar uno o varios para conformar una invitación grupal. -- **Copiar datos de un usuario existente:** Con este botón deslizable, puede activar o desactivar la opción de copiar la información (permisos), que posee un usuario existente actualmente en MPI, a el usuario o usuarios nuevos que desea crear. +- **Copiar datos de un usuario existente:** Con este botón deslizable, puede activar o desactivar la opción de copiar la información (permisos), que posee un usuario existente actualmente en 3DSS, a el usuario o usuarios nuevos que desea crear. - **Perfiles:** Si activó la opción "Copiar datos de un usuario existente", debe seleccionar uno o varios perfiles existente a partir del cual desea crear el nuevo usuario. @@ -319,7 +319,7 @@ Para crear un nuevo perfil debe hacerlo a través de una invitación. ### ¿Qué es el ACL? -El ACL (Access Control List), es un módulo de gestión de permisos y reglas desarrollado en PlacetoPay y utilizado por MPI. Este se encarga de gestionar los permisos y accesos de los diferentes roles y perfiles creados en MPI. +El ACL (Access Control List), es un módulo de gestión de permisos y reglas desarrollado en PlacetoPay y utilizado por 3DSS. Este se encarga de gestionar los permisos y accesos de los diferentes roles y perfiles creados en 3DSS. Estos permisos y reglas de acceso, se diferencian de los permisos básicos registrados en los roles, en que estos son más específicos y ofrecen una capa de seguridad extra a los datos manejados en la aplicación, ya que permiten que se visualice la información que corresponde solo a un cliente en específico y que no se filtre otra información que pertenece a otros clientes u organizaciones. @@ -353,13 +353,13 @@ Para acceder a este módulo, dírijase al menú ubicado en la parte lateral izqu ## Índice de logs: -En esta sección se registran los movimientos y actualizaciones que se realizan en la aplicación de MPI. Los logs permiten tener un control de los cambios y de lo que sucede en la aplicación. +En esta sección se registran los movimientos y actualizaciones que se realizan en la aplicación de 3DSS. Los logs permiten tener un control de los cambios y de lo que sucede en la aplicación. En la sección de logs se encuentra un listado de los mismos, con una descripción, la fecha y hora en que fue registrado el movimiento y el nombre del usuario que efectuó el movimiento. ### Filtros: -Para hacer búsquedas de los logs registrados utilice la sección de filtros. Haga clic en el botón *Filtros*, ubicado en la parte lateral izquierda, se desplegará un módulo para filtrar por rango de fechas y por el correo electrónico del usuario que realizó el cambio o movimiento: +Para hacer búsquedas de los logs registrados utilicé la sección de filtros. Haga clic en el botón *Filtros*, ubicado en la parte lateral izquierda, se desplegará un módulo para filtrar por rango de fechas y por el correo electrónico del usuario que realizó el cambio o movimiento: Para ejecutar la búsqueda haga clic en el botón **Buscar** y para limpiar los datos de búsqueda ingresados previamente, haga clic en el botón **Limpiar filtros**. diff --git a/src/pages/en/three-d-s-server/secure-protocol.mdx b/src/pages/en/three-d-s-server/secure-protocol.mdx index 4e07d10..25b3fb2 100644 --- a/src/pages/en/three-d-s-server/secure-protocol.mdx +++ b/src/pages/en/three-d-s-server/secure-protocol.mdx @@ -19,7 +19,7 @@ Los dominios son los siguientes: - Integrador 3DS (3DS Integrator) - Adquiriente (Acquirer) -> Este dominio está representado por la aplicación de MPI. + ***Este dominio está representado por la aplicación de 3DSS.*** **2. Dominio de Interoperabilidad:** Conecta al dominio Adquiriente y Emisor a través de los mensajes que contienen información acerca de la autenticación. diff --git a/src/pages/three-d-s-server/api/client-requirements.mdx b/src/pages/three-d-s-server/api/client-requirements.mdx index 4ee7b95..a2b5665 100644 --- a/src/pages/three-d-s-server/api/client-requirements.mdx +++ b/src/pages/three-d-s-server/api/client-requirements.mdx @@ -2,7 +2,7 @@ # Requerimientos para el cliente que va a integrarse -Para integrarse al servicio de 3DS Server o 3DS Secure Merchant Plugin (MPI) de Evertec, el comercio o pasarela deberá cumplir con los siguientes requisitos, necesarios para garantizar la compatibilidad en la conexión: +Para integrarse al servicio de 3DS Server o 3DS Secure de Evertec, el comercio o pasarela deberá cumplir con los siguientes requisitos, necesarios para garantizar la compatibilidad en la conexión: - **Encabezados HTTP:** Los encabezados HTTP deben estar parametrizados con los siguientes valores: @@ -15,6 +15,6 @@ Para integrarse al servicio de 3DS Server o 3DS Secure Merchant Plugin (MPI) de Authorization:"Bearer 1c6b2cda415f40f6f9f82e24d31d3fa6deb3cbcdd1def686fef7ed721a8abf83" - > Este token se crea en el módulo de **Tokens**, ubicado en el menú **Funcionamiento de MPI** -> **Seguridad**. + > Este token es proporcionado por el administrador de seguridad transaccional. - **Comunicaciones seguras:** Para establecer los enlaces asegurados por Transport Layer Security (TLS), entre el servicio y los clientes conectados, el número de versión debe ser 1.2 o superior. Las claves RSA deben tener una longitud mínima de 2048 bits. \ No newline at end of file diff --git a/src/pages/three-d-s-server/api/index.mdx b/src/pages/three-d-s-server/api/index.mdx index 2d3d308..c3d8dfb 100644 --- a/src/pages/three-d-s-server/api/index.mdx +++ b/src/pages/three-d-s-server/api/index.mdx @@ -8,7 +8,7 @@ En el dinámico mundo del comercio electrónico, donde la seguridad y la confian #### ¿Por qué Integrarse con nuestra API de 3DS? -Nuestra API de **3DS Server** le permite implementar de manera rápida y eficaz las funcionalidades del protocolo **3DS** en sus sistemas. Al integrarse con nuestra API, su empresa podrá aprovechar las últimas características de las últimas versiones activas del protocolo, como **EMV® 3DS 2.1.0, 2.2.0** y **2.3.1**. +Nuestra API de **3DS Server** le permite implementar de manera rápida y eficaz las funcionalidades del protocolo **3DS** en sus sistemas. Al integrarse con nuestra API, su empresa podrá aprovechar las últimas características de las últimas versiones activas del protocolo, como **EMV® 3DS 2.2.0** y **2.3.1**. La integración con nuestra API ofrece: diff --git a/src/pages/three-d-s-server/api/integration/authorization.mdx b/src/pages/three-d-s-server/api/integration/authorization.mdx index 9383004..1086694 100644 --- a/src/pages/three-d-s-server/api/integration/authorization.mdx +++ b/src/pages/three-d-s-server/api/integration/authorization.mdx @@ -5,7 +5,7 @@ Para interactuar con la API del 3DS Server, es necesario generar un token desde Dicho token se enviará en el encabezado HTTP como un "Bearer Token", conforme al [RFC 6750](https://datatracker.ietf.org/doc/html/rfc6750). -> Es importante destacar que el token es exclusivo del comercio y debe ser tratado con seguridad. No se debe compartir en áreas de acceso público ni en otros lugares de fácil acceso para terceros. +***Es importante destacar que el token es exclusivo del comercio y debe ser tratado con seguridad. No se debe compartir en áreas de acceso público ni en otros lugares de fácil acceso para terceros.*** Ejemplo de un Bearer Token: @@ -13,16 +13,6 @@ Ejemplo de un Bearer Token: Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiIxIiwianRpIjoiMjAzNjNkNDNhYjk0YzRhOGFkZmVlZTg1MzZlOGZjZTljM2M4MGI5YWYxNDk2YWRmNWJlNGE1NjkwNDk4YjcwNDllNTAwZDBjYWFjMjNjMDMiLCJpYXQiOjE2NzE0NjY2OTkuMTUyMjA2LCJuYmYiOjE2NzE0NjY2OTkuMTUyMjA3LCJleHAiOjE3NjYxNjEwOTkuMTM0ODkzLCJzdWIiOiIxIiwic2NvcGVzIjpbXX0.NzKTueFRgUyq_X9x0UmQeejlFWMw1yfImmpcRQUhMDDYE4p6torwzUCDkuKWz2AoelYTIWVqwPKot5kmG8zF9U8uqXYHttSc6VxbcgaTyx0NIFrkeZOReOLwommo-iJtIv9neLZoCU0GrCtg-nV7W2t1Yt1d9drAYbg6lOpH5Wc ``` -## ¿Cómo generar el token? +Este token es de uso personal y se mostrará únicamente en esta ocasión. Guárdalo en un lugar seguro y **¡asegúrate de no perderlo!** -Para generar el token, es imprescindible iniciar sesión en el panel administrativo. Una vez que haya accedido, deberá dirigirse a la vista de Comercio. Esto se puede realizar siguiendo la ruta en el menú: seleccione *Configuración*, a continuación, haga clic en *Comercios* e ingrese a la vista detallada del comercio seleccionado. Una vez dentro, proceda a la sección denominada *Tokens* y haga clic en el botón **"Crear Token"**. Complete los datos del formulario y finaliza con guardar. - -![Mpi_create_token.png](/3DS_server/Mpi_create_token.png) - -#### Datos del formulario: -- Nombre que es la información que identifica el Token. -- Duración del token. - -> Este token es de uso personal y se mostrará únicamente en esta ocasión. Guárdalo en un lugar seguro y **¡asegúrate de no perderlo!** - -> Si se llega a perder el token, será necesario generar uno nuevo. +***Si se llega a perder el token, será necesario generar uno nuevo.*** diff --git a/src/pages/three-d-s-server/api/integration/session.mdx b/src/pages/three-d-s-server/api/integration/session.mdx index 315f0db..737f5cb 100644 --- a/src/pages/three-d-s-server/api/integration/session.mdx +++ b/src/pages/three-d-s-server/api/integration/session.mdx @@ -83,7 +83,7 @@ Este mensaje se puede presentar cuando en los siguientes casos: --- -## Sesión con Digital Authentication Framework +## Sesión con Digital Authentication Framework (DAF) Visa Digital Authentication Framework DAF es una extensión de mensaje del protocolo 3DS que le permite a Visa identificar a titulares de tarjetas que superaron el flujo de autenticación con desafío en un determinado comercio - adquirente, para así otorgarles un estado de confiabilidad al determinarlos como credencial de pago autenticada **authenticated credential payment**, esto permite que las siguientes transacciones que ejecute el tarjetahabiente en el mismo comercio sean autenticadas de inmediato. El objetivo principal es reducir el fraude y la fricción. @@ -357,7 +357,7 @@ Este tipo de sesiones se presentan cuando el comerciante está iniciando una tra -## Sesión transacción con Bridging Message Extension: +## Sesión transacción con Bridging Message Extension (BME) El 3DS **v2.3** introduce elementos de datos en la extensión del mensaje que pueden duplicar aquellos presentes en las versiones 3DS **v2.1 y v2.2**, pero con valores nuevos o diferentes. De acuerdo con la Especificación Básica **v2.3**, estos valores se establecen en la extensión del mensaje, mientras que en las versiones **v2.1 y v2.2** se encuentran en la parte central de los mensajes 3DS. En estos casos, el valor del elemento de datos en la extensión del mensaje prevalece sobre el valor correspondiente en la parte central del mensaje 3DS. Además, el Servidor 3DS genera el mensaje AReq **v2.1** o **v2.2** bajo la suposición de que el ACS no soporta la Extensión del Mensaje de Puente, y posteriormente, proporciona la información adicional a través de dicha extensión. Si se soporta la Extensión del Mensaje de Puente, el componente 3DS deberá ser compatible al menos con uno de los objetos de datos ***como datos recurrentes, datos de desafío, datos adicionales o datos de URL de archivo*** de la extensión del mensaje e implementar los requisitos correspondientes de la Especificación Básica **v2.3**. @@ -419,11 +419,11 @@ Ver más detalle en [Reglas a tener en cuenta de la session API](/en/three-d-s-s ``` -### Ejemplo De la extención creada por MPI +### Ejemplo De la extención creada por 3DSS ```json { - "1": { + { "id": "A000000802-004", "data": { "addData": { @@ -440,71 +440,8 @@ Ver más detalle en [Reglas a tener en cuenta de la session API](/en/three-d-s-s "criticalityIndicator": false } } -``` - ---- - -## Transacción iniciada por el Titular de la Tarjeta (CIT) - -Cualquier transacción en la que el titular de la tarjeta participa activamente en la transacción. Las transacciones pueden realizarse con base en las credenciales proporcionadas por el titular de la tarjeta en el momento de la transacción o una credencial almacenada de una interacción previa. Las transacciones pueden ocurrir como una transacción en punto de venta (POS) en tienda, una transacción de comercio electrónico, una orden por correo/teléfono, o en un cajero automático **ATM**. - ---- - -## Transacción Iniciada por el Comerciante (MIT) - -Una transacción donde el titular de la tarjeta no participa activamente en la transacción. Las **MIT** a menudo pueden ser precedidas por una CIT **que involucre una PA - Payment Authentication** o una Consulta de Estado de Cuenta **ASI, por sus siglas en inglés**. - -**Payment Authentication (PA):** Implica monto de autenticación - -**Non Payment Authentication (NPA):** No implica monto - - ---- - -## Pago Recurrente / Cuotas - -Una transacción que surge de un acuerdo entre el titular de la tarjeta y el comerciante mediante el cual el titular de la tarjeta acepta que el comerciante almacene la credencial del titular de la tarjeta y utilice esa credencial almacenada para una compra subsiguiente de bienes o servicios. Estas transacciones pueden clasificarse como: -* Orden permanente -* Suscripción -* Cuota (pagos diferidos) -* CREDENCIAL-ON-FILE no programada - ---- - -## Práctica de la Industria MIT - -Una transacción iniciada por el comerciante para cumplir con una práctica comercial que ocurre más a menudo después de una interacción inicial con el titular de la tarjeta. Las transacciones pueden realizarse con credenciales que están almacenadas en archivo, o credenciales que no están almacenadas en archivo, sino que son temporalmente retenidas por el comerciante según lo acordado por el consumidor. Estas MIT de práctica de la industria pueden clasificarse como: - -* Envíos parciales -* Entregas parciales o retrasadas -* No presentación (Tarjetahabiente no está presente para tomar el servicio) -* Reenvío - ---- - -## Tipos de mensajes 3RI admitidos - -La funcionalidad 3RI abarca varios casos de uso técnicos y comerciales diferentes que son principalmente definidos por los siguientes campos EMV 3DS: - -• **Canal de dispositivo (deviceChannel)** = '03' - -• **Campo Indicador 3RI (tresRIInd)** en la solicitud de autenticación **AReq** que define el tipo de Transacción 3RI. No todos los valores de campo del indicador 3RI documentados en la especificación EMV 3DS actualmente son compatibles con las marcas - -| 3RI Indicador (threeRIInd) | Marcas | Pago (PA) | No Pago (NPA) | -|-----------------------------------------|------------------|-----------|---------------| -| **(01)** Recurring Transaction | Visa, Mastercard | SI | NO | -| **(02)** Installment Transaction | Visa, Mastercard | SI | NO | -| **(03)** Add Card | Visa, Mastercard | NO | SI | -| **(04)** Maintain Card Information | Visa, Mastercard | NO | SI | -| **(05)** Account Verification | Visa, Mastercard | NO | SI | -| **(06)** Split/Delayed Shipment | Visa, Mastercard | SI | NO | -| **(07)** Top-up | Visa, Mastercard | NO | NO | -| **(08)** Mail Order | Visa, Mastercard | NO | NO | -| **(09)** Telephone Order | Visa, Mastercard | NO | NO | -| **(10)** Whitelist Status Check | Visa, Mastercard | NO | SI | -| **(11)** Other Payment | Visa, Mastercard | SI | NO | -| **(81)** Unscheduled Credential-on-File | Visa | SI | NO | +``` --- @@ -512,7 +449,7 @@ La funcionalidad 3RI abarca varios casos de uso técnicos y comerciales diferent ### Opción PA -Por ejemplo, cuando durante el proceso de pago se tiene disponible la casilla que dice ***Guardar tarjeta para pagos futuros*** y se quiere verificar los fondos de la cuenta. +Durante el proceso de pago se tiene disponible la casilla que dice ***Guardar tarjeta para pagos futuros*** y se quiere verificar los fondos de la cuenta. `POST` https://3dss-dev.placetopay.ws/api/threeds/v2x/sessions @@ -535,7 +472,7 @@ Por ejemplo, cuando durante el proceso de pago se tiene disponible la casilla qu **deviceChannel:** 02 - Navegador. -**threeDSChallengeInd**, indica si se solicita desafío o no, las opciones recomendables son: +**threeDSChallengeInd:** indica si se solicita desafío o no, las opciones recomendables son: * **03:** el requestor tiene la preferencia de que se aplique desafío. * **04:** el desafío es obligatorio. @@ -608,7 +545,8 @@ Esta opción no require verificar fondos de la cuenta. ## Pagos recurrentes (Suscripción mensual a una plataforma) -Una transacción recurrente es aquella en la que se realiza un cargo periódico al titular de la tarjeta de forma programada. Estas transacciones son comunes en servicios de suscripción, como membresías, suscripciones a servicios de streaming, pagos de facturas recurrentes, etc. +Una transacción recurrente es aquella en la que se realiza un cargo periódico al titular de la tarjeta de forma programada. +Estas transacciones son comunes en servicios de suscripción, como membresías, suscripciones a servicios de streaming, pagos de facturas recurrentes, etc. `POST` https://3dss-dev.placetopay.ws/api/threeds/v2x/sessions @@ -631,7 +569,7 @@ Antes de realizar una solicitud 3RI, debe haberse realizado una autenticación E ```json { "deviceChannel": "02", - "threeDSAuthenticationInd": "03", + "threeDSAuthenticationInd": "02", "threeDSChallengeInd": "04", "recurringExpiry": "20250101", "recurringFrequency": "2", @@ -648,7 +586,7 @@ Antes de realizar una solicitud 3RI, debe haberse realizado una autenticación E **deviceChannel:** 02 - Navegador -**threeDSAuthenticationInd:** 03 indica que la transacción es a plazos +**threeDSAuthenticationInd:** 02 indica que la transacción es una recurrencia **threeDSChallengeInd:** 04: el desafío es obligatorio @@ -663,9 +601,9 @@ Antes de realizar una solicitud 3RI, debe haberse realizado una autenticación E ```json { "action": "redirect", - "sessionToken": "ae30396c70e0ee6c23324f7c5b0390960df2b9ebeb70996a1fc9315cc34bcb6c", - "redirectURL": "https://3dss-dev.placetopay.ws/threeds/v2x/sessions/1262/ae30396c70e0ee6c23324f7c5b0390960df2b9ebeb70996a1fc9315cc34bcb6c", - "transactionID": 1306 + "sessionToken": "398864c1e4c8217283b67f0312a2d8ee14e3814c0e000a92d4532bc406f65d2f", + "redirectURL": "https://3dss-test.placetopay.com/threeds/v2x/sessions/86036/398864c1e4c8217283b67f0312a2d8ee14e3814c0e000a92d4532bc406f65d2f", + "transactionID": 248002 } ``` @@ -698,11 +636,10 @@ Datos requeridos en la petición API ```json { "deviceChannel": "02", - "threeDSAuthenticationInd": "03", + "threeDSAuthenticationInd": "02", "threeDSChallengeInd": "04", "recurringExpiry": "20260101", "recurringFrequency": "2", - "purchaseInstalData": "2", "acctNumber": "4931119220729333", "cardExpiryDate": "2902", "purchaseAmount": "1.02", @@ -725,7 +662,7 @@ Datos requeridos en la petición API **deviceChannel:** 02 - Navegador -**threeDSAuthenticationInd:** 03 indica que la transacción es a plazos +**threeDSAuthenticationInd:** 02 indica que la transacción es recurrente **threeDSChallengeInd:** 04: el desafío es obligatorio @@ -749,9 +686,9 @@ Datos requeridos en la petición API ```json { "action": "redirect", - "sessionToken": "b3a0ce35a97aa1417f666c1f10151983a9bdb7b3f81966f721b290f1862b27a3", - "redirectURL": "https://3dss-dev.placetopay.ws/threeds/v2x/sessions/1265/b3a0ce35a97aa1417f666c1f10151983a9bdb7b3f81966f721b290f1862b27a3", - "transactionID": 1309 + "sessionToken": "c56d238b35d23b8cf564f2b6b641ed0e8a3056fb639d9df245d4bec825e4b74a", + "redirectURL": "https://3dss-test.placetopay.com/threeds/v2x/sessions/86039/c56d238b35d23b8cf564f2b6b641ed0e8a3056fb639d9df245d4bec825e4b74a", + "transactionID": 248005 } ``` @@ -759,7 +696,7 @@ Datos requeridos en la petición API **Autenticaciones posteriores** -Envíe una solicitud 3RI por el valor del segundo bien/servicio. +Envíe una solicitud 3RI por el valor de la recurrencia ### MASTERCARD @@ -771,8 +708,8 @@ Envíe una solicitud 3RI por el valor del segundo bien/servicio. "threeRIInd": "01", "threeDSRequestorPriorAuthenticationInfo": { "threeDSReqPriorAuthMethod": "CARDHOLDER_CHALLENGE_OCCURRED", - "threeDSReqPriorAuthTimestamp": "2024-08-22T13:16:01+00:00", - "threeDSReqPriorRef": "1192ffe6-6691-45e2-8ac9-a611cf122a9a" + "threeDSReqPriorAuthTimestamp": "2024-09-09T19:48:20+00:00", + "threeDSReqPriorRef": "fa4544ea-9002-444a-a891-5fd126735c41" }, "acctNumber": "5107000000010018", "cardExpiryDate": "2902", @@ -788,13 +725,17 @@ Envíe una solicitud 3RI por el valor del segundo bien/servicio. **threeRIInd:** 01 indica que la transacción es recurrente -**threeDSReqPriorAuthMethod:** Método que fue usado por el tarjetahabiente para la autenticación. 01 sin fricción, 02 con fricción, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo +**threeDSReqPriorAuthMethod:** Método que fue usado por el tarjetahabiente para la autenticación. 01 sin fricción, +02 con fricción, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo -**threeDSReqPriorAuthTimestamp:** Fecha y hora en formato UTC de la autenticación previa. El formato es C, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo +**threeDSReqPriorAuthTimestamp:** Fecha y hora en formato UTC de la autenticación previa. El formato es C, +consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo -**threeDSReqPriorRef:** El ID otorgado por el ACS en la transacción previa ***primera autenticación***, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo +**threeDSReqPriorRef:** El ID otorgado por el ACS en la transacción previa ***primera autenticación***, +consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo -**threeDSReqPriorAuthData:** El ID otorgado por el DS en la transacción previa ***primera autenticación***, si este dato no es enviado MPI lo asigna, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo +**threeDSReqPriorAuthData:** El ID otorgado por el DS en la transacción previa ***primera autenticación***, +si este dato no es enviado 3DSS lo asigna, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo ***Response Lookup*** @@ -802,26 +743,43 @@ Envíe una solicitud 3RI por el valor del segundo bien/servicio. { "action": "continue", "messageType": "ARes", - "threeDSServerTransID": "c03e0003-ef69-4ee9-8938-3083ba2f2839", - "acsReferenceNumber": "PTOPID", - "acsTransID": "766dbd1d-9736-408c-b7c6-7a6ba352e5b2", + "threeDSServerTransID": "2e6bd601-7a61-4fa5-accc-10a30e0d66db", + "acsReferenceNumber": "3DS_LOA_ACS_EISF_020200_00539", + "acsTransID": "80fb86d5-35e7-4249-b6df-6905d9c6ba4f", "dsReferenceNumber": "3DS_LOA_DIS_PPFU_020100_00010", - "dsTransID": "cf2735c9-c4d1-4cc1-869d-6901c8f9f58f", + "dsTransID": "3a961497-8ac7-447d-9926-06bf4c1fa1a9", "messageVersion": "2.2.0", - "authenticationValue": "xgSo/jtXAAAAAAAAAAAAAAAAAAA=", + "acsOperatorID": "ACS-V210-ACS-PLACETOPAY-11174", + "authenticationValue": "xgQiqOYmAAAAAAAAAAAAAAAAAAA=", "eci": "07", + "messageExtension": [ + { + "name": "ACS RBA", + "id": "A000000004-acsRBA", + "criticalityIndicator": false, + "data": { + "A000000004-acsRBA": { + "status": "success", + "score": "500", + "decision": "Low Risk", + "reasonCode1": "H", + "reasonCode2": "GG" + } + } + } + ], "transStatus": "Y", "whiteListStatusSource": "03", "whiteListStatus": "Y", "deviceChannel": "03", "messageCategory": "PA", - "authMethod": "FRICTIONLESS_AUTHENTICATION", - "authTimestamp": "2024-05-09T16:06:56+00:00", - "transactionID": 1318 + "authMethod": "01", + "authTimestamp": "2024-09-09T19:52:20+00:00", + "transactionID": 248003 } ``` -**Actión:** continue indica que la API retornara la información de la autenticación, y por ende no es necesario consumir endpoints adicionales para continuar con el flujo +**Actión:** continue indica que la API retornara la información de la autenticación,y por ende no es necesario consumir endpoints adicionales para continuar con el flujo ### VISA @@ -850,11 +808,11 @@ Datos requeridos en la petición API ```json { "deviceChannel": "03", - "threeRIInd": "02", + "threeRIInd": "01", "threeDSRequestorPriorAuthenticationInfo": { "threeDSReqPriorAuthMethod": "CARDHOLDER_CHALLENGE_OCCURRED", - "threeDSReqPriorAuthTimestamp": "2024-05-03T22:44:18+00:00", - "threeDSReqPriorRef": "052cd8e3-5678-4464-8787-8d1fa9758356" + "threeDSReqPriorAuthTimestamp": "2024-09-09T20:06:30+00:00", + "threeDSReqPriorRef": "3b632ce4-26ea-407d-a2a0-4a7b27c91c14" }, "acctNumber": "4931119220729333", "cardExpiryDate": "2902", @@ -878,7 +836,7 @@ Datos requeridos en la petición API **deviceChannel:** 03 indica que el canal es 3RI -**threeRIInd:** 02 indica que la transacción es a plazos +**threeRIInd:** 01 indica que la transacción es recurrente **threeDSReqPriorAuthMethod:** Método que fue usado por el tarjetahabiente para la autenticación. 01 sin fricción, 02 con fricción, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo @@ -886,7 +844,7 @@ Datos requeridos en la petición API **threeDSReqPriorRef:** El ID otorgado por el ACS en la transacción previa **primera autenticación**, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo -**threeDSReqPriorAuthData:** El ID otorgado por el DS en la transacción previa ***primera autenticación***, si este dato no es enviado MPI lo asigna, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo +**threeDSReqPriorAuthData:** El ID otorgado por el DS en la transacción previa ***primera autenticación***, si este dato no es enviado 3DSS lo asigna, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo **Datos DAF:** las llaves adicionales que se deberán enviar para que se aplique el DAF con VISA son los siguientes @@ -905,14 +863,14 @@ Datos requeridos en la petición API { "action": "continue", "messageType": "ARes", - "threeDSServerTransID": "a2de0e4d-fee5-4ac3-a5ec-8f763d73456b", - "acsReferenceNumber": "PTOPID", - "acsTransID": "6e56cb8c-c9a5-4e3c-aa16-21f29cd962f6", + "threeDSServerTransID": "0e0ee43c-9601-4e29-9c8d-32b893ded4db", + "acsReferenceNumber": "3DS_LOA_ACS_EISF_020200_00539V3", + "acsTransID": "ab8b1aec-2cf9-4d60-a45f-8d499894dae5", "dsReferenceNumber": "3DS_LOA_DIS_PPFU_020100_00010", - "dsTransID": "8be55ee3-dc8d-4dd2-ba46-656d569fca35", + "dsTransID": "072b329b-ca7f-47ff-a6b0-ff5a3d6321cb", "messageVersion": "2.2.0", - "acsOperatorID": "CAS_OPERD_DR", - "authenticationValue": "BpkCBkMndAAAAABkhAEkdYR0cUU=", + "acsOperatorID": "10078025", + "authenticationValue": "BpkCBIU4VgAAAABkhAJTdYknEmE=", "eci": "05", "messageExtension": [ { @@ -920,7 +878,7 @@ Datos requeridos en la petición API "id": "A000000003-003", "criticalityIndicator": false, "data": { - "chAccReqID": "PZFPk0jJzA/4p5cWcAufzU0vPnEWCABOuPE4vLp/FNk=", + "chAccReqID": "MUHZx0nojuVVAZJwPD4CWps0RuxUPxepI8sk57Yd/s4=", "authPayProcessReqInd": "01", "version": "1.0", "authPayCredStatus": "Y", @@ -933,8 +891,9 @@ Datos requeridos en la petición API "whiteListStatus": "Y", "deviceChannel": "03", "messageCategory": "PA", - "authMethod": "FRICTIONLESS_AUTHENTICATION", - "authTimestamp": "2024-05-03T22:46:20+00:00" + "authMethod": "01", + "authTimestamp": "2024-09-09T20:52:36+00:00", + "transactionID": 248013 } ``` @@ -942,8 +901,6 @@ Datos requeridos en la petición API --- - - ## Pagos a Plazos Una transacción a plazos es aquella en la que el monto total de la compra se divide en pagos periódicos más pequeños a lo largo de un período de tiempo determinado. Estos pagos pueden incluir intereses u otras tarifas asociadas con la financiación de la compra. @@ -958,27 +915,11 @@ A diferencia de una transacción recurrente, en una transacción a plazos, el ti * **Financiación de productos o servicios:** Como la compra de muebles para el hogar, equipos electrónicos, o servicios médicos que ofrecen opciones de financiación a plazos. * **Planes de pago de vacaciones:** Agencias de viajes que ofrecen la opción de pagar las vacaciones en varios pagos antes de la fecha del viaje -Aplica también para: - -* **Pago al finalizar el servicio:** el monto es desconocido o indefinido antes de la compra. -* **Pago a un clic:** pago recurrente con cantidades fijas/frecuencia fija -* **Tarjeta Guardada en una Wallet Digital:** pago recurrente combinado con compra única -* Modelo de Agente (AN 7792 dice que se envía 85) -* Cantidad final desconocida o indefinida antes de la compra (AN 7792 dice que se envía 86) -* Pago recurrente con cantidades fijas/frecuencia fija -* Pago recurrente con cantidades fijas/frecuencia fija y prueba gratuita -* Pago recurrente con cantidades fijas/frecuencia variable -* Pago recurrente con cantidades variables/frecuencia fija -* Pago recurrente con cantidades variables/frecuencia variable -* Pago recurrente combinado con compra única -* Pago recurrente con límite fijo o umbral - - -***Para VISA está disponible el flujo de pago recurrente a través del DAF*** +***Para VISA está disponible el flujo de pagos a plazo a través del DAF*** **Primera Autenticación** -Antes de realizar una solicitud 3RI, debe haberse realizado una autenticación EMV 3DS donde el titular de la tarjeta esté disponible para autenticarse. Esta autenticación inicial puede utilizarse para la autorización asociada a la primera entrega de los bienes/servicios. +Antes de realizar una solicitud 3RI, debe haberse realizado una autenticación EMV 3DS donde el titular de la tarjeta esté disponible para autenticarse. ### MASTERCARD @@ -995,7 +936,7 @@ Antes de realizar una solicitud 3RI, debe haberse realizado una autenticación E "acctNumber": "5107000000010018", "cardExpiryDate": "2902", "redirectURI": "https://www.placetopay.com/web", - "purchaseAmount": "10", + "purchaseAmount": "1000", "purchaseCurrency": "USD", "reference": "Enero 2024", "messageVersion": "2.2.0" @@ -1020,9 +961,9 @@ Antes de realizar una solicitud 3RI, debe haberse realizado una autenticación E ```json { "action": "redirect", - "sessionToken": "ae30396c70e0ee6c23324f7c5b0390960df2b9ebeb70996a1fc9315cc34bcb6c", - "redirectURL": "https://3dss-dev.placetopay.ws/threeds/v2x/sessions/1262/ae30396c70e0ee6c23324f7c5b0390960df2b9ebeb70996a1fc9315cc34bcb6c", - "transactionID": 1306 + "sessionToken": "d6aa0439b5f0e29e6a9413321962cf962593130717098cbcde322b6bb50808fb", + "redirectURL": "https://3dss-test.placetopay.com/threeds/v2x/sessions/86048/d6aa0439b5f0e29e6a9413321962cf962593130717098cbcde322b6bb50808fb", + "transactionID": 248014 } ``` @@ -1031,25 +972,6 @@ Antes de realizar una solicitud 3RI, debe haberse realizado una autenticación E ### VISA -***Para Visa está disponible el flujo de pago dividido a través del DAF a partir de Abríl de 2024. Consultar para más detalle sobre VISA DAF*** - -**Prerrequisitos:** - -1. El identificador de comercio de ***Visa Merchant ID VMID*** deberá estar disponible en la subscripción. -2. El rango de tarjetas debe soportar el procesamiento con DAF - -Datos requeridos en la petición API - -**Datos DAF:** las llaves adicionales que se deberán enviar para que se aplique el DAF con VISA son los siguientes - -* billAddrCity -* billAddrCountry -* billAddrLine1 -* billAddrPostCode -* billAddrState -* email -* mobilePhone - ***Request Lookup*** ```json @@ -1062,7 +984,7 @@ Datos requeridos en la petición API "purchaseInstalData": "2", "acctNumber": "4931119220729333", "cardExpiryDate": "2902", - "purchaseAmount": "1.02", + "purchaseAmount": "1000", "redirectURI": "https://www.placetopay.com/web", "purchaseCurrency": "USD", "reference": "Enero 2024", @@ -1106,9 +1028,9 @@ Datos requeridos en la petición API ```json { "action": "redirect", - "sessionToken": "b3a0ce35a97aa1417f666c1f10151983a9bdb7b3f81966f721b290f1862b27a3", - "redirectURL": "https://3dss-dev.placetopay.ws/threeds/v2x/sessions/1265/b3a0ce35a97aa1417f666c1f10151983a9bdb7b3f81966f721b290f1862b27a3", - "transactionID": 1309 + "sessionToken": "96c03fe78346d11024057dfccbc8eed58b736de36631c8ff25e5c154386ade1f", + "redirectURL": "https://3dss-test.placetopay.com/threeds/v2x/sessions/86104/96c03fe78346d11024057dfccbc8eed58b736de36631c8ff25e5c154386ade1f", + "transactionID": 248070 } ``` @@ -1117,7 +1039,7 @@ Datos requeridos en la petición API **Autenticaciones posteriores** -Envíe una solicitud 3RI por el valor del segundo bien/servicio. +Envíe una solicitud 3RI por el valor del pago a plazos ### MASTERCARD @@ -1126,15 +1048,18 @@ Envíe una solicitud 3RI por el valor del segundo bien/servicio. ```json { "deviceChannel": "03", - "threeRIInd": "01", + "threeRIInd": "02", + "recurringExpiry": "20250101", + "recurringFrequency": "2", + "purchaseInstalData": "2", "threeDSRequestorPriorAuthenticationInfo": { "threeDSReqPriorAuthMethod": "CARDHOLDER_CHALLENGE_OCCURRED", - "threeDSReqPriorAuthTimestamp": "2024-08-22T13:16:01+00:00", - "threeDSReqPriorRef": "1192ffe6-6691-45e2-8ac9-a611cf122a9a" + "threeDSReqPriorAuthTimestamp": "2024-09-10T16:12:47+00:00", + "threeDSReqPriorRef": "51bbcd10-0c31-4efc-ad49-ba9bdea2f413" }, "acctNumber": "5107000000010018", "cardExpiryDate": "2902", - "purchaseAmount": "5", + "purchaseAmount": "500", "redirectURI": "https://www.placetopay.com/web", "purchaseCurrency": "USD", "reference": "Febrero 2024", @@ -1144,7 +1069,7 @@ Envíe una solicitud 3RI por el valor del segundo bien/servicio. **deviceChannel:** 03 indica que el canal es 3RI -**threeRIInd:** 01 indica que la transacción es recurrente +**threeRIInd:** 02 indica que la transacción es a plazos **threeDSReqPriorAuthMethod:** Método que fue usado por el tarjetahabiente para la autenticación. 01 sin fricción, 02 con fricción, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo @@ -1152,7 +1077,7 @@ Envíe una solicitud 3RI por el valor del segundo bien/servicio. **threeDSReqPriorRef:** El ID otorgado por el ACS en la transacción previa ***primera autenticación***, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo -**threeDSReqPriorAuthData:** El ID otorgado por el DS en la transacción previa ***primera autenticación***, si este dato no es enviado MPI lo asigna, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo +**threeDSReqPriorAuthData:** El ID otorgado por el DS en la transacción previa ***primera autenticación***, si este dato no es enviado 3DSS lo asigna, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo ***Response Lookup*** @@ -1161,22 +1086,23 @@ Envíe una solicitud 3RI por el valor del segundo bien/servicio. { "action": "continue", "messageType": "ARes", - "threeDSServerTransID": "c03e0003-ef69-4ee9-8938-3083ba2f2839", - "acsReferenceNumber": "PTOPID", - "acsTransID": "766dbd1d-9736-408c-b7c6-7a6ba352e5b2", + "threeDSServerTransID": "f5e8b9c4-5cfd-461d-9115-e51fe7d5c42a", + "acsReferenceNumber": "3DS_LOA_ACS_EISF_020200_00539", + "acsTransID": "98d5739a-c623-4512-9f87-a48368848d44", "dsReferenceNumber": "3DS_LOA_DIS_PPFU_020100_00010", - "dsTransID": "cf2735c9-c4d1-4cc1-869d-6901c8f9f58f", + "dsTransID": "def67c44-653a-4879-b500-935d8429b4a4", "messageVersion": "2.2.0", - "authenticationValue": "xgSo/jtXAAAAAAAAAAAAAAAAAAA=", + "acsOperatorID": "ACS-V210-ACS-PLACETOPAY-11174", + "authenticationValue": "xgRKM8pzAAAAAAAAAAAAAAAAAAA=", "eci": "07", "transStatus": "Y", "whiteListStatusSource": "03", "whiteListStatus": "Y", "deviceChannel": "03", "messageCategory": "PA", - "authMethod": "FRICTIONLESS_AUTHENTICATION", - "authTimestamp": "2024-05-09T16:06:56+00:00", - "transactionID": 1318 + "authMethod": "01", + "authTimestamp": "2024-09-10T16:16:19+00:00", + "transactionID": 248067 } ``` @@ -1211,12 +1137,12 @@ Datos requeridos en la petición API "threeRIInd": "02", "threeDSRequestorPriorAuthenticationInfo": { "threeDSReqPriorAuthMethod": "CARDHOLDER_CHALLENGE_OCCURRED", - "threeDSReqPriorAuthTimestamp": "2024-05-03T22:44:18+00:00", - "threeDSReqPriorRef": "052cd8e3-5678-4464-8787-8d1fa9758356" + "threeDSReqPriorAuthTimestamp": "2024-09-10T16:35:31+00:00", + "threeDSReqPriorRef": "f0bb9172-018d-42ae-b2ad-715e274bddef" }, "acctNumber": "4931119220729333", "cardExpiryDate": "2902", - "purchaseAmount": "1.00", + "purchaseAmount": "500", "redirectURI": "https://www.placetopay.com/web", "purchaseCurrency": "USD", "reference": "Febrero 2024", @@ -1244,7 +1170,7 @@ Datos requeridos en la petición API **threeDSReqPriorRef:** El ID otorgado por el ACS en la transacción previa ***primera autenticación***, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo -**threeDSReqPriorAuthData:** El ID otorgado por el DS en la transacción previa **primera autenticación**, si este dato no es enviado MPI lo asigna, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo +**threeDSReqPriorAuthData:** El ID otorgado por el DS en la transacción previa **primera autenticación**, si este dato no es enviado 3DSS lo asigna, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo **Datos DAF:** las llaves adicionales que se deberán enviar para que se aplique el DAF con VISA son los siguientes @@ -1263,14 +1189,14 @@ Datos requeridos en la petición API { "action": "continue", "messageType": "ARes", - "threeDSServerTransID": "a2de0e4d-fee5-4ac3-a5ec-8f763d73456b", - "acsReferenceNumber": "PTOPID", - "acsTransID": "6e56cb8c-c9a5-4e3c-aa16-21f29cd962f6", + "threeDSServerTransID": "50709e2a-4dad-4c60-acaa-c5d3e1ede924", + "acsReferenceNumber": "3DS_LOA_ACS_EISF_020200_00539V3", + "acsTransID": "3cdfa009-4018-4230-a72b-658587a5794c", "dsReferenceNumber": "3DS_LOA_DIS_PPFU_020100_00010", - "dsTransID": "8be55ee3-dc8d-4dd2-ba46-656d569fca35", + "dsTransID": "72455b8f-5a57-4716-93fe-b72d3878805b", "messageVersion": "2.2.0", - "acsOperatorID": "CAS_OPERD_DR", - "authenticationValue": "BpkCBkMndAAAAABkhAEkdYR0cUU=", + "acsOperatorID": "10078025", + "authenticationValue": "BpkCBSMnAAAAAMNQhAJUdYknEmE=", "eci": "05", "messageExtension": [ { @@ -1278,7 +1204,7 @@ Datos requeridos en la petición API "id": "A000000003-003", "criticalityIndicator": false, "data": { - "chAccReqID": "PZFPk0jJzA/4p5cWcAufzU0vPnEWCABOuPE4vLp/FNk=", + "chAccReqID": "MUHZx0nojuVVAZJwPD4CWps0RuxUPxepI8sk57Yd/s4=", "authPayProcessReqInd": "01", "version": "1.0", "authPayCredStatus": "Y", @@ -1291,8 +1217,9 @@ Datos requeridos en la petición API "whiteListStatus": "Y", "deviceChannel": "03", "messageCategory": "PA", - "authMethod": "FRICTIONLESS_AUTHENTICATION", - "authTimestamp": "2024-05-03T22:46:20+00:00" + "authMethod": "01", + "authTimestamp": "2024-09-10T19:45:25+00:00", + "transactionID": 248109 } ``` @@ -1319,8 +1246,8 @@ Los Envíos divididos permiten a los comerciantes solicitar un nuevo CAVV para o ***Casos de Uso:*** -* Pedidos con múltiples artículos: un cliente realiza un pedido de varios productos que no están todos disponibles en el almacén al mismo tiempo. Por lo tanto, el comerciante decide enviar los artículos en varias entregas, dependiendo de la disponibilidad. -* Reserva de un paquete de viaje: un cliente reserva un paquete de viaje completo a través de una agencia de viajes en línea. El paquete incluye: un vuelo internacional, una estadía en un hotel y un tour guiado. Sin embargo, cada componente del paquete se confirma y cobra en diferentes momentos debido a las políticas de reserva de la agencia. +* **Pedidos con múltiples artículos:** un cliente realiza un pedido de varios productos que no están todos disponibles en el almacén al mismo tiempo. +Por lo tanto, el comerciante decide enviar los artículos en varias entregas, dependiendo de la disponibilidad. | Evento | Valor | Descripción | @@ -1338,11 +1265,10 @@ Los Envíos divididos permiten a los comerciantes solicitar un nuevo CAVV para o **Primera Autenticación** -Autenticación inicial por el importe total de la orden. +***Autenticación inicial por el importe total de la orden.*** Antes de realizar una solicitud 3RI, debe haberse realizado una autenticación EMV 3DS donde el titular de la tarjeta esté disponible para autenticarse por el valor total del pedido. Esta autenticación inicial puede utilizarse para la autorización asociada a la primera entrega de los bienes/servicios. - ### MASTERCARD ***Request Lookup*** @@ -1375,9 +1301,9 @@ Antes de realizar una solicitud 3RI, debe haberse realizado una autenticación E ```json { "action": "redirect", - "sessionToken": "db1c9baee5a5191aeda5845046ff7eb816b1fc7295d718787aa7f5a00750d607", - "redirectURL": "https://3dss-dev.placetopay.ws/threeds/v2x/sessions/1768/db1c9baee5a5191aeda5845046ff7eb816b1fc7295d718787aa7f5a00750d607", - "transactionID": 1812 + "sessionToken": "dc6c2a30c763d7ce640dcf0a98b5d172e3f86c62c3dea3ea1175469d0e6befae", + "redirectURL": "https://3dss-test.placetopay.com/threeds/v2x/sessions/86152/dc6c2a30c763d7ce640dcf0a98b5d172e3f86c62c3dea3ea1175469d0e6befae", + "transactionID": 248118 } ``` @@ -1385,25 +1311,6 @@ Antes de realizar una solicitud 3RI, debe haberse realizado una autenticación E ### VISA -***Para Visa está disponible el flujo de pago dividido a través del DAF a partir de Abríl de 2024. Consultar para más detalle sobre VISA DAF*** - -**Prerrequisitos:** - -1. El identificador de comercio de **Visa Merchant ID VMID** deberá estar disponible en la subscripción. -2. El rango de tarjetas debe soportar el procesamiento con DAF - -Datos requeridos en la petición API - -**Datos DAF:** las llaves adicionales que se deberán enviar para que se aplique el DAF con VISA son los siguientes - -* billAddrCity -* billAddrCountry -* billAddrLine1 -* billAddrPostCode -* billAddrState -* email -* mobilePhone - ***Request Lookup*** ```json @@ -1411,24 +1318,12 @@ Datos requeridos en la petición API "deviceChannel": "02", "threeDSAuthenticationInd": "01", "threeDSChallengeInd": "04", - "recurringExpiry": "20260101", - "recurringFrequency": "2", "acctNumber": "4931119220729333", "cardExpiryDate": "2902", "purchaseAmount": "167", "redirectURI": "https://www.placetopay.com/web", "purchaseCurrency": "USD", "reference": "Enero 2024", - "billAddrCity": "Medellín", - "billAddrCountry": "COL", - "billAddrLine1": "Carrera 65 # 45 - 20", - "billAddrPostCode": "050004", - "billAddrState": "ANT", - "email": "john.doe@evertecinc.com", - "mobilePhone": { - "cc": "57", - "subscriber": "30011122333" - }, "messageVersion": "2.2.0" } ``` @@ -1439,25 +1334,15 @@ Datos requeridos en la petición API **threeDSChallengeInd:** 04: el desafío es obligatorio -**Datos DAF:** las llaves adicionales que se deberán enviar para que se aplique el DAF con VISA son los siguientes - -* billAddrCity -* billAddrCountry -* billAddrLine1 -* billAddrPostCode -* billAddrState -* email -* mobilePhone - ***Response Lookup*** ```json { "action": "redirect", - "sessionToken": "db1c9baee5a5191aeda5845046ff7eb816b1fc7295d718787aa7f5a00750d607", - "redirectURL": "https://3dss-dev.placetopay.ws/threeds/v2x/sessions/1768/db1c9baee5a5191aeda5845046ff7eb816b1fc7295d718787aa7f5a00750d607", - "transactionID": 1900 + "sessionToken": "1e7c2e6f2516a07020f30f8e5ef63bca7de42e16ac9498b61f2a8efd5ba52968", + "redirectURL": "https://3dss-test.placetopay.com/threeds/v2x/sessions/86160/1e7c2e6f2516a07020f30f8e5ef63bca7de42e16ac9498b61f2a8efd5ba52968", + "transactionID": 248126 } ``` **Actión:** redirect indica que la API retornara un redirectURL que deberá ser consumido para continuar con el flujo @@ -1499,7 +1384,7 @@ Envíe una solicitud 3RI por el valor del segundo bien/servicio. **threeDSReqPriorRef:** El ID otorgado por el ACS en la transacción previa ***primera autenticación***, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo -**threeDSReqPriorAuthData:** El ID otorgado por el DS en la transacción previa ***primera autenticación***, si este dato no es enviado MPI lo asigna, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo +**threeDSReqPriorAuthData:** El ID otorgado por el DS en la transacción previa ***primera autenticación***, si este dato no es enviado 3DSS lo asigna, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo ***Response Lookup*** @@ -1508,22 +1393,23 @@ Envíe una solicitud 3RI por el valor del segundo bien/servicio. { "action": "continue", "messageType": "ARes", - "threeDSServerTransID": "26a0f527-c4ba-4543-a1f3-784df8f9044b", - "acsReferenceNumber": "DS_LOA_DIS_PPFU_020100_00010", - "acsTransID": "69dbc0bf-2675-4ea8-8117-015fdd2b8809", + "threeDSServerTransID": "4159591c-bb88-4321-a295-0e6397377d3b", + "acsReferenceNumber": "3DS_LOA_ACS_EISF_020200_00539", + "acsTransID": "b4ec2f82-106b-469b-897d-f2aa37bbf25f", "dsReferenceNumber": "3DS_LOA_DIS_PPFU_020100_00010", - "dsTransID": "85e4c318-1639-4af8-ba25-5684c7df21a0", + "dsTransID": "dc477252-ff8d-433d-b44a-4f8edbb0cae8", "messageVersion": "2.2.0", - "authenticationValue": "AAAAAAAAAAAAAAAAAAAAAAAAAAA=", + "acsOperatorID": "ACS-V210-ACS-PLACETOPAY-11174", + "authenticationValue": "xgTkbC8MAAAAAAAAAAAAAAAAAAA=", "eci": "07", "transStatus": "Y", "whiteListStatusSource": "03", "whiteListStatus": "Y", "deviceChannel": "03", "messageCategory": "PA", - "authMethod": "FRICTIONLESS_AUTHENTICATION", - "authTimestamp": "2024-08-14T16:17:52+00:00", - "transactionID": 1813 + "authMethod": "01", + "authTimestamp": "2024-09-10T20:19:30+00:00", + "transactionID": 248121 } ``` @@ -1531,25 +1417,6 @@ Envíe una solicitud 3RI por el valor del segundo bien/servicio. ### VISA -***Para Visa está disponible el flujo de pago dividido a través del DAF a partir de Abríl de 2024. Consultar para más detalle sobre VISA DAF*** - -**Prerrequicitos:** - -1. El identificador de comercio de ***Visa Merchant ID VMID*** deberá estar disponible en la subscripción. -2. El rango de tarjetas debe soportar el procesamiento con DAF - -Datos requeridos en la petición API - -**Datos DAF:** las llaves adicionales que se deberán enviar para que se aplique el DAF con VISA son los siguientes - -* billAddrCity -* billAddrCountry -* billAddrLine1 -* billAddrPostCode -* billAddrState -* email -* mobilePhone - ***Request Lookup*** ```json @@ -1558,8 +1425,8 @@ Datos requeridos en la petición API "threeRIInd": "06", "threeDSRequestorPriorAuthenticationInfo": { "threeDSReqPriorAuthMethod": "CARDHOLDER_CHALLENGE_OCCURRED", - "threeDSReqPriorAuthTimestamp": "2024-08-16T19:27:01+00:00", - "threeDSReqPriorRef": "59dd1fe3-1b7a-416c-93f4-fdc5b81836c5" + "threeDSReqPriorAuthTimestamp": "2024-09-10T20:33:55+00:00", + "threeDSReqPriorRef": "68ea3861-fa27-429b-8633-ff3f6a288f71" }, "acctNumber": "4931119220729333", "cardExpiryDate": "2902", @@ -1567,16 +1434,6 @@ Datos requeridos en la petición API "redirectURI": "https://www.placetopay.com/web", "purchaseCurrency": "USD", "reference": "Febrero 2024", - "billAddrCity": "Medellín", - "billAddrCountry": "COL", - "billAddrLine1": "Carrera 65 # 45 - 20", - "billAddrPostCode": "050004", - "billAddrState": "ANT", - "email": "john.doe@evertecinc.com", - "mobilePhone": { - "cc": "57", - "subscriber": "30011122333" - }, "messageVersion": "2.2.0" } ``` @@ -1591,17 +1448,7 @@ Datos requeridos en la petición API **threeDSReqPriorRef:** El ID otorgado por el ACS en la transacción previa ***primera autenticación***, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo -**threeDSReqPriorAuthData:** El ID otorgado por el DS en la transacción previa ***primera autenticación***, si este dato no es enviado MPI lo asigna, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo - -**Datos DAF:** las llaves adicionales que se deberán enviar para que se aplique el DAF con VISA son los siguientes - -* billAddrCity -* billAddrCountry -* billAddrLine1 -* billAddrPostCode -* billAddrState -* email -* mobilePhone +**threeDSReqPriorAuthData:** El ID otorgado por el DS en la transacción previa ***primera autenticación***, si este dato no es enviado 3DSS lo asigna, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo ***Response Lookup*** @@ -1610,36 +1457,23 @@ Datos requeridos en la petición API { "action": "continue", "messageType": "ARes", - "threeDSServerTransID": "4cda716a-fd92-4ee6-8ff2-7b5763468c5d", - "acsReferenceNumber": "DS_LOA_DIS_PPFU_020100_00010", - "acsTransID": "0dc71cc9-d64b-44fb-9388-12db4ae1e6f7", + "threeDSServerTransID": "87b8930d-8523-4083-8780-67adf3aeca96", + "acsReferenceNumber": "3DS_LOA_ACS_EISF_020200_00539V3", + "acsTransID": "b02b97b8-6748-4ecb-9f42-441b7d83d9cd", "dsReferenceNumber": "3DS_LOA_DIS_PPFU_020100_00010", - "dsTransID": "b5d81f03-d1e5-45ae-a9da-e9668f8e4c67", + "dsTransID": "26281147-cee2-4683-a538-c70fad690a08", "messageVersion": "2.2.0", - "authenticationValue": "AAAAAAAAAAAAAAAAAAAAAAAAAAA=", + "acsOperatorID": "10078025", + "authenticationValue": "AJkCBxaRcQAAAASwhAJUdYknEmE=", "eci": "05", - "messageExtension": [ - { - "name": "DAF Extension", - "id": "A000000003-003", - "criticalityIndicator": false, - "data": { - "chAccReqID": "uOQxQ7h7IQXWsmbrLh/46ikEVrRUXCwi8uGjMTUAIfQ=", - "authPayProcessReqInd": "01", - "version": "1.0", - "authPayCredStatus": "Y", - "dafAdvice": "01" - } - } - ], "transStatus": "Y", "whiteListStatusSource": "03", "whiteListStatus": "Y", "deviceChannel": "03", "messageCategory": "PA", - "authMethod": "FRICTIONLESS_AUTHENTICATION", - "authTimestamp": "2024-08-16T19:30:21+00:00", - "transactionID": 1901 + "authMethod": "01", + "authTimestamp": "2024-09-10T20:35:17+00:00", + "transactionID": 248127 } ``` @@ -1659,8 +1493,8 @@ Enviar una solicitud 3RI por el valor del tercer y último bien/servicio. "threeRIInd": "06", "threeDSRequestorPriorAuthenticationInfo": { "threeDSReqPriorAuthMethod": "CARDHOLDER_CHALLENGE_OCCURRED", - "threeDSReqPriorAuthTimestamp": "2024-08-14T16:16:01+00:00", - "threeDSReqPriorRef": "bd8571cb-f4f3-4ec6-ac23-d7ec11038c1c" + "threeDSReqPriorAuthTimestamp": "2024-09-10T20:16:01+00:00", + "threeDSReqPriorRef": "49c34627-aa6b-41dc-bdc8-e21c0276d9ce" }, "acctNumber": "5107000000010018", "cardExpiryDate": "2902", @@ -1682,7 +1516,7 @@ Enviar una solicitud 3RI por el valor del tercer y último bien/servicio. **threeDSReqPriorRef:** El ID otorgado por el ACS en la transacción previa ***primera autenticación***, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo -**threeDSReqPriorAuthData:** El ID otorgado por el DS en la transacción previa ***primera autenticación***, si este dato no es enviado MPI lo asigna, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo +**threeDSReqPriorAuthData:** El ID otorgado por el DS en la transacción previa ***primera autenticación***, si este dato no es enviado 3DSS lo asigna, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo ***Response Lookup*** @@ -1691,22 +1525,23 @@ Enviar una solicitud 3RI por el valor del tercer y último bien/servicio. { "action": "continue", "messageType": "ARes", - "threeDSServerTransID": "38744bb5-9f72-400d-8aaa-0d555afbd165", - "acsReferenceNumber": "DS_LOA_DIS_PPFU_020100_00010", - "acsTransID": "917f6e12-4b15-4553-906a-a9bc272aaf39", + "threeDSServerTransID": "bc925646-c654-4ba2-9e0a-9afaaa5684cc", + "acsReferenceNumber": "3DS_LOA_ACS_EISF_020200_00539", + "acsTransID": "187648b7-ae15-4da6-a5df-f7298db768d9", "dsReferenceNumber": "3DS_LOA_DIS_PPFU_020100_00010", - "dsTransID": "3c3cf1e4-3806-4e9c-b7ca-f2f6577d8440", + "dsTransID": "a0a446cd-0767-4fa7-942b-e94571f1f37c", "messageVersion": "2.2.0", - "authenticationValue": "AAAAAAAAAAAAAAAAAAAAAAAAAAA=", + "acsOperatorID": "ACS-V210-ACS-PLACETOPAY-11174", + "authenticationValue": "xgSlHx+5AAAAAAAAAAAAAAAAAAA=", "eci": "07", "transStatus": "Y", "whiteListStatusSource": "03", "whiteListStatus": "Y", "deviceChannel": "03", "messageCategory": "PA", - "authMethod": "FRICTIONLESS_AUTHENTICATION", - "authTimestamp": "2024-08-14T16:31:27+00:00", - "transactionID": 1814 + "authMethod": "01", + "authTimestamp": "2024-09-10T20:23:36+00:00", + "transactionID": 248122 } ``` @@ -1715,24 +1550,6 @@ Enviar una solicitud 3RI por el valor del tercer y último bien/servicio. ### VISA -***Para Visa está disponible el flujo de pago dividido a través del DAF a partir de Abríl de 2024. Consultar para más detalle sobre VISA DAF*** - -**Prerequicitos:** - -1. El identificador de comercio de **Visa Merchant ID VMID** deberá estar disponible en la subscripción. -2. El rango de tarjetas debe soportar el procesamiento con DAF - -Datos requeridos en la petición API - -**Datos DAF:** las llaves adicionales que se deberán enviar para que se aplique el DAF con VISA son los siguientes - -* billAddrCity -* billAddrCountry -* billAddrLine1 -* billAddrPostCode -* billAddrState -* email -* mobilePhone ***Request Lookup*** @@ -1742,8 +1559,8 @@ Datos requeridos en la petición API "threeRIInd": "06", "threeDSRequestorPriorAuthenticationInfo": { "threeDSReqPriorAuthMethod": "CARDHOLDER_CHALLENGE_OCCURRED", - "threeDSReqPriorAuthTimestamp": "2024-08-16T19:27:01+00:00", - "threeDSReqPriorRef": "59dd1fe3-1b7a-416c-93f4-fdc5b81836c5" + "threeDSReqPriorAuthTimestamp": "2024-09-10T20:33:55+00:00", + "threeDSReqPriorRef": "68ea3861-fa27-429b-8633-ff3f6a288f71" }, "acctNumber": "4931119220729333", "cardExpiryDate": "2902", @@ -1751,16 +1568,6 @@ Datos requeridos en la petición API "redirectURI": "https://www.placetopay.com/web", "purchaseCurrency": "USD", "reference": "Febrero 2024", - "billAddrCity": "Medellín", - "billAddrCountry": "COL", - "billAddrLine1": "Carrera 65 # 45 - 20", - "billAddrPostCode": "050004", - "billAddrState": "ANT", - "email": "john.doe@evertecinc.com", - "mobilePhone": { - "cc": "57", - "subscriber": "30011122333" - }, "messageVersion": "2.2.0" } @@ -1779,56 +1586,46 @@ Datos requeridos en la petición API { "action": "continue", "messageType": "ARes", - "threeDSServerTransID": "5fda716a-fd92-4ee6-8gg4-7b5763468a6b", - "acsReferenceNumber": "DS_LOA_DIS_PPFU_020100_00010", - "acsTransID": "b0c71cc9-d64b-44fb-9388-12db4ae1a5g6", + "threeDSServerTransID": "2f9f285a-f876-4744-adaa-9c1cedf97271", + "acsReferenceNumber": "3DS_LOA_ACS_EISF_020200_00539V3", + "acsTransID": "14f3123b-d769-4a14-afea-d6bd5719d332", "dsReferenceNumber": "3DS_LOA_DIS_PPFU_020100_00010", - "dsTransID": "b5d81f04-d1e5-45ad-a9de-e9668f8e5a87", + "dsTransID": "f1ca5639-b587-4cd1-894e-fa14b97b9fdf", "messageVersion": "2.2.0", - "authenticationValue": "AAAAAAAAAAAAAAAAAAAAAAAAAAA=", + "acsOperatorID": "10078025", + "authenticationValue": "AJkCAWCXJgAAADLIhAJUdYknEmE=", "eci": "05", - "messageExtension": [ - { - "name": "DAF Extension", - "id": "A000000003-003", - "criticalityIndicator": false, - "data": { - "chAccReqID": "uOQxQ7h7IQXWsmbrLh/46ikEVrRUXCwi8uGjMTUAIfQ=", - "authPayProcessReqInd": "01", - "version": "1.0", - "authPayCredStatus": "Y", - "dafAdvice": "01" - } - } - ], "transStatus": "Y", "whiteListStatusSource": "03", "whiteListStatus": "Y", "deviceChannel": "03", "messageCategory": "PA", - "authMethod": "FRICTIONLESS_AUTHENTICATION", - "authTimestamp": "2024-08-16T19:30:21+00:00", - "transactionID": 1902 + "authMethod": "01", + "authTimestamp": "2024-09-10T20:38:23+00:00", + "transactionID": 248129 } ``` -**Actión:** redirect indica que la API retornara un redirectURL que deberá ser consumido para continuar con el flujo +**Actión:** continue indica que la API retornara la información de la autenticación, y por ende no es necesario consumir endpoints adicionales para continuar con el flujo --- - - - ## Envío retrasado -Permite a los comerciantes mantener la protección de responsabilidad más allá de los 90 días después de una autenticación inicial. Los comerciantes pueden utilizar esta funcionalidad cuando, por ejemplo, un envío/servicio se retrasa más de 90 días. Si la solicitud 3RI tiene éxito, se generará un nuevo CAVV para el comerciante, otorgando otros 90 días de protección de responsabilidad. +Permite a los comerciantes mantener la protección de responsabilidad más allá de los 90 días después de una autenticación inicial. +Los comerciantes pueden utilizar esta funcionalidad cuando, por ejemplo, un envío/servicio se retrasa más de 90 días. +Si la solicitud 3RI tiene éxito, se generará un nuevo CAVV para el comerciante, otorgando otros 90 días de protección de responsabilidad. -Cuando los comerciantes soliciten un nuevo CAVV a través de una autenticación de 3RI, deben hacerlo dentro de los 90 días posteriores a la fecha de la autenticación inicial. Los comerciantes solo deben enviar este tipo de solicitudes si necesitan protección de responsabilidad más allá de los 90 días desde la autenticación inicial. Deberían retrasar la solicitud de un nuevo CAVV tanto como sea posible dentro del período de 90 días. Si el CAVV inicial ha expirado, aunque ya no proporciona protección de responsabilidad, los emisores deben considerar que aún puede ser utilizado por el comerciante como prueba de que se realizó la autenticación. +Cuando los comerciantes soliciten un nuevo CAVV a través de una autenticación de 3RI, deben hacerlo dentro de los 90 +días posteriores a la fecha de la autenticación inicial. Los comerciantes solo deben enviar este tipo de solicitudes si necesitan protección +de responsabilidad más allá de los 90 días desde la autenticación inicial. Deberían retrasar la solicitud de un nuevo CAVV tanto como sea posible +dentro del período de 90 días. Si el CAVV inicial ha expirado, aunque ya no proporciona protección de responsabilidad, los emisores deben considerar +que aún puede ser utilizado por el comerciante como prueba de que se realizó la autenticación. ***Datos a considerar al procesar envíos divididos:*** -* El nombre del solicitante 3DS **threeDSRequestorName** y el nombre del comerciante (merchantName) deben ser los mismos en la solicitud de autenticación inicial y en cada una de las solicitudes 3RI asociadas +* El nombre del solicitante 3DS **threeDSRequestorName** y el nombre del comerciante **merchantName** deben ser los mismos en la solicitud de autenticación inicial y en cada una de las solicitudes 3RI asociadas * El valor total de todas las solicitudes 3RI no debe sumar un monto mayor que el monto de la solicitud de autenticación inicial y del total de los montos ya autorizados `POST` https://3dss-dev.placetopay.ws/api/threeds/v2x/sessions @@ -1836,9 +1633,9 @@ Cuando los comerciantes soliciten un nuevo CAVV a través de una autenticación ***Casos de Uso:*** -* Preventa de productos: un cliente compra un producto en preventa, como un libro o un dispositivo electrónico que aún no está disponible. La tarjeta se carga cuando se realiza la compra, pero el producto se enviará semanas o meses después cuando esté disponible. -* Productos fuera de stock: un cliente compra un producto que no está en stock en ese momento, pero que será enviado una vez que esté disponible. La tarjeta se carga al hacer el pedido, y el producto se envía cuando el inventario se repone. -* Pedidos con envíos programados: un cliente compra varios productos, pero solicita que el envío se realice en una fecha futura específica. El pago se procesa de inmediato, pero el envío se retrasa hasta la fecha solicitada. +* **Preventa de productos:** un cliente compra un producto en preventa, como un libro o un dispositivo electrónico que aún no está disponible. La tarjeta se carga cuando se realiza la compra, pero el producto se enviará semanas o meses después cuando esté disponible. +* **Productos fuera de stock:** un cliente compra un producto que no está en stock en ese momento, pero que será enviado una vez que esté disponible. La tarjeta se carga al hacer el pedido, y el producto se envía cuando el inventario se repone. +* **Pedidos con envíos programados:** un cliente compra varios productos, pero solicita que el envío se realice en una fecha futura específica. El pago se procesa de inmediato, pero el envío se retrasa hasta la fecha solicitada. | Evento | Valor | Descripción | @@ -1888,9 +1685,9 @@ Antes de realizar una solicitud 3RI, debe haberse realizado una autenticación E ```json { "action": "redirect", - "sessionToken": "db1c9baee5a5191aeda5845046ff7eb816b1fc7295d718787aa7f5a00750d607", - "redirectURL": "https://3dss-dev.placetopay.ws/threeds/v2x/sessions/1768/db1c9baee5a5191aeda5845046ff7eb816b1fc7295d718787aa7f5a00750d607", - "transactionID": 1812 + "sessionToken": "c793365493edc34b17a7097ea8a33fdb5853d8e0da62d39ca9e49e6c021a641f", + "redirectURL": "https://3dss-test.placetopay.com/threeds/v2x/sessions/86167/c793365493edc34b17a7097ea8a33fdb5853d8e0da62d39ca9e49e6c021a641f", + "transactionID": 248133 } ``` @@ -1899,90 +1696,521 @@ Antes de realizar una solicitud 3RI, debe haberse realizado una autenticación E ### VISA -***Para Visa está disponible el flujo de pago dividido a través del DAF a partir de Abríl de 2024. Consultar para más detalle sobre VISA DAF*** - -**Prerrequisitos:** - -1. El identificador de comercio de **Visa Merchant ID VMID** deberá estar disponible en la subscripción. -2. El rango de tarjetas debe soportar el procesamiento con DAF - -Datos requeridos en la petición API +***Request Lookup*** -**Datos DAF:** las llaves adicionales que se deberán enviar para que se aplique el DAF con VISA son los siguientes +```json +{ + "deviceChannel": "02", + "threeDSAuthenticationInd": "01", + "threeDSChallengeInd": "04", + "acctNumber": "4931119220729333", + "cardExpiryDate": "2902", + "purchaseAmount": "112", + "redirectURI": "https://www.placetopay.com/web", + "purchaseCurrency": "USD", + "reference": "Enero 2024", + "messageVersion": "2.2.0" +} +``` -* billAddrCity -* billAddrCountry -* billAddrLine1 -* billAddrPostCode -* billAddrState -* email -* mobilePhone +**deviceChannel:** 02 - Navegador + +**threeDSAuthenticationInd:** 01 indica que la transacción es de pago + +**threeDSChallengeInd:** 04: el desafío es obligatorio + +***Response Lookup*** + + +```json +{ + "action": "redirect", + "sessionToken": "3dcdb5b0d1403b0b1e14348037a3c74f202bf18d73233597a07a38963721b18e", + "redirectURL": "https://3dss-test.placetopay.com/threeds/v2x/sessions/86170/3dcdb5b0d1403b0b1e14348037a3c74f202bf18d73233597a07a38963721b18e", + "transactionID": 248136 +} +``` + +**Actión:** redirect indica que la API retornara un redirectURL que deberá ser consumido para continuar con el flujo + + +**Solicitud 3RI de un bien/servicio retrasado.** + +Envíe una solicitud 3RI por el valor del segundo bien/servicio + +### MASTERCARD + +***Request Lookup*** + +```json +{ + "deviceChannel": "03", + "threeRIInd": "06", + "threeDSRequestorPriorAuthenticationInfo": { + "threeDSReqPriorAuthMethod": "CARDHOLDER_CHALLENGE_OCCURRED", + "threeDSReqPriorAuthTimestamp": "2024-09-10T21:06:02+00:00", + "threeDSReqPriorRef": "2dd8d5d0-8563-4ae5-aa9e-23d31fa6fb85" + }, + "acctNumber": "5107000000010018", + "cardExpiryDate": "2902", + "purchaseAmount": "112", + "redirectURI": "https://www.placetopay.com/web", + "purchaseCurrency": "USD", + "reference": "Febrero 2024", + "messageVersion": "2.2.0" +} +``` + +**deviceChannel:** 03 indica que el canal es 3RI + +**threeRIInd:** 06 indica que la transacción es un envío dividido o retrasado + +**threeDSReqPriorAuthMethod:** Método que fue usado por el tarjetahabiente para la autenticación. 01 sin fricción, 02 con fricción, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo + +**threeDSReqPriorAuthTimestamp:** Fecha y hora en formato UTC de la autenticación previa. El formato es C, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo + +**threeDSReqPriorRef:** El ID otorgado por el ACS en la transacción previa ***primera autenticación***, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo + +**threeDSReqPriorAuthData:** El ID otorgado por el DS en la transacción previa ***primera autenticación***, si este dato no es enviado 3DSS lo asigna, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo + +***Response Lookup*** + + +```json +{ + "action": "continue", + "messageType": "ARes", + "threeDSServerTransID": "f91b89a9-7924-48de-97ab-8cc58bc5fcc2", + "acsReferenceNumber": "3DS_LOA_ACS_EISF_020200_00539", + "acsTransID": "cc3b5ff3-9dd7-44ae-bfa0-472de466f449", + "dsReferenceNumber": "3DS_LOA_DIS_PPFU_020100_00010", + "dsTransID": "a730d64c-ddb1-4f99-8f2c-4591d00021e3", + "messageVersion": "2.2.0", + "acsOperatorID": "ACS-V210-ACS-PLACETOPAY-11174", + "authenticationValue": "xgQkuJ5tAAAAAAAAAAAAAAAAAAA=", + "eci": "07", + "transStatus": "Y", + "whiteListStatusSource": "03", + "whiteListStatus": "Y", + "deviceChannel": "03", + "messageCategory": "PA", + "authMethod": "01", + "authTimestamp": "2024-09-10T21:07:09+00:00", + "transactionID": 248135 +} +``` + +**Actión:** continue indica que la API retornara la información de la autenticación, y por ende no es necesario consumir endpoints adicionales para continuar con el flujo + +### VISA + +***Request Lookup*** + +```json +{ + "deviceChannel": "03", + "threeRIInd": "06", + "threeDSRequestorPriorAuthenticationInfo": { + "threeDSReqPriorAuthMethod": "CARDHOLDER_CHALLENGE_OCCURRED", + "threeDSReqPriorAuthTimestamp": "2024-09-10T21:10:29+00:00", + "threeDSReqPriorRef": "7f7c0594-7e0f-4b13-bd45-6d180c35ffb0" + }, + "acctNumber": "4931119220729333", + "cardExpiryDate": "2902", + "purchaseAmount": "112", + "redirectURI": "https://www.placetopay.com/web", + "purchaseCurrency": "USD", + "reference": "Febrero 2024", + "messageVersion": "2.2.0" +} +``` + +**deviceChannel:** 03 indica que el canal es 3RI + +**threeRIInd:** 06 indica que la transacción es un envío dividido o retrasado + +**threeDSReqPriorAuthMethod:** Método que fue usado por el tarjetahabiente para la autenticación. 01 sin fricción, 02 con fricción, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo + +**threeDSReqPriorAuthTimestamp:** Fecha y hora en formato UTC de la autenticación previa. El formato es C, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo + +**threeDSReqPriorRef:** El ID otorgado por el ACS en la transacción previa ***primera autenticación***, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo + +**threeDSReqPriorAuthData:** El ID otorgado por el DS en la transacción previa **primera autenticación**, si este dato no es enviado 3DSS lo asigna, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo + +***Response Lookup*** + + +```json + { + "action": "continue", + "messageType": "ARes", + "threeDSServerTransID": "0ec3a36a-3c91-4864-bfc0-730300027805", + "acsReferenceNumber": "3DS_LOA_ACS_EISF_020200_00539V3", + "acsTransID": "4483ff06-0f36-45a2-aa13-b7f88564910b", + "dsReferenceNumber": "3DS_LOA_DIS_PPFU_020100_00010", + "dsTransID": "8360727e-22ff-4c23-bef8-ba2510eaf59b", + "messageVersion": "2.2.0", + "acsOperatorID": "10078025", + "authenticationValue": "AJkCAREXeQAAACvAhAJUdYknEmE=", + "eci": "05", + "transStatus": "Y", + "whiteListStatusSource": "03", + "whiteListStatus": "Y", + "deviceChannel": "03", + "messageCategory": "PA", + "authMethod": "01", + "authTimestamp": "2024-09-10T21:12:29+00:00", + "transactionID": 248138 +} +``` + +**Actión:** redirect indica que la API retornara un redirectURL que deberá ser consumido para continuar con el flujo + +--- + +## Otros pagos/comercio entre múltiples partes + +**Otros pagos** es la categoría reservada para los escenarios de **comercio entre múltiples partes** que pueden tener lugar cuando varias partes están involucradas en el procesamiento de múltiples autorizaciones asociadas con una única reserva de viaje o cuando varias partes en sectores distintos al de viajes están involucradas en el procesamiento de múltiples autorizaciones asociadas con un único pago desde el punto de vista del titular de la tarjeta. + +En la solicitud de autenticación inicial y las solicitudes 3RI asociadas, los agentes de reservas/proveedores de servicios comerciales también deben usar las convenciones de nomenclatura y los identificadores apropiados para el caso de uso para el que están autenticando: + +* Autenticación solo en nombre de un solo comerciante +* Autenticación en nombre de varios comerciantes +* Autenticarse a sí mismos y en nombre de otro comerciante + + +De manera similar a los envíos divididos, los emisores deben realizar un seguimiento del valor total utilizando los datos de transacción tanto de autorización como de autenticación. Esto es necesario ya que el agente de reservas/proveedor de servicios del comerciante no puede realizar una solicitud 3RI para todas las partes involucradas en la transacción y, como tal, el emisor no puede asumir que la suma de todas las solicitudes 3RI será igual al total del monto de autenticación inicial, pero los montos 3RI no deben exceder el monto autenticado original. + +Agente de reservas que realiza la autenticación en nombre de un único comerciante + +El titular de una tarjeta ha reservado un artículo en el sitio web de un agente de viajes, por ejemplo, un vuelo +por valor de $395, que se debe pagar al vendedor (es decir, la aerolínea, que será el comerciante en el +sistema de autorización) o cobrar por él en el momento de la reserva, pero el agente de viajes se encarga de la autenticación. + + +| **Evento** | **Parte** | **Valor** | **Descripción** | +|--------------------------------------------------------|-------------------------|-----------|-----------------------------------------------------------------------------------------------------------------------------------------------------| +| Autenticación inicial por parte del agente de reservas | Agente de reservas | $395 | Autenticación inicial por el importe total del pedido por parte del agente de reservas | +| Autorización para bienes/servicios | Comerciante de viajes 1 | $395 | El agente de reservas proporciona el CAVV de la autenticación inicial al vendedor, lo que le permite realizar una autorización por el importe total | + + + + +**Autenticación inicial por parte del agente de reservas** + +Autenticación inicial por el importe total del pedido por parte del agente de reservas + +### MASTERCARD + +***Request Lookup*** + +```json +{ + "deviceChannel": "02", + "threeDSAuthenticationInd": "85", + "threeDSChallengeInd": "04", + "acctNumber": "5107000000010018", + "cardExpiryDate": "2902", + "redirectURI": "https://www.placetopay.com/web", + "purchaseAmount": "395", + "purchaseCurrency": "USD", + "reference": "Enero 2024", + "messageVersion": "2.2.0" +} + +``` + +**deviceChannel:** 02 - Navegador + +**threeDSAuthenticationInd:** 01 indica que la transacción es de pago + +**threeDSChallengeInd:** 04: el desafío es obligatorio + + +***Response Lookup*** + +```json +{ + "action": "redirect", + "sessionToken": "cf980dc8f7bc550243c9aa49e36902474b36dfcddd0d5671f78a924311c8bdc0", + "redirectURL": "https://3dss-test.placetopay.com/threeds/v2x/sessions/86177/cf980dc8f7bc550243c9aa49e36902474b36dfcddd0d5671f78a924311c8bdc0", + "transactionID": 248143 +} +``` + +**Actión:** redirect indica que la API retornara un redirectURL que deberá ser consumido para continuar con el flujo + + +### VISA + +***Request Lookup*** + +```json +{ + "deviceChannel": "02", + "threeDSAuthenticationInd": "01", + "threeDSChallengeInd": "04", + "acctNumber": "4931119220729333", + "cardExpiryDate": "2902", + "redirectURI": "https://www.placetopay.com/web", + "purchaseAmount": "395", + "purchaseCurrency": "USD", + "reference": "Enero 2024", + "messageVersion": "2.2.0" +} +``` + +**deviceChannel:** 02 - Navegador + +**threeDSAuthenticationInd:** 01 indica que la transacción es de pago + +**threeDSChallengeInd:** 04: el desafío es obligatorio + + +***Response Lookup*** + + +```json +{ + "action": "redirect", + "sessionToken": "c7bf55043c2d0403e87eaff8895951f70067e48a12a3d46203fd82df3da0a7c1", + "redirectURL": "https://3dss-test.placetopay.com/threeds/v2x/sessions/86180/c7bf55043c2d0403e87eaff8895951f70067e48a12a3d46203fd82df3da0a7c1", + "transactionID": 248146 +} +``` + +**Actión:** redirect indica que la API retornara un redirectURL que deberá ser consumido para continuar con el flujo + + + + +### Agente de reservas que realiza la autenticación en nombre de varios comerciantes + +Un titular de tarjeta ha reservado en un sitio web de viajes **agente de reservas** tres artículos pagaderos a cada proveedor de viajes individual **comerciante 1, 2 y 3 en el sistema de autorización**. El sitio web de viajes no está recaudando fondos, sino que realiza la autenticación en nombre de los 3 proveedores de viajes: + +* Un vuelo por $170 pagadero a la aerolínea **proveedor/comerciante 1** en el momento de la reserva +* Un hotel para el cual no se debe realizar un depósito en el momento de la reserva (el hotel **proveedor/comerciante 2 toma los datos de la tarjeta en caso de que se requiera un pago por no presentarse** +* Un alquiler de automóvil para el cual se debe realizar un depósito de $50 a la compañía de alquiler **vendedor/comerciante 3** en el momento de la reserva + + +| **Evento** | **Parte** | **Valor** | **Descripción** | +|------------------------------------------------------------|---------------------------------|-----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| Autenticación inicial por parte del agente de reservas | Agente de reservas | $220 | Autenticación inicial por parte del agente de reservas por el monto adeudado por el pedido | +| El agente de reservas realiza tres transacciones 3RI | Agente de reservas | $220 | El agente de reservas realiza tres transacciones 3RI para obtener tres CAVV independientes: Aerolínea $170, Hotel $0, Alquiler de automóvil $50 | +| Autorización para bienes/servicios (Vuelo) | Comerciante de viajes 1 | $170 | El comerciante de la aerolínea utiliza el CAVV de la transacción 3RI con un valor de 170 (y su nombre en el CAVV) para realizar la autorización del boleto de avión. | +| Autorización para bienes/servicios (Alojamiento) | Comerciante de viajes 2 (hotel) | $0 | El comerciante de alojamiento utiliza el CAVV de la transacción 3RI con un valor de 0 (y su nombre en el CAVV) para realizar la autorización para configurar un MIT. | +| Autorización para bienes/servicios (Alquiler de automóvil) | Comerciante de viajes 3 | $50 | El comerciante de alquiler de automóviles utiliza el CAVV de la transacción 3RI con un valor de 50 (y su nombre en el CAVV) para realizar la autorización del depósito. | + + + +**Autenticación inicial por parte del agente de reservas** + +Autenticación inicial por parte del agente de reservas por el monto adeudado por el pedido. + +### MASTERCARD + +***Request Lookup*** + +```json +{ + "deviceChannel": "02", + "threeDSAuthenticationInd": "85", + "threeDSChallengeInd": "04", + "acctNumber": "5107000000010018", + "cardExpiryDate": "2806", + "purchaseAmount": "220", + "redirectURI": "https://www.placetopay.com/web", + "purchaseCurrency": "USD", + "messageVersion": "2.2.0" +} +``` + +**deviceChannel:** 02 - Navegador + +**threeDSAuthenticationInd:** 85 indica que la transacción es de otros pagos + +**threeDSChallengeInd: 04:** el desafío es obligatorio + +***Response Lookup*** + +```json +{ + "action": "redirect", + "sessionToken": "a52df573f6a0a8071714958671d018030c90fc1e6cdc00ac4b7b50a35403da53", + "redirectURL": "https://3dss-test.placetopay.com/threeds/v2x/sessions/86184/a52df573f6a0a8071714958671d018030c90fc1e6cdc00ac4b7b50a35403da53", + "transactionID": 248150 +} +``` + +**Actión:** redirect indica que la API retornara un redirectURL que deberá ser consumido para continuar con el flujo + + +### VISA + +***Request Lookup*** + +```json +{ + "deviceChannel": "02", + "threeDSAuthenticationInd": "01", + "threeDSChallengeInd": "04", + "recurringExpiry": "20260101", + "recurringFrequency": "2", + "acctNumber": "4931119220729333", + "cardExpiryDate": "2902", + "purchaseAmount": "220", + "redirectURI": "https://www.placetopay.com/web", + "purchaseCurrency": "USD", + "reference": "Enero 2024", + "messageVersion": "2.2.0" +} + +``` + +**deviceChannel:** 02 - Navegador + +**threeDSAuthenticationInd:** 01 indica que la transacción es de pago + +**threeDSChallengeInd:** 04 el desafío es obligatorio + +***Response Lookup*** + +```json +{ + "action": "redirect", + "sessionToken": "e672a6977da87394e43b3da848a754f0fc0c3f73153e4adb781fc54db1e80525", + "redirectURL": "https://3dss-test.placetopay.com/threeds/v2x/sessions/86196/e672a6977da87394e43b3da848a754f0fc0c3f73153e4adb781fc54db1e80525", + "transactionID": 248162 +} +``` + +**Actión:** redirect indica que la API retornara un redirectURL que deberá ser consumido para continuar con el flujo +**Transacciones 3RI aerolínea** + +El agente de reservas realiza la transaccion 3RI para obtener el CAVV y proporcionarlo al comerciante de viajes 1 (aerolínea) + +### MASTERCARD ***Request Lookup*** ```json { - "deviceChannel": "02", - "threeDSAuthenticationInd": "01", - "threeDSChallengeInd": "04", - "recurringExpiry": "20260101", - "recurringFrequency": "2", - "acctNumber": "4931119220729333", + "deviceChannel": "03", + "threeRIInd": "85", + "threeDSRequestorPriorAuthenticationInfo": { + "threeDSReqPriorAuthMethod": "CARDHOLDER_CHALLENGE_OCCURRED", + "threeDSReqPriorAuthTimestamp": "2024-09-10T22:21:27+00:00", + "threeDSReqPriorRef": "c524216d-a19e-4a6b-ae1c-40b82c59fe38" + }, + "acctNumber": "5107000000010018", "cardExpiryDate": "2902", - "purchaseAmount": "102", + "purchaseAmount": "170", "redirectURI": "https://www.placetopay.com/web", "purchaseCurrency": "USD", - "reference": "Enero 2024", - "billAddrCity": "Medellín", - "billAddrCountry": "COL", - "billAddrLine1": "Carrera 65 # 45 - 20", - "billAddrPostCode": "050004", - "billAddrState": "ANT", - "email": "john.doe@evertecinc.com", - "mobilePhone": { - "cc": "57", - "subscriber": "30011122333" - }, + "reference": "Marzo 2024", "messageVersion": "2.2.0" } ``` -**deviceChannel:** 02 - Navegador +**deviceChannel:** 03 indica que el canal es 3RI -**threeDSAuthenticationInd:** 01 indica que la transacción es de pago +**threeRIInd:** 85 indica que la transacción de tipo otros pagos -**threeDSChallengeInd:** 04: el desafío es obligatorio +**threeDSReqPriorAuthMethod:** Método que fue usado por el tarjetahabiente para la autenticación. 01 sin fricción, 02 con fricción, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo -**Datos DAF:** las llaves adicionales que se deberán enviar para que se aplique el DAF con VISA son los siguientes +**threeDSReqPriorAuthTimestamp:** Fecha y hora en formato UTC de la autenticación previa. El formato es C, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo -* billAddrCity -* billAddrCountry -* billAddrLine1 -* billAddrPostCode -* billAddrState -* email -* mobilePhone +**threeDSReqPriorRef:** El ID otorgado por el ACS en la transacción previa (primera autenticación), consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo + +**threeDSReqPriorAuthData:** El ID otorgado por el DS en la transacción previa (primera autenticación), si este dato no es enviado 3DSS lo asigna, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo ***Response Lookup*** +```json +{ + "action": "continue", + "messageType": "ARes", + "threeDSServerTransID": "1045a464-161f-4538-a769-9a0f84e27a3d", + "acsReferenceNumber": "3DS_LOA_ACS_EISF_020200_00539", + "acsTransID": "f31f4da1-7ac1-4be4-b37a-9e28d8e4eb9e", + "dsReferenceNumber": "3DS_LOA_DIS_PPFU_020100_00010", + "dsTransID": "a0dca8a6-5fc5-49f9-96b2-8ee5c9e51508", + "messageVersion": "2.2.0", + "acsOperatorID": "ACS-V210-ACS-PLACETOPAY-11174", + "authenticationValue": "xgSFPEJIAAAAAAAAAAAAAAAAAAA=", + "eci": "07", + "transStatus": "Y", + "whiteListStatusSource": "03", + "whiteListStatus": "Y", + "deviceChannel": "03", + "messageCategory": "PA", + "authMethod": "01", + "authTimestamp": "2024-09-10T22:34:13+00:00", + "transactionID": 248159 +} +``` +**Actión:** continue indica que la API retornara la información de la autenticación, y por ende no es necesario consumir endpoints adicionales para continuar con el flujo + + +### VISA + +***Request Lookup*** ```json { - "action": "redirect", - "sessionToken": "db1c9baee5a5191aeda5845046ff7eb816b1fc7295d718787aa7f5a00750d607", - "redirectURL": "https://3dss-dev.placetopay.ws/threeds/v2x/sessions/1768/db1c9baee5a5191aeda5845046ff7eb816b1fc7295d718787aa7f5a00750d607", - "transactionID": 1900 + "deviceChannel": "03", + "threeRIInd": "11", + "threeDSRequestorPriorAuthenticationInfo": { + "threeDSReqPriorAuthMethod": "CARDHOLDER_CHALLENGE_OCCURRED", + "threeDSReqPriorAuthTimestamp": "2024-09-10T22:44:39+00:00", + "threeDSReqPriorRef": "9e4c13a7-0813-4402-9c53-687a01303f78" + }, + "acctNumber": "4931119220729333", + "cardExpiryDate": "2902", + "purchaseAmount": "170", + "redirectURI": "https://www.placetopay.com/web", + "purchaseCurrency": "USD", + "reference": "Febrero 2024", + "messageVersion": "2.2.0" } ``` -**Actión:** redirect indica que la API retornara un redirectURL que deberá ser consumido para continuar con el flujo +**deviceChannel:** 03 indica que el canal es 3RI +**threeRIInd:** 11 indica que la transacción de tipo otro pago -**Solicitud 3RI de un bien/servicio retrasado.** +***Response Lookup*** + +```json + { + "action": "continue", + "messageType": "ARes", + "threeDSServerTransID": "1a53d143-230f-47b9-b886-a201ee867489", + "acsReferenceNumber": "3DS_LOA_ACS_EISF_020200_00539V3", + "acsTransID": "179f6511-b042-41f3-939d-7f862a527751", + "dsReferenceNumber": "3DS_LOA_DIS_PPFU_020100_00010", + "dsTransID": "f5eb0bae-dccf-498e-b639-4abf5e86b162", + "messageVersion": "2.2.0", + "acsOperatorID": "10078025", + "authenticationValue": "AJkCAhAyeQAAAEJohAJUdYknEmE=", + "eci": "05", + "transStatus": "Y", + "whiteListStatusSource": "03", + "whiteListStatus": "Y", + "deviceChannel": "03", + "messageCategory": "PA", + "authMethod": "01", + "authTimestamp": "2024-09-10T22:46:32+00:00", + "transactionID": 248164 +} +``` + +**Actión:** continue indica que la API retornara la información de la autenticación, y por ende no es necesario consumir endpoints adicionales para continuar con el flujo -Envíe una solicitud 3RI por el valor del segundo bien/servicio + +**Transacciones 3RI hotel** ### MASTERCARD @@ -1991,180 +2219,257 @@ Envíe una solicitud 3RI por el valor del segundo bien/servicio ```json { "deviceChannel": "03", - "threeRIInd": "06", + "threeRIInd": "85", "threeDSRequestorPriorAuthenticationInfo": { "threeDSReqPriorAuthMethod": "CARDHOLDER_CHALLENGE_OCCURRED", - "threeDSReqPriorAuthTimestamp": "2024-08-21T16:30:35+00:00", - "threeDSReqPriorRef": "6775467f-4109-4a5b-a308-c2e628bfc289" + "threeDSReqPriorAuthTimestamp": "2024-09-10T22:21:27+00:00", + "threeDSReqPriorRef": "c524216d-a19e-4a6b-ae1c-40b82c59fe38" }, "acctNumber": "5107000000010018", "cardExpiryDate": "2902", - "purchaseAmount": "12", + "purchaseAmount": "0", "redirectURI": "https://www.placetopay.com/web", "purchaseCurrency": "USD", - "reference": "Febrero 2024", + "reference": "Abril 2024", "messageVersion": "2.2.0" } ``` **deviceChannel:** 03 indica que el canal es 3RI -**threeRIInd:** 06 indica que la transacción es un envío dividido o retrasado +**threeRIInd:** 85 indica que la transacción de tipo otros pagos -**threeDSReqPriorAuthMethod:** Método que fue usado por el tarjetahabiente para la autenticación. 01 sin fricción, 02 con fricción, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo +**threeDSReqPriorAuthMethod:** Método que fue usado por el tarjetahabiente para la autenticación. 01 sin fricción, 02 con fricción, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo **threeDSReqPriorAuthTimestamp:** Fecha y hora en formato UTC de la autenticación previa. El formato es C, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo -**threeDSReqPriorRef:** El ID otorgado por el ACS en la transacción previa ***primera autenticación***, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo +**threeDSReqPriorRef:** El ID otorgado por el ACS en la transacción previa (primera autenticación), consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo -**threeDSReqPriorAuthData:** El ID otorgado por el DS en la transacción previa ***primera autenticación***, si este dato no es enviado MPI lo asigna, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo +**threeDSReqPriorAuthData:** El ID otorgado por el DS en la transacción previa (primera autenticación), si este dato no es enviado 3DSS lo asigna, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo ***Response Lookup*** - ```json { "action": "continue", "messageType": "ARes", - "threeDSServerTransID": "f8c761e2-40a2-4a2d-91bb-189bb768a76e", - "acsReferenceNumber": "DS_LOA_DIS_PPFU_020100_00010", - "acsTransID": "967ba08b-28fb-4ad1-8181-0613a62d384e", + "threeDSServerTransID": "32c88ea6-7841-4c8b-9067-b84c99b20784", + "acsReferenceNumber": "3DS_LOA_ACS_EISF_020200_00539", + "acsTransID": "fa92fe01-84f7-4ae7-a3f1-1dd50f97ebef", "dsReferenceNumber": "3DS_LOA_DIS_PPFU_020100_00010", - "dsTransID": "1710f87d-d7ef-4ddb-a041-bb05156ca732", + "dsTransID": "634b8dc1-aa5b-48c3-b367-022156663c81", "messageVersion": "2.2.0", - "authenticationValue": "AAAAAAAAAAAAAAAAAAAAAAAAAAA=", + "acsOperatorID": "ACS-V210-ACS-PLACETOPAY-11174", + "authenticationValue": "xgRTaR2SAAAAAAAAAAAAAAAAAAA=", "eci": "07", "transStatus": "Y", "whiteListStatusSource": "03", "whiteListStatus": "Y", "deviceChannel": "03", "messageCategory": "PA", - "authMethod": "FRICTIONLESS_AUTHENTICATION", - "authTimestamp": "2024-08-21T16:32:14+00:00", - "transactionID": 163420 + "authMethod": "01", + "authTimestamp": "2024-09-10T22:36:05+00:00", + "transactionID": 248160 } ``` - **Actión:** continue indica que la API retornara la información de la autenticación, y por ende no es necesario consumir endpoints adicionales para continuar con el flujo ### VISA -***Para Visa está disponible el flujo de pago dividido a través del DAF a partir de Abríl de 2024. Consultar para más detalle sobre VISA DAF*** +***Request Lookup*** -**Prerrequicitos:** +```json +{ + "deviceChannel": "03", + "threeRIInd": "11", + "threeDSRequestorPriorAuthenticationInfo": { + "threeDSReqPriorAuthMethod": "CARDHOLDER_CHALLENGE_OCCURRED", + "threeDSReqPriorAuthTimestamp": "2024-09-10T22:44:39+00:00", + "threeDSReqPriorRef": "9e4c13a7-0813-4402-9c53-687a01303f78" + }, + "acctNumber": "4931119220729333", + "cardExpiryDate": "2902", + "purchaseAmount": "0", + "redirectURI": "https://www.placetopay.com/web", + "purchaseCurrency": "USD", + "reference": "Marzo 2024", + "messageVersion": "2.2.0" +} +``` -1. El identificador de comercio de **Visa Merchant ID VMID** deberá estar disponible en la subscripción. -2. El rango de tarjetas debe soportar el procesamiento con DAF +**deviceChannel:** 03 indica que el canal es 3RI -Datos requeridos en la petición API +**threeRIInd:** 11 indica que la transacción de tipo otros pagos -**Datos DAF:** las llaves adicionales que se deberán enviar para que se aplique el DAF con VISA son los siguientes +**threeDSReqPriorAuthMethod:** Método que fue usado por el tarjetahabiente para la autenticación. 01 sin fricción, 02 con fricción, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo -* billAddrCity -* billAddrCountry -* billAddrLine1 -* billAddrPostCode -* billAddrState -* email -* mobilePhone +**threeDSReqPriorAuthTimestamp:** Fecha y hora en formato UTC de la autenticación previa. El formato es C, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo + +**threeDSReqPriorRef:** El ID otorgado por el ACS en la transacción previa (primera autenticación), consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo + +**threeDSReqPriorAuthData:** El ID otorgado por el DS en la transacción previa (primera autenticación), si este dato no es enviado 3DSS lo asigna, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo + +***Response Lookup*** + +```json +{ + "action": "continue", + "messageType": "ARes", + "threeDSServerTransID": "b9913d5d-4980-4103-b77c-5daf0c7054b0", + "acsReferenceNumber": "3DS_LOA_ACS_EISF_020200_00539V3", + "acsTransID": "e9b7726c-6f9a-4606-afe3-09dce49f49a2", + "dsReferenceNumber": "3DS_LOA_DIS_PPFU_020100_00010", + "dsTransID": "6f9c449a-0ff3-4438-8c47-e3009ded9cd1", + "messageVersion": "2.2.0", + "acsOperatorID": "10078025", + "authenticationValue": "AJkCB4EjdQAAAAAAhAJUdYknEmE=", + "eci": "05", + "transStatus": "Y", + "whiteListStatusSource": "03", + "whiteListStatus": "Y", + "deviceChannel": "03", + "messageCategory": "PA", + "authMethod": "01", + "authTimestamp": "2024-09-10T22:48:07+00:00", + "transactionID": 248165 +} +``` + +**Actión:** continue indica que la API retornara la información de la autenticación, y por ende no es necesario consumir endpoints adicionales para continuar con el flujo + +**Transacciones 3RI alquiler de automóvil** + +El agente de reservas realiza la transacción 3RI para obtener el CAVV y proporcionarlo al comerciante de viajes 3 (alquiler automóvil) + +### MASTERCARD ***Request Lookup*** ```json { "deviceChannel": "03", - "threeRIInd": "06", + "threeRIInd": "85", "threeDSRequestorPriorAuthenticationInfo": { "threeDSReqPriorAuthMethod": "CARDHOLDER_CHALLENGE_OCCURRED", - "threeDSReqPriorAuthTimestamp": "2024-08-21T21:09:12+00:00", - "threeDSReqPriorRef": "e9c03914-1f35-49b7-b261-b26077bcaf8f" + "threeDSReqPriorAuthTimestamp": "2024-09-10T22:21:27+00:00", + "threeDSReqPriorRef": "c524216d-a19e-4a6b-ae1c-40b82c59fe38" }, - "acctNumber": "4931119220729333", + "acctNumber": "5107000000010018", "cardExpiryDate": "2902", - "purchaseAmount": "102", + "purchaseAmount": "50", "redirectURI": "https://www.placetopay.com/web", "purchaseCurrency": "USD", - "reference": "Febrero 2024", - "billAddrCity": "Medellín", - "billAddrCountry": "COL", - "billAddrLine1": "Carrera 65 # 45 - 20", - "billAddrPostCode": "050004", - "billAddrState": "ANT", - "email": "john.doe@evertecinc.com", - "mobilePhone": { - "cc": "57", - "subscriber": "30011122333" - }, + "reference": "Marzo 2024", "messageVersion": "2.2.0" } ``` **deviceChannel:** 03 indica que el canal es 3RI -**threeRIInd:** 06 indica que la transacción es un envío dividido o retrasado +**threeRIInd:** 85 indica que la transacción de tipo otros pagos **threeDSReqPriorAuthMethod:** Método que fue usado por el tarjetahabiente para la autenticación. 01 sin fricción, 02 con fricción, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo **threeDSReqPriorAuthTimestamp:** Fecha y hora en formato UTC de la autenticación previa. El formato es C, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo -**threeDSReqPriorRef:** El ID otorgado por el ACS en la transacción previa ***primera autenticación***, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo +**threeDSReqPriorRef:** El ID otorgado por el ACS en la transacción previa (primera autenticación), consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo -**threeDSReqPriorAuthData:** El ID otorgado por el DS en la transacción previa **primera autenticación**, si este dato no es enviado MPI lo asigna, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo +**threeDSReqPriorAuthData:** El ID otorgado por el DS en la transacción previa (primera autenticación), si este dato no es enviado 3DSS lo asigna, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo -**Datos DAF:** las llaves adicionales que se deberán enviar para que se aplique el DAF con VISA son los siguientes +***Response Lookup*** -* billAddrCity -* billAddrCountry -* billAddrLine1 -* billAddrPostCode -* billAddrState -* email -* mobilePhone +```json +{ + "action": "continue", + "messageType": "ARes", + "threeDSServerTransID": "c34f67dc-7a25-4977-97f7-ca1f961946be", + "acsReferenceNumber": "3DS_LOA_ACS_EISF_020200_00539", + "acsTransID": "fd189ecf-c65e-4a7d-9640-89662b850038", + "dsReferenceNumber": "3DS_LOA_DIS_PPFU_020100_00010", + "dsTransID": "4680679e-d6ed-48d2-89d2-b73de0828a57", + "messageVersion": "2.2.0", + "acsOperatorID": "ACS-V210-ACS-PLACETOPAY-11174", + "authenticationValue": "xgSELtLrAAAAAAAAAAAAAAAAAAA=", + "eci": "07", + "transStatus": "Y", + "whiteListStatusSource": "03", + "whiteListStatus": "Y", + "deviceChannel": "03", + "messageCategory": "PA", + "authMethod": "01", + "authTimestamp": "2024-09-10T22:38:11+00:00", + "transactionID": 248161 +} +``` -***Response Lookup*** +**Actión:** continue indica que la API retornara la información de la autenticación, y por ende no es necesario consumir endpoints adicionales para continuar con el flujo + + +### VISA +***Request Lookup*** ```json { + "deviceChannel": "03", + "threeRIInd": "11", + "threeDSRequestorPriorAuthenticationInfo": { + "threeDSReqPriorAuthMethod": "CARDHOLDER_CHALLENGE_OCCURRED", + "threeDSReqPriorAuthTimestamp": "2024-09-10T22:44:39+00:00", + "threeDSReqPriorRef": "9e4c13a7-0813-4402-9c53-687a01303f78" + }, + "acctNumber": "4931119220729333", + "cardExpiryDate": "2902", + "purchaseAmount": "50", + "redirectURI": "https://www.placetopay.com/web", + "purchaseCurrency": "USD", + "reference": "Mayo 2024", + "messageVersion": "2.2.0" +} +``` + +***deviceChannel:*** 03 indica que el canal es 3RI + +***threeRIInd:*** 11 indica que la transacción de tipo otros pagos + +***threeDSReqPriorAuthMethod:*** Método que fue usado por el tarjetahabiente para la autenticación. 01 sin fricción, 02 con fricción, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo + +***threeDSReqPriorAuthTimestamp:*** Fecha y hora en formato UTC de la autenticación previa. El formato es C, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo + +***threeDSReqPriorRef:*** El ID otorgado por el ACS en la transacción previa (primera autenticación), consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo + +***threeDSReqPriorAuthData:*** El ID otorgado por el DS en la transacción previa (primera autenticación), si este dato no es enviado 3DSS lo asigna, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo + +***Response Lookup*** + +```json + { "action": "continue", "messageType": "ARes", - "threeDSServerTransID": "cfa09f6a-3c1c-4847-9409-996b59d1afb2", - "acsReferenceNumber": "DS_LOA_DIS_PPFU_020100_00010", - "acsTransID": "b6f9145b-436f-4a9d-adad-42833f2f0e03", + "threeDSServerTransID": "7a64778d-45de-48ae-8c78-ec688775315d", + "acsReferenceNumber": "3DS_LOA_ACS_EISF_020200_00539V3", + "acsTransID": "d4b3bbae-5594-4c89-9cf8-ae2ac3499223", "dsReferenceNumber": "3DS_LOA_DIS_PPFU_020100_00010", - "dsTransID": "9f9c5743-952a-4fc9-bd0a-16be21996737", + "dsTransID": "5c4c3ec0-d31b-442d-81e8-86025c08cb9d", "messageVersion": "2.2.0", - "authenticationValue": "AAAAAAAAAAAAAAAAAAAAAAAAAAA=", + "acsOperatorID": "10078025", + "authenticationValue": "AJkCByOJNAAAABOIhAJUdYknEmE=", "eci": "05", - "messageExtension": [ - { - "name": "DAF Extension", - "id": "A000000003-003", - "criticalityIndicator": false, - "data": { - "chAccReqID": "uOQxQ7h7IQXWsmbrLh/46ikEVrRUXCwi8uGjMTUAIfQ=", - "authPayProcessReqInd": "01", - "version": "1.0", - "authPayCredStatus": "N" - } - } - ], "transStatus": "Y", "whiteListStatusSource": "03", "whiteListStatus": "Y", "deviceChannel": "03", "messageCategory": "PA", - "authMethod": "FRICTIONLESS_AUTHENTICATION", - "authTimestamp": "2024-08-21T21:14:38+00:00", - "transactionID": 163429 + "authMethod": "01", + "authTimestamp": "2024-09-10T22:49:54+00:00", + "transactionID": 248166 } ``` -**Actión:** redirect indica que la API retornara un redirectURL que deberá ser consumido para continuar con el flujo - ---- +**Actión:** continue indica que la API retornara la información de la autenticación, y por ende no es necesario consumir endpoints adicionales para continuar con el flujo +--- ## Transacciones con tarjeta registrada no programadas @@ -2185,7 +2490,7 @@ Las transacciones UCOF **Unscheduled card-on-file** se producen cuando un comerc ### VISA con DAF -Opción NPA: esta opción no require verificar fondos de la cuenta. +**Opción NPA:** esta opción no require verificar fondos de la cuenta. ***Request Lookup*** @@ -2293,7 +2598,7 @@ Opción NPA: esta opción no require verificar fondos de la cuenta. **threeDSReqPriorRef:** El ID otorgado por el ACS en la transacción previa ***primera autenticación***, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo -**threeDSReqPriorAuthData:** El ID otorgado por el DS en la transacción previa **primera autenticación**, si este dato no es enviado MPI lo asigna, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo +**threeDSReqPriorAuthData:** El ID otorgado por el DS en la transacción previa **primera autenticación**, si este dato no es enviado 3DSS lo asigna, consultar la sesión Obtener los datos del threeDSRequestorPriorAuthenticationInfo **Datos DAF:** las llaves adicionales que se deberán enviar para que se aplique el DAF con VISA son los siguientes @@ -2380,37 +2685,20 @@ Para obtener los datos requeridos se deberá de lanzar la transacción tipo CIT } ``` +--- + ## Otros casos * Delayed Shipment **threeDSAuthenticationInd 09, threeRIInd 15** aplica par EMV 3DS 2.2 with Bridging Message Extension o par la versión EMV 3DS 2.3.1 * Split Shipment **threeDSAuthenticationInd 08, threeRIInd 06** aplica par EMV 3DS 2.2 with Bridging Message Extension o par la versión EMV 3DS 2.3.1 * Split Payment **threeDSAuthenticationInd 10, threeRIInd 16** aplica par EMV 3DS 2.2 with Bridging Message Extension o par la versión EMV 3DS 2.3.1 -## Preguntas frecuentes - -* **¿Es posible Agregar Tarjeta ***"threeDSAuthenticationInd": "04"*** y hacer la Autenticación de un Pago (PA) al mismo tiempo?** - - No es posible. En el proceso de Agregar Tarjeta a un comercio para validar la identidad de la tarjeta habiente, es permitido enviar un monto, en cuyo caso se descontará el monto para la verificación de fondos y DEBE ser reembolsado posteriormente por el comercio, lo cual no representa una Autenticación Pago en sí mismo. - - Es necesario enviar posterior al proceso de Agregar Tarjeta otra autenticación con el monto a Autenticacior - -* **¿Se puede usar una CIT NPA como PriorInformation para una MIT PA?** - - Es posible UNICAMENTE en el escenario de un pago único, en este caso, se podrá utilizar una CIT NPA de tipo “Agregar Tarjeta” **este es el único caso confirmado para este uso**. La transacción MIT deberá mandarse con el indicativo threeRIInd=81 **Unscheduled Credential-on-File**, este tipo de transacción no requiere ningún valor de recurrencia **recurringExpiry, recurringFrequency** únicamente el monto que se va a pagar. Eventualmente otros casos de uso pueden ser agregados en versiones del Protocolo. Esto aplica exclusivamente para VISA usando la extensión DAF - - La razón principal es que estas dos categorías de transacciones tienen naturalezas diferentes y propósitos distintos: - - 1. **MIT (Merchant Initiated Transaction):** Una MIT es iniciada por el comerciante en lugar del titular de la tarjeta. Por lo general, las MIT se utilizan para pagos recurrentes, como suscripciones mensuales o anuales, donde el comerciante tiene la autorización del titular de la tarjeta para cargar periódicamente el monto acordado en su tarjeta. En las MIT, la autenticación suele ser realizada por el comerciante y no requiere la interacción activa del titular de la tarjeta en el momento de la transacción. - 2. **CIT NPA ***Customer Initiated Transaction - Non Payment Authentication***:** Una CIT NPA es una transacción iniciada por el titular de la tarjeta que no implica un pago directo, sino que se utiliza para otros fines, como la verificación de la tarjeta o la consulta de saldo. En una CIT NPA, se puede realizar una autenticación sin que se realice una transferencia de fondos directa. - - Dado que una MIT implica un pago por parte del comerciante y una CIT NPA no implica un pago directo, no tendría sentido lanzar una transacción MIT junto con una CIT NPA. Cada tipo de transacción tiene su propio propósito y aplicación específica en el contexto del protocolo **3D Secure**. - - En pocas palabras: es posible unsar una CIT NPA en una MIT PA si el pago es único **no recurrente**. - - Unscheduled card-on-file transactions **UCOF**: A transaction using a stored credential for a fixed or variable amount that does not occur on a scheduled or regularly occurring transaction date, where the cardholder has provided consent for the merchant to initiate one or more future transactions +--- -* **Visa Digital Authentication Framework DAF** +## Mejora la tasa de autenticaciones con datos adicionales +Nos complace invitarles a visitar el apartado de [Adicional Data](/three-d-s-server/api/sessions/detail-info) en nuestra documentación del API. Este apartado ofrece información crucial para optimizar el proceso de autenticación 3DS. - Visa Digital Authentication Framework DAF es una extensión de mensaje del protocolo 3DS que le permite a Visa identificar a titulares de tarjetas que superaron el flujo de autenticación con desafío en un determinado comercio - adquirente, para así otorgarles un estado de confiabilidad al determinarlos como credencial de pago autenticada ***Authenticated Credential Payment - ACP***, esto permite que las siguientes transacciones que ejecute el tarjetahabiente en el mismo comercio sean autenticadas de inmediato. +La inclusión de estos datos adicionales en sus solicitudes permite a los emisores realizar una evaluación más precisa, lo que puede mejorar considerablemente la tasa de autenticaciones exitosas. +Les recomendamos revisar estas pautas para aprovechar al máximo las funcionalidades del API y así ofrecer una experiencia más segura y eficiente a sus usuarios. diff --git a/src/pages/three-d-s-server/api/merchants/create.mdx b/src/pages/three-d-s-server/api/merchants/create.mdx index 6b1282b..6982bc4 100644 --- a/src/pages/three-d-s-server/api/merchants/create.mdx +++ b/src/pages/three-d-s-server/api/merchants/create.mdx @@ -111,17 +111,20 @@ export const apiRefs = ['/v1/merchants']; "id":2, "name":"Evertec Placetopay S.A.S.", "token":"eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiIxIiwianRpIj..........." + "expires_at": "2024-09-16 15:30:45" }, "branches":[ { "id":1, "name":"Oficina principal", - "token":"eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWMWIyNDkyNmU4............." + "token":"eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWMWIyNDkyNmU4.............", + "expires_at": "2024-09-16 15:30:45" }, { "id":2, "name":"Test name 5622", - "token":"eyJ0eXAiOiJKV19.eyJhdWQiOiIxIiwianRpIjoiMWIyNjgk867nh..............." + "token":"eyJ0eXAiOiJKV19.eyJhdWQiOiIxIiwianRpIjoiMWIyNjgk867nh...............", + "expires_at": "2024-09-16 15:30:45" } ] } diff --git a/src/pages/three-d-s-server/api/sessions/detail-info.mdx b/src/pages/three-d-s-server/api/sessions/detail-info.mdx index 6788d80..cbf3ee6 100644 --- a/src/pages/three-d-s-server/api/sessions/detail-info.mdx +++ b/src/pages/three-d-s-server/api/sessions/detail-info.mdx @@ -1,5 +1,38 @@ export const sectionMode = 'nav'; +# Datos adicionales para mejorar la tasa de autenticación +--- + +En este proceso, enviar **data adicional** es crucial para mejorar la experiencia del usuario y garantizar la seguridad. +Aquí algunas razones para enviar información adicional: + +1. **Evaluación del riesgo mejorada:** +Proporcionar más datos sobre la transacción y el cliente permite que el emisor y los sistemas de autenticación realicen una evaluación del riesgo más precisa. +Datos como el historial de compras, la ubicación geográfica, y la información del dispositivo device info ayudan a los emisores a determinar si se puede proceder con una autenticación basada en el riesgo, +lo que podría evitar pasos adicionales de autenticación como introducir un OTP. + +2. **Minimizar fricción para el usuario:** +Enviar información como el número de teléfono, correo electrónico, historial de autenticación previo y detalles de envío puede ayudar a autenticar la transacción sin pedir intervención directa del cliente. +Si la evaluación de riesgo determina que la transacción es de bajo riesgo, el usuario podría no necesitar autenticarse activamente, +lo que mejora la experiencia del usuario conocido como "frictionless flow". + +3. **Reducir la probabilidad de rechazos:** +Cuanta más información útil se proporcione en la solicitud de autenticación, menos probable será que el banco emisor rechace la transacción por falta de datos suficientes para evaluar la autenticidad del comprador. +Esto puede mejorar las tasas de aprobación de transacciones. + +4. **Prevenir el fraude:** +Enviar datos adicionales, como la geolocalización del dispositivo, la dirección IP, el comportamiento del navegador y detalles sobre autenticaciones anteriores, +ayuda a los emisores a identificar transacciones fraudulentas con mayor eficacia. + +5. **Experiencia personalizada para autenticaciones repetidas:** +En escenarios donde se están procesando varias transacciones para el mismo usuario o cuando un usuario ha realizado autenticaciones previas, +enviar información sobre la autenticación previa como se ve en el campo threeDSRequestorPriorAuthenticationInfo permite que el emisor ajuste el proceso de autenticación en función +del historial del usuario. + +Para optimizar el uso de la data adicional, le invitamos a consultar el apartado de [Casos de Uso](/three-d-s-server/api/integration/session), donde encontrará ejemplos claros sobre cuándo y cómo enviar estos datos en sus integraciones. Estos casos detallan situaciones específicas en las que se recomienda o requiere el uso de información adicional para mejorar la tasa de autenticaciones exitosas. + +--- + ## AcctInfoProperties ### Descripción @@ -8,11 +41,11 @@ export const sectionMode = 'nav'; ### Descripción del Objeto -| Campo | Descripción | -|----------------|-------------------------------------------------------| -| **title** | `acctInfo` | -| **type** | `object` | -| **description**| Información adicional sobre la cuenta del titular de la tarjeta. | +| Campo | Descripción | +|-----------------|------------------------------------------------------------------| +| **title** | `acctInfo` | +| **type** | `object` | +| **description** | Información adicional sobre la cuenta del titular de la tarjeta. | ### Propiedades del Objeto @@ -221,23 +254,33 @@ export const sectionMode = 'nav'; ```json { - "chAccAgeInd": "01", - "chAccChange": "20210310", - "chAccChangeInd": "02", - "chAccDate": "20210310", - "chAccPwChange": "20210310", - "chAccPwChangeInd": "03", - "nbPurchaseAccount": "1234", - "provisionAttemptsDay": "002", - "txnActivityDay": "02", - "txnActivityYear": "2", - "paymentAccAge": "20210307", - "paymentAccInd": "01", - "shipAddressUsage": "20210305", - "shipAddressUsageInd": "02", - "shipNameIndicator": "01", - "suspiciousAccActivity": "02" + "acctNumber": "4005580000000040", + "cardExpiryDate": "2506", + "purchaseAmount": "20.5", + "purchaseCurrency": "USD", + "redirectURI": "https://www.placetopay.com", + "threeDSAuthenticationInd": "01", + "reference": "12345", + "acctInfo": { + "chAccAgeInd": "05", + "chAccDate": "20170101", + "chAccChangeInd": "04", + "chAccChange": "20170101", + "chAccPwChangeInd": "05", + "chAccPwChange": "20170101", + "shipAddressUsageInd": "04", + "shipAddressUsage": "20170101", + "txnActivityDay": "1", + "txnActivityYear": "1", + "provisionAttemptsDay": "0", + "nbPurchaseAccount": "1", + "suspiciousAccActivity": "01", + "shipNameIndicator": "01", + "paymentAccInd": "05", + "paymentAccAge": "20170101" + } } + ``` --- @@ -280,10 +323,28 @@ export const sectionMode = 'nav'; ```json { - "cc": "1", - "subscriber": "1234567899" + "acctNumber": "4005580000000040", + "cardExpiryDate": "2506", + "purchaseAmount": "20.5", + "purchaseCurrency": "USD", + "redirectURI": "https://www.placetopay.com", + "threeDSAuthenticationInd": "01", + "reference": "12345", + "homePhone": { + "cc": "123", + "subscriber": "123456789" + }, + "mobilePhone": { + "cc": "123", + "subscriber": "123456789" + }, + "workPhone": { + "cc": "123", + "subscriber": "123456789" + } } + ``` --- @@ -347,12 +408,41 @@ export const sectionMode = 'nav'; ### Ejemplo de Petición ```json + { - "threeDSReqPriorAuthMethod": "01", - "threeDSReqPriorAuthTimestamp": "202401011212", - "threeDSReqPriorRef": "c83f3f5d-1a47-4eff-9fd0-6b63090a89c6", - "threeDSReqPriorAuthData": "f234f3f5d-1a47-4eff-9fd4-1b62190a89f3" + "email": "john.doe@example.com", + "mobilePhone": { + "cc": "1", + "subscriber": "5551234567" + }, + "deviceChannel": "RI", + "acctNumber": "4111111111111111", + "cardExpiryDate": "2411", + "purchaseAmount": "8.25", + "redirectURI": "http://www.placetopay.com", + "purchaseCurrency": "USD", + "messageCategory": "NPA", + "messageVersion": "2.2.0", + "threeRIInd": "80", + "threeDSRequestorPriorAuthenticationInfo": { + "threeDSReqPriorAuthMethod": "01", + "threeDSReqPriorAuthTimestamp": "202401011212", + "threeDSReqPriorRef": "c83f3f5d-1a47-4eff-9fd0-6b63090a89c6", + "threeDSReqPriorAuthData": "f234f3f5d-1a47-4eff-9fd4-1b62190a89f3" + }, + "billAddrState": "NY", + "billAddrLine2": "Apt 4B", + "billAddrCity": "New York", + "billAddrPostCode": "10001", + "billAddrLine3": "", + "billAddrLine1": "123 Main St", + "billAddrCountry": "USA", + "threeDSRequestorID": "MERAESK00100090796", + "threeDSRequestorName": "EMVCo 3DS Test Requestor", + "threeDSRequestorURL": "http://ul.com/aa5c3035-0b61-4e3c-8290-44bb1b4ce643" } + + ``` --- @@ -488,15 +578,24 @@ export const sectionMode = 'nav'; ```json { - "deliveryEmailAddress": "example@example.com", - "deliveryTimeframe": "02", - "giftCardAmount": "123", - "giftCardCount": "05", - "giftCardCurr": "USD", - "preOrderDate": "20250601", - "preOrderPurchaseInd": "02", - "reorderItemsInd": "01", - "shipIndicator": "01" + "acctNumber": "4005580000000040", + "cardExpiryDate": "2506", + "purchaseAmount": "20.5", + "purchaseCurrency": "USD", + "redirectURI": "https://www.placetopay.com", + "threeDSAuthenticationInd": "01", + "reference": "12345", + "merchantRiskIndicator": { + "shipIndicator": "01", + "deliveryTimeframe": "02", + "deliveryEmailAddress": "example@example.com", + "reorderItemsInd": "01", + "preOrderPurchaseInd": "02", + "preOrderDate": "20300101", + "giftCardAmount": "1", + "giftCardCurr": "840", + "giftCardCount": "01" + } } ``` @@ -560,11 +659,26 @@ export const sectionMode = 'nav'; ```json { - "threeDSReqAuthData": "28401b9d217ef8731f0dbee99c73c5902c183c5b1428d572ef63a4fe26586548", - "threeDSReqAuthMethod": "01", - "threeDSReqAuthTimestamp": "202103051200" + "acctNumber": "4005580000000040", + "cardExpiryDate": "2506", + "purchaseAmount": "20.5", + "purchaseCurrency": "USD", + "redirectURI": "https://www.placetopay.com", + "threeDSAuthenticationInd": "01", + "reference": "12345", + "threeDSRequestorAuthenticationInfo": { + "threeDSReqAuthData": "28401b9d217ef8731f0dbee99c73c5902c183c5b1428d572ef63a4fe26586548", + "threeDSReqAuthMethod": "01", + "threeDSReqAuthTimestamp": "202103051200" + } } ``` +--- + +## BridgingMessageExtension + +Para obtener más detalles sobre cómo utilizar esta extensión y mejorar la tasa de autenticación aprovechando las ventajas de la versión 2.3.1, +consulte [Sesión transacción con Bridging Message Extension](/three-d-s-server/api/integration/session#sesion-transaccion-con-bridging-message-extension) diff --git a/src/pages/three-d-s-server/api/sessions/index.mdx b/src/pages/three-d-s-server/api/sessions/index.mdx index 25aed8d..ca8ac7b 100644 --- a/src/pages/three-d-s-server/api/sessions/index.mdx +++ b/src/pages/three-d-s-server/api/sessions/index.mdx @@ -1,6 +1,6 @@ export const apiRefs = ['/threeds/v2x/sessions'] -**Este es el servicio para iniciar una sesión en el flujo de autenticación de 3DS Server.** +# Servicio para iniciar una sesión en el flujo de autenticación de 3DS Server. Los siguientes pasos le darán una guía en la utilización del mismo: @@ -26,7 +26,7 @@ Los siguientes pasos le darán una guía en la utilización del mismo: > Para obtener estados en la autenticación diferentes al "Y", puede modificar el campo "acctNumber" de la petición, con los números de tarjetas de prueba dados en esta documentación. --- -# Implementación del Contrato v2x +## Implementación del Contrato v2x Se recomienda la implementación de un nuevo contrato que proporciona el siguiente conjunto de resultados: @@ -39,6 +39,12 @@ Se recomienda la implementación de un nuevo contrato que proporciona el siguien Para más detalles sobre la acción "redirect" y su implementación, puedes consultar la documentación específica del flujo de autenticación de BRW. --- +## Mejora la tasa de autenticaciones con datos adicionales +Nos complace invitarles a visitar el apartado de [Adicional Data](/three-d-s-server/api/sessions/detail-info) en nuestra documentación del API. Este apartado ofrece información crucial para optimizar el proceso de autenticación 3DS. + +La inclusión de estos datos adicionales en sus solicitudes permite a los emisores realizar una evaluación más precisa, lo que puede mejorar considerablemente la tasa de autenticaciones exitosas. + +Les recomendamos revisar estas pautas para aprovechar al máximo las funcionalidades del API y así ofrecer una experiencia más segura y eficiente a sus usuarios. --- diff --git a/src/pages/three-d-s-server/api/sessions/rules.mdx b/src/pages/three-d-s-server/api/sessions/rules.mdx index 3c7bd10..ea206a7 100644 --- a/src/pages/three-d-s-server/api/sessions/rules.mdx +++ b/src/pages/three-d-s-server/api/sessions/rules.mdx @@ -4,91 +4,91 @@ A continuación se detallan las reglas para cada uno de los elementos de datos a tener en consideración. Esta tabla te ayudará a verificar los requisitos y valores aceptados para cada campo en función del `Canal del dispositivo` y `Categoría del mensaje`, así como a entender las reglas específicas que se deben seguir. -| **Elemento** | **Reglas de inclusión** | **Contextualización** | **Ejemplo** | -|---------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| **acctNumber**
Cardholder Account Number | Requerido
Tipo: String
Valores aceptados: [ISO 7812](https://es.wikipedia.org/wiki/ISO/IEC_7812) | Número de cuenta del titular de la tarjeta.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA
Mas detalle en: [Tarjetas de prueba](/three-d-s-server/test-cards)
[Algoritmo de Luhn](https://es.wikipedia.org/wiki/Algoritmo_de_Luhn) | **5180300000000005** | -| **cardExpiryDate**
Card/Token Expiry Date | Requerido
Tipo: String
| Fecha de expiración de la tarjeta o token en formato **ym** (año, mes).
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **2407** (Julio de 2024) | -| **redirectURI**
Redirect URI | Requerido
Tipo: String
Máximo 255 caracteres | URI a la que se redirigirá después de un proceso exitoso.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **https://example.com/redirect** | -| **threeDSAuthenticationInd**
ThreeDS Requestor Authentication Ind | Opcional
Tipo: String
Valores aceptados:
**01** (Pago)
**02** (Transacción recurrente)
**03** (Transacción a plazos)
**04** (Añadir tarjeta)
**05** (Mantener tarjeta)
**06** (Verificación del titular como parte del ID&V del token EMV) | Indicador de autenticación solicitado por el 3DS.
**Device Channel:** BRW, APP
**Message Category:** PA, NPA | **01** | -| **purchaseAmount**
Purchase Amount | Requerido con **purchaseCurrency** | Monto de la compra en la moneda especificada.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **100.00** | -| **threeDSChallengeInd**
threeDS Challenge Indicator | Opcional
Valores aceptados:
**01** (Sin desafío)
**02** (Desafío condicional)
**03** (Preferencia de desafío)
**04** (Desafío mandatado)
**05** (Sin desafío, análisis ya realizado)
**06** (Sin desafío, autenticación ya realizada)
**07** (Sin desafío, exención de lista blanca)
**08** (Desafío solicitado, exención de lista blanca)
**09** (Desafío solicitado, solicitud de lista blanca) | Indicador de desafío solicitado por el 3DS.
**Device Channel:** APP
**Message Category:** PA, NPA | **01** | -| **purchaseCurrency**
Purchase Currency | Requerido con **purchaseAmount**.
Moneda existente en el sistema
[ISO 4217](https://es.wikipedia.org/wiki/ISO_4217)
Tipo: String | Moneda en la que se realizará la compra, en formato alfabético de tres letras.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **USD** (Dólar estadounidense) | -| **threeDSRequestorID**
ThreeDS Requestor ID | Opcional
Tipo: String
Longitud máxima :35 caracteres | Identificador del solicitante del 3DS.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **3DSRequestor12345** | -| **cardholderName**
Cardholder Name | Opcional
Tipo: String
min:2 | Nombre del titular de la tarjeta.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **John Doe** | -| **email**
Email Address | Opcional
Tipo: Email | Dirección de correo electrónico del titular.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **johndoe@example.com** | -| **threeDSRequestorDecMaxTime**
3DS Requestor Decision Max Time | Requerido si threeDSRequestorDecReqInd es igual **Y**
Entre 1 y 5 digitos
Entre 1 y 10080 números | Tiempo máximo para la decisión del solicitante del 3DS en minutos.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **1440** (1 día) | -| **deviceChannel**
Device Channel | Opcional
Tipo: String
Valores aceptados:
**01 APP** (Aplicación móvil)
**02 BRW** (Navegador)
**03 RI** (Autenticación iniciada por el comerciante) | Canal a través del cual se realiza la transacción. Puede ser un canal web, móvil, etc.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **03** | -| **threeRIInd**
ThreeRI Indicator | Requerido si **deviceChannel** es 03
Valores aceptados:
**01** Transacción Recurrente
**02** Transacción a Plazos
**03** Añadir Tarjeta
**04** Mantener Información de la Tarjeta
**05** Verificación de Cuenta
**06** Envío Parcial o Retrasado
**07** Recarga
**08** Pedido por Correo
**09** Pedido por Teléfono
**10** Verificación de Estado en la Lista Blanca
**11** Otro Pago
**12** Acuerdo de Facturación | Indica el tipo de **3RI** pedido. Este elemento de datos proporciona adicional información al ACS para determinar el mejor enfoque para entregar un Solicitud 3RI..
**Device Channel:** RI
**Message Category:** PA, NPA | **02** | -| **purchaseExponent**
Purchase Exponent | Opcional
Tipo: String
1 digito | Exponente asociado con el monto de la compra, utilizado para manejar la escala en la representación decimal.
**Device Channel:** APP
**Message Category:** PA, NPA | **0** (Sin exponente) | -| **purchaseDate**
Purchase Date | Opcional
Tipo: String
Formato de la fecha y hora **YmdHis** | Fecha y hora en la que se realiza la compra, en formato específico.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **20240808T153000** (8 de agosto de 2024, 15:30:00) | -| **reference**
Reference | Opcional
Tipo: String
| Referencia del proceso o transacción.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **REF123456789** | -| **recurringFrequency**
Recurring Frequency | Requerido si **threeDSAuthenticationInd** es **02** o **03** | Frecuencia de pagos recurrentes en días.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **30** (Cada 30 días) | -| **recurringExpiry**
Recurring Expiry | Requerido si **threeDSAuthenticationInd** es **02** o **03** y existe **recurringFrequency** | Fecha de expiración de la recurrencia en formato `Ymd`.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **20231231** (31 de diciembre de 2023) | -| **purchaseInstalData**
Purchase Installment Data | Requerido si **threeDSAuthenticationInd** es **03** | Datos de instalación de la compra.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **12** | -| **billAddrCity**
Billing Address City | Opcional
Tipo: String
| Ciudad de la dirección de facturación.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **New York** | -| **billAddrCountry**
Billing Address Country | Opcional
[ISO 3166-1](https://es.wikipedia.org/wiki/ISO_3166-1) | País de la dirección de facturación en formato alfa-3.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **USA** (Estados Unidos) | -| **billAddrLine1**
Billing Address Line 1 | Opcional
Tipo: String
| Línea 1 de la dirección de facturación.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **123 Main St** | -| **billAddrLine2**
Billing Address Line 2 | Opcional
Tipo: String
| Línea 2 de la dirección de facturación.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **Apt 4B** | -| **billAddrLine3**
Billing Address Line 3 | Opcional
Tipo: String
| Línea 3 de la dirección de facturación.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | `` | -| **billAddrPostCode**
Billing Address Post Code | Opcional
Tipo: String
| Código postal de la dirección de facturación.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **10001** | -| **billAddrState**
Billing Address State | Opcional
[ISO 3166-2](https://es.wikipedia.org/wiki/ISO_3166-2) | Estado de la dirección de facturación.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **NY** (Nueva York) | -| **shipAddrCity**
Shipping Address City | Opcional
Tipo: String
| Ciudad de la dirección de envío.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **New York** | -| **shipAddrCountry**
Shipping Address Country | Opcional
[ISO 3166-1](https://es.wikipedia.org/wiki/ISO_3166-1) | País de la dirección de envío en formato alfa-3.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **USA** (Estados Unidos) | -| **shipAddrLine1**
Shipping Address Line 1 | Opcional
Tipo: String
| Línea 1 de la dirección de envío.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **123 Main St** | -| **shipAddrLine2**
Shipping Address Line 2 | Opcional
Tipo: String
| Línea 2 de la dirección de envío.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **Apt 4B** | -| **shipAddrLine3**
Shipping Address Line 3 | Opcional
Tipo: String
| Línea 3 de la dirección de envío.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | `` | -| **shipAddrPostCode**
Shipping Address Post Code | Opcional
Tipo: String
| Código postal de la dirección de envío.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **10001** | -| **shipAddrState**
Shipping Address State | Opcional
[ISO 3166-2](https://es.wikipedia.org/wiki/ISO_3166-2) | Estado de la dirección de envío.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **NY** (Nueva York) | -| **threeDSAuthenticationInfo**
3DS Authentication Info | Opcional
Tipo: Array | Información de autenticación solicitada por el 3DS.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | ```json {"threeDSReqAuthMethod": "01","threeDSReqAuthTimestamp": "20240808T153000","threeDSReqAuthData": "data123"}``` | -| **threeDSAuthenticationInfo.threeDSReqAuthMethod**
3DS Request Authentication Method | Requerido
Valores aceptados:
**01** (Verificado)
**02** (Fallido)
**03** (No realizado)
**04–79** (Reservado para uso futuro EMVCo)
**80–99** (Reservado para uso DS) | Método de autenticación solicitado por 3DS.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **01** | -| **threeDSAuthenticationInfo.threeDSReqAuthTimestamp**
3DS Request Authentication Timestamp | Requerido
Formato de fecha y hora: **YmdHi** | Marca de tiempo para la autenticación solicitada por 3DS.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **20240808T153000** (8 de agosto de 2024, 15:30) | -| **threeDSAuthenticationInfo.threeDSReqAuthData**
3DS Request Authentication Data | Opcional
Tipo: String
Máximo 20000 caracteres | Datos para la autenticación solicitada por 3DS.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **data123** | -| **acctInfo**
Account Information | Opcional
Tipo: Array | Información adicional de la cuenta.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | ```json { "chAccAgeInd": "01", "chAccChange": "20240808", "chAccChangeInd": "01", "chAccDate": "20240101", "chAccPwChange": "20240808", "chAccPwChangeInd": "02", "nbPurchaseAccount": "10", "provisionAttemptsDay": "5", "txnActivityDay": "15", "txnActivityYear": "100", "paymentAccAge": "20230808", "paymentAccInd": "01", "shipAddressUsage": "20240808", "shipNameIndicator": "02", "suspiciousAccActivity": "01" }``` | -| **acctInfo.chAccAgeInd**
Account Age Indicator | Opcional
Valores aceptados: **01** (No existe cuenta)
**02** (Creada durante la transacción)
**03** (Menos de 30 días)
**04** (Entre 30 y 60 días)
**05** (Más de 60 días) | Indicador de la antigüedad de la cuenta.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **01** | -| **acctInfo.chAccChange**
Account Change Date | Opcional
Formato de fecha: **Ymd** | Fecha de cambio en la cuenta.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **20230701** (1 de julio de 2023) | -| **acctInfo.chAccChangeInd**
Account Change Indicator | Opcional
Valores aceptados:
**01** (No hay cambio)
**02** (Cambio menor)
**03** (Cambio significativo)
**04** (Cambio importante) | Indicador del cambio en la cuenta.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **01** | -| **acctInfo.chAccDate**
Account Creation Date | Opcional
Formato de fecha: **Ymd** | Fecha en que se creó la cuenta.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **20220101** (1 de enero de 2022) | -| **acctInfo.chAccPwChange**
Account Password Change Date | Opcional
Formato de fecha: **Ymd** | Fecha en que se cambió la contraseña de la cuenta.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **20230801** (1 de agosto de 2023) | -| **acctInfo.chAccPwChangeInd**
Account Password Change Indicator | Opcional
Valores aceptados:
**01** (No cambio)
**02** (Cambio durante la transacción)
**03** (Menos de 30 días)
**04** (Entre 30 y 60 días)
**05** (Más de 60 días) | Indicador de cambio en la contraseña de la cuenta.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **01** | -| **acctInfo.nbPurchaseAccount**
Number of Purchases | Opcional
Tipo: Numérico
Entre 1 y 4 dígitos | Número de compras realizadas en la cuenta.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **5** | -| **acctInfo.provisionAttemptsDay**
Provision Attempts per Day | Opcional
Tipo: Numérico
Entre 1 y 3 dígitos | Número de intentos de provisión por día.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **1** | -| **acctInfo.txnActivityDay**
Transaction Activity per Day | Opcional
Entre 1 y 3 dígitos | Actividad de transacciones por día.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **2** | -| **acctInfo.txnActivityYear**
Transaction Activity per Year | Opcional
Entre 1 y 3 dígitos | Actividad de transacciones por año.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **10** | -| **acctInfo.paymentAccAge**
Payment Account Age | Opcional
Formato de fecha: **Ymd** | Edad de la cuenta de pago.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **20200801** (1 de agosto de 2020) | -| **acctInfo.paymentAccInd**
Payment Account Indicator | Opcional
Valores aceptados:
**01** (No cuenta)
**02** (Creada durante la transacción)
**03** (Menos de 30 días)
**04** (Entre 30 y 60 días)
**05** (Más de 60 días) | Indicador de la antigüedad de la cuenta de pago.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **01** | -| **acctInfo.shipAddressUsage**
Shipping Address Usage | Opcional
Formato de fecha: **Ymd** | Fecha en la que se usa la dirección de envío.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **20230801** (1 de agosto de 2023) | -| **acctInfo.shipNameIndicator**
Shipping Name Indicator | Opcional
Valores aceptados:
**01** (Nombre de cuenta idéntico al nombre de envío)
**02** (Nombre de cuenta diferente al nombre de envío) | Indicador del nombre de envío.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **01** | -| **acctInfo.suspiciousAccActivity**
Suspicious Account Activity | Opcional
Valores aceptados:
**01** (No se observó actividad sospechosa)
**02** (Actividad sospechosa observada) | Indicador de actividad sospechosa en la cuenta.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **01** | -| **browserLanguage**
Browser Language | Opcional
Tipo: String
Longitud máxima:8 caracteres
Formatos aceptados:
[ISO 639-1](https://es.wikipedia.org/wiki/ISO_639-1) | El parámetro browserLanguage se usa para enviar el idioma de preferencia. Si el idioma enviado no es compatible con ACS o MPI, se mostrará el idioma configurado en el navegador. Si el idioma del navegador no es compatible con ACS o MPI, se mostrará el idioma configurado por defecto en cada aplicación (en).
**Device Channel:** BRW
**Message Category:** PA, NPA | es | -| **homePhone**
Cardholder Home Phone Number | Requerido si se proporciona el número de teléfono.
Tipo: Array
[ITU-E.164](https://www.itu.int/rec/dologin_pub.asp?lang=e&id=T-REC-E.164-201011-I!!PDF-S&type=items) | Número de teléfono de hogar.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | ```json {"cc": "01","subscriber": "20240808T153000"}``` | -| **homePhone.cc**
| Requerido con **homePhone**
Entre 1 y 3 dígitos | Código de país para el número de teléfono de hogar.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **01** | -| **homePhone.subscriber**
| Requerido con **homePhone**
Entre 1 15 dígitos | Número de suscriptor para el número de teléfono de hogar.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **1234567899** | -| **mobilePhone**
Cardholder Mobile Phone Number | Requerido si se proporciona el número de teléfono móvil.
Tipo: Array
[ITU-E.164](https://www.itu.int/rec/dologin_pub.asp?lang=e&id=T-REC-E.164-201011-I!!PDF-S&type=items) | Número de teléfono móvil.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | ```json {"cc": "01","subscriber": "20240808T153000"}``` | -| **mobilePhone.cc**
| Requerido con **mobilePhone**
Entre 1 y 3 dígitos | Código de país para el número de teléfono móvil.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **57** | -| **mobilePhone.subscriber**
| Requerido con **mobilePhone**
Entre 1 y 15 dígitos | Número de suscriptor para el número de teléfono móvil.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **3026015836** | -| **workPhone**
Cardholder Work Phone Number | Requerido si se proporciona el número de teléfono de trabajo.
Tipo: Array
[ITU-E.164](https://www.itu.int/rec/dologin_pub.asp?lang=e&id=T-REC-E.164-201011-I!!PDF-S&type=items) | Número de teléfono de trabajo.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | ```json {"cc": "01","subscriber": "20240808T153000"}``` | -| **workPhone.cc**
| Requerido con **workPhone**
Entre 1 y 3 dígitos | Código de país para el número de teléfono de trabajo.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **1** | -| **workPhone.subscriber**
| Requerido con **workPhone**
Entre 1 y 15 dígitos | Número de suscriptor para el número de teléfono de trabajo.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **1234567899** | -| **merchantRiskIndicator**
| Opcional
Tipo: Array | Indicador de riesgo del comerciante. Incluye varios sub-elementos relacionados con el riesgo de la transacción.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | | -| **merchantRiskIndicator.deliveryEmailAddress**
Delivery Email Address | Opcional
Tipo: Email
Longitud máxima: 254 caracteres | Dirección de correo electrónico para la entrega.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **example@example.com** | -| **merchantRiskIndicator.deliveryTimeframe**
Delivery Timeframe | Opcional
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) | Tiempo estimado para la entrega de los bienes.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **01** | -| **merchantRiskIndicator.giftCardAmount**
Gift Card Amount | Opcional
Tipo: String
Longitud máxima: 15 caracteres | Monto de la tarjeta de regalo.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **100.00** | -| **merchantRiskIndicator.giftCardCount**
Gift Card Count | Opcional
Tipo: String
Entre 1 y 2 dígitos | Cantidad de tarjetas de regalo.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **1** | -| **merchantRiskIndicator.giftCardCurr**
Gift Card Currency | Opcional
Tipo: String
Longitud máxima: 3 caracteres | Moneda de las tarjetas de regalo.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **USD** | -| **merchantRiskIndicator.preOrderDate**
Pre-Order Date | Opcional
Formato de fecha: **Ymd** | Fecha del pedido anticipado.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **20240808** | -| **merchantRiskIndicator.preOrderPurchaseInd**
Pre-Order Purchase Indicator | Opcional
Valores aceptados:
**01:** (Mercancía disponible)
**02:** (Disponibilidad futura) | Indicador de compra anticipada.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **02** | -| **merchantRiskIndicator.preOrderItemsInd**
| Opcional
Valores aceptados:
**01:** (Mercancía disponible)
**02:** (Disponibilidad futura) | Indicador de artículos anticipados.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **01** | -| **merchantRiskIndicator.shipIndicator**
Shipping Indicator | Opcional
Valores aceptados:
**01:** (Enviar a la dirección de facturación del titular)
**02:** (Enviar a otra dirección verificada del comerciante)
**03:** (Enviar a una dirección diferente a la del titular)
**04:** (Recoger en tienda / Recoger en una tienda local (la dirección de la tienda debe ser proporcionada 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:** (Tickets de viaje y eventos, no enviados)
**07:** Otro (por ejemplo, servicios digitales no enviados, suscripciones a medios electrónicos, etc.) | Indicador de envío.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **01** | -| **threeDSRequestorDecReqInd**
| Opcional
Tipo: String
Longitud máxima: 1
Valores aceptados: **Y**, **N** | Indicador de solicitud de decisión del solicitante 3DS.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **Y** | -| **acctID**
Cardholder Account Identifier | Condicional
Tipo: String
Longitud máxima: 64 caracteres | Identificador de cuenta.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **ABC1234567890** | -| **messageVersion**
Message Version Number | Opcional
Tipo: String
Valores aceptados
**2.1.0** y **2.2.0** | Versión del mensaje. **Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **2.2.0** | -| **messageCategory**
Message Category | Requerido
Valores aceptados
**01** (PA)
**02** (NPA) | Categoría del mensaje. **Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **01** | -| **addPriorInformation**
| Opcional
Tipo: String
Longitud máxima: 1
Valores aceptados:
**Y**, **N**
Prohibido cuando **threeDSRequestorPriorAuthenticationInfo** | Información adicional previa. **Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **Y** | -| **threeDSRequestorPriorAuthenticationInfo**
3DS Requestor Prior Transaction
Authentication Information | Condicional
Tipo: Array
Prohibico cuando **addPriorInformation** | Información previa de autenticación del solicitante 3DS. **Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | | -| **threeDSRequestor
PriorAuthenticationInfo.
threeDSReqPriorAuthMethod**
3DS Prior Authentication Method | Opcional
Tipo: String
Valores aceptados:
**FRICTIONLESS_AUTHENTICATION:** Autenticación sin fricciones
**CARDHOLDER_CHALLENGE_OCCURRED:** Se produjo un desafío para el titular de la tarjeta
**AVS_VERIFIED:** Verificación de AVS (Address Verification System)
**OTHER_ISSUER_METHODS:** Otros métodos del emisor
| Método de autenticación previo utilizado por el solicitante del 3DS. Indica el tipo de autenticación previa.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **CARDHOLDER_CHALLENGE_OCCURRED** | -| **threeDSRequestorPriorAuthenticationInfo.
threeDSReqPriorAuthTimestamp**
3DS Requestor Prior Transaction
Authentication Timestamp | Opcional
Tipo: String
Formatos: **YmdHi**, **c** | Marca de tiempo de la autenticación previa del solicitante 3DS.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **20240808153000** ó **2024-08-08T15:30:00Z** | -| **threeDSRequestorPriorAuthenticationInfo.
threeDSReqPriorRef**
3DS Requestor Prior Transaction
Reference | Opcional
Tipo: UUID
| Referencia de autenticación previa del solicitante 3DS.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **550e8400-e29b-41d4-a716-446655440000** | -| **threeDSRequestorPriorAuthenticationInfo.
threeDSReqPriorAuthData**
3DS Requestor Prior Transaction
Authentication Data | Opcional
Tipo: String
Longitud máxima: 2048 caracteres | Datos de autenticación previa del solicitante 3DS.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | | +| **Elemento** | **Reglas de inclusión** | **Contextualización** | **Ejemplo** | +|---------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| **acctNumber**
Cardholder Account Number | Requerido
Tipo: String
Valores aceptados: [ISO 7812](https://es.wikipedia.org/wiki/ISO/IEC_7812) | Número de cuenta del titular de la tarjeta.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA
Mas detalle en: [Tarjetas de prueba](/three-d-s-server/test-cards)
[Algoritmo de Luhn](https://es.wikipedia.org/wiki/Algoritmo_de_Luhn) | **5180300000000005** | +| **cardExpiryDate**
Card/Token Expiry Date | Requerido
Tipo: String
| Fecha de expiración de la tarjeta o token en formato **ym** (año, mes).
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **2407** (Julio de 2024) | +| **redirectURI**
Redirect URI | Requerido
Tipo: String
Máximo 255 caracteres | URI a la que se redirigirá después de un proceso exitoso.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **https://example.com/redirect** | +| **threeDSAuthenticationInd**
ThreeDS Requestor Authentication Ind | Opcional
Tipo: String
Valores aceptados:
**01** (Pago)
**02** (Transacción recurrente)
**03** (Transacción a plazos)
**04** (Añadir tarjeta)
**05** (Mantener tarjeta)
**06** (Verificación del titular como parte del ID&V del token EMV) | Indicador de autenticación solicitado por el 3DS.
**Device Channel:** BRW, APP
**Message Category:** PA, NPA | **01** | +| **purchaseAmount**
Purchase Amount | Requerido con **purchaseCurrency** | Monto de la compra en la moneda especificada.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **100.00** | +| **threeDSChallengeInd**
threeDS Challenge Indicator | Opcional
Valores aceptados:
**01** (Sin desafío)
**02** (Desafío condicional)
**03** (Preferencia de desafío)
**04** (Desafío mandatado)
**05** (Sin desafío, análisis ya realizado)
**06** (Sin desafío, autenticación ya realizada)
**07** (Sin desafío, exención de lista blanca)
**08** (Desafío solicitado, exención de lista blanca)
**09** (Desafío solicitado, solicitud de lista blanca) | Indicador de desafío solicitado por el 3DS.
**Device Channel:** APP
**Message Category:** PA, NPA | **01** | +| **purchaseCurrency**
Purchase Currency | Requerido con **purchaseAmount**.
Moneda existente en el sistema
[ISO 4217](https://es.wikipedia.org/wiki/ISO_4217)
Tipo: String | Moneda en la que se realizará la compra, en formato alfabético de tres letras.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **USD** (Dólar estadounidense) | +| **threeDSRequestorID**
ThreeDS Requestor ID | Opcional
Tipo: String
Longitud máxima :35 caracteres | Identificador del solicitante del 3DS.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **3DSRequestor12345** | +| **cardholderName**
Cardholder Name | Opcional
Tipo: String
min:2 | Nombre del titular de la tarjeta.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **John Doe** | +| **email**
Email Address | Opcional
Tipo: Email | Dirección de correo electrónico del titular.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **johndoe@example.com** | +| **threeDSRequestorDecMaxTime**
3DS Requestor Decision Max Time | Requerido si threeDSRequestorDecReqInd es igual **Y**
Entre 1 y 5 digitos
Entre 1 y 10080 números | Tiempo máximo para la decisión del solicitante del 3DS en minutos.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **1440** (1 día) | +| **deviceChannel**
Device Channel | Opcional
Tipo: String
Valores aceptados:
**01 APP** (Aplicación móvil)
**02 BRW** (Navegador)
**03 RI** (Autenticación iniciada por el comerciante) | Canal a través del cual se realiza la transacción. Puede ser un canal web, móvil, etc.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **03** | +| **threeRIInd**
ThreeRI Indicator | Requerido si **deviceChannel** es 03
Valores aceptados:
**01** Transacción Recurrente
**02** Transacción a Plazos
**03** Añadir Tarjeta
**04** Mantener Información de la Tarjeta
**05** Verificación de Cuenta
**06** Envío Parcial o Retrasado
**07** Recarga
**08** Pedido por Correo
**09** Pedido por Teléfono
**10** Verificación de Estado en la Lista Blanca
**11** Otro Pago
**12** Acuerdo de Facturación | Indica el tipo de **3RI** pedido. Este elemento de datos proporciona adicional información al ACS para determinar el mejor enfoque para entregar un Solicitud 3RI..
**Device Channel:** RI
**Message Category:** PA, NPA | **02** | +| **purchaseExponent**
Purchase Exponent | Opcional
Tipo: String
1 digito | Exponente asociado con el monto de la compra, utilizado para manejar la escala en la representación decimal.
**Device Channel:** APP
**Message Category:** PA, NPA | **0** (Sin exponente) | +| **purchaseDate**
Purchase Date | Opcional
Tipo: String
Formato de la fecha y hora **YmdHis** | Fecha y hora en la que se realiza la compra, en formato específico.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **20240808T153000** (8 de agosto de 2024, 15:30:00) | +| **reference**
Reference | Opcional
Tipo: String
| Referencia del proceso o transacción.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **REF123456789** | +| **recurringFrequency**
Recurring Frequency | Requerido si **threeDSAuthenticationInd** es **02** o **03** | Frecuencia de pagos recurrentes en días.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **30** (Cada 30 días) | +| **recurringExpiry**
Recurring Expiry | Requerido si **threeDSAuthenticationInd** es **02** o **03** y existe **recurringFrequency** | Fecha de expiración de la recurrencia en formato `Ymd`.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **20231231** (31 de diciembre de 2023) | +| **purchaseInstalData**
Purchase Installment Data | Requerido si **threeDSAuthenticationInd** es **03** | Datos de instalación de la compra.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **12** | +| **billAddrCity**
Billing Address City | Opcional
Tipo: String
| Ciudad de la dirección de facturación.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **New York** | +| **billAddrCountry**
Billing Address Country | Opcional
[ISO 3166-1](https://es.wikipedia.org/wiki/ISO_3166-1) | País de la dirección de facturación en formato alfa-3.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **USA** (Estados Unidos) | +| **billAddrLine1**
Billing Address Line 1 | Opcional
Tipo: String
| Línea 1 de la dirección de facturación.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **123 Main St** | +| **billAddrLine2**
Billing Address Line 2 | Opcional
Tipo: String
| Línea 2 de la dirección de facturación.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **Apt 4B** | +| **billAddrLine3**
Billing Address Line 3 | Opcional
Tipo: String
| Línea 3 de la dirección de facturación.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | `` | +| **billAddrPostCode**
Billing Address Post Code | Opcional
Tipo: String
| Código postal de la dirección de facturación.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **10001** | +| **billAddrState**
Billing Address State | Opcional
[ISO 3166-2](https://es.wikipedia.org/wiki/ISO_3166-2) | Estado de la dirección de facturación.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **NY** (Nueva York) | +| **shipAddrCity**
Shipping Address City | Opcional
Tipo: String
| Ciudad de la dirección de envío.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **New York** | +| **shipAddrCountry**
Shipping Address Country | Opcional
[ISO 3166-1](https://es.wikipedia.org/wiki/ISO_3166-1) | País de la dirección de envío en formato alfa-3.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **USA** (Estados Unidos) | +| **shipAddrLine1**
Shipping Address Line 1 | Opcional
Tipo: String
| Línea 1 de la dirección de envío.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **123 Main St** | +| **shipAddrLine2**
Shipping Address Line 2 | Opcional
Tipo: String
| Línea 2 de la dirección de envío.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **Apt 4B** | +| **shipAddrLine3**
Shipping Address Line 3 | Opcional
Tipo: String
| Línea 3 de la dirección de envío.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | `` | +| **shipAddrPostCode**
Shipping Address Post Code | Opcional
Tipo: String
| Código postal de la dirección de envío.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **10001** | +| **shipAddrState**
Shipping Address State | Opcional
[ISO 3166-2](https://es.wikipedia.org/wiki/ISO_3166-2) | Estado de la dirección de envío.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **NY** (Nueva York) | +| **threeDSAuthenticationInfo**
3DS Authentication Info | Opcional
Tipo: Array | Información de autenticación solicitada por el 3DS.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | ```json {"threeDSReqAuthMethod": "01","threeDSReqAuthTimestamp": "20240808T153000","threeDSReqAuthData": "data123"}``` | +| **threeDSAuthenticationInfo.threeDSReqAuthMethod**
3DS Request Authentication Method | Requerido
Valores aceptados:
**01** (Verificado)
**02** (Fallido)
**03** (No realizado)
**04–79** (Reservado para uso futuro EMVCo)
**80–99** (Reservado para uso DS) | Método de autenticación solicitado por 3DS.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **01** | +| **threeDSAuthenticationInfo.threeDSReqAuthTimestamp**
3DS Request Authentication Timestamp | Requerido
Formato de fecha y hora: **YmdHi** | Marca de tiempo para la autenticación solicitada por 3DS.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **20240808T153000** (8 de agosto de 2024, 15:30) | +| **threeDSAuthenticationInfo.threeDSReqAuthData**
3DS Request Authentication Data | Opcional
Tipo: String
Máximo 20000 caracteres | Datos para la autenticación solicitada por 3DS.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **data123** | +| **acctInfo**
Account Information | Opcional
Tipo: Array | Información adicional de la cuenta.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | ```json { "chAccAgeInd": "01", "chAccChange": "20240808", "chAccChangeInd": "01", "chAccDate": "20240101", "chAccPwChange": "20240808", "chAccPwChangeInd": "02", "nbPurchaseAccount": "10", "provisionAttemptsDay": "5", "txnActivityDay": "15", "txnActivityYear": "100", "paymentAccAge": "20230808", "paymentAccInd": "01", "shipAddressUsage": "20240808", "shipNameIndicator": "02", "suspiciousAccActivity": "01" }``` | +| **acctInfo.chAccAgeInd**
Account Age Indicator | Opcional
Valores aceptados: **01** (No existe cuenta)
**02** (Creada durante la transacción)
**03** (Menos de 30 días)
**04** (Entre 30 y 60 días)
**05** (Más de 60 días) | Indicador de la antigüedad de la cuenta.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **01** | +| **acctInfo.chAccChange**
Account Change Date | Opcional
Formato de fecha: **Ymd** | Fecha de cambio en la cuenta.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **20230701** (1 de julio de 2023) | +| **acctInfo.chAccChangeInd**
Account Change Indicator | Opcional
Valores aceptados:
**01** (No hay cambio)
**02** (Cambio menor)
**03** (Cambio significativo)
**04** (Cambio importante) | Indicador del cambio en la cuenta.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **01** | +| **acctInfo.chAccDate**
Account Creation Date | Opcional
Formato de fecha: **Ymd** | Fecha en que se creó la cuenta.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **20220101** (1 de enero de 2022) | +| **acctInfo.chAccPwChange**
Account Password Change Date | Opcional
Formato de fecha: **Ymd** | Fecha en que se cambió la contraseña de la cuenta.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **20230801** (1 de agosto de 2023) | +| **acctInfo.chAccPwChangeInd**
Account Password Change Indicator | Opcional
Valores aceptados:
**01** (No cambio)
**02** (Cambio durante la transacción)
**03** (Menos de 30 días)
**04** (Entre 30 y 60 días)
**05** (Más de 60 días) | Indicador de cambio en la contraseña de la cuenta.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **01** | +| **acctInfo.nbPurchaseAccount**
Number of Purchases | Opcional
Tipo: Numérico
Entre 1 y 4 dígitos | Número de compras realizadas en la cuenta.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **5** | +| **acctInfo.provisionAttemptsDay**
Provision Attempts per Day | Opcional
Tipo: Numérico
Entre 1 y 3 dígitos | Número de intentos de provisión por día.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **1** | +| **acctInfo.txnActivityDay**
Transaction Activity per Day | Opcional
Entre 1 y 3 dígitos | Actividad de transacciones por día.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **2** | +| **acctInfo.txnActivityYear**
Transaction Activity per Year | Opcional
Entre 1 y 3 dígitos | Actividad de transacciones por año.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **10** | +| **acctInfo.paymentAccAge**
Payment Account Age | Opcional
Formato de fecha: **Ymd** | Edad de la cuenta de pago.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **20200801** (1 de agosto de 2020) | +| **acctInfo.paymentAccInd**
Payment Account Indicator | Opcional
Valores aceptados:
**01** (No cuenta)
**02** (Creada durante la transacción)
**03** (Menos de 30 días)
**04** (Entre 30 y 60 días)
**05** (Más de 60 días) | Indicador de la antigüedad de la cuenta de pago.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **01** | +| **acctInfo.shipAddressUsage**
Shipping Address Usage | Opcional
Formato de fecha: **Ymd** | Fecha en la que se usa la dirección de envío.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **20230801** (1 de agosto de 2023) | +| **acctInfo.shipNameIndicator**
Shipping Name Indicator | Opcional
Valores aceptados:
**01** (Nombre de cuenta idéntico al nombre de envío)
**02** (Nombre de cuenta diferente al nombre de envío) | Indicador del nombre de envío.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **01** | +| **acctInfo.suspiciousAccActivity**
Suspicious Account Activity | Opcional
Valores aceptados:
**01** (No se observó actividad sospechosa)
**02** (Actividad sospechosa observada) | Indicador de actividad sospechosa en la cuenta.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **01** | +| **browserLanguage**
Browser Language | Opcional
Tipo: String
Longitud máxima:8 caracteres
Formatos aceptados:
[ISO 639-1](https://es.wikipedia.org/wiki/ISO_639-1) | El parámetro browserLanguage se usa para enviar el idioma de preferencia. Si el idioma enviado no es compatible con ACS o 3DSS, se mostrará el idioma configurado en el navegador. Si el idioma del navegador no es compatible con ACS o 3DSS, se mostrará el idioma configurado por defecto en cada aplicación (en).
**Device Channel:** BRW
**Message Category:** PA, NPA | es | +| **homePhone**
Cardholder Home Phone Number | Requerido si se proporciona el número de teléfono.
Tipo: Array
[ITU-E.164](https://www.itu.int/rec/dologin_pub.asp?lang=e&id=T-REC-E.164-201011-I!!PDF-S&type=items) | Número de teléfono de hogar.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | ```json {"cc": "01","subscriber": "20240808T153000"}``` | +| **homePhone.cc**
| Requerido con **homePhone**
Entre 1 y 3 dígitos | Código de país para el número de teléfono de hogar.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **01** | +| **homePhone.subscriber**
| Requerido con **homePhone**
Entre 1 15 dígitos | Número de suscriptor para el número de teléfono de hogar.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **1234567899** | +| **mobilePhone**
Cardholder Mobile Phone Number | Requerido si se proporciona el número de teléfono móvil.
Tipo: Array
[ITU-E.164](https://www.itu.int/rec/dologin_pub.asp?lang=e&id=T-REC-E.164-201011-I!!PDF-S&type=items) | Número de teléfono móvil.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | ```json {"cc": "01","subscriber": "20240808T153000"}``` | +| **mobilePhone.cc**
| Requerido con **mobilePhone**
Entre 1 y 3 dígitos | Código de país para el número de teléfono móvil.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **57** | +| **mobilePhone.subscriber**
| Requerido con **mobilePhone**
Entre 1 y 15 dígitos | Número de suscriptor para el número de teléfono móvil.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **3026015836** | +| **workPhone**
Cardholder Work Phone Number | Requerido si se proporciona el número de teléfono de trabajo.
Tipo: Array
[ITU-E.164](https://www.itu.int/rec/dologin_pub.asp?lang=e&id=T-REC-E.164-201011-I!!PDF-S&type=items) | Número de teléfono de trabajo.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | ```json {"cc": "01","subscriber": "20240808T153000"}``` | +| **workPhone.cc**
| Requerido con **workPhone**
Entre 1 y 3 dígitos | Código de país para el número de teléfono de trabajo.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **1** | +| **workPhone.subscriber**
| Requerido con **workPhone**
Entre 1 y 15 dígitos | Número de suscriptor para el número de teléfono de trabajo.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **1234567899** | +| **merchantRiskIndicator**
| Opcional
Tipo: Array | Indicador de riesgo del comerciante. Incluye varios sub-elementos relacionados con el riesgo de la transacción.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | | +| **merchantRiskIndicator.deliveryEmailAddress**
Delivery Email Address | Opcional
Tipo: Email
Longitud máxima: 254 caracteres | Dirección de correo electrónico para la entrega.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **example@example.com** | +| **merchantRiskIndicator.deliveryTimeframe**
Delivery Timeframe | Opcional
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) | Tiempo estimado para la entrega de los bienes.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **01** | +| **merchantRiskIndicator.giftCardAmount**
Gift Card Amount | Opcional
Tipo: String
Longitud máxima: 15 caracteres | Monto de la tarjeta de regalo.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **100.00** | +| **merchantRiskIndicator.giftCardCount**
Gift Card Count | Opcional
Tipo: String
Entre 1 y 2 dígitos | Cantidad de tarjetas de regalo.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **1** | +| **merchantRiskIndicator.giftCardCurr**
Gift Card Currency | Opcional
Tipo: String
Longitud máxima: 3 caracteres | Moneda de las tarjetas de regalo.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **USD** | +| **merchantRiskIndicator.preOrderDate**
Pre-Order Date | Opcional
Formato de fecha: **Ymd** | Fecha del pedido anticipado.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **20240808** | +| **merchantRiskIndicator.preOrderPurchaseInd**
Pre-Order Purchase Indicator | Opcional
Valores aceptados:
**01:** (Mercancía disponible)
**02:** (Disponibilidad futura) | Indicador de compra anticipada.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **02** | +| **merchantRiskIndicator.preOrderItemsInd**
| Opcional
Valores aceptados:
**01:** (Mercancía disponible)
**02:** (Disponibilidad futura) | Indicador de artículos anticipados.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **01** | +| **merchantRiskIndicator.shipIndicator**
Shipping Indicator | Opcional
Valores aceptados:
**01:** (Enviar a la dirección de facturación del titular)
**02:** (Enviar a otra dirección verificada del comerciante)
**03:** (Enviar a una dirección diferente a la del titular)
**04:** (Recoger en tienda / Recoger en una tienda local (la dirección de la tienda debe ser proporcionada 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:** (Tickets de viaje y eventos, no enviados)
**07:** Otro (por ejemplo, servicios digitales no enviados, suscripciones a medios electrónicos, etc.) | Indicador de envío.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **01** | +| **threeDSRequestorDecReqInd**
| Opcional
Tipo: String
Longitud máxima: 1
Valores aceptados: **Y**, **N** | Indicador de solicitud de decisión del solicitante 3DS.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **Y** | +| **acctID**
Cardholder Account Identifier | Condicional
Tipo: String
Longitud máxima: 64 caracteres | Identificador de cuenta.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **ABC1234567890** | +| **messageVersion**
Message Version Number | Opcional
Tipo: String
Valores aceptados
**2.2.0** | Versión del mensaje. **Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **2.2.0** | +| **messageCategory**
Message Category | Requerido
Valores aceptados
**01** (PA)
**02** (NPA) | Categoría del mensaje. **Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **01** | +| **addPriorInformation**
| Opcional
Tipo: String
Longitud máxima: 1
Valores aceptados:
**Y**, **N**
Prohibido cuando **threeDSRequestorPriorAuthenticationInfo** | Información adicional previa. **Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **Y** | +| **threeDSRequestorPriorAuthenticationInfo**
3DS Requestor Prior Transaction
Authentication Information | Condicional
Tipo: Array
Prohibico cuando **addPriorInformation** | Información previa de autenticación del solicitante 3DS. **Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | | +| **threeDSRequestor
PriorAuthenticationInfo.
threeDSReqPriorAuthMethod**
3DS Prior Authentication Method | Opcional
Tipo: String
Valores aceptados:
**FRICTIONLESS_AUTHENTICATION:** Autenticación sin fricciones
**CARDHOLDER_CHALLENGE_OCCURRED:** Se produjo un desafío para el titular de la tarjeta
**AVS_VERIFIED:** Verificación de AVS (Address Verification System)
**OTHER_ISSUER_METHODS:** Otros métodos del emisor
| Método de autenticación previo utilizado por el solicitante del 3DS. Indica el tipo de autenticación previa.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **CARDHOLDER_CHALLENGE_OCCURRED** | +| **threeDSRequestorPriorAuthenticationInfo.
threeDSReqPriorAuthTimestamp**
3DS Requestor Prior Transaction
Authentication Timestamp | Opcional
Tipo: String
Formatos: **YmdHi**, **c** | Marca de tiempo de la autenticación previa del solicitante 3DS.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **20240808153000** ó **2024-08-08T15:30:00Z** | +| **threeDSRequestorPriorAuthenticationInfo.
threeDSReqPriorRef**
3DS Requestor Prior Transaction
Reference | Opcional
Tipo: UUID
| Referencia de autenticación previa del solicitante 3DS.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | **550e8400-e29b-41d4-a716-446655440000** | +| **threeDSRequestorPriorAuthenticationInfo.
threeDSReqPriorAuthData**
3DS Requestor Prior Transaction
Authentication Data | Opcional
Tipo: String
Longitud máxima: 2048 caracteres | Datos de autenticación previa del solicitante 3DS.
**Device Channel:** BRW, RI, APP
**Message Category:** PA, NPA | | --- diff --git a/src/pages/three-d-s-server/api/terms-and-definitions.mdx b/src/pages/three-d-s-server/api/terms-and-definitions.mdx index 4c3e8a1..45669a6 100644 --- a/src/pages/three-d-s-server/api/terms-and-definitions.mdx +++ b/src/pages/three-d-s-server/api/terms-and-definitions.mdx @@ -1,6 +1,7 @@ +export const sectionMode = 'nav'; -# Términos y Definiciones +## Términos generales Las siguientes definiciones pretenden dar claridad sobre la información presentada a lo largo de este documento. @@ -50,4 +51,85 @@ Las siguientes definiciones pretenden dar claridad sobre la información present - **Titular de la Tarjeta:** Una persona a quien se le emite una tarjeta o que está autorizada para usar dicha tarjeta. - **Token de autenticación:** Es una cadena de texto que no pretende tener un significado alguno y representa un acceso de autorización que es emitido al cliente. El token permite reemplazar las credenciales de autenticación del propietario directamente, con el fin de proteger la información. - **Valor de autenticación - AV:** Un valor criptográfico generado por el ACS para proporcionar una forma, durante el procesamiento de autorización, para que el sistema de autorización valide la integridad del resultado de la autenticación. El algoritmo AV es definido por cada Sistema de Pago. -- **Versión del Mensaje:** Se refiere a la versión del protocolo que será utilizada por todos los componentes para procesar la transacción 3-D Secure. La versión del mensaje siempre es consistente en todos los mensajes del protocolo 3-D Secure para una transacción específica. \ No newline at end of file +- **Versión del Mensaje:** Se refiere a la versión del protocolo que será utilizada por todos los componentes para procesar la transacción 3-D Secure. La versión del mensaje siempre es consistente en todos los mensajes del protocolo 3-D Secure para una transacción específica. +- **Transacción iniciada por el Titular de la Tarjeta (CIT):** Cualquier transacción en la que el titular de la tarjeta participa activamente en la transacción. Las transacciones pueden realizarse con base en las credenciales proporcionadas por el titular de la tarjeta en el momento de la transacción o una credencial almacenada de una interacción previa. Las transacciones pueden ocurrir como una transacción en punto de venta **POS** en tienda, una transacción de comercio electrónico, una orden por correo/teléfono, o en un cajero automático **ATM**. +- **Transacción Iniciada por el Comerciante (MIT):** Una transacción donde el titular de la tarjeta no participa activamente en la transacción. Las **MIT** a menudo pueden ser precedidas por una CIT **que involucre una PA - Payment Authentication** o una Consulta de Estado de Cuenta **ASI, por sus siglas en inglés**. +- **Payment Authentication (PA):** Implica monto de autenticación +- **Not Payment Authentication (NPA):** No implica monto + + +--- + +## Pago Recurrente / Cuotas + +Una transacción que surge de un acuerdo entre el titular de la tarjeta y el comerciante mediante el cual el titular de la tarjeta acepta que el comerciante almacene la credencial del titular de la tarjeta y utilice esa credencial almacenada para una compra subsiguiente de bienes o servicios. Estas transacciones pueden clasificarse como: + +* Orden permanente +* Suscripción +* Cuota pagos diferidos +* CREDENCIAL-ON-FILE no programada + +--- + +## Práctica de la Industria MIT + +Una transacción iniciada por el comerciante para cumplir con una práctica comercial que ocurre más a menudo después de una interacción inicial con el titular de la tarjeta. Las transacciones pueden realizarse con credenciales que están almacenadas en archivo, o credenciales que no están almacenadas en archivo, sino que son temporalmente retenidas por el comerciante según lo acordado por el consumidor. Estas MIT de práctica de la industria pueden clasificarse como: + +* Envíos parciales +* Entregas parciales o retrasadas +* No presentación (Tarjetahabiente no está presente para tomar el servicio) +* Reenvío + +--- + +## Tipos de mensajes 3RI admitidos + +La funcionalidad 3RI abarca varios casos de uso técnicos y comerciales diferentes que son principalmente definidos por los siguientes campos EMV 3DS: + +• **Canal de dispositivo (deviceChannel)** = '03' + +• **Campo Indicador 3RI (tresRIInd)** en la solicitud de autenticación **AReq** que define el tipo de Transacción 3RI. No todos los valores de campo del indicador 3RI documentados en la especificación EMV 3DS actualmente son compatibles con las marcas + +| 3RI Indicador (threeRIInd) | Marcas | Pago (PA) | No Pago (NPA) | +|-----------------------------------------|------------------|-----------|---------------| +| **(01)** Recurring Transaction | Visa, Mastercard | SI | NO | +| **(02)** Installment Transaction | Visa, Mastercard | SI | NO | +| **(03)** Add Card | Visa, Mastercard | NO | SI | +| **(04)** Maintain Card Information | Visa, Mastercard | NO | SI | +| **(05)** Account Verification | Visa, Mastercard | NO | SI | +| **(06)** Split/Delayed Shipment | Visa, Mastercard | SI | NO | +| **(07)** Top-up | Visa, Mastercard | NO | NO | +| **(08)** Mail Order | Visa, Mastercard | NO | NO | +| **(09)** Telephone Order | Visa, Mastercard | NO | NO | +| **(10)** Whitelist Status Check | Visa, Mastercard | NO | SI | +| **(11)** Other Payment | Visa, Mastercard | SI | NO | +| **(81)** Unscheduled Credential-on-File | Visa | SI | NO | + +--- + +## Preguntas frecuentes + +* **¿Es posible Agregar Tarjeta ***"threeDSAuthenticationInd": "04"*** y hacer la Autenticación de un Pago (PA) al mismo tiempo?** + +No es posible. En el proceso de Agregar Tarjeta a un comercio para validar la identidad de la tarjeta habiente, es permitido enviar un monto, en cuyo caso se descontará el monto para la verificación de fondos y DEBE ser reembolsado posteriormente por el comercio, lo cual no representa una Autenticación Pago en sí mismo. + +Es necesario enviar posterior al proceso de Agregar Tarjeta otra autenticación con el monto a Autenticacior + +* **¿Se puede usar una CIT NPA como PriorInformation para una MIT PA?** + +Es posible UNICAMENTE en el escenario de un pago único, en este caso, se podrá utilizar una CIT NPA de tipo “Agregar Tarjeta” **este es el único caso confirmado para este uso**. La transacción MIT deberá mandarse con el indicativo threeRIInd=81 **Unscheduled Credential-on-File**, este tipo de transacción no requiere ningún valor de recurrencia **recurringExpiry, recurringFrequency** únicamente el monto que se va a pagar. Eventualmente otros casos de uso pueden ser agregados en versiones del Protocolo. Esto aplica exclusivamente para VISA usando la extensión DAF + +La razón principal es que estas dos categorías de transacciones tienen naturalezas diferentes y propósitos distintos: + + 1. **MIT (Merchant Initiated Transaction):** Una MIT es iniciada por el comerciante en lugar del titular de la tarjeta. Por lo general, las MIT se utilizan para pagos recurrentes, como suscripciones mensuales o anuales, donde el comerciante tiene la autorización del titular de la tarjeta para cargar periódicamente el monto acordado en su tarjeta. En las MIT, la autenticación suele ser realizada por el comerciante y no requiere la interacción activa del titular de la tarjeta en el momento de la transacción. + 2. **CIT NPA ***Customer Initiated Transaction - Non Payment Authentication***:** Una CIT NPA es una transacción iniciada por el titular de la tarjeta que no implica un pago directo, sino que se utiliza para otros fines, como la verificación de la tarjeta o la consulta de saldo. En una CIT NPA, se puede realizar una autenticación sin que se realice una transferencia de fondos directa. + +Dado que una MIT implica un pago por parte del comerciante y una CIT NPA no implica un pago directo, no tendría sentido lanzar una transacción MIT junto con una CIT NPA. Cada tipo de transacción tiene su propio propósito y aplicación específica en el contexto del protocolo **3D Secure**. + +En pocas palabras: es posible unsar una CIT NPA en una MIT PA si el pago es único **no recurrente**. + +Unscheduled card-on-file transactions **UCOF**: A transaction using a stored credential for a fixed or variable amount that does not occur on a scheduled or regularly occurring transaction date, where the cardholder has provided consent for the merchant to initiate one or more future transactions + +* **Visa Digital Authentication Framework DAF** + +Visa Digital Authentication Framework DAF es una extensión de mensaje del protocolo 3DS que le permite a Visa identificar a titulares de tarjetas que superaron el flujo de autenticación con desafío en un determinado comercio - adquirente, para así otorgarles un estado de confiabilidad al determinarlos como credencial de pago autenticada ***Authenticated Credential Payment - ACP***, esto permite que las siguientes transacciones que ejecute el tarjetahabiente en el mismo comercio sean autenticadas de inmediato. diff --git a/src/pages/three-d-s-server/api/transactions/index.mdx b/src/pages/three-d-s-server/api/transactions/index.mdx index 346e26a..52441d3 100644 --- a/src/pages/three-d-s-server/api/transactions/index.mdx +++ b/src/pages/three-d-s-server/api/transactions/index.mdx @@ -83,7 +83,7 @@ Los siguientes pasos le darán una guía para la utilización del mismo: "threeDSServerTransID":"1ed95a50eee5-48a8-91fa-6a1ee6378dba", "sdkTransID":null, "authenticationValue":"AJkBAmBANQAAACcPhAI0dAJBQVk=", - "messageVersion":"2.1.0", + "messageVersion":"2.2.0", "authMethod":"FRICTIONLESS_AUTHENTICATION", "authTimestamp":"2020-04-21T01:44:54+00:00", "enrolled":null, diff --git a/src/pages/three-d-s-server/faq.mdx b/src/pages/three-d-s-server/faq.mdx index bb984fa..bccb115 100644 --- a/src/pages/three-d-s-server/faq.mdx +++ b/src/pages/three-d-s-server/faq.mdx @@ -1,14 +1,12 @@ +# Preguntas frecuentes sobre el funcionamiento 3DSS API +En esta sección podrá encontrar respuestas a preguntas o solución a problemas que puede encontrarse en 3DSS. -# Preguntas frecuentes sobre el funcionamiento MPI +## ¿Qué significan las siglas 3DSS? -En esta sección podrá encontrar respuestas a preguntas o solución a problemas que puede encontrarse en MPI. +Las siglas 3DSS en el protocolo 3DS (3D Secure) de EMVCo se refieren a Three-Domain Secure Server o 3D Secure Server. Este servidor es uno de los componentes clave dentro del ecosistema del protocolo 3D Secure, que se utiliza para autenticar de manera segura a los titulares de tarjetas en transacciones de pago en línea. -## ¿Qué significan las siglas MPI? - -3DSS traduce en inglés Merchant Server Plugin o en español, Complemento del Servidor de Comercio. - -## ¿Para qué es necesario MPI? +## ¿Para qué es necesario 3DSS? La aplicación de 3DSS permite la comunicación entre el solicitante de la autenticación, que puede ser la pasarela de pagos, y el servidor de directorio que comunica a su vez con el otro componente del 3-D Secure (ACS). De tal forma, 3DSS es necesario porque es el componente que inicia el flujo de autenticación y envía la petición de autenticación a procesar, para obtener posteriormente una respuesta de autenticación y devolverla al solicitante. @@ -22,100 +20,6 @@ El Protocolo 3-D Secure es quien define y describe la infraestructura y las paut Recomendamos leer la documentación en su totalidad, ya que en cada una de las secciones se describen situaciones particulares que se pueden experimentar y sus respectivas soluciones -## ¿Cómo acceder a MPI? - -Para acceder a la consola de MPI, se requiere de un usuario registrado, con permisos y cuyo acceso haya sido autorizado mediante una invitación, con el cual procederá a iniciar sesión. - -### Usuario: -Para obtener el usuario de MPI, se debe hacer mediante una invitación que creará un usuario registrado y autenticado actualmente en la aplicación. - -Para obtener más información de las invitaciones, diríjase a la sección de **Seguridad** y luego **Invitaciones**, de esta documentación. - -### Activación de usuario: - -Posterior a la creación de una invitación, será enviado un correo electrónico al correo registrado en el formulario de creación, con el cual podrá activar el usuario. -Para activar el usuario, haga clic en el botón **Activar Registro** y se redireccionará a la página de inicio de sesión de MPI. - -### Inicio de sesión: - -En este formulario de inicio de sesión, ingrese el correo electrónico con el cual fue creada la invitación y la contraseña. - -### Restablecimiento de contraseña: - -Si olvidó la contraseña de inicio de sesión, puede hacer clic en la opción **¿Olvidaste tu contraseña?** y se redireccionará a un formalario para ingresar su correo electrónico y enviar una solicitud de cambio de contraseña. - - -## ¿Cómo mostrar datos en las diferentes métricas? - -Cuando accede a la sección de métricas puede preguntarse ¿cómo obtener información a partir de las gráficas?, la respuesta a esta pregunta es que debe hacer un filtrado de datos en primer lugar, para ello haga clic en el botón **Filtrar** como lo ilustra la siguiente imagen y posteriormente seleccione los datos con los cuales desea que se grafiquen y se muestren estadísticas de funcionamiento de la aplicación. - -Para obtener información más detallada del funcionamiento de las métricas, diríjase al menú **Funcionamiento de MPI** -> **Funcionalidades**. - -## ¿Puedo acceder a registros de cambios e interacciones realizadas en la aplicación? - -La aplicación de 3DSS contiene un módulo ubicado en el menú **Seguridad** -> **Logs**, donde se registran los movimientos realizados en la aplicación, con el detalle del número de registro, la fecha, hora, usuario, descripción del movimiento y datos del equipo desde el cual se realizó. - -## ¿Cómo se validan los datos que ingresan los usuarios en los diferentes formularios de la aplicación? - -### Validación de datos: - -Para todos los formularios de la aplicación, se dispone de la funcionalidad de validación de los datos ingresados, lo cual permite asegurar la integridad y veracidad de éstos. - -De esta forma, al diligenciar el formulario puede encontrar y verificar dos tipos de validaciones: - -1. **Validaciones de lado del cliente:** - - Estas validaciones se realizan cuando un dato no cumple las reglas mínimas de aceptación y no hay necesidad de enviar la respuesta al servidor si se ha validado previamente que está errónea la información. Se visualizan con mensajes en rojo para el campo erróneo y le ofrece al usuario una ayuda de cómo debe diligenciar el campo en cuestión para ser aceptado. Si hay errores en estas validaciones, la aplicación no permite el envío del formulario. - - -1. **Validaciones de lado del servidor:** - - Estas validaciones se aplican cuando se envía un formulario o unos datos al servidor y estos no cumplen con las validaciones requeridas, por lo cual se genera un error,se deniega la solicitud y posteriormente, se muestra al usuario el error encontrado. Estas validaciones se ejecutan cuando no se han registrado como validaciones del lado del cliente, o son complicadas de validar del lado del cliente o el usuario logra por algún medio pasar el primer filtro de validaciones del cliente con la información errónea, sin embargo, este filtro de validaciones detiene una solicitud con datos inválidos. - - -## ¿Cómo funciona el paginador que se encuentra en los módulos de la aplicación? - -En la vista principal de cada módulo, donde se presenta el listado de datos, se encuentra un paginador en la parte inferior de la pantalla. Este paginador permite obtener listas de datos agrupadas más fáciles de visualizar. - -El paginador contiene varias funcionalidades dentro de sí: - - 1. **Seleccionar cantidad de registros:** Puede seleccionar la cantidad de registros a visualizar en la opción **Mostrar** ubicada en la parte izquierda, despliegue el campo y seleccione la cantidad de registros que desea mostrar por página. - -2. **Cambiar de página:** Puede cambiar de página en dos partes. En la parte central puede hacer clic en el número de la página que desea mostrar y en la parte lateral derecha, puede aumentar o disminuir la página a mostrar, haciendo uso de las flechas de arriba y abajo del campo. - -3. **Mostrar cantidad de registros:** El paginador muestra la cantidad de registros en dos partes. En la parte central muestra el rango de datos iniciales y finales dependiendo de la página seleccionada y muestra el total de registros. Además, en la parte lateral derecha muestra cuántas páginas tiene el listado de registros. - -# Eventos frecuentes y soluciones - -## ¿Cómo ocultar la pestaña de selección de filtros? - -Cuando accede a módulos de la aplicación que contienen la funcionalidad de filtros (para hacer búsquedas específicas de información). Puede encontrarse con la necesidad de ocultar la pestaña de filtros para tener mayor acceso y visualización a la información mostrada. - -Para ocultar la pestaña o sección, lo único que debe hacer es dar clic nuevamente en el botón de filtros. - -## ¿Qué hacer cuando el token de acceso ha expirado? - -Al generar una petición de autenticación, podrá obtener el mensaje **"No Autenticado"**, lo cual indica que el token de acceso para hacer solicitudes a un comercio específico ha expirado. - -Para solucionar este error, diríjase al detalle del comercio con el cual desea procesar la autenticación, posteriormente deslice la barra del detalle hacia abajo hasta encontrar la sección **Tokens**. - -Allí podrá visualizar el token que estaba utilizando y corroborar la fecha de expiración, además de que podrá crear uno nuevo para continuar con el proceso de autenticación. - -#### Crear nuevo token: - -Para crear el nuevo token, haga clic en el botón **Crear token**, asigne un nombre que le permita identificarlo y haga clic en el botón **Guardar**. Luego es importante que copie el bloque de texto que se asignó para el token, ya que este solo se muestra en esta ocasión y si lo pierde, debe proceder a crear uno nuevo. - -## ¿El número de tarjeta no está en el rango? - -Cuando procese una petición de autenticación, es probable que pueda ocurrirle el error **"La longitud del número de tarjeta no coincide con los valores esperados"**, el cual -indica que el número de tarjeta con el cual está intentando ejecutar una petición de autenticación, no está en el rango de tarjetas ingresadas para esa franquicia. - -Para solucionar este error debe dirigirse a la franquicia con la cual está intentando procesar la autenticación, ir al detalle de esta, luego a la sección servidores de directorio y luego seleccione el servidor de directorio encargado de la autenticación y diríjase al detalle de este. - -Luego en el detalle del servidor de directorio, podrá visualizar los rangos de tarjeta disponibles y corroborar que la tarjeta que está intentando autenticar, no está en los rangos dados. - -Los rangos de tarjetas se sincronizan con los servidores de directorio a partir de los bines registrados en cada adquirente. De esta forma, si un rango de tarjeta no se encuentra disponible, debe de proceder a comunicarse con el servidor de directorio para que haga el respectivo proceso de sincronización de rangos de tarjeta. - # Contacto y soporte Si existe alguna duda o la solución al problema que posee no está contenida en esta documentación, puede acceder al servicio de posventa que brinda la compañía para atender su requerimiento. diff --git a/src/pages/three-d-s-server/index.mdx b/src/pages/three-d-s-server/index.mdx index c4e57b1..98b5c06 100644 --- a/src/pages/three-d-s-server/index.mdx +++ b/src/pages/three-d-s-server/index.mdx @@ -16,17 +16,16 @@ Esta documentación está diseñada para ofrecer una comprensión completa del p ## Redes Soportadas -3DS Placetopay se encuentra certificado en las versiones **EMV® 3DS 2.1.0 y 2.2.0** en los siguientes programas: - -| | EMV® 3DS 2.1.0 | EMV® 3DS 2.2.0 | -|---------------------------|----------------|----------------| -| Visa Secure | **Soportado** | **Soportado** | -| Mastercard Identity Check | **Soportado** | **Soportado** | -| American Express SafeKey® | **Soportado** | **Soportado** | -| Discover ProtectBuy | **Soportado** | **Soportado** | -| Diners ProtectBuy | **Soportado** | **Soportado** | -| ELO (Brasil) | En progreso | En progreso | - +3DSS Placetopay se encuentra certificado en las versiones **EMV® 3DS 2.2.0** en los siguientes programas: + +| | EMV® 3DS 2.2.0 | +|---------------------------|----------------| +| Visa Secure | **Soportado** | +| Mastercard Identity Check | **Soportado** | +| American Express SafeKey® | **Soportado** | +| Discover ProtectBuy | **Soportado** | +| Diners ProtectBuy | **Soportado** | +| ELO (Brasil) | **Soportado** | **Nota:** "Soportado" significa que la red ya está completamente integrada y funcional. "En progreso" indica que estamos trabajando en la integración y se espera que esté disponible próximamente. Actualmente, estamos en el proceso de obtener la certificación para **EMV® 3DS 2.3.1**, la cual esperamos completar en 2024. diff --git a/src/pages/three-d-s-server/panel/configurations.mdx b/src/pages/three-d-s-server/panel/configurations.mdx index 2202a3e..9f53472 100644 --- a/src/pages/three-d-s-server/panel/configurations.mdx +++ b/src/pages/three-d-s-server/panel/configurations.mdx @@ -190,7 +190,7 @@ Puede eliminar un certificado, haciendo clic en la opción *Eliminar*.. ### Creación del CSR (Solicitud de firma para un certificado): -Para crear un nuevo certificado en MPI, haga clic en el botón **Crear** ubicado en la parte lateral derecha del índice de certificados. +Para crear un nuevo certificado en 3DSS, haga clic en el botón **Crear** ubicado en la parte lateral derecha del índice de certificados. Visualizará un formulario similar al siguiente: @@ -389,7 +389,7 @@ Para acceder a este módulo, diríjase al menú lateral izquierdo, despliegue la ## Índice de aliados comerciales: -En esta sección se visualiza el índice o listado de los aliados comerciales registrados en MPI. +En esta sección se visualiza el índice o listado de los aliados comerciales registrados en 3DSS. Un ejemplo de este índice es el siguiente: diff --git a/src/pages/three-d-s-server/panel/franchise-configuration.mdx b/src/pages/three-d-s-server/panel/franchise-configuration.mdx index 7e51b73..4dc5b38 100644 --- a/src/pages/three-d-s-server/panel/franchise-configuration.mdx +++ b/src/pages/three-d-s-server/panel/franchise-configuration.mdx @@ -1,12 +1,12 @@ -# Franquicias en MPI +# Franquicias en 3DSS ## ¿Qué es una franquicia? Una franquicia de una tarjeta de crédito, es una compañía aliada con los bancos emisores de tarjetas de crédito. Tienen como función proveer diversos beneficios bancarios a sus clientes (tarjetabientes) y gestionar el uso de las tarjetas. -## ¿Cómo acceder a la gestión de franquicias de MPI? +## ¿Cómo acceder a la gestión de franquicias de 3DSS? Para acceder al listado de franquicias de la aplicación siga los siguientes pasos: @@ -15,7 +15,7 @@ Para acceder al listado de franquicias de la aplicación siga los siguientes pas 2. Visualizará una pantalla con el listado de franquicias organizadas en una tabla, la cual corresponde al índice de franquicias: -# ¿Cómo crear una franquicia en MPI? +# ¿Cómo crear una franquicia en 3DSS? Para crear una franquicia, haga clic en el botón **Crear** ubicado en la parte lateral derecha del índice de franquicias, posteriormente diligencie los datos del formulario teniendo en cuenta la siguiente información: @@ -27,7 +27,7 @@ Para crear una franquicia, haga clic en el botón **Crear** ubicado en la parte - **Certificados intermedios,** Copie y pegue en este campo el bloque de texto correspondiente al certificado intermedio. -- **Certificados raíz,** Copie y pegue en este campo el bloque de texto correspondiente al certificado raíz. +- **Certificado raíz,** Copie y pegue en este campo el bloque de texto correspondiente al certificado raíz. ## ¿Cuáles son los requerimientos para crear una franquicia? diff --git a/src/pages/three-d-s-server/panel/functionalities.mdx b/src/pages/three-d-s-server/panel/functionalities.mdx index 8a10fa5..5e1ab5e 100644 --- a/src/pages/three-d-s-server/panel/functionalities.mdx +++ b/src/pages/three-d-s-server/panel/functionalities.mdx @@ -116,7 +116,7 @@ Para acceder a la gestión de transacciones, vaya al menú lateral izquierdo, se ## Índice de transacciones: -En este módulo se registra la información de todas las transacciones procesadas por MPI. En este índice se encuentra el listado de las transacciones con fecha, país, comercio, referencia, monto de la transacción, categoría, versión y resumen de la traza. +En este módulo se registra la información de todas las transacciones procesadas por 3DSS. En este índice se encuentra el listado de las transacciones con fecha, país, comercio, referencia, monto de la transacción, categoría, versión y resumen de la traza. El índice de transacciones se visualiza como en la siguiente imagen: @@ -230,7 +230,7 @@ Para acceder al módulo de reportes, diríjase al menú lateral izquierdo, despl ## Índice de reportes: -Los reportes son archivos que contienen registros de las transacciones procesadas por MPI. +Los reportes son archivos que contienen registros de las transacciones procesadas por 3DSS. La siguiente imagen muestra un ejemplo de la vista con el índice de reportes generados. diff --git a/src/pages/three-d-s-server/panel/general-configuration.mdx b/src/pages/three-d-s-server/panel/general-configuration.mdx index 10de04d..d683fba 100644 --- a/src/pages/three-d-s-server/panel/general-configuration.mdx +++ b/src/pages/three-d-s-server/panel/general-configuration.mdx @@ -1,6 +1,6 @@ -# ¿Cómo configurar MPI? +# ¿Cómo configurar 3DSS? Para obtener un óptimo funcionamiento de la aplicación, esta se debe configurar adecuadamente, con el fin de que pueda pueda hacer las peticiones y dar respuestas a los componentes del 3-D Secure con los cuales tiene relación, de forma efectiva. @@ -16,7 +16,7 @@ Seleccione el **idioma** con el cual desea que se presente toda la información Ubique y **familiarícese con los módulos** en los cuales se divide la aplicación y las funcionalidades que cada uno contiene. Estos se encuentran en el menú ubicado en la parte lateral izquierda de la aplicación. #### Tablero: -En este módulo se encuentran las principales funcionalidades de MPI, conformando el tablero principal con el cual el usuario se va a relacionar de forma frecuente. +En este módulo se encuentran las principales funcionalidades de 3DSS, conformando el tablero principal con el cual el usuario se va a relacionar de forma frecuente. Se encuentran en el menú: @@ -24,7 +24,7 @@ En este módulo se encuentran las principales funcionalidades de MPI, conformand - Listado, detalles y funcionalidades para las transacciones procesadas por el componente 3DS Server. - Listado, detalles y funcionalidades para los reportes gestionados en diferentes módulos de la aplicación, como reportes de transacciones. -> Este módulo y sus funcionalidades, se revisan y explican detalladamente en la sección de **Funcionamiento de MPI** -> **Funcionalidades**, en esta esta documentación. +> Este módulo y sus funcionalidades, se revisan y explican detalladamente en la sección de **Funcionamiento de 3DSS** -> **Funcionalidades**, en esta esta documentación. #### Configuración: @@ -42,11 +42,11 @@ En este módulo se encuentran los componentes que permiten configurar 3DSS y ges - Listado, detalles y funcionalidades para los aliados comerciales. - Listado, detalles y funcionalidades para los tipos de adjuntos. -> Este módulo y sus funcionalidades, se revisan y explican detalladamente en la sección de **Funcionamiento de MPI** -> **Configuración**, de esta documentación. +> Este módulo y sus funcionalidades, se revisan y explican detalladamente en la sección de **Funcionamiento de 3DSS** -> **Configuración**, de esta documentación. #### Seguridad: -En este módulo se encuentran los componentes que gestionan los registros de movimientos, los accesos y la seguridad para MPI. +En este módulo se encuentran los componentes que gestionan los registros de movimientos, los accesos y la seguridad para 3DSS. Se encuentran en el menú: @@ -54,40 +54,40 @@ En este módulo se encuentran los componentes que gestionan los registros de mov - Listado, detalles y funcionalidades para los usuarios registrados en la aplicación. - Listado, detalles y funcionalidades relacionadas con los roles creados en la aplicación. - Listado, detalles y funcionalidades de las invitaciones creadas para gestionar los usuarios de la aplicación. - - Listado, detalles y funcionalidades de los perfiles para usuarios de MPI. - - Listado y gestión de los registros de movimientos realizados por los diferentes usuarios de MPI. + - Listado, detalles y funcionalidades de los perfiles para usuarios de 3DSS. + - Listado y gestión de los registros de movimientos realizados por los diferentes usuarios de 3DSS. - > Este módulo y sus funcionalidades, se revisan y explican detalladamente en la sección de **Funcionamiento de MPI** -> **Seguridad**, de esta documentación. + > Este módulo y sus funcionalidades, se revisan y explican detalladamente en la sección de **Funcionamiento de 3DSS** -> **Seguridad**, de esta documentación. ### Paso 4: -Cree los ***aliados comerciales***. Siga la guía dada en el menú de **Funcionamiento de MPI** -> **Configuración** -> **Otras configuraciones** -> **Aliados comerciales** de la presente documentación, y habílitelos según los requiera. +Cree los ***aliados comerciales***. Siga la guía dada en el menú de **Funcionamiento de 3DSS** -> **Configuración** -> **Otras configuraciones** -> **Aliados comerciales** de la presente documentación, y habílitelos según los requiera. ### Paso 5: -Cree los ***consultores comerciales***. Siga la guía dada en el menú de **Funcionamiento de MPI** -> **Configuración** -> **Otras configuraciones** -> **Consultores comerciales**, de la presente documentación, y habílitelos según los requiera. +Cree los ***consultores comerciales***. Siga la guía dada en el menú de **Funcionamiento de 3DSS** -> **Configuración** -> **Otras configuraciones** -> **Consultores comerciales**, de la presente documentación, y habílitelos según los requiera. ### Paso 6: -Cree los ***comercios*** con los cuales tiene convenio. Siga la guía dada en el menú de **Funcionamiento de MPI** -> **Configuración** -> **Configuración de comercios**, de la presente documentación, y habílitelos según los requiera. +Cree los ***comercios*** con los cuales tiene convenio. Siga la guía dada en el menú de **Funcionamiento de 3DSS** -> **Configuración** -> **Configuración de comercios**, de la presente documentación, y habílitelos según los requiera. ### Paso 7: -Cree las ***franquicias*** con las cuales esté certificada MPI. Siga la guía dada en el menú de **Funcionamiento de MPI** -> **Configuración** -> **Configuración de franquicias**, de la presente documentación, y habílitelas según las requiera. +Cree las ***franquicias*** con las cuales esté certificada 3DSS. Siga la guía dada en el menú de **Funcionamiento de 3DSS** -> **Configuración** -> **Configuración de franquicias**, de la presente documentación, y habílitelas según las requiera. ### Paso 8: -Cree los ***servidores de directorio*** (DS), respectivos para cada franquicia. Para ello vaya al detalle de cada franquicia, a la sección *Servidores de directorio*. Para obtener más detalles, siga la guía dada en el menú de **Funcionamiento de MPI** -> **Configuración** -> **Configuración de franquicias**, de la presente documentación, y habílitelos según los requiera. +Cree los ***servidores de directorio*** (DS), respectivos para cada franquicia. Para ello vaya al detalle de cada franquicia, a la sección *Servidores de directorio*. Para obtener más detalles, siga la guía dada en el menú de **Funcionamiento de 3DSS** -> **Configuración** -> **Configuración de franquicias**, de la presente documentación, y habílitelos según los requiera. ### Paso 9: -Cree ***configuraciones para cada servidor de directorio*** (DS). Para ello vaya al detalle de cada franquicia, luego a la sección *Servidores de directorio*, y luego al detalle de cada servidor de directorio y a la sección *Configuraciones*. Para obtener más detalles, siga la guía dada en el menú de **Funcionamiento de MPI** -> **Configuración** -> **Configuración de franquicias**, de la presente documentación. +Cree ***configuraciones para cada servidor de directorio*** (DS). Para ello vaya al detalle de cada franquicia, luego a la sección *Servidores de directorio*, y luego al detalle de cada servidor de directorio y a la sección *Configuraciones*. Para obtener más detalles, siga la guía dada en el menú de **Funcionamiento de 3DSS** -> **Configuración** -> **Configuración de franquicias**, de la presente documentación. ### Paso 10: -Cree los ***adquirientes*** con los cuales tiene convenio. Siga la guía dada en el menú de **Funcionamiento de MPI** -> **Configuración** **Otras configuraciones** -> **Adquirientes**, de la presente documentación, y habílitelos según los requiera. +Cree los ***adquirientes*** con los cuales tiene convenio. Siga la guía dada en el menú de **Funcionamiento de 3DSS** -> **Configuración** **Otras configuraciones** -> **Adquirientes**, de la presente documentación, y habílitelos según los requiera. ### Paso 11: -Cree los ***bines*** que requiera para cada adquiriente creado. Los bines hacen referencia a los primeros 6 dígitos de las tarjetas que pueden procesar las franquicias de cada adquieriente. Para ello vaya al detalle de cada adquiriente, a la sección *Bines*. Para obtener más detalles, siga la guía dada en el menú de **Funcionamiento de MPI** -> **Configuración** **Otras configuraciones** -> **Adquirientes**, de la presente documentación. +Cree los ***bines*** que requiera para cada adquiriente creado. Los bines hacen referencia a los primeros 6 dígitos de las tarjetas que pueden procesar las franquicias de cada adquieriente. Para ello vaya al detalle de cada adquiriente, a la sección *Bines*. Para obtener más detalles, siga la guía dada en el menú de **Funcionamiento de 3DSS** -> **Configuración** **Otras configuraciones** -> **Adquirientes**, de la presente documentación. ### Paso 12: -Cree el ***certificado SSL*** para cada comercio, y fírmelo. Para más detalle de este proceso siga la guía dada en el menú de **Funcionamiento de MPI** -> **Configuración** **Otras configuraciones** -> **Certificados**, de la presente documentación. +Cree el ***certificado SSL*** para cada comercio, y fírmelo. Para más detalle de este proceso siga la guía dada en el menú de **Funcionamiento de 3DSS** -> **Configuración** **Otras configuraciones** -> **Certificados**, de la presente documentación. ### Paso 13: ***Suscriba adquirientes*** por franquicia y versión del protocolo para cada comercio. Para ello diríjase al detalle de cada comercio, a la sección *Adquirientes suscritos*, haga clic en el botón *Suscribir adquiriente*, diligencie el formulario y luego en el listado de *Adquirientes suscritos*, haga clic en el ícono con forma de probeta, para validar la suscripción, esta debe arrojarle un mensaje de éxito, además el certificado debe aparecer como "OK" y con el estado "Disponible*, en el listado de adquirientes suscritos. ### Paso 14: -Cree un ***token de acceso*** y autentiquese con este en la API para comenzar a procesar transacciones. Para ello vaya al detalle de cada comercio, a la sección *Tokens*. Para obtener más detalles, siga la guía dada en el menú de **Funcionamiento de MPI** -> **Configuración** **Otras configuraciones** -> **Certificados**, de la presente documentación. \ No newline at end of file +Cree un ***token de acceso*** y autentiquese con este en la API para comenzar a procesar transacciones. Para ello vaya al detalle de cada comercio, a la sección *Tokens*. Para obtener más detalles, siga la guía dada en el menú de **Funcionamiento de 3DSS** -> **Configuración** **Otras configuraciones** -> **Certificados**, de la presente documentación. \ No newline at end of file diff --git a/src/pages/three-d-s-server/panel/merchant-configuration.mdx b/src/pages/three-d-s-server/panel/merchant-configuration.mdx index 410e188..902f1a7 100644 --- a/src/pages/three-d-s-server/panel/merchant-configuration.mdx +++ b/src/pages/three-d-s-server/panel/merchant-configuration.mdx @@ -1,18 +1,18 @@ -# Comercios en MPI +# Comercios en 3DSS ## ¿Qué es un comercio? Un comercio en 3DSS son todas aquellas organizaciones establecidas legalmente y con convenio con Evertec Placetopay, que permiten la compra y venta de bienes o servicios de forma virtual, utilizando los productos que ofrece la compañía en cuanto a soluciones transaccionales y de seguridad. -## ¿Cómo acceder a la gestión de comercios de MPI? +## ¿Cómo acceder a la gestión de comercios de 3DSS? Para acceder al listado de comercios de la aplicación siga los siguientes pasos: Remítase al menú lateral izquierdo dónde visualizará tres opciones, "Tablero", "Configuración" y "Seguridad", seleccione **Configuración** y luego **Comercios**: -# ¿Cómo crear un comercio en MPI? +# ¿Cómo crear un comercio en 3DSS? Para crear un comercio, haga clic en el botón **Crear** ubicado en la parte lateral derecha del índice de comercios. @@ -28,26 +28,26 @@ Para diligenciarlo tenga en cuenta los siguientes datos: - **Moneda:** Seleccione de la lista desplegable la moneda con la cual procesa las transacciones el comercio. -- **Clase CIIU:** Seleccione de la lista desplegable la clase de categoría de actividad económica del comercio, para ello guíese con el indicador numérico que precede a la descripción de la actividad. Para más información de este campo, puede dirigirse al módulo de esta documentación en la siguiente ruta: **Funcionamiento de MPI** -> **Configuración** -> **Otras configuraciones** -> **Clases CIIU**. +- **Clase CIIU:** Seleccione de la lista desplegable la clase de categoría de actividad económica del comercio, para ello guíese con el indicador numérico que precede a la descripción de la actividad. Para más información de este campo, puede dirigirse al módulo de esta documentación en la siguiente ruta: **Funcionamiento de 3DSS** -> **Configuración** -> **Otras configuraciones** -> **Clases CIIU**. -- **Código de categoría del comerciante:** Seleccione de la lista desplegable el código de categoría del comerciante correspondiente al comercio a registrar, para ello guíese con el indicador numérico que precede a la descripción de la actividad. Para más información de este campo, puede dirigirse al módulo de esta documentación en la siguiente ruta: **Funcionamiento de MPI** -> **Configuración** -> **Otras configuraciones** -> **Códigos del comercio**. +- **Código de categoría del comerciante:** Seleccione de la lista desplegable el código de categoría del comerciante correspondiente al comercio a registrar, para ello guíese con el indicador numérico que precede a la descripción de la actividad. Para más información de este campo, puede dirigirse al módulo de esta documentación en la siguiente ruta: **Funcionamiento de 3DSS** -> **Configuración** -> **Otras configuraciones** -> **Códigos del comercio**. - **Consultor comercial:** Seleccione de la lista desplegable el consultor comercial que opera para el comercio en el país seleccionado. - **Aliado comercial:** Seleccione de la lista desplegable el aliado comercial que opera para el comercio en el país seleccionado. -- **Url:** Ingrese una URL válida que funcionará para conectar el comercio con MPI. A esta URL se redirigirá el usuario al procesar una autenticación. +- **Url:** Ingrese una URL válida que funcionará para conectar el comercio con 3DSS. A esta URL se redirigirá el usuario al procesar una autenticación. - **Habilitar/Deshabilitar:** Puede habilitar o deshabilitar un comercio, deslizando el botón tipo switch con nombre *Habilitar* cuando está deshabilitado el comercio, o con nombre *Deshabilitar* cuando está habilitado y desea deshabilitarlo. -## ¿Cuáles son los requerimientos para crear un comercio en MPI? +## ¿Cuáles son los requerimientos para crear un comercio en 3DSS? -Para crear y configurar un comercio en MPI, se requiere inicialmente que tenga un convenio y esté certificado con Evertec Placetopay, también que el país y el idioma con el cual opera el comercio, estén disponibles para MPI. +Para crear y configurar un comercio en 3DSS, se requiere inicialmente que tenga un convenio y esté certificado con Evertec Placetopay, también que el país y el idioma con el cual opera el comercio, estén disponibles para 3DSS. Se requiere que exista una relación entre emisor, adquiriente y comercio y que estos estén registrados en las aplicaciones de ACS y de 3DSS de Evertec Placetopay, para lograr un proceso de autenticación exitosa utilizando el protocolo 3-D Secure. -Importante tener en cuenta que previo a la creación del comercio, debe haber creado previamente en MPI, el consultor y el aliado comercial con los cuales operarán el comercio. +Importante tener en cuenta que previo a la creación del comercio, debe haber creado previamente en 3DSS, el consultor y el aliado comercial con los cuales operarán el comercio. # Índice de comercios @@ -55,7 +55,7 @@ En esta sección se visualiza el listado o índice de comercios, la información ### Buscador de comercios: -El índice de comercios tiene la funcionalidad de buscador,está ubicado en la parte lateral izquierda y se puede buscar por el nombre completo del comercio, el documento, el código ISO alfa-3 o fragmentos de éstos datos. +El índice de comercios tiene la funcionalidad de buscador, está ubicado en la parte lateral izquierda y se puede buscar por el nombre completo del comercio, el documento, el código ISO alfa-3 o fragmentos de éstos datos. ### Acciones disponibles para los comercios: @@ -158,7 +158,7 @@ Para diligenciarlo tenga en cuenta los siguientes datos: - **Moneda:** Seleccione de la lista desplegable la moneda con la cual procesa las transacciones la sucursal. -- **Url:** Ingrese una URL válida que funcionará para conectar la sucursal con MPI. A esta URL se redirigirá el usuario al procesar una autenticación. +- **Url:** Ingrese una URL válida que funcionará para conectar la sucursal con 3DSS. A esta URL se redirigirá el usuario al procesar una autenticación. - **Habilitar/Deshabilitar:** Puede habilitar o deshabilitar la sucursal, deslizando el botón tipo switch con nombre *Habilitar* cuando está deshabilitada la sucursal, o con nombre *Deshabilitar* cuando está habilitada y desea deshabilitarla. @@ -242,7 +242,7 @@ En esta sección se listan todos los tokens de acceso creados para el comercio e ### ¿Cómo crear un nuevo token? -Para crear un nuevo token para un comercio, que le permite el acceso para procesar una autenticación con la aplicación de MPI, deberá hacer clic en el botón **Crear token**. +Para crear un nuevo token para un comercio, que le permite el acceso para procesar una autenticación con la aplicación de 3DSS, deberá hacer clic en el botón **Crear token**. Se mostrará un formulario como el siguiente, donde únicamente le pedirá ingresar un nombre para identificar al nuevo token a crear. diff --git a/src/pages/three-d-s-server/panel/security.mdx b/src/pages/three-d-s-server/panel/security.mdx index 3fe6512..19c69c3 100644 --- a/src/pages/three-d-s-server/panel/security.mdx +++ b/src/pages/three-d-s-server/panel/security.mdx @@ -24,7 +24,7 @@ Las acciones disponibles son: - **Eliminar:** Puede eliminar el token seleccionado. -> Es importante recordar que los tokens se crean a través del módulo **Comercios**, en el detalle de cada comercio y luego en la sección **Tokens**. Para obtener más detalles de este proceso, diríjase a la sección de la documentación **Funcionamiento de MPI** -> **Configuración** -> **Configuración de comercios**. +> Es importante recordar que los tokens se crean a través del módulo **Comercios**, en el detalle de cada comercio y luego en la sección **Tokens**. Para obtener más detalles de este proceso, diríjase a la sección de la documentación **Funcionamiento de 3DSS** -> **Configuración** -> **Configuración de comercios**. # Usuarios @@ -33,17 +33,17 @@ Para acceder al módulo de usuarios, diríjase al menú lateral izquierdo, despl ## Listado de usuarios: -En este módulo se puede visualizar el listado de usuarios con acceso a MPI. El listado contiene el nombre, el correo electrónico asociado al usuario y el estado de habilitación en el que se encuentra. +En este módulo se puede visualizar el listado de usuarios con acceso a 3DSS. El listado contiene el nombre, el correo electrónico asociado al usuario y el estado de habilitación en el que se encuentra. -> Es importante recordar que los usuarios se crean a través del módulo invitaciones. Además, un usuario solo aparece en este módulo, cuando haya aceptado la invitación para unirse a MPI, haya creado el usuario y haya iniciado sesión sin conflicto alguno. +> Es importante recordar que los usuarios se crean a través del módulo invitaciones. Además, un usuario solo aparece en este módulo, cuando haya aceptado la invitación para unirse a 3DSS, haya creado el usuario y haya iniciado sesión sin conflicto alguno. ### Buscador de usuarios: -El índice de usuarios tiene la funcionalidad de buscador, está ubicado en la parte lateral izquierda y se puede buscar por el nombre y el correo electrónico, digitándolos completos o fragmentos de éstos. +El índice de usuarios tiene la funcionalidad de buscador, está ubicado en la parte lateral izquierda y se puede buscar por el nombre y el correo electrónico, digitándolos completos o fragmentos de estos. ### Acciones para los usuarios: -En el índice de usuarios puede acceder a las acciones disponibles para las usuarios, haciendo clic en el menú con tres puntos, ubicado al final de cada registro de usuario: +En el índice de usuarios puede acceder a las acciones disponibles para el usuario, haciendo clic en el menú con tres puntos, ubicado al final de cada registro de usuario: Las acciones disponibles son: @@ -95,7 +95,7 @@ Al seleccionar esta opción en el menú, se desplegará un formulario como el si Describa en el formulario con la descripción del conflicto con detalle y pantallazos, para ser solucionado efectivamente por el equipo de soporte de Evertec. -## ¿Cómo cerrar sesión en MPI?: +## ¿Cómo cerrar sesión en 3DSS?: Para cerrar sesión cuando desea finalizar la actividad en la aplicación, diríjase al menú desplegable que se encuentra al lado derecho del avatar de usuario. @@ -103,7 +103,7 @@ Haga clic en el botón *Cerrar sesión*. # Roles -Para acceder a este módulo, dírijase al menú ubicado en la parte lateral izquierda, y despliegue la opción de *Seguridad*, luego seleccione el título *Roles*. +Para acceder a este módulo, diríjase al menú ubicado en la parte lateral izquierda, y despliegue la opción de *Seguridad*, luego seleccione el título *Roles*. ## Índice de roles: @@ -196,9 +196,9 @@ Las invitaciones poseen dos estados: > Cuando la invitación fue enviada a varios usuarios, el estado se muestra con un indicador similar al siguiente, el cual muestra cuantas de las invitaciones enviadas, están en el estado específico. -## Invitaciones para crear nuevos usuarios en MPI: +## Invitaciones para crear nuevos usuarios en 3DSS: -Es a través de una invitación que se pueden crear nuevos usuarios. Una invitación se envía a uno o varios correos electrónicos y allí redirecciona al usuario a la aplicación de Accounts de PlacetoPay. En esta redirección, el usuario podrá registrar sus datos personales y contraseña para acceder posteriormente a MPI. +Es a través de una invitación que se pueden crear nuevos usuarios. Una invitación se envía a uno o varios correos electrónicos y allí redirecciona al usuario a la aplicación de Accounts de PlacetoPay. En esta redirección, el usuario podrá registrar sus datos personales y contraseña para acceder posteriormente a 3DSS. > Los datos que registre deben ser los mismos que se utilizaron para enviar la invitación. @@ -212,7 +212,7 @@ Datos a diligenciar: - **Correo electrónico:** Debe ingresar un correo válido porque allí es dónde se enviará la invitación. Puede ingresar uno o varios para conformar una invitación grupal. -- **Copiar datos de un usuario existente:** Con este botón deslizable, puede activar o desactivar la opción de copiar la información (permisos), que posee un usuario existente actualmente en MPI, a el usuario o usuarios nuevos que desea crear. +- **Copiar datos de un usuario existente:** Con este botón deslizable, puede activar o desactivar la opción de copiar la información (permisos), que posee un usuario existente actualmente en 3DSS, al usuario o usuarios nuevos que desea crear. - **Perfiles:** Si activó la opción "Copiar datos de un usuario existente", debe seleccionar uno o varios perfiles existente a partir del cual desea crear el nuevo usuario. @@ -319,7 +319,7 @@ Para crear un nuevo perfil debe hacerlo a través de una invitación. ### ¿Qué es el ACL? -El ACL (Access Control List), es un módulo de gestión de permisos y reglas desarrollado en PlacetoPay y utilizado por MPI. Este se encarga de gestionar los permisos y accesos de los diferentes roles y perfiles creados en MPI. +El ACL (Access Control List), es un módulo de gestión de permisos y reglas desarrollado en PlacetoPay y utilizado por 3DSS. Este se encarga de gestionar los permisos y accesos de los diferentes roles y perfiles creados en 3DSS. Estos permisos y reglas de acceso, se diferencian de los permisos básicos registrados en los roles, en que estos son más específicos y ofrecen una capa de seguridad extra a los datos manejados en la aplicación, ya que permiten que se visualice la información que corresponde solo a un cliente en específico y que no se filtre otra información que pertenece a otros clientes u organizaciones. @@ -353,13 +353,13 @@ Para acceder a este módulo, dírijase al menú ubicado en la parte lateral izqu ## Índice de logs: -En esta sección se registran los movimientos y actualizaciones que se realizan en la aplicación de MPI. Los logs permiten tener un control de los cambios y de lo que sucede en la aplicación. +En esta sección se registran los movimientos y actualizaciones que se realizan en la aplicación de 3DSS. Los logs permiten tener un control de los cambios y de lo que sucede en la aplicación. En la sección de logs se encuentra un listado de los mismos, con una descripción, la fecha y hora en que fue registrado el movimiento y el nombre del usuario que efectuó el movimiento. ### Filtros: -Para hacer búsquedas de los logs registrados utilice la sección de filtros. Haga clic en el botón *Filtros*, ubicado en la parte lateral izquierda, se desplegará un módulo para filtrar por rango de fechas y por el correo electrónico del usuario que realizó el cambio o movimiento: +Para hacer búsquedas de los logs registrados utilicé la sección de filtros. Haga clic en el botón *Filtros*, ubicado en la parte lateral izquierda, se desplegará un módulo para filtrar por rango de fechas y por el correo electrónico del usuario que realizó el cambio o movimiento: Para ejecutar la búsqueda haga clic en el botón **Buscar** y para limpiar los datos de búsqueda ingresados previamente, haga clic en el botón **Limpiar filtros**. diff --git a/src/pages/three-d-s-server/secure-protocol.mdx b/src/pages/three-d-s-server/secure-protocol.mdx index 4fbbda6..90f4f36 100644 --- a/src/pages/three-d-s-server/secure-protocol.mdx +++ b/src/pages/three-d-s-server/secure-protocol.mdx @@ -19,7 +19,7 @@ Los dominios son los siguientes: - Integrador 3DS (3DS Integrator) - Adquiriente (Acquirer) -> Este dominio está representado por la aplicación de MPI. + ***Este dominio está representado por la aplicación de 3DSS.*** **2. Dominio de Interoperabilidad:** Conecta al dominio Adquiriente y Emisor a través de los mensajes que contienen información acerca de la autenticación.