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

# Capturar autorización (dos tarjetas)

> Captura la autorización de una tarjeta de un pago de dos tarjetas, usando el id de transacción de esa tarjeta.

Esta solicitud captura una tarjeta de un pago creado con `capture: false` en [Create Payment (two cards)](https://docs.y.uno/es/reference/payments/create-payment-v2.md). La captura es por tarjeta: llámala una vez por cada tarjeta, con el `id` de la transacción `AUTHORIZE` de esa tarjeta en `payment_method.payment_methods[].transactions`.

Después de la primera captura, el pago queda en `SUCCEEDED / PARTIALLY_CAPTURED`. Después de ambas, queda en `SUCCEEDED / CAPTURED`. La respuesta es `201` con el pago en el formato v2.

> [!WARNING]
>
> Mientras el pago está en `REFUND_RETRY_IN_PROCESS` o `CANCEL_RETRY_IN_PROCESS`, una captura es rechazada. Consulta [Pay with two cards](https://docs.y.uno/es/docs/payment-features/pay-with-two-cards.md#operations).

Esta solicitud requiere un `X-Idempotency-Key`. Consulta [Authentication](https://docs.y.uno/es/reference/getting-started/authentication.md#idempotency) para obtener más detalles.


## OpenAPI

````yaml openapi/es/payments/capture-authorization-v2.json POST /payments/{payment_id}/transactions/{transaction_id}/capture
openapi: 3.1.0
info:
  title: payments-v2
  version: 2.0.0
servers:
  - url: https://api-sandbox.y.uno/v2
    description: Sandbox
  - url: https://api.y.uno/v2
    description: Production (US)
security:
  - sec0: []
    sec1: []
paths:
  /payments/{payment_id}/transactions/{transaction_id}/capture:
    post:
      summary: Capturar autorización (dos tarjetas)
      description: >-
        Captura la autorización de una tarjeta. Llámalo una vez por tarjeta, con
        el id de la transacción `AUTHORIZE` de esa tarjeta.
      operationId: capture-authorization-v2
      parameters:
        - name: X-Idempotency-Key
          in: header
          required: true
          description: >-
            Clave única de esta solicitud. Obligatoria en cada solicitud de pago
            v2. Si el resultado no es claro, reintenta con la misma clave. Sin
            ella, la solicitud se rechaza con `400 INVALID_PARAMETERS`: "The
            header 'x-idempotency-key' is required."
          schema:
            type: string
            format: uuid
        - name: payment_id
          in: path
          required: true
          description: El `id` del pago devuelto por `POST /v2/payments`.
          schema:
            type: string
            format: uuid
        - name: transaction_id
          in: path
          required: true
          description: >-
            El `id` de la transacción de la tarjeta sobre la que operar, de
            `payment_method.payment_methods[].transactions[]`.
          schema:
            type: string
            format: uuid
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
                - merchant_reference
                - reason
              properties:
                merchant_reference:
                  type: string
                  description: >-
                    Identificación de la transacción de pago definida por el
                    comercio (MAX 255; MIN 3)
                amount:
                  type: object
                  description: >-
                    Opcional. Monto a capturar en esta tarjeta. Si lo omites, se
                    captura el monto autorizado completo de la tarjeta.
                  required:
                    - currency
                    - value
                  properties:
                    currency:
                      type: string
                      description: Código de moneda ISO 4217 (3 caracteres).
                      example: BRL
                    value:
                      type: number
                      description: Monto en unidades mayores (múltiplo de 0.0001).
                      example: 300
                reason:
                  type: string
                  description: >-
                    Motivo de la operación. Los valores posibles son
                    `DUPLICATE`, `FRAUDULENT` y `REQUESTED_BY_CUSTOMER`.
                  enum:
                    - DUPLICATE
                    - FRAUDULENT
                    - REQUESTED_BY_CUSTOMER
                additional_data:
                  type: object
                  description: Datos adicionales para complementar la captura del pago
                  properties:
                    order:
                      type: object
                      description: Indica el objeto order.
                      properties:
                        shipping_amount:
                          type: number
                          description: El monto de envío de la orden (múltiplo de 0.0001)
                          format: float
                        fee_amount:
                          type: number
                          description: >-
                            El monto de la comisión de la orden (múltiplo de
                            0.0001)
                          format: float
                        items:
                          type: array
                          description: Indica el array de objetos items.
                          items:
                            properties:
                              id:
                                type: string
                                description: >-
                                  El identificador único del artículo (MAX 255;
                                  MIN 3).
                              name:
                                type: string
                                description: El nombre del artículo (MAX 255; MIN 3).
                              quantity:
                                type: integer
                                description: La cantidad del artículo.
                                format: int32
                              unit_amount:
                                type: number
                                description: >-
                                  El monto unitario del artículo (múltiplo de
                                  0.0001).
                                format: float
                              category:
                                type: string
                                description: >-
                                  La categoría del artículo. Consulta [Item
                                  category
                                  reference](/es/reference/items-category-list).
                                enum:
                                  - art
                                  - baby
                                  - coupons
                                  - beauty_&_personal_care
                                  - donations
                                  - computing
                                  - books
                                  - grocery_&_gourmet_food
                                  - cameras
                                  - video_games
                                  - television
                                  - car_electronics
                                  - electronics
                                  - automotive
                                  - toys_&_games
                                  - musical_instruments
                                  - handmade
                                  - garden_&_outdoor
                                  - entertainment
                                  - industrial_&_scientific
                                  - fashion
                                  - games
                                  - pet_supplies
                                  - home
                                  - musical
                                  - phones
                                  - services
                                  - learnings
                                  - tickets
                                  - travels
                                  - virtual_goods
                                  - others
                              brand:
                                type: string
                                description: La marca del artículo (MAX 255; MIN 3).
                              sku_code:
                                type: string
                                description: >-
                                  La unidad de mantenimiento de stock (SKU) del
                                  artículo (MAX 255; MIN 3).
                              manufacture_part_number:
                                type: string
                                description: El número de parte del fabricante del artículo
                            required:
                              - id
                              - name
                              - quantity
                              - unit_amount
                            type: object
                    airline:
                      type: object
                      description: Indica el objeto airline.
                      properties:
                        pnr:
                          type: string
                          description: >-
                            Registro del nombre del pasajero (PNR) (MAX 10; MIN
                            1).
                        legs:
                          type: array
                          description: Indica el array de objetos legs.
                          items:
                            properties:
                              departure_airport:
                                type: string
                                description: >-
                                  Código IATA. Consulta http://www.iata.org (MAX
                                  3; MIN 3).
                              departure_datetime:
                                type: string
                                description: >-
                                  La fecha y la hora de salida en UTC ([ISO
                                  8601](https://en.wikipedia.org/wiki/ISO_8601),
                                  MAX 27; MIN 27).
                                format: date-time
                              departure_airport_timezone:
                                type: string
                                description: Zona horaria del aeropuerto (MAX 6; MIN 6).
                              arrival_airport:
                                type: string
                                description: >-
                                  Código IATA del aeropuerto. Consulta
                                  http://www.iata.org (MAX 3; MIN 3).
                              carrier_code:
                                type: string
                                description: >-
                                  Código IATA de la aerolínea. Consulta
                                  http://www.iata.org (MAX 2; MIN 2).
                              carrier_name:
                                type: string
                                description: El nombre de la aerolínea (MAX 100; MIN 1).
                              flight_number:
                                type: string
                                description: >-
                                  El número de vuelo asignado por la aerolínea
                                  (MAX 5; MIN 1).
                              fare_basis_code:
                                type: string
                                description: >-
                                  El código de tarifa base da información
                                  específica sobre la tarifa además de la clase
                                  de servicio; ambos son necesarios para la
                                  reserva (MAX 15; MIN 1).
                              fare_class_code:
                                type: string
                                description: >-
                                  El código de clase tarifaria de la aerolínea
                                  (MAX 1; MIN 1). Los valores pueden ser una
                                  letra (A-Z), pero pueden variar según la
                                  definición de cada aerolínea. Consulta la
                                  [Airline information
                                  reference](/es/reference/airline-information#fare-class-code).
                                enum:
                                  - F
                                  - FR
                                  - B
                                  - CR
                                  - 'Y'
                                  - YD
                              base_fare:
                                type: number
                                description: >-
                                  El monto de la transacción, sin impuestos ni
                                  cargos, en la unidad más pequeña de la moneda
                                  (multipleOf 0.0001).
                                format: float
                              base_fare_currency:
                                type: string
                                description: >-
                                  La moneda usada para el monto de la
                                  transacción (MAX 3; MIN 3; [ISO
                                  4217](country-reference)).
                              stopover_code:
                                type: string
                                description: >-
                                  Código de 1 letra que indica si el pasajero
                                  puede hacer una escala. Solo se permiten dos
                                  caracteres: O: escala permitida (la letra “O”,
                                  no el cero) / X: escala no permitida. (MAX 1;
                                  MIN 1)
                            required:
                              - departure_airport
                              - departure_datetime
                              - departure_airport_timezone
                              - arrival_airport
                              - carrier_code
                              - flight_number
                              - fare_basis_code
                              - fare_class_code
                            type: object
                        passengers:
                          type: array
                          description: >-
                            Especifica el arreglo de objetos de pasajeros
                            asociados a los boletos.
                          items:
                            properties:
                              first_name:
                                type: string
                                description: El nombre del pasajero (MAX 255; MIN 3).
                              last_name:
                                type: string
                                description: El apellido del pasajero (MAX 255; MIN 3)
                              middle_name:
                                type: string
                                description: >-
                                  El segundo nombre del pasajero (MAX 255; MIN
                                  3).
                              type:
                                type: string
                                description: >-
                                  El tipo de pasajero (MAX 1; MIN 1). Consulta
                                  la [Airline information
                                  reference](/es/reference/airline-information#passenger-type).
                                enum:
                                  - A
                                  - C
                                  - I
                              date_of_birth:
                                type: string
                                description: >-
                                  La fecha de nacimiento del pasajero en formato
                                  YYYY-MM-DD (MAX 10; MIN 10).
                                format: date
                              nationality:
                                type: string
                                description: >-
                                  La nacionalidad del pasajero (MAX 2; MIN 2;
                                  [ISO 3166-1](country-reference)).
                                enum:
                                  - AR
                                  - BO
                                  - BR
                                  - CL
                                  - CO
                                  - CR
                                  - EC
                                  - SV
                                  - GT
                                  - HN
                                  - MX
                                  - NI
                                  - PA
                                  - PY
                                  - PE
                                  - US
                                  - UY
                              document:
                                type: object
                                description: >-
                                  Especifica el objeto de documento de los
                                  pasajeros.
                                properties:
                                  document_number:
                                    type: string
                                    description: >-
                                      Número de documento del pasajero (MAX 40;
                                      MIN 3).
                                  document_type:
                                    type: string
                                    description: >-
                                      El tipo de documento del pasajero (MAX 6,
                                      MIN 2; ([referencia de
                                      países](country-reference))).
                                    enum:
                                      - DNI
                                      - CI
                                      - LC
                                      - LE
                                      - CUIT
                                      - CUIL
                                      - PAS
                                      - CPF
                                      - RG
                                      - CNH
                                      - CNPJ
                                      - RUT
                                      - RUN
                                      - CC
                                      - CE
                                      - NIT
                                      - DUI
                                      - PIC
                                      - DPI
                                      - IFR
                                      - INE
                                      - CP
                                      - RFC
                                      - CURP
                                      - CIP
                                      - CIC
                                      - CUI
                                      - RUC
                                      - ''
                                  country:
                                    type: string
                                    description: >-
                                      País donde se emitió el documento (MAX 2;
                                      MIN 2; [ISO 3166-1](country-reference)).
                                    enum:
                                      - AR
                                      - BO
                                      - BR
                                      - CL
                                      - CO
                                      - CR
                                      - EC
                                      - SV
                                      - GT
                                      - HN
                                      - MX
                                      - NI
                                      - PA
                                      - PY
                                      - PE
                                      - US
                                      - UY
                              loyalty_number:
                                type: string
                                description: Número del programa de fidelidad del pasajero.
                              loyalty_tier:
                                type: string
                                description: >-
                                  Nivel del programa de fidelidad del pasajero.
                                  Consulta la [Airline information
                                  reference](/es/reference/airline-information#loyalty-tier).
                                enum:
                                  - '1'
                                  - '2'
                                  - '3'
                              phone:
                                type: object
                                description: Indica el objeto del teléfono del pasajero.
                            type: object
                        tickets:
                          type: array
                          description: >-
                            Especifica el arreglo de objetos de boletos
                            asociados a los pasajeros.
                          items:
                            properties:
                              ticket_number:
                                type: string
                                description: Número de boleto (MAX 14; MIN 1).
                              e_ticket:
                                type: boolean
                                description: ¿Es un boleto electrónico?  (true) (false).
                              restricted:
                                type: boolean
                                description: >-
                                  Indica si el boleto es reembolsable o no
                                  (true/false)
                              total_fare_amount:
                                type: number
                                description: >-
                                  Monto total de la tarifa en la unidad más
                                  pequeña de la moneda (múltiplo de 0.0001).
                                format: float
                              total_tax_amount:
                                type: number
                                description: >-
                                  Monto total de impuestos en la unidad más
                                  pequeña de la moneda (múltiplo de 0.0001).
                                format: float
                              total_fee_amount:
                                type: number
                                description: >-
                                  Monto total de cargos en la unidad más pequeña
                                  de la moneda (múltiplo de 0.0001).
                                format: float
                              issue:
                                type: object
                                description: Indica el objeto issue.
                                properties:
                                  carrier_prefix_code:
                                    type: string
                                    description: >-
                                      Aerolínea emisora o validadora. Es el
                                      código numérico de 3 dígitos del prefijo
                                      AWB (Air waybill) (MAX 3; MIN 3).
                                  travel_agent_code:
                                    type: string
                                    description: >-
                                      Código del agente de viajes que emite el
                                      boleto (MAX 9; MIN 8).
                                  travel_agent_name:
                                    type: string
                                    description: >-
                                      El nombre con el que aparece el punto de
                                      venta en la lista de agencias, o el nombre
                                      de la franquicia (MAX 32; MIN 1).
                                  date:
                                    type: string
                                    description: >-
                                      Fecha de emisión del boleto (MAX 27; MIN
                                      27).
                                    format: date-time
                                  address:
                                    type: string
                                    description: >-
                                      Dirección del agente que vendió el boleto
                                      (MAX 255; MIN 3).
                                  city:
                                    type: string
                                    description: >-
                                      Ciudad del agente que vendió el boleto
                                      (MAX 255; MIN 3).
                                  country:
                                    type: string
                                    description: >-
                                      Código de país alpha-2 donde se emitió el
                                      boleto (MAX 2; MIN 2; [ISO
                                      3166-1](country-reference)).
                                    enum:
                                      - AR
                                      - BO
                                      - BR
                                      - CL
                                      - CO
                                      - CR
                                      - EC
                                      - SV
                                      - GT
                                      - HN
                                      - MX
                                      - NI
                                      - PA
                                      - PY
                                      - PE
                                      - US
                                      - UY
                            type: object
                    seller_details:
                      type: object
                      description: Especifica el objeto con los detalles del vendedor.
                      properties:
                        name:
                          type: string
                          description: La razón social del vendedor (MAX 255; MIN 3).
                        email:
                          type: string
                          description: El email del vendedor (MAX 255; MIN 3).
                        reference:
                          type: number
                          description: >-
                            El código de identificación del vendedor (MAX 255;
                            MIN 3).
                          format: float
                        website:
                          type: string
                          description: La URL del sitio web del vendedor (MAX 255; MIN 3).
                        industry:
                          type: string
                          description: >-
                            La industria del vendedor (MAX 235; MIN 1). Para más
                            información, consulta la [Industry category
                            reference](/es/reference/industry-category-list).
                        merchant_category_code:
                          type: string
                          description: >-
                            MCC: el código de categoría del comercio (MAX 235;
                            MIN 1).
                        country:
                          type: string
                          description: >-
                            El país del vendedor (MAX 255; MIN 3; [ISO
                            3166-1](/es/reference/country-reference)).
                          enum:
                            - AR
                            - BO
                            - BR
                            - CL
                            - CO
                            - CR
                            - EC
                            - SV
                            - GT
                            - HN
                            - MX
                            - NI
                            - PA
                            - PY
                            - PE
                            - US
                            - UY
                            - ''
                        document:
                          type: object
                          description: Indica el objeto del documento del vendedor.
                          properties:
                            document_number:
                              type: string
                              description: >-
                                El número de documento del vendedor (MAX 40; MIN
                                3).
                            document_type:
                              type: string
                              description: >-
                                El tipo de documento del vendedor (MAX 6, MIN 2;
                                [lista de tipos de
                                documento](/es/reference/country-reference)).
                              enum:
                                - DNI
                                - CI
                                - LC
                                - LE
                                - CUIT
                                - CUIL
                                - PAS
                                - CPF
                                - RG
                                - CNH
                                - CNPJ
                                - RUT
                                - RUN
                                - CC
                                - CE
                                - NIT
                                - DUI
                                - PIC
                                - DPI
                                - IFR
                                - INE
                                - CP
                                - RFC
                                - CURP
                                - CIP
                                - CIC
                                - CUI
                                - RUC
                                - ''
                        phone:
                          type: object
                          description: >-
                            Indica el objeto del número de teléfono del
                            vendedor.
                          properties:
                            country_code:
                              type: string
                              description: >-
                                El código de país del teléfono del vendedor (MAX
                                3; MIN 1). Consulta la [Country
                                reference](country-reference) para ver los
                                códigos telefónicos.
                            number:
                              type: string
                              description: >-
                                El número de teléfono del vendedor, sin el
                                código de país (MAX 32; MIN 1).
                        address:
                          type: object
                          description: Indica el objeto de la dirección del vendedor.
                          properties:
                            address_line_1:
                              type: string
                              description: >-
                                La línea principal de la dirección del vendedor
                                (MAX 255; MIN 3).
                            address_line_2:
                              type: string
                              description: >-
                                La línea secundaria de la dirección de
                                facturación del vendedor (MAX 255; MIN 3).
                            city:
                              type: string
                              description: >-
                                La ciudad de la dirección del vendedor (MAX 255;
                                MIN 3).
                            country:
                              type: string
                              description: >-
                                El país de la dirección del vendedor (MAX 2; MIN
                                2; [ISO
                                3166-1](/es/reference/country-reference)).
                              enum:
                                - AR
                                - BO
                                - BR
                                - CL
                                - CO
                                - CR
                                - EC
                                - SV
                                - GT
                                - HN
                                - MX
                                - NI
                                - PA
                                - PY
                                - PE
                                - US
                                - UY
                                - ''
                            state:
                              type: string
                              description: >-
                                El estado considerado para la dirección del
                                vendedor (MAX 255; MIN 3).
                            zip_code:
                              type: string
                              description: >-
                                El código postal de la dirección del vendedor
                                (MAX 11; MIN 4).
      responses:
        '201':
          description: El pago después de la operación, con la estructura v2
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaymentV2'
              examples:
                One card captured:
                  value:
                    id: 7c1b6e2a-5f3d-4a8e-9b21-3e4f5a6b7c8d
                    account_id: 493e9374-510a-4201-9e09-de669d75f256
                    description: Order paid with two cards
                    country: BR
                    status: SUCCEEDED
                    sub_status: PARTIALLY_CAPTURED
                    merchant_order_id: order-10045
                    created_at: '2026-10-27T14:02:11.120Z'
                    updated_at: '2026-10-27T14:02:12.300Z'
                    split_payment_methods: true
                    payment_methods_count: 2
                    sdk_action_required: false
                    amount:
                      currency: BRL
                      value: 300
                    checkout:
                      session: null
                    payment_method:
                      capture: false
                      account_updater: false
                      payment_methods:
                        - sequence: 1
                          type: CARD
                          amount:
                            currency: BRL
                            value: 200
                          transactions:
                            - id: d2a4f6b8-1c3e-4a5b-8d7f-9e0a1b2c3d4e
                              type: AUTHORIZE
                              status: SUCCEEDED
                              category: CARD
                              amount: 200
                              provider_id: YUNO_TEST_PAYMENT_GATEWAY
                              response_code: SUCCEEDED
                              response_message: Transaction successful
                              reason: null
                              description: null
                              merchant_reference: null
                              three_d_secure_action_required: false
                              created_at: '2026-10-27T14:02:11.402Z'
                              updated_at: '2026-10-27T14:02:12.118Z'
                            - id: a5d7c9e1-4f6b-4d8e-9a0c-2b3c4d5e6f7a
                              type: CAPTURE
                              status: SUCCEEDED
                              category: CARD
                              amount: 200
                              provider_id: YUNO_TEST_PAYMENT_GATEWAY
                              response_code: SUCCEEDED
                              response_message: Transaction successful
                              reason: null
                              description: null
                              merchant_reference: null
                              three_d_secure_action_required: false
                              created_at: '2026-10-27T14:02:11.402Z'
                              updated_at: '2026-10-27T14:02:12.118Z'
                        - sequence: 2
                          type: CARD
                          amount:
                            currency: BRL
                            value: 100
                          transactions:
                            - id: e3b5a7c9-2d4f-4b6c-9e8a-0f1b2c3d4e5f
                              type: AUTHORIZE
                              status: SUCCEEDED
                              category: CARD
                              amount: 100
                              provider_id: YUNO_TEST_PAYMENT_GATEWAY
                              response_code: SUCCEEDED
                              response_message: Transaction successful
                              reason: null
                              description: null
                              merchant_reference: null
                              three_d_secure_action_required: false
                              created_at: '2026-10-27T14:02:11.402Z'
                              updated_at: '2026-10-27T14:02:12.118Z'
                    customer_payer:
                      id: cfae0941-7234-427a-a739-ef4fce966c79
                      first_name: Ana
                      last_name: Souza
                      email: ana.souza@example.com
                    workflow: DIRECT
                    callback_url: https://merchant.example.com/checkout/return
                    metadata: []
        '400':
          description: >-
            Solicitud no válida. `INVALID_PARAMETERS` cuando falta la clave de
            idempotencia o el monto supera lo que se puede operar;
            `INVALID_STATUS` cuando la tarjeta no admite la operación, por
            ejemplo un reembolso mientras la tarjeta tiene un contracargo
            abierto, o una captura o cancelación mientras el pago está en
            `REFUND_RETRY_IN_PROCESS` o `CANCEL_RETRY_IN_PROCESS`.
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                  messages:
                    type: array
                    items:
                      type: string
              examples:
                Missing idempotency key:
                  value:
                    code: INVALID_PARAMETERS
                    messages:
                      - The header 'x-idempotency-key' is required.
        '401':
          description: Credenciales no válidas
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                  messages:
                    type: array
                    items:
                      type: string
              example:
                code: INVALID_CREDENTIALS
                messages:
                  - Invalid credentials
components:
  schemas:
    PaymentV2:
      type: object
      description: Un pago financiado con dos tarjetas.
      properties:
        id:
          type: string
          format: uuid
        account_id:
          type: string
          format: uuid
        description:
          type: string
        country:
          type: string
        status:
          type: string
          description: >-
            Estado agregado del pago. Consulta [Pagar con dos
            tarjetas](/es/docs/payment-features/pay-with-two-cards#statuses).
        sub_status:
          type: string
          description: >-
            Subestado agregado, por ejemplo `APPROVED`, `AUTHORIZED`,
            `PARTIALLY_CAPTURED`, `PARTIALLY_REFUNDED`,
            `REFUND_RETRY_IN_PROCESS` o `CANCEL_RETRY_IN_PROCESS`.
        merchant_order_id:
          type: string
        merchant_reference:
          type: string
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
        split_payment_methods:
          type: boolean
          description: '`true` para un pago financiado con dos tarjetas.'
        payment_methods_count:
          type: integer
          description: 'Número de tarjetas que financian el pago: `2`.'
        sdk_action_required:
          type: boolean
          description: >-
            `true` cuando el SDK debe continuar el pago, por ejemplo para
            ejecutar un desafío 3DS.
        amount:
          type: object
          description: Total del pago.
          required:
            - currency
            - value
          properties:
            currency:
              type: string
              description: Código de moneda ISO 4217 (3 caracteres).
              example: BRL
            value:
              type: number
              description: Monto en unidades mayores (múltiplo de 0.0001).
              example: 300
        checkout:
          type: object
          properties:
            session:
              type:
                - string
                - 'null'
        payment_method:
          type: object
          properties:
            capture:
              type: boolean
              description: Configuración de captura compartida por ambas tarjetas.
            account_updater:
              type:
                - boolean
                - 'null'
            payment_methods:
              type: array
              description: >-
                Una entrada por tarjeta. No hay un estado por tarjeta: lee el
                resultado de cada tarjeta en sus `transactions`.
              minItems: 2
              maxItems: 2
              items:
                type: object
                properties:
                  sequence:
                    type: integer
                    description: 'Posición de la tarjeta: `1` o `2`.'
                  type:
                    type: string
                    enum:
                      - CARD
                  amount:
                    type: object
                    description: Parte del total que paga esta tarjeta.
                    required:
                      - currency
                      - value
                    properties:
                      currency:
                        type: string
                        description: Código de moneda ISO 4217 (3 caracteres).
                        example: BRL
                      value:
                        type: number
                        description: Monto en unidades mayores (múltiplo de 0.0001).
                        example: 300
                  payment_method_detail:
                    type: object
                    description: Detalles de la tarjeta, como en el objeto de pago v1.
                  payment_method_owner:
                    type: object
                    description: Titular de la tarjeta, cuando se envía en la solicitud.
                  transactions:
                    type: array
                    description: >-
                      Transacciones de esta tarjeta. Una tarjeta que pasó por
                      3DS muestra `THREE_D_SECURE` seguido de `PURCHASE` o
                      `AUTHORIZE`.
                    items:
                      type: object
                      description: >-
                        Una transacción de la tarjeta. Lee el resultado de la
                        tarjeta en sus transacciones.
                      properties:
                        id:
                          type: string
                          format: uuid
                          description: >-
                            Id de la transacción. Úsalo en las operaciones por
                            transacción.
                        type:
                          type: string
                          description: >-
                            Tipo de transacción, por ejemplo `THREE_D_SECURE`,
                            `PURCHASE`, `AUTHORIZE`, `CAPTURE`, `CANCEL` o
                            `REFUND`.
                        status:
                          type: string
                          description: >-
                            Estado de esta transacción, por ejemplo `SUCCEEDED`,
                            `DECLINED`, `PENDING` o `ERROR`.
                        category:
                          type: string
                          example: CARD
                        amount:
                          type: number
                          description: Monto de esta transacción.
                        provider_id:
                          type: string
                          description: Proveedor que procesó la transacción.
                        response_code:
                          type: string
                          description: Código de respuesta de Yuno de la transacción.
                        response_message:
                          type: string
                        reason:
                          type:
                            - string
                            - 'null'
                        description:
                          type:
                            - string
                            - 'null'
                        merchant_reference:
                          type:
                            - string
                            - 'null'
                        three_d_secure_action_required:
                          type:
                            - boolean
                            - 'null'
                        created_at:
                          type: string
                          format: date-time
                        updated_at:
                          type:
                            - string
                            - 'null'
                          format: date-time
        customer_payer:
          type: object
          description: El pagador, tal como se envió en la solicitud.
        additional_data:
          type:
            - object
            - 'null'
        callback_url:
          type: string
        workflow:
          type: string
          enum:
            - DIRECT
            - REDIRECT
            - SDK_CHECKOUT
        metadata:
          type: array
          items:
            type: object
  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.