> ## 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 token de un solo uso (SDK Checkout)

> Genera un token volátil de un solo uso para el procesamiento seguro de pagos dentro de una sesión de checkout activa

Crea un token volátil de un solo uso para el procesamiento seguro de pagos dentro de una sesión de checkout.


## OpenAPI

````yaml openapi/es/checkout-sessions/create-one-time-use-token-sdk-checkout.json POST /checkout/sessions/{checkout_session}/token
openapi: 3.1.0
info:
  title: 3ds-setup
  version: 1.0.2
servers:
  - url: https://api-sandbox.y.uno/v1
    description: Sandbox
  - url: https://api.y.uno/v1
    description: Production (US)
security:
  - sec0: []
    sec1: []
paths:
  /checkout/sessions/{checkout_session}/token:
    post:
      operationId: post_checkout-sessions-checkout-session-token
      parameters:
        - in: path
          name: checkout_session
          schema:
            type: string
            default: '{{checkout_session}}'
          required: true
          description: Identificador de la sesión de checkout (UUID).
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                payment_method:
                  type: object
                  properties: {}
              required:
                - payment_method
            examples:
              Card Payment:
                summary: Card Payment
                value:
                  account_id: '{{account_id}}'
                  card_data:
                    number: '4111111111111111'
                    expiration_month: 12
                    expiration_year: 29
                    security_code: '123'
                    holder_name: John Doe
                  payment_method:
                    type: CARD
                    card:
                      number: '4111111111111111'
                      expiration_month: 12
                      expiration_year: 29
                      security_code: '123'
                      holder_name: John Doe
      responses:
        '201':
          content:
            application/json:
              schema:
                type: object
                properties:
                  token:
                    type: string
                    example: dab106a6-9067-4418-ae43-6045663531dc
                  vaulted_token: {}
                  vault_on_success:
                    type: boolean
                    example: false
                    default: true
                  type:
                    type: string
                    example: CARD
                  card_data:
                    type: object
                    properties:
                      holder_name:
                        type: string
                        example: John Doe
                      iin:
                        type: string
                        example: '41111111'
                      lfd:
                        type: string
                        example: '1111'
                      number_length:
                        type: integer
                        example: 16
                        default: 0
                      security_code_length:
                        type: integer
                        example: 3
                        default: 0
                      brand:
                        type: string
                        example: VISA
                      type:
                        type: string
                        example: DEBIT
                      category:
                        type: string
                        example: CLASSIC
                      issuer_name:
                        type: string
                        example: CONOTOXIA SP Z O O
                      issuer_code: {}
                      fingerprint: {}
                      country_code:
                        type: string
                        example: PL
                  customer: {}
                  installment: {}
                  country:
                    type: string
                    example: BR
                  customer_session: {}
                  bank_transfer:
                    type: object
                    description: >-
                      Solo ACH. Datos de la transferencia bancaria derivados de
                      la solicitud de token.
                    properties:
                      bank_name:
                        type: string
                        description: >-
                          Solo ACH. El nombre del banco que Yuno deriva del
                          routing number (o el valor enviado en la solicitud de
                          token). Los números de cuenta y de routing nunca se
                          devuelven.
                        example: JPMorgan Chase
              examples:
                Created - Card Payment:
                  summary: Created - Card Payment
                  value:
                    token: dab106a6-9067-4418-ae43-6045663531dc
                    vaulted_token: null
                    vault_on_success: false
                    type: CARD
                    card_data:
                      holder_name: John Doe
                      iin: '41111111'
                      lfd: '1111'
                      number_length: 16
                      security_code_length: 3
                      brand: VISA
                      type: DEBIT
                      category: CLASSIC
                      issuer_name: CONOTOXIA SP Z O O
                      issuer_code: null
                      fingerprint: null
                      country_code: PL
                    customer: null
                    installment: null
                    country: BR
                    customer_session: null
          description: Creado
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>

````

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