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

# Consultar un reembolso sin referencia por ID

> Consulta los detalles de un reembolso sin referencia existente mediante el id proporcionado en la ruta de la solicitud.

Esta solicitud te permite consultar los detalles de un reembolso sin referencia a partir de su `id`, que debe proporcionarse en la ruta de la solicitud.

> [!NOTE]
>
> **Datos sin procesar del proveedor**
>
> El objeto `provider` contiene el intercambio sin modificar con el proveedor en dos campos. La estructura de ambos la define el proveedor, no Yuno, por lo que varía según el proveedor y la operación. Cada uno se controla por separado:
>
> | Campo | Contenido | Cómo obtenerlo |
> | - | - | - |
> | `raw_request` | El payload exacto que Yuno envió al proveedor. | Requiere que tu cuenta esté habilitada para los datos sin procesar del proveedor. Contacta a tu gerente de cuenta de Yuno para solicitar acceso. No se ve afectado por `include_raw_responses`. |
> | `raw_response` | El payload completo que devolvió el proveedor. | Envía `include_raw_responses=true` en esta solicitud. |
>
> `raw_response_code` y `raw_response_message` son resúmenes de la respuesta del proveedor y siempre se devuelven, independientemente de los dos campos anteriores.

**public-api-key** `string` *required*

La clave de API pública única de tu cuenta.

**private-secret-key** `string` *required*

La clave secreta privada única de tu cuenta.

**unreferenced\_refund\_id** `string` *required*

Identificador único del reembolso sin referencia generado por Yuno.

**include\_raw\_responses** `boolean` (default: false)

Cuando es `true`, el objeto `provider` en el payload de la respuesta incluirá `raw_response`, el payload completo que devolvió el proveedor. Los campos de resumen `raw_response_code` y `raw_response_message` siempre se devuelven, sin importar este parámetro.

**include\_transaction\_responses** `boolean` (default: false)

Cuando es `true`, devuelve la lista completa de intentos y respuestas intermedias de la red si el reembolso desencadenó varios reintentos internos.

```bash Example request theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
curl --request GET \
  --url 'https://api.y.uno/v1/unreferenced-refunds/d290f1ee-6c54-4b01-90e6-d701748f0851?include_raw_responses=true' \
  --header 'public-api-key: YOUR_PUBLIC_API_KEY' \
  --header 'private-secret-key: YOUR_PRIVATE_SECRET_KEY' \
  --header 'Accept: application/json'
```

```json 200 - Refund found theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
{
  "id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
  "account_id": "9f6e0a4c-1d2b-4e3f-8a9b-1c2d3e4f5a6b",
  "merchant_order_id": "REFUND-2026-05-14-001",
  "country": "US",
  "amount": { "value": 25.00, "currency": "USD" },
  "status": "SUCCEEDED",
  "sub_status": "SUCCEEDED",
  "payment_method": {
    "vaulted_token": "550e8400-e29b-41d4-a716-446655440000",
    "detail": {
      "card": {
        "card_data": { "brand": "VISA", "last_four": "1111", "type": "CREDIT" }
      }
    }
  },
  "customer_payer": {
    "id": "6ba7b810-9dad-11d1-80b4-00c04fd430c8"
  },
  "provider": {
    "name": "STRIPE",
    "type": "PSP",
    "reference": "re_3OqQz92eZvKYlo2C0g6XK1Yj",
    "category": "APPROVED",
    "raw_response_code": "succeeded",
    "raw_response_message": "Refund settled",
    "raw_request": {
      "amount": 2500,
      "currency": "usd",
      "payment_method": "pm_1OqQz92eZvKYlo2C7Kx9Vbnm",
      "metadata": { "merchant_order_id": "REFUND-2026-05-14-001" }
    },
    "raw_response": {
      "id": "re_3OqQz92eZvKYlo2C0g6XK1Yj",
      "object": "refund",
      "amount": 2500,
      "currency": "usd",
      "status": "succeeded"
    }
  },
  "created_at": "2026-05-14T11:47:13.482Z",
  "updated_at": "2026-05-14T11:47:18.030Z"
}
```

```json 404 - Refund not found theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
{
  "code": "UNREFERENCED_REFUND_NOT_FOUND",
  "messages": [
    "No unreferenced refund with the provided id exists on this account."
  ]
}
```


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