Saltar al contenido principal
POST
Registra los datos de configuración de 3D Secure 2 que tu integración ha recopilado: el entorno del navegador del titular de la tarjeta y las huellas de dispositivo que ya hayas calculado. A cambio, recibes un three_d_secure_setup_id para referenciar en el POST /v1/payments posterior.
Solo para integraciones servidor a servidorUsa este endpoint cuando operes una integración servidor a servidor (B2B) y recopiles los datos de dispositivo de 3DS2 de tu lado, mediante tu propio SDK, el recolector de un proveedor de evaluación de fraude o un servidor 3DS2 al que llamas directamente.Si te integras mediante el SDK Web/Mobile de Yuno y una sesión de checkout, puedes omitir este endpoint por completo. El SDK recopila los datos de dispositivo y los registra automáticamente como parte del flujo de checkout.
Solo paso de registroEste endpoint no llama al emisor, no muestra un desafío y no se vincula a una tarjeta específica. La tarjeta y el three_d_secure_setup_id viajan juntos en la llamada de pago.
La calidad de los datos de dispositivo importaEl proveedor de pagos usa browser_info y device_fingerprints para evaluar el riesgo y decidir entre un flujo sin fricción y un desafío cuando se envía el pago. Los campos faltantes o desactualizados aumentan la tasa de desafíos. Envía los valores exactamente como se observaron en el navegador del titular de la tarjeta en el momento en que llamas a este endpoint.
Cómo proporciona el comercio los datos de dispositivoEl campo type le indica a Yuno dónde se recopilaron los datos de dispositivo. MERCHANT_PROVIDED, actualmente el único valor admitido, significa que recopilaste de tu lado el entorno del navegador y las huellas de dispositivo y los estás enviando directamente. Yuno no ejecuta su propio recolector para este endpoint. Si necesitas que Yuno capture los datos de navegador/dispositivo, usa en su lugar la variante con SDK.

Cómo usar la respuesta

  1. Guarda el id. Conserva three_d_secure_setup_id asociado a la orden de tu lado.
  2. Referéncialo en el pago. En el Create Payment posterior, envíalo en payment_method.detail.card.three_d_secure.three_d_secure_setup_id junto con la tarjeta o el token almacenado. Yuno adjunta los browser_info y device_fingerprints registrados a la solicitud que envía al proveedor de pagos.
Ten en cuenta que esta solicitud requiere un X-Idempotency-Key. La misma clave con el mismo payload devuelve el id de configuración original dentro de una ventana de repetición de 24 horas. Consulta la página Authentication para más información.

Reglas de campos y casos límite

Autorizaciones

public-api-key
string
header
predeterminado:<Your public-api-key>
requerido
private-secret-key
string
header
predeterminado:<Your private-secret-key>
requerido
X-Idempotency-Key
string
header
predeterminado:<Your X-Idempotency-Key>
requerido

Cuerpo

application/json
account_id
string<uuid>
requerido

UUID de la cuenta que es dueña de esta configuración de 3DS2.

type
enum<string>
requerido

Origen de los datos del dispositivo. MERCHANT_PROVIDED significa que recopilaste los datos del navegador o dispositivo por tu cuenta y los envías directamente.

Opciones disponibles:
MERCHANT_PROVIDED
browser_info
object
requerido

Entorno del navegador capturado de la sesión del titular de la tarjeta. Se reenvía tal cual al servidor 3DS2 para la puntuación de riesgo y las decisiones sin fricción.

device_fingerprints
object[]

Una o más huellas digitales de dispositivo, por proveedor, ya recopiladas por tu cuenta. Yuno no volverá a ejecutar la recopilación de dispositivo para ningún provider_id que incluyas aquí.

Respuesta

201

three_d_secure_setup_id
string

Identificador generado de la configuración de 3DS2. Pásalo en payment_method.detail.card.three_d_secure.three_d_secure_setup_id en el siguiente POST /v1/payments.

Ejemplo:

"a17b4f2c-08d1-4e9b-b6c5-9a3e0c7f1b22"

account_id
string

Eco del account_id de la solicitud.

Ejemplo:

"11111111-1111-1111-1111-111111111111"

type
string

Eco del type de la solicitud.

Ejemplo:

"MERCHANT_PROVIDED"

browser_info
object

Eco del browser_info de la solicitud.

device_fingerprints
object[]

Eco del device_fingerprints de la solicitud.