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:

Canal
Indicador del Canal
Acción
Categoría de Mensaje
Información
APP
“01”
continue
PA, NPA
Esta nueva acción permite retornar el resultado de la transacción y no necesita intervención del usuario para ser completada.
BRW
“02”
redirect
PA, NPA
Esta acción se ejecuta en los flujos para dispositivos BRW, en el cual retornamos una URL redirectURL, para iniciar el flujo de autenticación.
3RI
“03”
continue
PA, NPA
Esta nueva acción permite retornar el resultado de la transacción y no necesita intervención del usuario para ser completada.

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.


POST/threeds/v2x/sessions

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 pago
    • RECURRING_TRANSACTION (02) - Transacción recurrente
    • INSTALMENT_TRANSACTION (03) - Transacción a plazos
    • ADD_CARD (04) - Agregar una tarjeta
    • MAINTAIN_CARD (05) - Mantener una tarjeta
    • CARDHOLDER_VERIFICATION_AS_PART_OF_EMV_TOKEN_IDV (06) - Verificación del tarjetahabiente como parte del EMV token ID&V
    • BILLING_AGREEMENT (07) - Acuerdo de facturación
    • MASTERCARD_THE_PAYMENT_REQUEST_IS_FOR_AN_AGENT_PAYMENT_TRANSACTION (85) - Transacción de pago de agente para Mastercard
    • MASTERCARD_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) o INSTALMENT_TRANSACTION (03) Debe estar presente siempre que se envíe recurringExpiry Ejemplos de valores: 31, 031, 0031

    Longitud 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) o INSTALMENT_TRANSACTION (03) Debe estar presente siempre que se envíe recurringFrequency Formato: Ymd Ejemplo: 20250601

    Longitud 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 ocurrida
      • AUTHENTICATED_WITH_OWN_REQUESTOR_CREDENTIALS (02) - Autenticado con credenciales propias del solicitante
      • AUTHENTICATED_IN_REQUESTOR_WITH_FEDERATED_ID (03) - Autenticado en el solicitante con ID federado
      • AUTHENTICATED_IN_REQUESTOR_WITH_ISSUER_CREDENTIALS (04) - Autenticado en el solicitante con credenciales del emisor
      • AUTHENTICATED_IN_REQUESTOR_USING_THIRD_PARTY_AUTHENTICATION (05) - Autenticado en el solicitante usando autenticación de terceros
      • AUTHENTICATED_IN_REQUESTOR_WITH_FIDO (06) - Autenticado en el solicitante con FIDO
      • AUTHENTICATED_IN_REQUESTOR_USING_FIDO_AUTHENTICATOR (07) - Autenticado en el solicitante usando autenticador FIDO
      • SRC_ASSURANGE_DATA (08) - Datos de aseguramiento SRC
      • MASTERCARD_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 preferencia
    • NO_CHALLENGE_REQUESTED (02) - No se solicitó desafío
    • CHALLENGE_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 PRIOR
    • N - 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ón
      • CARDHOLDER_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ón
    • CARDHOLDER_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 recurrente
    • INSTALMENT_TRANSACTION (02) - Transacción a plazos
    • ADD_CARD (03) - Agregar tarjeta
    • MAINTAIN_CARD_INFORMATION (04) - Mantener información de tarjeta
    • ACCOUNT_VERIFICATION (05) - Verificación de cuenta
    • SPLIT_OR_DELAYED_SHIPMENT (06) - Envío dividido o retrasado
    • TOP_UP (07) - Recarga
    • MAIL_ORDER (08) - Pedido por correo
    • TELEPHONE_ORDER (09) - Pedido por teléfono
    • WHITELIST_STATUS_CHECK (10) - Verificación del estado de la lista blanca
    • OTHER_PAYMENT (11) - Otro tipo de pago
    • BILLING_AGREEMENT (12) - Acuerdo de facturación
    • MASTERCARD_3RI_IS_FOR_AN_AGENT_PAYMENT_TRANSACTION (85) - Transacción de pago de agente para Mastercard
    • MASTERCARD_3RI_FOR_UNKNOWN_OR_UNDEFINED_FINAL_AMOUNT_BEFORE_PURCHASE_TRANSACTION (86) - Transacción para Mastercard con monto final desconocido o indefinido antes de la compra
    • VISA_UNSCHEDULED_CREDENTIAL_ON_FILE (81) - Credencial no programada en archivo (Visa)

Solicitud

POST
/threeds/v2x/sessions
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
}