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:
1. Cree una solicitud HTTP de tipo POST en su servidor y con el endpoint /sessions
2. En el encabezado de la petición, ingrese el bearer token, el cual le permitirá registrarse como un usuario autorizado. Este encabezado es obligatorio.
3. El encabezado deberá contener también, en el Content-Type, el valor de "application/json".
4. Ingrese en el cuerpo de la petición los campos mínimos requeridos, los cuales son:
- acctNumber
- cardExpiryDate
- purchaseAmount
- redirectURI
- purchaseCurrency
La descripción de los campos de las peticiones y de las respuestas, el tipo de dato, longitud y demás especificaciones, puede visualizarse en el apartado de respuestas, en el esquema de datos.
5. Envíe la petición y obtenga una respuesta.
6. Puede visualizar el estado de la autenticación, redirigiéndose a la "redirectURI", dato arrojado en una respuesta exitosa o con estado "Y".
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
Se recomienda la implementación de un nuevo contrato que proporciona el siguiente conjunto de resultados:
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 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.
Para el flujo 3RI, se devuelve el mismo contrato de respuesta que en el Show Transaction de la versión 2.x. Valores devueltos en la respuesta API
Crear una sesión BRW o RI
Este endpoint te permite crear una nueva sesión para la autenticación del titular de la tarjeta.
Solicitud
- Name
acctNumber
- Type
- string
- is Required
- REQUIRED
- Description
Número de cuenta que se utilizará en la solicitud de autorización para transacciones de pago. Debe pasar la validación del Algoritmo de Luhn Valores aceptados: Ver formato ISO 7812
Ejemplo:4005580000000040
Longitud máxima:19
Longitud mínima:13
- Name
cardExpiryDate
- Type
- string
- is Required
- REQUIRED
- Description
Fecha de vencimiento de la tarjeta suministrado por el titular. Formato: ym Ejemplo: 2506
Ejemplo:2506
Longitud máxima:4
Longitud mínima:4
- Name
purchaseAmount
- Type
- string
- is Required
- REQUIRED
- Description
Monto de la transacción. Ejemplo: 20.5
Ejemplo:20.5
- Name
purchaseCurrency
- Type
- string
- is Required
- REQUIRED
- Description
El código alfabético de 3 letras de la moneda en la que se expresa el monto de la compra Valores: Ver formato ISO 4217
Ejemplo:USD
Longitud máxima:3
Longitud mínima:3
- Name
redirectURI
- Type
- string
- is Required
- REQUIRED
- Description
URL del sistema donde el titular de la tarjeta será redirigido después de completar una transacción de autenticación.
Ejemplo:https://www.placetopay.com
Formato:uri
Longitud máxima:256
- Name
threeDSAuthenticationInd
- Type
- string
- is optional
- Description
Indica el tipo de solicitud de autenticación. Valores:
PAYMENT_TRANSACTION
(01) - Transacción de pagoRECURRING_TRANSACTION
(02) - Transacción recurrenteINSTALMENT_TRANSACTION
(03) - Transacción a plazosADD_CARD
(04) - Agregar una tarjetaMAINTAIN_CARD
(05) - Mantener una tarjetaCARDHOLDER_VERIFICATION_AS_PART_OF_EMV_TOKEN_IDV
(06) - Verificación del tarjetahabiente como parte del EMV token ID&VBILLING_AGREEMENT
(07) - Acuerdo de facturaciónMASTERCARD_THE_PAYMENT_REQUEST_IS_FOR_AN_AGENT_PAYMENT_TRANSACTION
(85) - Transacción de pago de agente para MastercardMASTERCARD_FOR_UNKNOWN_OR_UNDEFINED_FINAL_AMOUNT_BEFORE_PURCHASE_TRANSACTION
(86) - Transacción para Mastercard con monto final desconocido o indefinido antes de la compra
Ejemplo:01
Longitud máxima:2
Longitud mínima:2
- Name
reference
- Type
- string
- is optional
- Description
Referencia de la transacción.
Longitud máxima:32
- Name
recurringFrequency
- Type
- string
- is optional
- Description
Indica el número mínimo de días entre autorizaciones. Requerido sí threeDSAuthenticationInd es igual a
RECURRING_TRANSACTION
(02) oINSTALMENT_TRANSACTION
(03) Debe estar presente siempre que se envíe recurringExpiry Ejemplos de valores: 31, 031, 0031Longitud máxima:4
Longitud mínima:1
- Name
recurringExpiry
- Type
- string
- is optional
- Description
Fecha después de la cual no se realizarán más autorizaciones. Requerido sí threeDSAuthenticationInd es igual a
RECURRING_TRANSACTION
(02) oINSTALMENT_TRANSACTION
(03) Debe estar presente siempre que se envíe recurringFrequency Formato: Ymd Ejemplo: 20250601Longitud máxima:8
Longitud mínima:8
- Name
purchaseInstalData
- Type
- string
- is optional
- Description
Indica el número máximo de autorizaciones permitidas para pagos a plazos. El valor debe ser mayor que 1. Se requiere sí el comerciante y el titular de la tarjeta han acordado pagos a plazos, es decir, si threeDSAuthenticationInd = 03. Se omite sí no se trata de una autenticación de pago a plazos. Ejemplos de valores: 2, 02, 002
Longitud máxima:3
Longitud mínima:1
- Name
threeDSAuthenticationInfo
- Type
- threeDSAuthenticationInfo
- is optional
- Description
Información sobre cómo el 3DS Requestor autenticó al titular de la tarjeta antes o durante la transacción.
- Name
threeDSReqAuthData
- Type
- string
- is optional
- Description
Datos de autenticación del solicitante de 3DS.
Longitud máxima:20000
- Name
threeDSReqAuthMethod
- Type
- string
- is optional
- Description
Mecanismo utilizado por el Titular de la tarjeta para autenticarse ante el 3DS Requestor. Valores:
REQUESTOR_AUTHENTICATED_OCCURRED
(01) - Autenticación del solicitante ocurridaAUTHENTICATED_WITH_OWN_REQUESTOR_CREDENTIALS
(02) - Autenticado con credenciales propias del solicitanteAUTHENTICATED_IN_REQUESTOR_WITH_FEDERATED_ID
(03) - Autenticado en el solicitante con ID federadoAUTHENTICATED_IN_REQUESTOR_WITH_ISSUER_CREDENTIALS
(04) - Autenticado en el solicitante con credenciales del emisorAUTHENTICATED_IN_REQUESTOR_USING_THIRD_PARTY_AUTHENTICATION
(05) - Autenticado en el solicitante usando autenticación de tercerosAUTHENTICATED_IN_REQUESTOR_WITH_FIDO
(06) - Autenticado en el solicitante con FIDOAUTHENTICATED_IN_REQUESTOR_USING_FIDO_AUTHENTICATOR
(07) - Autenticado en el solicitante usando autenticador FIDOSRC_ASSURANGE_DATA
(08) - Datos de aseguramiento SRCMASTERCARD_UNKNOWN_VALUE
(90) - Valor desconocido para Mastercard
Longitud máxima:2
Longitud mínima:2
- Name
threeDSReqAuthTimestamp
- Type
- string
- is optional
- Description
Fecha y hora en UTC de la autenticación del titular de la tarjeta. Formato: YYYYMMDDHHMM Ejemplo: 202506011200
Longitud máxima:12
Longitud mínima:12
- Name
threeDSChallengeInd
- Type
- string
- is optional
- Description
Indica si se solicita un desafío para esta transacción. Si este parámetro no se envía en la petición, se asumirá
NO_PREFERENCE
(01) como valor por defecto. Valores:NO_PREFERENCE
(01) - Sin preferenciaNO_CHALLENGE_REQUESTED
(02) - No se solicitó desafíoCHALLENGE_REQUESTED_REQUESTOR_PREFERENCE
(03) - Desafío solicitado (preferencia del solicitante)CHALLENGE_REQUESTED_MANDATE
(04) - Desafío solicitado (mandato)NO_CHALLENGE_REQUESTED_RISK_PERFORMED
(05) - No se solicitó desafío (análisis de riesgo realizado)NO_CHALLENGE_REQUESTED_DATA_SHARED_ONLY
(06) - No se solicitó desafío (solo datos compartidos)NO_CHALLENGE_REQUESTED_CONSUMER_AUTH_PERFORMED
(07) - No se solicitó desafío (autenticación del consumidor realizada)NO_CHALLENGE_REQUESTED_WHITELIST_EXEMPTION
(08) - No se solicitó desafío (exención de lista blanca)NO_CHALLENGE_REQUESTED_WHITELIST_PROMPT_REQUESTED
(09) - No se solicitó desafío (solicitud de lista blanca)VISA_RESERVED
(82) - Reservado para VISA
Longitud máxima:2
Longitud mínima:2
- Name
threeDSRequestorID
- Type
- string
- is optional
- Description
Identificador asociado por el DS al Solicitante 3DS. Cada Directory Server puede imponer requisitos específicos de formato y caracteres en el contenido de este campo.
Longitud máxima:35
- Name
acctInfo
- Type
- acctInfo
- is optional
- Description
Información adicional sobre la cuenta del titular de la tarjeta.
- Name
chAccAgeInd
- Type
- string
- is optional
- Description
Longitud del tiempo en que la cuenta fue creada en el sitio web del comercio.
Valores:
- NO_ACCOUNT (01) - Sin cuenta
- CREATED_DURING_TRANSACTION (02) - Creado durante la transacción
- LESS_30_DAYS (03) - Menos de 30 días
- BETWEEN_30_AND_60_DAYS (04) - Entre 30 y 60 días
- MORE_60_DAYS (05) - Más de 60 días
Longitud máxima:2
Longitud mínima:2
- Name
chAccChange
- Type
- string
- is optional
- Description
Fecha del último cambio efectuado en la cuenta del tarjetahabiente en el sitio web del comercio. Incluyendo dirección de envío, dirección de pago. Formato: YYYYMMDD Ejemplo: 20250601
Longitud máxima:8
Longitud mínima:8
- Name
chAccChangeInd
- Type
- string
- is optional
- Description
Longitud del tiempo desde el último cambio efectuado en la cuenta en el sitio web del comercio. Valores:
- CHANGED_DURING_TRANSACTION (01) - Cambiado durante la transacción
- LESS_30_DAYS (02) - Menos de 30 días
- BETWEEN_30_AND_60_DAYS (03) - Entre 30 y 60 días
- MORE_60_DAYS (04) - Más de 60 días
Longitud máxima:2
Longitud mínima:2
- Name
chAccDate
- Type
- string
- is optional
- Description
Fecha en la que se creó la cuenta en el sitio web del comercio. Formato: YYYYMMDD Ejemplo: 20250601
Longitud máxima:8
Longitud mínima:8
- Name
chAccPwChange
- Type
- string
- is optional
- Description
Fecha en la que se realizó el último cambio o recuperación de contraseña. Formato: YYYYMMDD Ejemplo: 20250601
Longitud máxima:8
Longitud mínima:8
- Name
chAccPwChangeInd
- Type
- string
- is optional
- Description
Longitud de tiempo desde el último cambio o recuperación de contraseña. Valores:
- NO_CHANGE (01) - Sin cambios
- CHANGED_DURING_TRANSACTION (02) - Cambiado durante la transacción
- LESS_30_DAYS (03) - Menos de 30 días
- BETWEEN_30_AND_60_DAYS (04) - Entre 30 y 60 días
- MORE_60_DAYS (05) - Más de 60 días
Longitud máxima:2
Longitud mínima:2
- Name
nbPurchaseAccount
- Type
- string
- is optional
- Description
Número de compras durante los últimos 6 meses.
Longitud máxima:4
Longitud mínima:1
- Name
provisionAttemptsDay
- Type
- string
- is optional
- Description
Número de intentos de agregar tarjetas en las últimas 24 horas. Ejemplos de valores: 2, 02, 002
Longitud máxima:3
- Name
txnActivityDay
- Type
- string
- is optional
- Description
Número de transacciones (exitosas y abandonadas) para esta cuenta en las últimas 24 horas. Ejemplos de valores: 2, 02, 002
Longitud máxima:3
- Name
txnActivityYear
- Type
- string
- is optional
- Description
Número de transacciones (exitosas y abandonadas) para esta cuenta en el último año. Ejemplos de valores: 2, 02, 002
Longitud máxima:3
- Name
paymentAccAge
- Type
- string
- is optional
- Description
Fecha en la que el método de pago se agregó a la cuenta del usuario en el sitio web del comercio. Formato: YYYYMMDD Ejemplo: 20250601
Longitud máxima:8
Longitud mínima:8
- Name
paymentAccInd
- Type
- string
- is optional
- Description
Longitud de tiempo desde que el método de pago fué enrolado en la cuenta en el sitio web del comercio. Valores:
- NO_ACCOUNT (01) - Sin cuenta
- CREATED_DURING_TRANSACTION (02) - Creado durante la transacción
- LESS_30_DAYS (03) - Menos de 30 días
- BETWEEN_30_AND_60_DAYS (04) - Entre 30 y 60 días
- MORE_60_DAYS (05) - Más de 60 días
Longitud máxima:2
Longitud mínima:2
- Name
shipAddressUsage
- Type
- string
- is optional
- Description
Fecha en la que la dirección de entrega fue usada por primera vez en el sitio web del comercio. Formato: YYYYMMDD Ejemplo: 20250601
Longitud máxima:8
Longitud mínima:8
- Name
shipAddressUsageInd
- Type
- string
- is optional
- Description
Longitud de tiempo desde que la dirección de entrega fue usada por primera vez en el sitio web del comercio. Valores:
- 01 - Esta transacción
- 02 - Menos de 30 días
- 03 - Entre 30 y 60 días
- 04 - Más de 60 días
Longitud máxima:2
Longitud mínima:2
- Name
shipNameIndicator
- Type
- string
- is optional
- Description
Indica si el nombre del titular de la tarjeta es igual al nombre de envío usado en esta transacción. Valores:
- 01 - Nombre de cuenta idéntico al nombre de envío.
- 02 - Nombre de cuenta diferente al nombre de envío.
Longitud máxima:2
Longitud mínima:2
- Name
suspiciousAccActivity
- Type
- string
- is optional
- Description
Indica si el comercio ha experimentado actividad sospechosa (incluido fraude previo) en la cuenta del titular de la tarjeta. Valores:
- 01 - No se ha observado actividad sospechosa.
- 02 - Se ha observado actividad sospechosa.
Longitud máxima:2
Longitud mínima:2
- Name
acctID
- Type
- string
- is optional
- Description
Información adicional sobre la cuenta proporcionada por 3DS Requestor.
Longitud máxima:64
- Name
billAddrCity
- Type
- string
- is optional
- Description
El nombre de la ciudad de la dirección de facturación del Titular de la tarjeta asociada con la tarjeta utilizada para esta compra.
Longitud máxima:50
- Name
billAddrCountry
- Type
- string
- is optional
- Description
El código alfabético de tres letras que relaciona al país de la dirección de facturación del Titular de la tarjeta asociada con la tarjeta utilizada para esta compra. Valores aceptados: Ver formato ISO 3166-1
Longitud máxima:3
- Name
billAddrLine1
- Type
- string
- is optional
- Description
Primera línea de la dirección postal o parte local equivalente de la dirección de facturación del titular de la tarjeta asociada con la tarjeta utilizada para esta compra.
Longitud máxima:50
- Name
billAddrLine2
- Type
- string
- is optional
- Description
Segunda línea de la dirección postal o parte local equivalente de la dirección de facturación del titular de la tarjeta asociada con la tarjeta utilizada para esta compra.
Longitud máxima:50
- Name
billAddrLine3
- Type
- string
- is optional
- Description
Tercera línea de la dirección postal o parte local equivalente de la dirección de facturación del titular de la tarjeta asociada con la tarjeta utilizada para esta compra.
Longitud máxima:50
- Name
billAddrPostCode
- Type
- string
- is optional
- Description
ZIP u otro código postal de la dirección de facturación del titular de la tarjeta asociada con la tarjeta utilizada para esta compra.
Longitud máxima:16
- Name
billAddrState
- Type
- string
- is optional
- Description
Código alfabético de 3 letras de la subdivisión del país que representa el estado o provincia de la dirección de facturación del titular de la tarjeta asociada con la tarjeta utilizada para esta compra. Valores: Ver formato ISO 3166-2
Longitud máxima:3
- Name
email
- Type
- string
- is optional
- Description
La dirección de correo electrónico asociada con la cuenta que ingresó el Titular de la tarjeta o que está archivada con el Solicitante de 3DS.
Formato:email
Longitud máxima:254
- Name
homePhone
- Type
- PhoneProperties
- is optional
- Description
Valores aceptados según especificación Ver formato ITU-E.164
- Name
cc
- Type
- string
- is Required
- REQUIRED
- Description
Código del país.
Longitud máxima:3
Longitud mínima:1
- Name
subscriber
- Type
- string
- is Required
- REQUIRED
- Description
Suscriptor.
Longitud máxima:15
- Name
mobilePhone
- Type
- PhoneProperties
- is optional
- Description
Valores aceptados según especificación Ver formato ITU-E.164
- Name
cc
- Type
- string
- is Required
- REQUIRED
- Description
Código del país.
Longitud máxima:3
Longitud mínima:1
- Name
subscriber
- Type
- string
- is Required
- REQUIRED
- Description
Suscriptor.
Longitud máxima:15
- Name
cardholderName
- Type
- string
- is optional
- Description
Nombre del titular de la tarjeta.
Longitud máxima:45
Longitud mínima:2
- Name
shipAddrCity
- Type
- string
- is optional
- Description
Nombre completo o parcial de la ciudad de la dirección de envío proporcionado por el titular de la tarjeta.
Longitud máxima:50
- Name
shipAddrCountry
- Type
- string
- is optional
- Description
El código alfabético de tres letras que relaciona al país de la dirección de envío proporcionado por el Titular de la tarjeta. Valores: Ver formato ISO 3166-1
Longitud máxima:3
Longitud mínima:3
- Name
shipAddrLine1
- Type
- string
- is optional
- Description
Primera línea de la dirección postal o parte local equivalente de la dirección de envío proporcionado por el titular de la tarjeta.
Longitud máxima:50
- Name
shipAddrLine2
- Type
- string
- is optional
- Description
Segunda línea de la dirección postal o parte local equivalente de la dirección de envío proporcionado por el titular de la tarjeta.
Longitud máxima:50
- Name
shipAddrLine3
- Type
- string
- is optional
- Description
Tercera línea de la dirección postal o parte local equivalente de la dirección de envío proporcionado por el titular de la tarjeta.
Longitud máxima:50
- Name
shipAddrPostCode
- Type
- string
- is optional
- Description
ZIP u otro código postal de la dirección de envío proporcionado por el titular de la tarjeta
Longitud máxima:16
- Name
shipAddrState
- Type
- string
- is optional
- Description
Código alfabético de 3 letras de la subdivisión del país que representa el estado o provincia de la dirección de envío proporcionado por el titular de la tarjeta. Valores: Ver formato ISO 3166-2
Longitud máxima:3
- Name
workPhone
- Type
- PhoneProperties
- is optional
- Description
Valores aceptados según especificación Ver formato ITU-E.164
- Name
cc
- Type
- string
- is Required
- REQUIRED
- Description
Código del país.
Longitud máxima:3
Longitud mínima:1
- Name
subscriber
- Type
- string
- is Required
- REQUIRED
- Description
Suscriptor.
Longitud máxima:15
- Name
merchantRiskIndicator
- Type
- merchantRiskIndicator
- is optional
- Description
Evaluación del comerciante sobre el nivel de riesgo de fraude en la autenticación específica.
- Name
deliveryEmailAddress
- Type
- string
- is optional
- Description
Para entrega electrónica, la dirección de correo electrónico a la que se entregó la mercancía.
Longitud máxima:254
- Name
deliveryTimeframe
- Type
- string
- is optional
- Description
Indica el plazo de entrega de la mercancía.
Valores:
- ELECTRONIC_DELIVERY (01) - Entrega electrónica
- SAME_DAY_SHIPPING (02) - Envío el mismo día
- OVERNIGHT_SHIPPING (03) - Envío nocturno
- TWO_DAYS_OR_MORE_SHIPPING (04) - Envío de dos días o más
Longitud máxima:2
Longitud mínima:2
- Name
giftCardAmount
- Type
- string
- is optional
- Description
Para compras con tarjeta de regalo o prepago, el monto total de la compra de tarjetas de regalo o prepago en unidades principales (por ejemplo, 123,45 USD es 123). Ejemplos de valores: 123, 0123, 00123
Longitud máxima:15
- Name
giftCardCount
- Type
- string
- is optional
- Description
Para compras con tarjeta de regalo o prepago, recuento total de tarjetas, códigos de regalo o prepago individuales comprados.
Longitud máxima:2
Longitud mínima:2
- Name
giftCardCurr
- Type
- string
- is optional
- Description
Para compras con tarjeta de regalo o prepago, código de moneda de tres dígitos ISO 4217 de la tarjeta de regalo. Valores: Ver formato ISO 4217
Longitud máxima:3
Longitud mínima:3
- Name
preOrderDate
- Type
- string
- is optional
- Description
Para una compra pre-ordenada, la fecha esperada en que la mercancía estará disponible. Formato: Ymd Ejemplo: 20250601
Longitud máxima:8
Longitud mínima:8
- Name
preOrderPurchaseInd
- Type
- string
- is optional
- Description
Indica si el Titular de la tarjeta está realizando un pedido de mercancía con una disponibilidad futura o una fecha de lanzamiento. Valores:
- MERCHANDISE_AVAILABLE (01) - Mercancía disponible
- FUTURE_AVAILABILITY (02) - Disponibilidad futura
Longitud máxima:2
Longitud mínima:2
- Name
reorderItemsInd
- Type
- string
- is optional
- Description
Indica si el titular de la tarjeta está reordenando mercancía comprada anteriormente. Valores:
- MERCHANDISE_AVAILABLE (01) - Mercancía disponible
- FUTURE_AVAILABILITY (02) - Disponibilidad futura
Longitud máxima:2
Longitud mínima:2
- Name
shipIndicator
- Type
- string
- is optional
- Description
Indica el método de envío elegido para la transacción. Valores:
- SHIP_TO_CARDHOLDER_BILLING_ADDR (01) - Enviar a la dirección de facturación del titular de la tarjeta
- SHIP_TO_ANOTHER_VERIFIED_ADDR_ON_FILE (02) - Enviar a otra dirección verificada en archivo
- SHIP_TO_ADDR_DIFF_CARDHOLDER_BILLING_ADDR (03) - Enviar a una dirección diferente de la dirección de facturación del titular de la tarjeta
- SHIP_TO_STORE (04) - Enviar a la tienda
- DIGITAL_GOODS (05) - Bienes digitales
- TRAVEL_EVENT_TICKETS_NOT_SHIPPED (06) - Entradas para eventos de viaje no enviadas
- OTHER (07) - Otro
Longitud máxima:2
Longitud mínima:2
- Name
addPriorInformation
- Type
- string
- is optional
- Description
Indica el tipo de solicitud de autenticación.
Valores:
Y
- Solicita a 3DSS Agregar información del PRIORN
- Solicita No Agregar información del PRIOR
Ejemplo:Y
Longitud máxima:1
Longitud mínima:1
- Name
threeDSRequestorPriorAuthenticationInfo
- Type
- threeDSRequestorPriorAuthenticationInfo
- is optional
- Description
Información sobre cómo el 3DS Requestor autenticó al titular de la tarjeta antes o durante la transacción.
- Name
threeDSReqPriorAuthMethod
- Type
- string
- is optional
- Description
Método de autenticación usado en la transacción. Valores:
FRICTIONLESS_AUTHENTICATION
– 01 Autenticación sin fricciónCARDHOLDER_CHALLENGE_OCCURRED
– 02 Autenticación con fricción
Longitud máxima:2
Longitud mínima:2
- Name
threeDSReqPriorAuthTimestamp
- Type
- string
- is optional
- Description
Timestamp de la transacción en UTC Formatos aceptados:
- c – 2020-04-21T01:44:54+00:00
- YmdHi – 202401011212
Longitud máxima:12
Longitud mínima:12
- Name
threeDSReqPriorRef
- Type
- string
- is optional
- Description
Contiene el ACS Transaction ID de la transacción anterior que fue autenticada. Ejemplos de valores: c83f3f5d-1a47-4eff-9fd0-6b63090a89c6
Longitud máxima:72
- Name
threeDSReqPriorAuthData
- Type
- string
- is optional
- Description
Contiene el DS Transaction ID de la transacción anterior que fue autenticada. Ejemplos de valores: c83f3f5d-1a47-4eff-9fd0-6b63090a89c6
Longitud máxima:72
- Name
threeDSReqPriorAuthMethod
- Type
- string
- is optional
- Description
Método que fue usado por el tarjetahabiente para la autenticación previa. Valores:
FRICTIONLESS_AUTHENTICATION
(01) sin fricciónCARDHOLDER_CHALLENGE_OCCURRED
(02) con fricción
Ejemplo:FRICTIONLESS_AUTHENTICATION
- Name
threeDSReqPriorAuthTimestamp
- Type
- string
- is optional
- Description
Fecha y hora en formato UTC de la autenticación previa. El formato es C, por ejemplo
2024-07-15T10:00:00Z
.Ejemplo:2024-07-15T10:00:00Z
- Name
threeDSReqPriorRef
- Type
- string
- is optional
- Description
El ID otorgado por el ACS en la transacción previa (primera autenticación).
Ejemplo:abc123
- Name
threeDSReqPriorAuthData
- Type
- string
- is optional
- Description
El ID otorgado por el DS en la transacción previa (primera autenticación). Si este dato no es enviado, 3DSS lo asigna. Consulta la sesión
Ejemplo:xyz789
- Name
threeRIInd
- Type
- string
- is optional
- Description
Indica si la transacción es recurrente. Valores:
RECURRING_TRANSACTION
(01) - Transacción recurrenteINSTALMENT_TRANSACTION
(02) - Transacción a plazosADD_CARD
(03) - Agregar tarjetaMAINTAIN_CARD_INFORMATION
(04) - Mantener información de tarjetaACCOUNT_VERIFICATION
(05) - Verificación de cuentaSPLIT_OR_DELAYED_SHIPMENT
(06) - Envío dividido o retrasadoTOP_UP
(07) - RecargaMAIL_ORDER
(08) - Pedido por correoTELEPHONE_ORDER
(09) - Pedido por teléfonoWHITELIST_STATUS_CHECK
(10) - Verificación del estado de la lista blancaOTHER_PAYMENT
(11) - Otro tipo de pagoBILLING_AGREEMENT
(12) - Acuerdo de facturaciónMASTERCARD_3RI_IS_FOR_AN_AGENT_PAYMENT_TRANSACTION
(85) - Transacción de pago de agente para MastercardMASTERCARD_3RI_FOR_UNKNOWN_OR_UNDEFINED_FINAL_AMOUNT_BEFORE_PURCHASE_TRANSACTION
(86) - Transacción para Mastercard con monto final desconocido o indefinido antes de la compraVISA_UNSCHEDULED_CREDENTIAL_ON_FILE
(81) - Credencial no programada en archivo (Visa)
Solicitud
curl -X "POST" https://3dss-test.placetopay.com/threeds/v2x/sessions \
-H "Content-Type: application/json" \
-d '{
"acctNumber": "4005580000000040",
"cardExpiryDate": "2506",
"purchaseAmount": "20.5",
"purchaseCurrency": "USD",
"redirectURI": "https://www.placetopay.com",
"threeDSAuthenticationInd": "PAYMENT_TRANSACTION",
"reference": "12345"
}'
Respuesta
Respuesta recibida: 200 Ok
Para continuar con el proceso de autenticación, se debe redirigir al usuario a la url recibida en el campo (redirectURL). Allí se le informará el resultado de la autenticación y posteriormente, se redirigirá al comercio.
- Name
sessionToken
- Type
- string
- is Required
- REQUIRED
- Description
Token de autenticación.
Ejemplo:8e580eb1948ae1b13e614aac04c75ad31d6431ef2ea7b1a85573979b7ec4e656
Longitud máxima:64
Longitud mínima:64
- Name
redirectURL
- Type
- string
- is Required
- REQUIRED
- Description
URL de redirección para continuar el proceso de autenticación.
Ejemplo:https://3dss-test.placetopay.com/threeds/v2x/sessions/8e580eb1948ae1b13e614aac04c75ad31d6431ef2ea7b1a85573979b7ec4e656
Longitud máxima:256
Longitud mínima:1
- Name
transactionID
- Type
- integer
- is Required
- REQUIRED
- Description
Indicador de la transacción.
Ejemplo:9099
Respuesta
{
"action":"redirect",
"sessionToken": "8e580eb1948ae1b13e614aac04c75ad31d6431ef2ea7b1a85573979b7ec4e656",
"redirectURL": "https://3dss-test.placetopay.com/threeds/v2x/sessions/8e580eb1948ae1b13e614aac04c75ad31d6431ef2ea7b1a85573979b7ec4e656",
"transactionID": 9099
}