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

# Obtener pago (dos tarjetas)

> Obtiene un pago financiado con dos tarjetas, con el monto y las transacciones de cada tarjeta, desde GET /v2/payments/{payment_id}.

Esta solicitud obtiene un pago creado con [Create Payment (two cards)](https://docs.y.uno/es/reference/payments/create-payment-v2.md), usando el `id` en la ruta de la solicitud. La URL base es `https://api-sandbox.y.uno/v2` en sandbox y `https://api.y.uno/v2` en producción.

La respuesta tiene `split_payment_methods: true`, `payment_methods_count: 2` y una entrada por tarjeta en `payment_method.payment_methods`, cada una con su `sequence` (`1` o `2`), `type`, `amount` y `transactions`. Una tarjeta no tiene un estado propio: lee el resultado de cada tarjeta en sus transacciones, y el resultado del pago en el `status` y el `sub_status` del nivel del pago. Consulta [Pay with two cards](https://docs.y.uno/es/docs/payment-features/pay-with-two-cards.md#statuses).

> [!NOTE]
>
> Para un pago creado con `POST /v1/payments`, usa la solicitud v1 `GET /v1/payments/{payment_id}`. La respuesta v1 muestra un pago como un todo, no cada tarjeta.


## OpenAPI

````yaml openapi/es/payments/retrieve-payment-two-cards.json GET /payments/{payment_id}
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}:
    get:
      summary: Obtener pago (v2)
      description: >-
        Obtiene un pago creado con `POST /v2/payments`, con una entrada por cada
        tarjeta en `payment_method.payment_methods`.
      operationId: retrieve-payment-two-cards
      parameters:
        - name: payment_id
          in: path
          required: true
          description: El `id` del pago devuelto por `POST /v2/payments`.
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: El pago
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaymentV2'
              examples:
                Both cards charged:
                  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: APPROVED
                    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: true
                      account_updater: false
                      payment_methods:
                        - sequence: 1
                          type: CARD
                          amount:
                            currency: BRL
                            value: 200
                          transactions:
                            - id: d2a4f6b8-1c3e-4a5b-8d7f-9e0a1b2c3d4e
                              type: PURCHASE
                              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: PURCHASE
                              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: []
                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: []
        '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
        '404':
          description: Pago no encontrado
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                  messages:
                    type: array
                    items:
                      type: string
              example:
                code: PAYMENT_NOT_FOUND
                messages:
                  - Payment not found
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.