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

# Estado del reembolso sin referencia

> Ciclo de vida y máquina de estados de los reembolsos sin referencia.

El campo `status` informa la etapa actual del ciclo de vida. El campo `sub_status` aporta un contexto más detallado dentro de cada estado de nivel superior.

| Estado | Sub\_status | Descripción |
| - | - | - |
| `CREATED` | `CREATED` | Estado temporal. Yuno guardó el reembolso después de la validación y está en proceso de enrutarlo a un proveedor. |
| `PENDING` | `APPROVED` | El proveedor aceptó el reembolso y está a la espera de la liquidación asíncrona de la red o del banco. Típico de ACH, SEPA, GoCardless. |
| `SUCCEEDED` | `SUCCEEDED` | Terminal. El reembolso fue entregado al destino, ya sea liquidado de forma síncrona por el proveedor (reembolsos de tarjeta de Stripe, Nuvei) o confirmado de forma asíncrona mediante un webhook del proveedor (ACH, SEPA, GoCardless). |
| `FAILED` | `DECLINED_BY_PROVIDER` | Terminal. El reembolso no se completó. Incluye rechazos síncronos, devoluciones asíncronas (códigos R de ACH, SEPA RJCT), bloqueos de OFAC, cuentas no válidas, saldo insuficiente del comercio, tiempos de espera de SLA y rechazos por fraude. El detalle está en `provider.raw_response_code` y `provider.raw_response_message`. |

## Eventos de webhook

Los eventos de webhook se envían solo en las transiciones del `status` de nivel superior. Los cambios de `sub_status` dentro de `PENDING` no son observables externamente.

| Evento | Fires when `status` enters |
| - | - |
| `unreferenced_refund.created` | `CREATED` |
| `unreferenced_refund.succeeded` | `SUCCEEDED` |
| `unreferenced_refund.failed` | `FAILED` |

***


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