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

# Reembolsar pago

> Emite un reembolso parcial o total para una transacción de pago existente.

> [!WARNING]
>
> No ejecutes un reembolso mientras otro está en curso. Espera a que la operación actual termine antes de iniciar una nueva.

Este endpoint te permite emitir un reembolso para un pago existente.

Si especificas un `amount`, se creará un **reembolso parcial**. Si omites el `amount`, se procesará un **reembolso total** del pago original.

> [!NOTE]
>
> **Pagos con una promoción de Yuno**
>
> Un reembolso se calcula sobre lo que pagó el cliente, `amount.value` menos `discount_amount`. Un reembolso total devuelve ese monto, y un `amount` superior a lo que queda por reembolsar se rechaza con `400 INVALID_PARAMETERS`. Consulta [Promotions](https://docs.y.uno/es/docs/payment-features/promotions#refunds-captures-and-cancellations).

> [!NOTE]
>
> **Pagos aprobados parcialmente**
>
> Para un pago con tarjeta enviado con `payment_method.detail.card.partial_approval: true` y aprobado por menos de lo solicitado, los reembolsos se limitan a `amount.authorized`. Un reembolso total devuelve `amount.authorized`, y un `amount` superior a lo que queda de ese monto se rechaza con `400 INVALID_PARAMETERS`.

Los reembolsos solo se pueden crear para cargos que aún no han sido reembolsados. El monto reembolsado se devolverá al método de pago original usado en la transacción.

Ten en cuenta que esta solicitud requiere un `X-Idempotency-Key`. Consulta la página [Authentication](https://docs.y.uno/es/reference/getting-started/authentication.md#idempotency) para obtener más información.


## OpenAPI

````yaml openapi/es/payments/refund-payment.json POST /payments/{id}/transactions/{transaction_id}/refund
openapi: 3.1.0
info:
  title: payment-api-refundcancel-payment
  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: []
    sec2: []
paths:
  /payments/{id}/transactions/{transaction_id}/refund:
    post:
      summary: Reembolsar pago
      operationId: refund-payment
      parameters:
        - name: id
          in: path
          description: El identificador único del pago (UUID, 36 caracteres).
          schema:
            type: string
          required: true
        - name: transaction_id
          in: path
          description: El identificador único de la transacción (UUID, 36 caracteres).
          schema:
            type: string
          required: true
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
                - merchant_reference
              properties:
                description:
                  type: string
                  description: Descripción del reembolso. (MAX 255; MIN 3).
                reason:
                  type: string
                  description: >-
                    Indica el motivo del reembolso. Si se define, los valores
                    posibles son `DUPLICATE`, `FRAUDULENT`,
                    `REQUESTED_BY_CUSTOMER` y `REVERSE`. Usa `REVERSE` para
                    solicitar una reversión automática de los fondos del
                    destinatario cuando hay un destinatario involucrado en la
                    transacción.
                  enum:
                    - DUPLICATE
                    - FRAUDULENT
                    - REQUESTED_BY_CUSTOMER
                    - REVERSE
                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: >-
                    Especifica el objeto de monto para el reembolso. **Solo es
                    obligatorio para reembolsos parciales**.
                  properties:
                    currency:
                      type: string
                      description: >-
                        La moneda con la que se hace el pago. Para ver la lista
                        completa de códigos de moneda, consulta [Country
                        reference](/es/reference/country-reference) (MAX 3; MIN
                        3; ISO 4217).
                    value:
                      type: number
                      format: float
                      description: >-
                        El monto del reembolso (múltiplo de 0.0001). Para una
                        moneda sin decimales (por ejemplo KRW, JPY o CLP) el
                        valor debe ser un número entero: consulta [Montos y
                        monedas](/es/docs/basic-concepts/amounts-and-currencies).
                split_marketplace:
                  type: array
                  description: Array de objetos de split marketplace
                  items:
                    properties:
                      recipient_id:
                        type: string
                        description: >-
                          El identificador único del destinatario en el sistema
                          de Yuno. <br/> Al crear un pago, debes enviar el
                          [`recipient_id`](/es/reference/recipients-for-marketplace/create-recipient-1)
                          (generado por Yuno) o el `provider_recipient_id` (el
                          ID del proveedor externo).
                      provider_recipient_id:
                        type: string
                        description: >-
                          El ID del destinatario que entrega el proveedor de
                          pagos externo, si corresponde. <br/> Al crear un pago,
                          debes enviar el `provider_recipient_id` o el
                          [`recipient_id`](/es/reference/recipients-for-marketplace/create-recipient-1)
                          (generado por Yuno).
                      description:
                        type: string
                        description: Descripción del split. (MAX 255; MIN 3).
                      type:
                        type: string
                        description: >-
                          El tipo de split. `recipient_id` es obligatorio para
                          `PURCHASE` y `MARKETPLACE`.
                        enum:
                          - PURCHASE
                          - PAYMENTFEE
                          - VAT
                          - COMMISSION
                          - MARKETPLACE
                          - SHIPPING
                      merchant_reference:
                        type: string
                        description: >-
                          Identificador único opcional de la transacción de
                          split (MAX 255; MIN 3).
                      recipient_type:
                        type: string
                        description: El tipo de destinatario para el proveedor.
                        enum:
                          - MEAL
                          - FOOD
                          - MULTI_BENEFITS
                          - FLEET
                        example: MEAL
                      amount:
                        type: object
                        description: Define el monto de la división.
                        required:
                          - value
                          - currency
                        properties:
                          value:
                            type: number
                            description: El monto del split (múltiplo de 0.0001).
                            format: float
                          currency:
                            type: string
                            description: >-
                              La moneda con la que se hace el pago. Para ver la
                              lista completa de códigos de moneda, consulta
                              [Country
                              reference](/es/reference/country-reference) (MAX
                              3; MIN 3; ISO 4217).
                      liability:
                        type: object
                        description: >-
                          Información opcional sobre la responsabilidad del
                          destinatario por cargos y contracargos.
                        properties:
                          processing_fee:
                            type: string
                            description: >-
                              Indica a quién se le cobra el cargo de la
                              transacción.
                            enum:
                              - MERCHANT
                              - RECIPIENT
                              - SHARED
                          chargebacks:
                            type: boolean
                            description: >-
                              El destinatario es responsable en caso de un
                              contracargo.
                    required:
                      - type
                    type: object
                simplified_mode:
                  type: boolean
                  description: >-
                    Determina si Yuno debe intentar reembolsar automáticamente
                    un pago después de un error o rechazo inicial. Cuando se
                    establece en `true`, Yuno reintenta el proceso si el primer
                    intento falla. Por defecto, es `false`. Accede a [Reintentos
                    de
                    transacciones](https://docs.y.uno/es/docs/payment-features/transaction-retries)
                    para más detalles.
                response_additional_data:
                  type: object
                  description: >-
                    Especifica datos adicionales requeridos para la respuesta de
                    la transacción
                  properties:
                    receipt:
                      type: boolean
                      description: >-
                        Indica si se necesita un comprobante en la respuesta de
                        la transacción
                    receipt_language:
                      type: string
                      description: Indica el idioma del comprobante que se generará
                      enum:
                        - ES
                        - EN
                        - PT
                customer_payer:
                  type: object
                  description: Indica el objeto customer de los pagos.
                  properties:
                    first_name:
                      type: string
                      description: El nombre del cliente (MAX 255; MIN 3).
                    last_name:
                      type: string
                      description: El apellido del cliente (MAX 255; MIN 3).
                    gender:
                      type: string
                      description: >-
                        El género del cliente (MAX 2; MIN 1). <br/>- M=Masculino
                        <br/>- F=Femenino <br/>- NB=No binario <br/>- NA=No
                        aplica <br/>- NK=No se conoce <br/>- U=Sin definir.
                      enum:
                        - M
                        - F
                        - NB
                        - NA
                        - NK
                        - U
                    date_of_birth:
                      type: string
                      description: >-
                        La fecha de nacimiento del cliente en formato
                        `YYYY-MM-DD` (Longitud: 10).
                    email:
                      type: string
                      description: El correo electrónico del cliente (MAX 255; MIN 3).
                    nationality:
                      type: string
                      description: >-
                        La nacionalidad del cliente (MAX 2; MIN 2; [ISO
                        3166-1](/es/reference/country-reference)).
                    document:
                      type: object
                      description: >-
                        Indica el objeto del documento del cliente, con su
                        número y su tipo.
                      required:
                        - document_number
                        - document_type
                      properties:
                        document_number:
                          type: string
                          description: Número de documento del cliente (MAX 40; MIN 3)
                        document_type:
                          type: string
                          description: >-
                            El tipo de documento del cliente (MAX 6, MIN 2).
                            Accede a la [lista de tipos de
                            documento](/es/reference/country-reference) para más
                            detalles.
                          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: Especifica el objeto de teléfono del cliente.
                      properties:
                        country_code:
                          type: string
                          description: >-
                            El código de país del teléfono del cliente (MAX 3;
                            MIN 1).
                        number:
                          type: string
                          description: >-
                            El número de teléfono del cliente, sin el código de
                            país (MAX 32; MIN 1).
                    billing_address:
                      type: object
                      description: >-
                        Indica el objeto de la dirección de facturación del
                        cliente.
                      properties:
                        address_line_1:
                          type: string
                          description: >-
                            La línea principal de la dirección de facturación
                            del cliente (MAX 255; MIN 3).
                        address_line_2:
                          type: string
                          description: >-
                            La línea secundaria de la dirección de facturación
                            del cliente (MAX 255; MIN 3).
                        city:
                          type: string
                          description: >-
                            La ciudad considerada para la dirección de
                            facturación (MAX 255; MIN 3).
                        country:
                          type: string
                          description: >-
                            El país considerado para la dirección de facturación
                            (MAX 2; MIN 2; [ISO
                            3166-1](https://docs.y.uno/es/reference/customers/the-customer-object#country-code-list-iso-3166-1)).
                          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 de
                            facturación (MAX 255; MIN 3).
                        zip_code:
                          type: string
                          description: >-
                            El código postal considerado para la dirección de
                            facturación (MAX 10; MIN 5).
                    shipping_address:
                      type: object
                      description: Indica el objeto de la dirección de envío del cliente.
                      properties:
                        address_line_1:
                          type: string
                          description: >-
                            La línea principal de la dirección de envío del
                            cliente (MAX 255; MIN 3).
                        address_line_2:
                          type: string
                          description: >-
                            La línea secundaria de la dirección de envío del
                            cliente (MAX 255; MIN 3).
                        city:
                          type: string
                          description: >-
                            La ciudad considerada para la dirección de envío
                            (MAX 255; MIN 3).
                        country:
                          type: string
                          description: >-
                            El país considerado para la dirección de envío (MAX
                            2; MIN 2; [ISO
                            3166-1](https://docs.y.uno/es/reference/customers/the-customer-object#country-code-list-iso-3166-1)).
                          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 de envío
                            (MAX 255; MIN 3).
                        zip_code:
                          type: string
                          description: >-
                            El código postal considerado para la dirección de
                            envío (MAX 10; MIN 5).
                payment_method:
                  type: object
                  description: Especifica el objeto de método de pago para los pagos.
                  properties:
                    detail:
                      type: object
                      description: Indica el objeto con el detalle del método de pago.
                      properties:
                        bank_transfer:
                          type: object
                          description: >-
                            Especifica los detalles del método de pago por
                            transferencia bancaria.
                          properties:
                            account_type:
                              type: string
                              description: Tipo de cuenta bancaria (MAX 255; MIN 3)
                              enum:
                                - CHECKINGS
                                - SAVINGS
                            bank_name:
                              type: string
                              description: Nombre del banco (MAX 255; MIN 3)
                            bank_id:
                              type: string
                              description: ID del banco (MAX 255; MIN 3)
                            beneficiary_name:
                              type: string
                              description: Nombre del titular de la cuenta (MAX 255; MIN 3)
                            bank_account:
                              type: string
                              description: Número de cuenta bancaria (MAX 255; MIN 3)
                            beneficiary_document_type:
                              type: string
                              description: >-
                                Tipo de documento del titular de la cuenta (MAX
                                255; MIN 3)
                            beneficiary_document:
                              type: string
                              description: >-
                                Número de documento del titular de la cuenta
                                (MAX 255; MIN 3)
                            reference:
                              type: string
                              description: >-
                                Código de referencia del usuario (MAX 255; MIN
                                1)
                            bank_account_mask_number:
                              type: string
                              description: >-
                                Número enmascarado de la cuenta bancaria
                                asociada a la transferencia (por ejemplo,
                                ****6789). Es un dato de la cuenta, no del
                                mandato.
                            mandate:
                              type: object
                              description: >-
                                Datos del mandato de débito directo, para los
                                métodos de transferencia bancaria que funcionan
                                con mandatos (por ejemplo, ACH, SEPA, BACS,
                                PAD).
                              properties:
                                id:
                                  type: string
                                  description: >-
                                    Identificador del mandato, tal como lo
                                    entrega el proveedor de pagos.
                                info:
                                  type: string
                                  description: Free-text mandate information.
                                received_status:
                                  type: string
                                  description: >-
                                    Estado del proveedor que indica si se
                                    recibió el mandato. Se reenvía tal como lo
                                    entrega el proveedor de pagos.
                                existing_status:
                                  type: string
                                  description: >-
                                    Estado del proveedor del mandato existente.
                                    Se reenvía tal como lo entrega el proveedor
                                    de pagos.
                                created_at:
                                  type: string
                                  format: date-time
                                  description: >-
                                    Fecha y hora en que se creó el mandato (ISO
                                    8601).
                                updated_at:
                                  type: string
                                  format: date-time
                                  description: >-
                                    Fecha y hora de la última actualización del
                                    mandato (ISO 8601).
            examples:
              Full Refund:
                value:
                  description: Duplicate
                  reason: REQUESTED_BY_CUSTOMER
                  merchant_reference: AAB01-432245
              Partial Refund:
                value:
                  amount:
                    currency: USD
                    value: 30
                  description: Duplicate transaction
                  reason: REQUESTED_BY_CUSTOMER
                  merchant_reference: US-INV-432245
      responses:
        '201':
          description: '201'
          content:
            application/json:
              examples:
                Full Refund:
                  value:
                    id: f2d6884a-f737-4565-ae32-ff60b19089e3
                    account_id: ''
                    description: Duplicate
                    country: US
                    status: REFUNDED
                    sub_status: REFUNDED
                    merchant_order_id: AAB01-432245
                    created_at: '2025-04-14T17:51:45.179645Z'
                    updated_at: '2025-04-14T17:52:07.908698Z'
                    amount:
                      captured: 0
                      currency: USD
                      currency_conversion: null
                      refunded: 30000
                      value: 30000
                    checkout:
                      session: ''
                      sdk_action_required: false
                    payment_method:
                      vaulted_token: ''
                      type: CARD
                      vault_on_success: false
                      token: ''
                      parent_payment_method_type: null
                      payment_method_detail:
                        card:
                          verify: false
                          capture: false
                          installments: 1
                          installments_plan_id: null
                          first_installment_deferral: 0
                          installments_type: MERCHANT
                          installment_amount: null
                          soft_descriptor: ''
                          authorization_code: '216303'
                          retrieval_reference_number: ''
                          acquirer_reference_number: ''
                          voucher: null
                          card_data:
                            holder_name: John Doe
                            iin: '41111111'
                            lfd: '1111'
                            number_length: 16
                            security_code_length: 3
                            brand: VISA
                            issuer_name: CHASE BANK USA
                            issuer_code: null
                            country_code: US
                            category: CLASSIC
                            type: DEBIT
                            three_d_secure:
                              version: null
                              electronic_commerce_indicator: null
                              cryptogram: null
                              transaction_id: null
                              directory_server_transaction_id: null
                              pares_status: null
                              acs_id: null
                            fingerprint: d244e20d-43a1-43f7-9b48-0a76423be35e
                            expiration_month: 3
                            expiration_year: 26
                          stored_credentials:
                            reason: null
                            usage: null
                            subscription_agreement_id: null
                            network_transaction_id: null
                    customer_payer:
                      id: null
                      merchant_customer_id: '1744653105'
                      first_name: John
                      last_name: Doe
                      gender: M
                      date_of_birth: '1990-02-28'
                      email: john.doe@example.com
                      nationality: US
                      ip_address: 192.168.1.1
                      device_fingerprint: null
                      device_fingerprints: []
                      browser_info: null
                      document:
                        document_type: SSN
                        document_number: 123-45-6789
                      phone:
                        number: '5551234567'
                        country_code: '1'
                      billing_address:
                        address_line_1: 1234 Elm Street
                        address_line_2: Apt 5B
                        country: US
                        state: California
                        city: Los Angeles
                        zip_code: '90001'
                        neighborhood: null
                      shipping_address:
                        address_line_1: 1234 Elm Street
                        address_line_2: Apt 5B
                        country: US
                        state: California
                        city: Los Angeles
                        zip_code: '90001'
                        neighborhood: null
                      merchant_customer_created_at: null
                    additional_data: null
                    transactions:
                      id: 5414f862-51e6-433f-a54c-b46b176e87a0
                      type: REFUND
                      status: SUCCEEDED
                      category: CARD
                      amount: 30000
                      provider_id: YUNO_TEST_PAYMENT_GW
                      payment_method:
                        vaulted_token: ''
                        type: CARD
                        vault_on_success: false
                        token: ''
                        parent_payment_method_type: null
                        detail:
                          card:
                            verify: false
                            capture: false
                            installments: 1
                            installments_plan_id: null
                            first_installment_deferral: 0
                            installments_type: MERCHANT
                            installment_amount: null
                            soft_descriptor: ''
                            authorization_code: '216303'
                            retrieval_reference_number: ''
                            acquirer_reference_number: ''
                            voucher: null
                            card_data:
                              holder_name: John Doe
                              iin: '41111111'
                              lfd: '1111'
                              number_length: 16
                              security_code_length: 3
                              brand: VISA
                              issuer_name: CHASE BANK USA
                              issuer_code: null
                              country_code: US
                              category: CLASSIC
                              type: DEBIT
                              three_d_secure:
                                version: null
                                electronic_commerce_indicator: null
                                cryptogram: null
                                transaction_id: null
                                directory_server_transaction_id: null
                                pares_status: null
                                acs_id: null
                              fingerprint: d244e20d-43a1-43f7-9b48-0a76423be35e
                              expiration_month: 3
                              expiration_year: 26
                            stored_credentials:
                              reason: null
                              usage: null
                              subscription_agreement_id: null
                              network_transaction_id: null
                      response_code: SUCCEEDED
                      response_message: Transaction successful
                      reason: REQUESTED_BY_CUSTOMER
                      description: Test refund
                      merchant_reference: REFUND_001
                      provider_data:
                        id: YUNO_TEST_PAYMENT_GW
                        transaction_id: 2e5c04d5-4cf7-4d2a-b57a-dd5eb9a687bc
                        account_id: ''
                        status: ''
                        sub_status: ''
                        status_detail: ''
                        response_message: null
                        response_code: SUCCEEDED
                        raw_request:
                          amount:
                            currency: BRL
                            value: 2100
                          reference: '34343434'
                        raw_response:
                          message: provider response
                        third_party_transaction_id: null
                        third_party_account_id: null
                        iso8583_response_code: null
                        iso8583_response_message: null
                      connection_data:
                        id: 58cc35f4-faef-4107-8e09-d18d60121d38
                        name: Connection name
                      created_at: '2025-04-14T17:52:07.768528Z'
                      updated_at: '2025-04-14T17:52:07.862912Z'
                    transactions_history: null
                    metadata: []
                    fraud_screening: null
                    payment_link_id: ''
                    subscription_code: null
                    routing_rules: null
                    simplified_mode: false
                Partial Refund:
                  value:
                    id: b908fd70-9af7-41a6-8e1c-3a5ec78ea88b
                    account_id: ''
                    description: Duplicate transaction
                    country: US
                    status: SUCCEEDED
                    sub_status: PARTIALLY_REFUNDED
                    merchant_order_id: '0000023'
                    created_at: '2025-04-14T17:50:55.936358Z'
                    updated_at: '2025-04-14T17:51:23.347308Z'
                    amount:
                      captured: 0
                      currency: USD
                      currency_conversion: null
                      refunded: 30
                      value: 300
                    checkout:
                      session: ''
                      sdk_action_required: false
                    payment_method:
                      vaulted_token: ''
                      type: CARD
                      vault_on_success: false
                      token: ''
                      parent_payment_method_type: null
                      payment_method_detail:
                        card:
                          verify: false
                          capture: false
                          installments: 1
                          installments_plan_id: null
                          first_installment_deferral: 0
                          installments_type: MERCHANT
                          installment_amount: null
                          soft_descriptor: ''
                          authorization_code: '344836'
                          retrieval_reference_number: ''
                          acquirer_reference_number: ''
                          voucher: null
                          card_data:
                            holder_name: John Doe
                            iin: '41111111'
                            lfd: '1111'
                            number_length: 16
                            security_code_length: 3
                            brand: VISA
                            issuer_name: CHASE BANK USA
                            issuer_code: null
                            country_code: US
                            category: CLASSIC
                            type: DEBIT
                            three_d_secure:
                              version: null
                              electronic_commerce_indicator: null
                              cryptogram: null
                              transaction_id: null
                              directory_server_transaction_id: null
                              pares_status: null
                              acs_id: null
                            fingerprint: d244e20d-43a1-43f7-9b48-0a76423be35e
                            expiration_month: 3
                            expiration_year: 26
                          stored_credentials:
                            reason: null
                            usage: null
                            subscription_agreement_id: null
                            network_transaction_id: null
                    customer_payer:
                      id: null
                      merchant_customer_id: '1744653056'
                      first_name: John
                      last_name: Doe
                      gender: M
                      date_of_birth: '1990-02-28'
                      email: john.doe@example.com
                      nationality: US
                      ip_address: 192.0.2.1
                      device_fingerprint: null
                      device_fingerprints: []
                      browser_info: null
                      document:
                        document_type: SSN
                        document_number: 123-45-6789
                      phone:
                        number: '5551234567'
                        country_code: '1'
                      billing_address:
                        address_line_1: 456 Maple Ave
                        address_line_2: Apt 12C
                        country: US
                        state: New York
                        city: New York
                        zip_code: '10001'
                        neighborhood: null
                      shipping_address:
                        address_line_1: 456 Maple Ave
                        address_line_2: Apt 12C
                        country: US
                        state: New York
                        city: New York
                        zip_code: '10001'
                        neighborhood: null
                      merchant_customer_created_at: null
                    additional_data: null
                    transactions:
                      id: 3f47548e-a1c9-418e-b899-40d30da9c699
                      type: REFUND
                      status: SUCCEEDED
                      category: CARD
                      amount: 30
                      provider_id: YUNO_TEST_PAYMENT_GW
                      payment_method:
                        vaulted_token: ''
                        type: CARD
                        vault_on_success: false
                        token: ''
                        parent_payment_method_type: null
                        detail:
                          card:
                            verify: false
                            capture: false
                            installments: 1
                            installments_plan_id: null
                            first_installment_deferral: 0
                            installments_type: MERCHANT
                            installment_amount: null
                            soft_descriptor: ''
                            authorization_code: '344836'
                            retrieval_reference_number: ''
                            acquirer_reference_number: ''
                            voucher: null
                            card_data:
                              holder_name: John Doe
                              iin: '41111111'
                              lfd: '1111'
                              number_length: 16
                              security_code_length: 3
                              brand: VISA
                              issuer_name: CHASE BANK USA
                              issuer_code: null
                              country_code: US
                              category: CLASSIC
                              type: DEBIT
                              three_d_secure:
                                version: null
                                electronic_commerce_indicator: null
                                cryptogram: null
                                transaction_id: null
                                directory_server_transaction_id: null
                                pares_status: null
                                acs_id: null
                              fingerprint: d244e20d-43a1-43f7-9b48-0a76423be35e
                              expiration_month: 3
                              expiration_year: 26
                            stored_credentials:
                              reason: null
                              usage: null
                              subscription_agreement_id: null
                              network_transaction_id: null
                      response_code: SUCCEEDED
                      response_message: Transaction successful
                      reason: REQUESTED_BY_CUSTOMER
                      description: Test refund
                      merchant_reference: US-INV-432245
                      provider_data:
                        id: YUNO_TEST_PAYMENT_GW
                        transaction_id: 831017b2-928f-4f19-8f0b-0e0ae14013bd
                        account_id: ''
                        status: ''
                        sub_status: ''
                        status_detail: ''
                        response_message: null
                        response_code: SUCCEEDED
                        raw_response:
                          message: provider response
                        third_party_transaction_id: null
                        third_party_account_id: null
                        iso8583_response_code: null
                        iso8583_response_message: null
                      connection_data:
                        id: 58cc35f4-faef-4107-8e09-d18d60121d38
                        name: Connection name
                      created_at: '2025-04-14T17:51:23.232152Z'
                      updated_at: '2025-04-14T17:51:23.322335Z'
                    transactions_history: null
                    metadata: []
                    fraud_screening: null
                    payment_link_id: ''
                    subscription_code: null
                    routing_rules: null
                    simplified_mode: false
              schema:
                oneOf:
                  - title: Reembolso total
                    type: object
                    properties:
                      id:
                        type: string
                        example: f2d6884a-f737-4565-ae32-ff60b19089e3
                      account_id:
                        type: string
                        example: ''
                      description:
                        type: string
                        example: Duplicate
                      country:
                        type: string
                        example: US
                      status:
                        type: string
                        example: REFUNDED
                      sub_status:
                        type: string
                        example: REFUNDED
                      merchant_order_id:
                        type: string
                        example: AAB01-432245
                      created_at:
                        type: string
                        example: '2025-04-14T17:51:45.179645Z'
                      updated_at:
                        type: string
                        example: '2025-04-14T17:52:07.908698Z'
                      amount:
                        type: object
                        properties:
                          captured:
                            type: integer
                            example: 0
                            default: 0
                          currency:
                            type: string
                            example: USD
                          currency_conversion: {}
                          refunded:
                            type: integer
                            example: 30000
                            default: 0
                          value:
                            type: integer
                            example: 30000
                            default: 0
                      discount_amount:
                        type: object
                        description: >-
                          El descuento total de la promoción de Yuno aplicada al
                          pago: la suma de las líneas `YUNO_PROMOTION` de
                          `additional_data.order.discounts`. No aparece cuando
                          no se aplicó ninguna promoción. El monto cobrado es
                          `amount.value` menos este valor, y está en
                          `transactions.amount`. Consulta
                          [Promociones](/es/docs/payment-features/promotions).
                        properties:
                          currency:
                            type: string
                            description: >-
                              La moneda del descuento, la misma que
                              `amount.currency`.
                          value:
                            type: number
                            description: El descuento.
                      checkout:
                        type: object
                        properties:
                          session:
                            type: string
                            example: ''
                          sdk_action_required:
                            type: boolean
                            example: false
                            default: true
                      payment_method:
                        type: object
                        properties:
                          vaulted_token:
                            type: string
                            example: ''
                          type:
                            type: string
                            example: CARD
                          vault_on_success:
                            type: boolean
                            example: false
                            default: true
                          token:
                            type: string
                            example: ''
                          parent_payment_method_type: {}
                          payment_method_detail:
                            type: object
                            properties:
                              card:
                                type: object
                                properties:
                                  verify:
                                    type: boolean
                                    example: false
                                    default: true
                                  capture:
                                    type: boolean
                                    example: false
                                    default: true
                                  installments:
                                    type: integer
                                    example: 1
                                    default: 0
                                  installments_plan_id: {}
                                  first_installment_deferral:
                                    type: integer
                                    example: 0
                                    default: 0
                                  installments_type:
                                    type: string
                                    example: ''
                                  installment_amount: {}
                                  soft_descriptor:
                                    type: string
                                    example: ''
                                  authorization_code:
                                    type: string
                                    example: '216303'
                                  retrieval_reference_number:
                                    type: string
                                    example: ''
                                  acquirer_reference_number:
                                    type: string
                                    example: ''
                                  par:
                                    type: string
                                    description: >-
                                      La Payment Account Reference (PAR) de la
                                      tarjeta, tal como la devuelve el
                                      proveedor. Una PAR identifica la cuenta
                                      del titular a través del número de tarjeta
                                      y de sus network tokens. Se devuelve en
                                      los pagos con tarjeta, con o sin network
                                      token, y se omite cuando el proveedor no
                                      la envía.
                                    example: V0010013019000000000000000001
                                  voucher: {}
                                  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
                                      issuer_name:
                                        type: string
                                        example: CHASE BANK USA
                                      issuer_code: {}
                                      country_code:
                                        type: string
                                        example: US
                                      category:
                                        type: string
                                        example: CLASSIC
                                      type:
                                        type: string
                                        example: DEBIT
                                      three_d_secure:
                                        type: object
                                        properties:
                                          version: {}
                                          electronic_commerce_indicator: {}
                                          cryptogram: {}
                                          transaction_id: {}
                                          directory_server_transaction_id: {}
                                          pares_status: {}
                                          acs_id: {}
                                      fingerprint:
                                        type: string
                                        example: d244e20d-43a1-43f7-9b48-0a76423be35e
                                      expiration_month:
                                        type: integer
                                        example: 3
                                        default: 0
                                      expiration_year:
                                        type: integer
                                        example: 26
                                        default: 0
                                  stored_credentials:
                                    type: object
                                    properties:
                                      reason: {}
                                      usage: {}
                                      subscription_agreement_id: {}
                                      network_transaction_id: {}
                      customer_payer:
                        type: object
                        properties:
                          id: {}
                          merchant_customer_id:
                            type: string
                            example: '1744653105'
                          first_name:
                            type: string
                            example: John
                          last_name:
                            type: string
                            example: Doe
                          gender:
                            type: string
                            example: M
                          date_of_birth:
                            type: string
                            example: '1990-02-28'
                          email:
                            type: string
                            example: john.doe@example.com
                          nationality:
                            type: string
                            example: US
                          ip_address:
                            type: string
                            example: 192.168.1.1
                          device_fingerprint: {}
                          device_fingerprints:
                            type: array
                          browser_info: {}
                          document:
                            type: object
                            properties:
                              document_type:
                                type: string
                                example: SSN
                              document_number:
                                type: string
                                example: 123-45-6789
                          phone:
                            type: object
                            properties:
                              number:
                                type: string
                                example: '5551234567'
                              country_code:
                                type: string
                                example: '1'
                          billing_address:
                            type: object
                            properties:
                              address_line_1:
                                type: string
                                example: 1234 Elm Street
                              address_line_2:
                                type: string
                                example: Apt 5B
                              country:
                                type: string
                                example: US
                              state:
                                type: string
                                example: California
                              city:
                                type: string
                                example: Los Angeles
                              zip_code:
                                type: string
                                example: '90001'
                              neighborhood: {}
                          shipping_address:
                            type: object
                            properties:
                              address_line_1:
                                type: string
                                example: 1234 Elm Street
                              address_line_2:
                                type: string
                                example: Apt 5B
                              country:
                                type: string
                                example: US
                              state:
                                type: string
                                example: California
                              city:
                                type: string
                                example: Los Angeles
                              zip_code:
                                type: string
                                example: '90001'
                              neighborhood: {}
                          merchant_customer_created_at: {}
                      additional_data: {}
                      transactions:
                        type: object
                        properties:
                          id:
                            type: string
                            example: 5414f862-51e6-433f-a54c-b46b176e87a0
                          type:
                            type: string
                            example: REFUND
                          status:
                            type: string
                            example: SUCCEEDED
                          category:
                            type: string
                            example: CARD
                          amount:
                            type: integer
                            example: 30000
                            default: 0
                          provider_id:
                            type: string
                            example: YUNO_TEST_PAYMENT_GW
                          payment_method:
                            type: object
                            properties:
                              vaulted_token:
                                type: string
                                example: ''
                              type:
                                type: string
                                example: CARD
                              vault_on_success:
                                type: boolean
                                example: false
                                default: true
                              token:
                                type: string
                                example: ''
                              parent_payment_method_type: {}
                              detail:
                                type: object
                                properties:
                                  card:
                                    type: object
                                    properties:
                                      verify:
                                        type: boolean
                                        example: false
                                        default: true
                                      capture:
                                        type: boolean
                                        example: false
                                        default: true
                                      installments:
                                        type: integer
                                        example: 1
                                        default: 0
                                      installments_plan_id: {}
                                      first_installment_deferral:
                                        type: integer
                                        example: 0
                                        default: 0
                                      installments_type:
                                        type: string
                                        example: ''
                                      installment_amount: {}
                                      soft_descriptor:
                                        type: string
                                        example: ''
                                      authorization_code:
                                        type: string
                                        example: '216303'
                                      retrieval_reference_number:
                                        type: string
                                        example: ''
                                      acquirer_reference_number:
                                        type: string
                                        example: ''
                                      par:
                                        type: string
                                        description: >-
                                          La Payment Account Reference (PAR) de la
                                          tarjeta, tal como la devuelve el
                                          proveedor. Una PAR identifica la cuenta
                                          del titular a través del número de
                                          tarjeta y de sus network tokens. Se
                                          devuelve en los pagos con tarjeta, con o
                                          sin network token, y se omite cuando el
                                          proveedor no la envía.
                                        example: V0010013019000000000000000001
                                      voucher: {}
                                      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
                                          issuer_name:
                                            type: string
                                            example: CHASE BANK USA
                                          issuer_code: {}
                                          country_code:
                                            type: string
                                            example: US
                                          category:
                                            type: string
                                            example: CLASSIC
                                          type:
                                            type: string
                                            example: DEBIT
                                          three_d_secure:
                                            type: object
                                            properties:
                                              version: {}
                                              electronic_commerce_indicator: {}
                                              cryptogram: {}
                                              transaction_id: {}
                                              directory_server_transaction_id: {}
                                              pares_status: {}
                                              acs_id: {}
                                          fingerprint:
                                            type: string
                                            example: d244e20d-43a1-43f7-9b48-0a76423be35e
                                          expiration_month:
                                            type: integer
                                            example: 3
                                            default: 0
                                          expiration_year:
                                            type: integer
                                            example: 26
                                            default: 0
                                      stored_credentials:
                                        type: object
                                        properties:
                                          reason: {}
                                          usage: {}
                                          subscription_agreement_id: {}
                                          network_transaction_id: {}
                          response_code:
                            type: string
                            example: SUCCEEDED
                          response_message:
                            type: string
                            example: Transaction successful
                          reason:
                            type: string
                            example: REQUESTED_BY_CUSTOMER
                          description:
                            type: string
                            example: Test refund
                          merchant_reference:
                            type: string
                            example: REFUND_001
                          provider_data:
                            type: object
                            properties:
                              id:
                                type: string
                                example: YUNO_TEST_PAYMENT_GW
                              transaction_id:
                                type: string
                                example: 2e5c04d5-4cf7-4d2a-b57a-dd5eb9a687bc
                              account_id:
                                type: string
                                example: ''
                              status:
                                type: string
                                example: ''
                              sub_status:
                                type: string
                                example: ''
                              status_detail:
                                type: string
                                example: ''
                              response_message: {}
                              response_code:
                                type: string
                                example: SUCCEEDED
                              raw_request:
                                type: object
                                description: >-
                                  Copia ofuscada de la solicitud que Yuno envió
                                  al proveedor. Solo se devuelve para
                                  organizaciones autorizadas.
                              raw_response:
                                type: object
                                properties:
                                  message:
                                    type: string
                                    example: provider response
                              third_party_transaction_id: {}
                              third_party_account_id: {}
                              iso8583_response_code: {}
                              iso8583_response_message: {}
                          connection_data:
                            type: object
                            properties:
                              id:
                                type: string
                                example: 58cc35f4-faef-4107-8e09-d18d60121d38
                              name:
                                type: string
                                example: Connection name
                          created_at:
                            type: string
                            example: '2025-04-14T17:52:07.768528Z'
                          updated_at:
                            type: string
                            example: '2025-04-14T17:52:07.862912Z'
                      transactions_history: {}
                      metadata:
                        type: array
                      fraud_screening: {}
                      payment_link_id:
                        type: string
                        example: ''
                      subscription_code: {}
                      routing_rules: {}
                      simplified_mode:
                        type: boolean
                        example: false
                        default: true
                  - title: Reembolso parcial
                    type: object
                    properties:
                      id:
                        type: string
                        example: b908fd70-9af7-41a6-8e1c-3a5ec78ea88b
                      account_id:
                        type: string
                        example: ''
                      description:
                        type: string
                        example: Duplicate transaction
                      country:
                        type: string
                        example: US
                      status:
                        type: string
                        example: SUCCEEDED
                      sub_status:
                        type: string
                        example: PARTIALLY_REFUNDED
                      merchant_order_id:
                        type: string
                        example: '0000023'
                      created_at:
                        type: string
                        example: '2025-04-14T17:50:55.936358Z'
                      updated_at:
                        type: string
                        example: '2025-04-14T17:51:23.347308Z'
                      amount:
                        type: object
                        properties:
                          captured:
                            type: integer
                            example: 0
                            default: 0
                          currency:
                            type: string
                            example: USD
                          currency_conversion: {}
                          refunded:
                            type: integer
                            example: 30
                            default: 0
                          value:
                            type: integer
                            example: 300
                            default: 0
                      discount_amount:
                        type: object
                        description: >-
                          El descuento total de la promoción de Yuno aplicada al
                          pago: la suma de las líneas `YUNO_PROMOTION` de
                          `additional_data.order.discounts`. No aparece cuando
                          no se aplicó ninguna promoción. El monto cobrado es
                          `amount.value` menos este valor, y está en
                          `transactions.amount`. Consulta
                          [Promociones](/es/docs/payment-features/promotions).
                        properties:
                          currency:
                            type: string
                            description: >-
                              La moneda del descuento, la misma que
                              `amount.currency`.
                          value:
                            type: number
                            description: El descuento.
                      checkout:
                        type: object
                        properties:
                          session:
                            type: string
                            example: ''
                          sdk_action_required:
                            type: boolean
                            example: false
                            default: true
                      payment_method:
                        type: object
                        properties:
                          vaulted_token:
                            type: string
                            example: ''
                          type:
                            type: string
                            example: CARD
                          vault_on_success:
                            type: boolean
                            example: false
                            default: true
                          token:
                            type: string
                            example: ''
                          parent_payment_method_type: {}
                          payment_method_detail:
                            type: object
                            properties:
                              card:
                                type: object
                                properties:
                                  verify:
                                    type: boolean
                                    example: false
                                    default: true
                                  capture:
                                    type: boolean
                                    example: false
                                    default: true
                                  installments:
                                    type: integer
                                    example: 1
                                    default: 0
                                  installments_plan_id: {}
                                  first_installment_deferral:
                                    type: integer
                                    example: 0
                                    default: 0
                                  installments_type:
                                    type: string
                                    example: ''
                                  installment_amount: {}
                                  soft_descriptor:
                                    type: string
                                    example: ''
                                  authorization_code:
                                    type: string
                                    example: '344836'
                                  retrieval_reference_number:
                                    type: string
                                    example: ''
                                  acquirer_reference_number:
                                    type: string
                                    example: ''
                                  par:
                                    type: string
                                    description: >-
                                      La Payment Account Reference (PAR) de la
                                      tarjeta, tal como la devuelve el
                                      proveedor. Una PAR identifica la cuenta
                                      del titular a través del número de tarjeta
                                      y de sus network tokens. Se devuelve en
                                      los pagos con tarjeta, con o sin network
                                      token, y se omite cuando el proveedor no
                                      la envía.
                                    example: V0010013019000000000000000001
                                  voucher: {}
                                  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
                                      issuer_name:
                                        type: string
                                        example: CHASE BANK USA
                                      issuer_code: {}
                                      country_code:
                                        type: string
                                        example: US
                                      category:
                                        type: string
                                        example: CLASSIC
                                      type:
                                        type: string
                                        example: DEBIT
                                      three_d_secure:
                                        type: object
                                        properties:
                                          version: {}
                                          electronic_commerce_indicator: {}
                                          cryptogram: {}
                                          transaction_id: {}
                                          directory_server_transaction_id: {}
                                          pares_status: {}
                                          acs_id: {}
                                      fingerprint:
                                        type: string
                                        example: d244e20d-43a1-43f7-9b48-0a76423be35e
                                      expiration_month:
                                        type: integer
                                        example: 3
                                        default: 0
                                      expiration_year:
                                        type: integer
                                        example: 26
                                        default: 0
                                  stored_credentials:
                                    type: object
                                    properties:
                                      reason: {}
                                      usage: {}
                                      subscription_agreement_id: {}
                                      network_transaction_id: {}
                      customer_payer:
                        type: object
                        properties:
                          id: {}
                          merchant_customer_id:
                            type: string
                            example: '1744653056'
                          first_name:
                            type: string
                            example: John
                          last_name:
                            type: string
                            example: Doe
                          gender:
                            type: string
                            example: M
                          date_of_birth:
                            type: string
                            example: '1990-02-28'
                          email:
                            type: string
                            example: john.doe@example.com
                          nationality:
                            type: string
                            example: US
                          ip_address:
                            type: string
                            example: 192.0.2.1
                          device_fingerprint: {}
                          device_fingerprints:
                            type: array
                          browser_info: {}
                          document:
                            type: object
                            properties:
                              document_type:
                                type: string
                                example: SSN
                              document_number:
                                type: string
                                example: 123-45-6789
                          phone:
                            type: object
                            properties:
                              number:
                                type: string
                                example: '5551234567'
                              country_code:
                                type: string
                                example: '1'
                          billing_address:
                            type: object
                            properties:
                              address_line_1:
                                type: string
                                example: 456 Maple Ave
                              address_line_2:
                                type: string
                                example: Apt 12C
                              country:
                                type: string
                                example: US
                              state:
                                type: string
                                example: New York
                              city:
                                type: string
                                example: New York
                              zip_code:
                                type: string
                                example: '10001'
                              neighborhood: {}
                          shipping_address:
                            type: object
                            properties:
                              address_line_1:
                                type: string
                                example: 456 Maple Ave
                              address_line_2:
                                type: string
                                example: Apt 12C
                              country:
                                type: string
                                example: US
                              state:
                                type: string
                                example: New York
                              city:
                                type: string
                                example: New York
                              zip_code:
                                type: string
                                example: '10001'
                              neighborhood: {}
                          merchant_customer_created_at: {}
                      additional_data: {}
                      transactions:
                        type: object
                        properties:
                          id:
                            type: string
                            example: 3f47548e-a1c9-418e-b899-40d30da9c699
                          type:
                            type: string
                            example: REFUND
                          status:
                            type: string
                            example: SUCCEEDED
                          category:
                            type: string
                            example: CARD
                          amount:
                            type: integer
                            example: 30
                            default: 0
                          provider_id:
                            type: string
                            example: YUNO_TEST_PAYMENT_GW
                          payment_method:
                            type: object
                            properties:
                              vaulted_token:
                                type: string
                                example: ''
                              type:
                                type: string
                                example: CARD
                              vault_on_success:
                                type: boolean
                                example: false
                                default: true
                              token:
                                type: string
                                example: ''
                              parent_payment_method_type: {}
                              detail:
                                type: object
                                properties:
                                  card:
                                    type: object
                                    properties:
                                      verify:
                                        type: boolean
                                        example: false
                                        default: true
                                      capture:
                                        type: boolean
                                        example: false
                                        default: true
                                      installments:
                                        type: integer
                                        example: 1
                                        default: 0
                                      installments_plan_id: {}
                                      first_installment_deferral:
                                        type: integer
                                        example: 0
                                        default: 0
                                      installments_type:
                                        type: string
                                        example: ''
                                      installment_amount: {}
                                      soft_descriptor:
                                        type: string
                                        example: ''
                                      authorization_code:
                                        type: string
                                        example: '344836'
                                      retrieval_reference_number:
                                        type: string
                                        example: ''
                                      acquirer_reference_number:
                                        type: string
                                        example: ''
                                      par:
                                        type: string
                                        description: >-
                                          La Payment Account Reference (PAR) de la
                                          tarjeta, tal como la devuelve el
                                          proveedor. Una PAR identifica la cuenta
                                          del titular a través del número de
                                          tarjeta y de sus network tokens. Se
                                          devuelve en los pagos con tarjeta, con o
                                          sin network token, y se omite cuando el
                                          proveedor no la envía.
                                        example: V0010013019000000000000000001
                                      voucher: {}
                                      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
                                          issuer_name:
                                            type: string
                                            example: CHASE BANK USA
                                          issuer_code: {}
                                          country_code:
                                            type: string
                                            example: US
                                          category:
                                            type: string
                                            example: CLASSIC
                                          type:
                                            type: string
                                            example: DEBIT
                                          three_d_secure:
                                            type: object
                                            properties:
                                              version: {}
                                              electronic_commerce_indicator: {}
                                              cryptogram: {}
                                              transaction_id: {}
                                              directory_server_transaction_id: {}
                                              pares_status: {}
                                              acs_id: {}
                                          fingerprint:
                                            type: string
                                            example: d244e20d-43a1-43f7-9b48-0a76423be35e
                                          expiration_month:
                                            type: integer
                                            example: 3
                                            default: 0
                                          expiration_year:
                                            type: integer
                                            example: 26
                                            default: 0
                                      stored_credentials:
                                        type: object
                                        properties:
                                          reason: {}
                                          usage: {}
                                          subscription_agreement_id: {}
                                          network_transaction_id: {}
                          response_code:
                            type: string
                            example: SUCCEEDED
                          response_message:
                            type: string
                            example: Transaction successful
                          reason:
                            type: string
                            example: REQUESTED_BY_CUSTOMER
                          description:
                            type: string
                            example: Test refund
                          merchant_reference:
                            type: string
                            example: US-INV-432245
                          provider_data:
                            type: object
                            properties:
                              id:
                                type: string
                                example: YUNO_TEST_PAYMENT_GW
                              transaction_id:
                                type: string
                                example: 831017b2-928f-4f19-8f0b-0e0ae14013bd
                              account_id:
                                type: string
                                example: ''
                              status:
                                type: string
                                example: ''
                              sub_status:
                                type: string
                                example: ''
                              status_detail:
                                type: string
                                example: ''
                              response_message: {}
                              response_code:
                                type: string
                                example: SUCCEEDED
                              raw_request:
                                type: object
                                description: >-
                                  Copia ofuscada de la solicitud que Yuno envió
                                  al proveedor. Solo se devuelve para
                                  organizaciones autorizadas.
                              raw_response:
                                type: object
                                properties:
                                  message:
                                    type: string
                                    example: provider response
                              third_party_transaction_id: {}
                              third_party_account_id: {}
                              iso8583_response_code: {}
                              iso8583_response_message: {}
                          connection_data:
                            type: object
                            properties:
                              id:
                                type: string
                                example: 58cc35f4-faef-4107-8e09-d18d60121d38
                              name:
                                type: string
                                example: Connection name
                          created_at:
                            type: string
                            example: '2025-04-14T17:51:23.232152Z'
                          updated_at:
                            type: string
                            example: '2025-04-14T17:51:23.322335Z'
                      transactions_history: {}
                      metadata:
                        type: array
                      fraud_screening: {}
                      payment_link_id:
                        type: string
                        example: ''
                      subscription_code: {}
                      routing_rules: {}
                      simplified_mode:
                        type: boolean
                        example: false
                        default: true
        '400':
          description: '400'
          content:
            application/json:
              examples:
                Bad Request:
                  value:
                    code: INVALID_REQUEST
                    messages:
                      - Invalid request
              schema:
                type: object
                properties:
                  code:
                    type: string
                    example: INVALID_REQUEST
                  messages:
                    type: array
                    items:
                      type: string
                      example: Invalid request
        '401':
          description: '401'
          content:
            application/json:
              examples:
                Unauthorized:
                  value:
                    code: INVALID_CREDENTIALS
                    messages:
                      - Invalid credentials
              schema:
                type: object
                properties:
                  code:
                    type: string
                    example: INVALID_CREDENTIALS
                  messages:
                    type: array
                    items:
                      type: string
                      example: Invalid credentials
        '403':
          description: '403'
          content:
            application/json:
              examples:
                Forbidden:
                  value:
                    code: AUTHORIZATION_REQUIRED
                    messages:
                      - The merchant has no authorization to use this API.
              schema:
                type: object
                properties:
                  code:
                    type: string
                    example: AUTHORIZATION_REQUIRED
                  messages:
                    type: array
                    items:
                      type: string
                      example: The merchant has no authorization to use this API.
      deprecated: false
components:
  securitySchemes:
    sec0:
      type: apiKey
      in: header
      x-default: <Your public-api-key>
      name: public-api-key
    sec1:
      type: apiKey
      in: header
      x-default: <Your private-secret-key>
      name: private-secret-key
    sec2:
      type: apiKey
      in: header
      x-default: <Your X-Idempotency-Key>
      name: X-Idempotency-Key

````

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