> ## Documentation Index
> Fetch the complete documentation index at: https://docs.y.uno/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Test in the sandbox first: base URL https://api-sandbox.y.uno (Test Mode in the Dashboard). Production is https://api.y.uno (Live Mode).
> Every API request needs the public-api-key and private-secret-key headers. Get them in the Dashboard at https://dashboard.y.uno/developers (Developers > Credentials); sandbox and production keys are different.
> Send an X-Idempotency-Key (a UUID) when creating payments, refunds and cancels, so retries do not create duplicates.
> Start with the Quickstart (https://docs.y.uno/docs/quickstart.md) and the agent guide (https://docs.y.uno/agents.md). To search these docs from a coding agent, connect the docs MCP server at https://docs.y.uno/mcp.

# Crear configuración de 3DS2

> Registra datos de navegador y dispositivo de 3D Secure 2 para integraciones servidor a servidor y recibe un three_d_secure_setup_id para usar en el pago posterior.

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.

> [!NOTE]
>
> **Solo para integraciones servidor a servidor**
>
> Usa 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.

> [!NOTE]
>
> **Solo paso de registro**
>
> Este 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.

> [!WARNING]
>
> **La calidad de los datos de dispositivo importa**
>
> El 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.

> [!NOTE]
>
> **Cómo proporciona el comercio los datos de dispositivo**
>
> El 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](https://docs.y.uno/es/docs/payment-features/3ds-standalone.md).

## 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](https://docs.y.uno/es/reference/payments/create-payment.md) 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](https://docs.y.uno/es/reference/getting-started/authentication.md#idempotency) para más información.

## Reglas de campos y casos límite

| Regla | Comportamiento |
| - | - |
| `type` con un valor distinto de `MERCHANT_PROVIDED` | `400 INVALID_PARAMETERS`. Otros valores están reservados para uso futuro. |
| `browser_info.platform` con un valor no admitido | `400 INVALID_PARAMETERS`. Permitidos: `WEB`, `IOS`, `ANDROID`. |
| `device_fingerprints` omitido | Se acepta. Yuno omitirá el enriquecimiento con huellas de dispositivo para cualquier proveedor que no se haya proporcionado previamente. |
| `device_fingerprints[*].provider_id` no encontrado en tu cuenta | La entrada se descarta silenciosamente; la configuración continúa con las entradas restantes. |
| `account_id` que no pertenece a la clave de API | Se trata como un fallo de autorización (`403`). |


## OpenAPI

````yaml openapi/es/three-d-secure-setups/create-three-d-secure-setup.json POST /three-d-secure/setups
openapi: 3.1.0
info:
  title: three-d-secure-setups-api
  version: 1.0.0
servers:
  - url: https://api-sandbox.y.uno/v1
    description: Sandbox
  - url: https://api.y.uno/v1
    description: Production (US)
security:
  - sec0: []
    sec1: []
    sec2: []
paths:
  /three-d-secure/setups:
    post:
      summary: Create 3DS2 Setup
      description: >-
        Registra los datos de configuración de 3D Secure 2 que recopiló tu
        integración (el entorno del navegador del titular de la tarjeta y
        cualquier huella digital de dispositivo precalculada) y recibe un
        `three_d_secure_setup_id` para referenciar en el siguiente `POST
        /v1/payments`.
      operationId: create-three-d-secure-setup
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
                - account_id
                - type
                - browser_info
              properties:
                account_id:
                  type: string
                  format: uuid
                  description: >-
                    UUID de la cuenta que es dueña de esta configuración de
                    3DS2.
                type:
                  type: string
                  description: >-
                    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.
                  enum:
                    - MERCHANT_PROVIDED
                browser_info:
                  type: object
                  description: >-
                    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.
                  required:
                    - user_agent
                    - accept_header
                    - color_depth
                    - screen_height
                    - screen_width
                    - language
                  properties:
                    user_agent:
                      type: string
                      description: >-
                        `navigator.userAgent` del navegador del titular de la
                        tarjeta.
                    accept_header:
                      type: string
                      description: >-
                        Valor del encabezado HTTP `Accept` que envía el
                        navegador.
                    color_depth:
                      type: string
                      description: '`screen.colorDepth`, por ejemplo `"24"`.'
                    screen_height:
                      type: string
                      description: '`screen.height` en píxeles.'
                    screen_width:
                      type: string
                      description: '`screen.width` en píxeles.'
                    language:
                      type: string
                      description: >-
                        Etiqueta de idioma BCP-47 de `navigator.language`, por
                        ejemplo `"es-CO"`.
                    javascript_enabled:
                      type: boolean
                      description: >-
                        Indica si JavaScript está habilitado. Es `true` por
                        defecto cuando se omite.
                    java_enabled:
                      type: boolean
                      description: >-
                        Indica si el plugin de Java está habilitado. Casi
                        siempre es `false` en los navegadores modernos.
                    browser_time_difference:
                      type: string
                      description: >-
                        Desfase UTC del navegador en minutos, con signo (por
                        ejemplo, `"-300"` para UTC-5). Equivale a `new
                        Date().getTimezoneOffset()`.
                    platform:
                      type: string
                      description: Canal que capturó los datos.
                      enum:
                        - WEB
                        - IOS
                        - ANDROID
                    accept_content:
                      type: string
                      description: Valor opcional de `Accept-Encoding` si lo capturas.
                    accept_browser:
                      type: string
                      description: Valor opcional de `Accept-Language` si lo capturas.
                device_fingerprints:
                  type: array
                  description: >-
                    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í.
                  items:
                    type: object
                    required:
                      - provider_id
                      - id
                    properties:
                      provider_id:
                        type: string
                        format: uuid
                        description: >-
                          UUID de la conexión de fraude o de inteligencia de
                          dispositivo en tu cuenta de Yuno que produjo esta
                          huella digital. Encuéntralo en **Dashboard →
                          Connections** o mediante `GET /v1/connections`.
                      id:
                        type: string
                        description: >-
                          El valor de la huella digital tal como lo devuelve el
                          recopilador de ese proveedor.
            examples:
              With device fingerprints:
                value:
                  account_id: 11111111-1111-1111-1111-111111111111
                  type: MERCHANT_PROVIDED
                  browser_info:
                    user_agent: >-
                      Mozilla/5.0 (Windows NT 10.0; Win64; x64)
                      AppleWebKit/537.36
                    accept_header: text/html,application/xhtml+xml,application/xml;q=0.9
                    color_depth: '24'
                    screen_height: '1080'
                    screen_width: '1920'
                    language: es-CO
                    javascript_enabled: true
                    java_enabled: false
                    browser_time_difference: '-300'
                    platform: WEB
                  device_fingerprints:
                    - provider_id: f3a8b5d2-9c4e-4a7b-b1f8-2d6c9e0a4f12
                      id: fp_abc123xyz
              Without device fingerprints:
                value:
                  account_id: 11111111-1111-1111-1111-111111111111
                  type: MERCHANT_PROVIDED
                  browser_info:
                    user_agent: >-
                      Mozilla/5.0 (Windows NT 10.0; Win64; x64)
                      AppleWebKit/537.36
                    accept_header: text/html,application/xhtml+xml,application/xml;q=0.9
                    color_depth: '24'
                    screen_height: '1080'
                    screen_width: '1920'
                    language: es-CO
                    javascript_enabled: true
                    java_enabled: false
                    browser_time_difference: '-300'
                    platform: WEB
      responses:
        '201':
          description: '201'
          content:
            application/json:
              examples:
                With device fingerprints:
                  value:
                    three_d_secure_setup_id: a17b4f2c-08d1-4e9b-b6c5-9a3e0c7f1b22
                    account_id: 11111111-1111-1111-1111-111111111111
                    type: MERCHANT_PROVIDED
                    browser_info:
                      user_agent: >-
                        Mozilla/5.0 (Windows NT 10.0; Win64; x64)
                        AppleWebKit/537.36
                      accept_header: text/html,application/xhtml+xml,application/xml;q=0.9
                      color_depth: '24'
                      screen_height: '1080'
                      screen_width: '1920'
                      language: es-CO
                      javascript_enabled: true
                      java_enabled: false
                      browser_time_difference: '-300'
                      platform: WEB
                    device_fingerprints:
                      - provider_id: f3a8b5d2-9c4e-4a7b-b1f8-2d6c9e0a4f12
                        id: fp_abc123xyz
              schema:
                type: object
                properties:
                  three_d_secure_setup_id:
                    type: string
                    description: >-
                      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`.
                    example: a17b4f2c-08d1-4e9b-b6c5-9a3e0c7f1b22
                  account_id:
                    type: string
                    description: Eco del `account_id` de la solicitud.
                    example: 11111111-1111-1111-1111-111111111111
                  type:
                    type: string
                    description: Eco del `type` de la solicitud.
                    example: MERCHANT_PROVIDED
                  browser_info:
                    type: object
                    description: Eco del `browser_info` de la solicitud.
                    properties:
                      user_agent:
                        type: string
                        example: >-
                          Mozilla/5.0 (Windows NT 10.0; Win64; x64)
                          AppleWebKit/537.36
                      accept_header:
                        type: string
                        example: text/html,application/xhtml+xml,application/xml;q=0.9
                      color_depth:
                        type: string
                        example: '24'
                      screen_height:
                        type: string
                        example: '1080'
                      screen_width:
                        type: string
                        example: '1920'
                      language:
                        type: string
                        example: es-CO
                      javascript_enabled:
                        type: boolean
                        example: true
                      java_enabled:
                        type: boolean
                        example: false
                      browser_time_difference:
                        type: string
                        example: '-300'
                      platform:
                        type: string
                        example: WEB
                  device_fingerprints:
                    type: array
                    description: Eco del `device_fingerprints` de la solicitud.
                    items:
                      type: object
                      properties:
                        provider_id:
                          type: string
                          example: f3a8b5d2-9c4e-4a7b-b1f8-2d6c9e0a4f12
                        id:
                          type: string
                          example: fp_abc123xyz
        '400':
          description: '400'
          content:
            application/json:
              examples:
                Invalid parameters:
                  value:
                    code: INVALID_PARAMETERS
                    messages:
                      - account_id must be a valid UUIDv4
                    httpCode: 400
                Missing parameters:
                  value:
                    code: MISSING_PARAMETERS
                    messages:
                      - account_id is required
                    httpCode: 400
              schema:
                type: object
                properties:
                  code:
                    type: string
                    example: INVALID_PARAMETERS
                  messages:
                    type: array
                    items:
                      type: string
                      example: account_id must be a valid UUIDv4
                  httpCode:
                    type: integer
                    example: 400
        '401':
          description: '401'
          content:
            application/json:
              examples:
                Unauthorized:
                  value:
                    code: NOT_AUTHENTICATED
                    messages:
                      - Missing API credentials
                    httpCode: 401
              schema:
                type: object
                properties:
                  code:
                    type: string
                    example: NOT_AUTHENTICATED
                  messages:
                    type: array
                    items:
                      type: string
                      example: Missing API credentials
                  httpCode:
                    type: integer
                    example: 401
        '403':
          description: '403'
          content:
            application/json:
              examples:
                Forbidden:
                  value:
                    code: FORBIDDEN
                    messages:
                      - Account inactive or lacks 3DS2 entitlement
                    httpCode: 403
              schema:
                type: object
                properties:
                  code:
                    type: string
                    example: FORBIDDEN
                  messages:
                    type: array
                    items:
                      type: string
                      example: Account inactive or lacks 3DS2 entitlement
                  httpCode:
                    type: integer
                    example: 403
      deprecated: false
components:
  securitySchemes:
    sec0:
      type: apiKey
      in: header
      name: public-api-key
      x-default: <Your public-api-key>
    sec1:
      type: apiKey
      in: header
      name: private-secret-key
      x-default: <Your private-secret-key>
    sec2:
      type: apiKey
      in: header
      name: X-Idempotency-Key
      x-default: <Your X-Idempotency-Key>

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.