Este es el 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:

CanalIndicador del CanalAcciónCategoría de MensajeInformación
APP“01”continuePA, NPAEsta nueva acción permite retornar el resultado de la transacción y no necesita intervención del usuario para ser completada.
BRW“02”redirectPA, NPAEsta 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”continuePA, NPAEsta 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.

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

  • Name
    cardExpiryDate
    Type
    string
    is Required
    REQUIRED
    Description

    Fecha de vencimiento de la tarjeta suministrado por el titular. Formato: ym Ejemplo: 2506

  • Name
    purchaseAmount
    Type
    string
    is Required
    REQUIRED
    Description

    Monto de la transacción. 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 aceptados: Ver formato ISO 4217

  • 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.

  • Name
    threeDSAuthenticationInd
    Type
    string
    is optional
    Description

    Indica el tipo de solicitud de autenticación. Valores aceptados:

    • 01 - Transacción de pago
    • 02 - Transacción recurrente
    • 03 - Transacción a plazos
    • 04 - Agregar una tarjeta
    • 05 - Mantener una tarjeta
    • 06 - Verficación del tarjeta habiente como parte del EMV token ID&V
  • Name
    reference
    Type
    string
    is optional
    Description

    Referencia de la transacción.

  • Name
    recurringFrequency
    Type
    string
    is optional
    Description

    Indica el número mínimo de días entre autorizaciones. Requerido sí threeDSAuthenticationInd es igual a '02' o '03' Debe estar presente siempre que se envíe recurringExpiry Ejemplos de valores aceptados: 31, 031, 0031

  • Name
    recurringExpiry
    Type
    string
    is optional
    Description

    Fecha después de la cual no se realizarán más autorizaciones. Requerido si threeDSAuthenticationInd es igual a '02' o '03' Debe estar presente siempre que se envíe recurringFrequency Formato: Ymd Ejemplo: 20250601

  • 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 aceptados: 2, 02, 002

  • 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.

    • Name
      threeDSReqAuthMethod
      Type
      string
      is optional
      Description

      Mecanismo utilizado por el Titular de la tarjeta para autenticarse ante el 3DS Requestor.

      Valores aceptados:

      • 01
      • 02
      • 03
      • 04
      • 05
      • 06
      • 07
      • 08
    • 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

  • Name
    threeDSChallengeInd
    Type
    string
    is optional
    Description

    Indica si se solicita un desafío para esta transacción. Si este parámetro no es enviado en la petición, se asumirá '01 = Sin preferencia' como valor por defecto Valores aceptados:

    • 01 = No preference
    • 02 = No challenge requested
    • 03 = Challenge requested (3DS Requestor preference)
    • 04 = Challenge requested (Mandate)
    • 05 = No challenge requested (transactional risk analysis is already performed)
    • 06 = No challenge requested (Data share only)
    • 07 = No challenge requested (strong consumer authentication is already performed)
    • 08 = No challenge requested (utilise whitelist exemption if no challenge required)
    • 09 = Challenge requested (whitelist prompt requested if challenge required)
  • 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.

  • 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 aceptados:

      • 01 - Sin cuenta (invitado)
      • 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
    • 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

    • 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 aceptados:

      • 01 - Cambiado durante la transacción
      • 02 - Menos de 30 días
      • 03 - Entre 30 y 60 días
      • 04 - Más de 60 días
    • 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

    • 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

    • Name
      chAccPwChangeInd
      Type
      string
      is optional
      Description

      Longitud de tiempo desde el último cambio o recuperación de contraseña. Valores aceptados:

      • 01 - Sin cambios
      • 02 - Cambiado durante la transacción
      • 03 - Menos de 30 días
      • 04 - Entre 30 y 60 días
      • 05 - Más de 60 días
    • Name
      nbPurchaseAccount
      Type
      string
      is optional
      Description

      Número de compras durante los últimos 6 meses.

    • Name
      provisionAttemptsDay
      Type
      string
      is optional
      Description

      Número de intentos de agregar tarjetas en las últimas 24 horas. Ejemplos de valores aceptados: 2, 02, 002

    • 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 aceptados: 2, 02, 002

    • 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 aceptados: 2, 02, 002

    • 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

    • 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 aceptados:

      • 01 - Sin cuenta (invitado)
      • 02 - Durante la transacción
      • 03 - Menos de 30 días
      • 04 - Entre 30 y 60 días
      • 05 - Más de 60 días
    • 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

    • 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 aceptados:

      • 01 - Esta transacción
      • 02 - Menos de 30 días
      • 03 - Entre 30 y 60 días
      • 04 - Más de 60 días
    • 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 aceptados:

      • 01 - Nombre de cuenta idéntico al nombre de envío.
      • 02 - Nombre de cuenta diferente al nombre de envío.
    • 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 aceptados:

      • 01 - No se ha observado actividad sospechosa.
      • 02 - Se ha observado actividad sospechosa.
  • Name
    acctID
    Type
    string
    is optional
    Description

    Información adicional sobre la cuenta proporcionada por 3DS Requestor.

  • 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.

  • 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

  • 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.

  • 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.

  • 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.

  • 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.

  • 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 aceptados: Ver formato ISO 3166-2

  • 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.

  • 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.

    • Name
      subscriber
      Type
      string
      is Required
      REQUIRED
      Description

      Suscriptor.

  • 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.

    • Name
      subscriber
      Type
      string
      is Required
      REQUIRED
      Description

      Suscriptor.

  • Name
    cardholderName
    Type
    string
    is optional
    Description

    Nombre del titular de la tarjeta.

  • 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.

  • 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 aceptados: Ver formato ISO 3166-1

  • 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.

  • 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.

  • 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.

  • 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

  • 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 aceptados: Ver formato ISO 3166-2

  • 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.

    • Name
      subscriber
      Type
      string
      is Required
      REQUIRED
      Description

      Suscriptor.

  • 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.

    • Name
      deliveryTimeframe
      Type
      string
      is optional
      Description

      Indica el plazo de entrega de la mercancía.

      Valores aceptados:

      • 01 – Entrega electrónica
      • 02 – Entrega el mismo día
      • 03 – Envío nocturno
      • 04 – Entrega en dos días o más
    • 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 aceptados: 123, 0123, 00123

    • 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.

    • 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 aceptados: Ver formato ISO 4217

    • 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

    • 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 aceptados:

      • 01 - Mercancía disponible
      • 02 - Disponibilidad futura
    • Name
      reorderItemsInd
      Type
      string
      is optional
      Description

      Indica si el titular de la tarjeta está reordenando mercancía comprada anteriormente. Valores aceptados:

      • 01 – Primera vez
      • 02 – Reordenado
    • Name
      shipIndicator
      Type
      string
      is optional
      Description

      Indica el método de envío elegido para la transacción. Valores aceptados:

      • 01 = Enviar a la dirección de facturación del titular de la tarjeta
      • 02 = Enviar a otra dirección verificada registrada con el comerciante
      • 03 = Envío a una dirección diferente a la dirección de facturación del titular de la tarjeta
      • 04 = "Enviar a la tienda" / Recoger en la tienda local (la dirección de la tienda se completará en los campos de dirección de envío)
      • 05 = Productos digitales (incluye servicios en línea, tarjetas de regalo electrónicas y códigos de canje)
      • 06 = Boletos de viaje y eventos, no enviados
      • 07 = Otro (por ejemplo, juegos, servicios digitales no enviados, suscripciones a emedia, etc.)
  • Name
    addPriorInformation
    Type
    string
    is optional
    Description

    Indica el tipo de solicitud de autenticación.

    Valores aceptados:

    • Y - Solicita a MPI Agregar información del PRIOR
    • N - Solicita No Agregar información del PRIOR
  • 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 aceptados:

      • 01 – Autenticación sin fricción
      • 02 – Autenticación con fricción
    • 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
    • Name
      threeDSReqPriorRef
      Type
      string
      is optional
      Description

      Contiene el ACS Transaction ID de la transacción anterior que fue autenticada. Ejemplos de valores aceptados: c83f3f5d-1a47-4eff-9fd0-6b63090a89c6

    • Name
      threeDSReqPriorAuthData
      Type
      string
      is optional
      Description

      Contiene el DS Transaction ID de la transacción anterior que fue autenticada. Ejemplos de valores aceptados: c83f3f5d-1a47-4eff-9fd0-6b63090a89c6

  • Name
    threeDSReqPriorAuthMethod
    Type
    string
    is optional
    Description

    Método que fue usado por el tarjetahabiente para la autenticación previa. Valores aceptados:

    • 01 sin fricción
    • 02 con fricción
  • 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.

  • Name
    threeDSReqPriorRef
    Type
    string
    is optional
    Description

    El ID otorgado por el ACS en la transacción previa (primera autenticación).

  • 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, MPI lo asigna. Consulta la sesión

  • Name
    threeRIInd
    Type
    string
    is optional
    Description

    Indica si la transacción es recurrente. Valores aceptados:

    • 01 al 99

    significado:

    • '01' = recurring transaction
    • '02' = instalment transaction
    • '03' = add card
    • '04' = maintain card information
    • '05' = account verification
    • '06' = split or delayed shipment
    • '07' = top up
    • '08 = mail order
    • '09' = telephone order
    • '10' = whitelist status check
    • '11' = other payment
    • '12' = billing agreement
    • '85' = mastercard 3ri is for an agent payment transaction
    • '86' = mastercard 3ri for unknown or undefined final amount before purchase transaction
    • '81' = visa unscheduled credential on file

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": "01",
     "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.

  • Name
    redirectURL
    Type
    string
    is Required
    REQUIRED
    Description

    URL de redirección para continuar el proceso de autenticación.

  • Name
    transactionID
    Type
    integer
    is Required
    REQUIRED
    Description

    Indicador de la transacción.


Respuesta

{
  "action":"redirect",
  "sessionToken": "8e580eb1948ae1b13e614aac04c75ad31d6431ef2ea7b1a85573979b7ec4e656",
  "redirectURL": "https://3dss-test.placetopay.com/threeds/v2x/sessions/8e580eb1948ae1b13e614aac04c75ad31d6431ef2ea7b1a85573979b7ec4e656",
  "transactionID": 9099
}

Reglas a Tener en Consideración

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 deviceChannel y messageCategory, así como a entender las reglas específicas que se deben seguir.

Data ElementConditionalContextualizaciónValues
acctNumber
Cardholder Account Number		Requerido
Valores aceptados: ISO 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
Algoritmo de Luhn		5180300000000005
cardExpiryDate
Card/Token Expiry Date		RequeridoFecha 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.
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		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)
07–79 (Reservado para uso futuro de EMVCo)
80–99 (Reservado para uso de DS)		Indicador de autenticación solicitado por el 3DS.
Device Channel: BRW, APP
Message Category: PA, NPA		01
purchaseAmount
Purchase Amount		Requerido con purchaseCurrencyMonto 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		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
max:35		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		[email protected]
threeDSRequestorDecMaxTime
3DS Requestor Decision Max Time		Requerido si threeDSRequestorDecReqInd es igual Y
digits_between:1,5
numeric between:1,10080		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 lo mejor enfoque para entregar un Solicitud 3RI..
Device Channel: RI
Message Category: PA, NPA		02
purchaseExponent
Purchase Exponent		Tamaño 1Exponente 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		OpcionalReferencia del proceso o transacción.
Device Channel: BRW, RI, APP
Message Category: PA, NPA		REF123456789
recurringFrequency
Recurring Frequency		Requerido si threeDSAuthenticationInd es 02 o 03Frecuencia 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 recurringFrequencyFecha 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 03Datos de instalación de la compra.
Device Channel: BRW, RI, APP
Message Category: PA, NPA		12
billAddrCity
Billing Address City		OpcionalCiudad 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		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		OpcionalLí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		OpcionalLí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		OpcionalLínea 3 de la dirección de facturación.
Device Channel: BRW, RI, APP
Message Category: PA, NPA		``
billAddrPostCode
Billing Address Post Code		OpcionalCó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		Estado de la dirección de facturación.
Device Channel: BRW, RI, APP
Message Category: PA, NPA		NY (Nueva York)
shipAddrCity
Shipping Address City		OpcionalCiudad 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		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		OpcionalLí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		OpcionalLí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		OpcionalLínea 3 de la dirección de envío.
Device Channel: BRW, RI, APP
Message Category: PA, NPA		``
shipAddrPostCode
Shipping Address Post Code		OpcionalCó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		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
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
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
Numérico
Dígitos entre 1 y 4		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
Numérico
Dígitos entre 1 y 3		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
Dígitos entre 1 y 3		Actividad de transacciones por día.
Device Channel: BRW, RI, APP
Message Category: PA, NPA		2
acctInfo.txnActivityYear
Transaction Activity per Year		Opcional
Dígitos entre 1 y 3		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
max:8
Formatos aceptados:
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.
Array
ITU-E.164		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
digits_between:1,3		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
digits_between:1,15		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.
Array
ITU-E.164		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
digits_between:1,3		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
digits_between:1,15		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.
Array
ITU-E.164		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
digits_between:1,3		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
digits_between:1,15		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		[email protected]
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
digits_between:1,2		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.1.0
messageCategory
Message Category		Requerido
Valores aceptados
01 (PA)
02 (NPA)
80 (Mastercard Identity Check Insights)
85 (Mastercard Validation Payment)
86 (Mastercard Non Validation Payment)		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