> ## Documentation Index
> Fetch the complete documentation index at: https://docs.y.uno/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Test in the sandbox first: base URL https://api-sandbox.y.uno (Test Mode in the Dashboard). Production is https://api.y.uno (Live Mode).
> Every API request needs the public-api-key and private-secret-key headers. Get them in the Dashboard at https://dashboard.y.uno/developers (Developers > Credentials); sandbox and production keys are different.
> Send an X-Idempotency-Key (a UUID) when creating payments, refunds and cancels, so retries do not create duplicates.
> Start with the Quickstart (https://docs.y.uno/docs/quickstart.md) and the agent guide (https://docs.y.uno/agents.md). To search these docs from a coding agent, connect the docs MCP server at https://docs.y.uno/mcp.

# Obtener transferencias

> Explica casos de uso comunes y códigos de error para el seguimiento de transferencias de destinatarios y de onboarding

## Casos de uso

### Caso de uso 1: Verificar que la transferencia se completó

Crea una transferencia y verifica que fue exitosa.

1. **Iniciar la transferencia**

```http theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
   POST /v1/recipients/A/onboardings/O1/transfer
```

**Respuesta**

```json theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
{ "id": "T1", ... }
```

2. **Consultar el estado**

```http theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
   GET /v1/transfers/T1
```

Respuesta:

```json theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
   {
     "id": "T1",
     "destination_onboarding": { "status": "SUCCEEDED" }
   }
```

3. **Resultado**: La transferencia fue exitosa ✓

**Para determinar el éxito:**

* Revisa `destination_onboarding.status`
* `SUCCEEDED`: La transferencia se completó correctamente
* `PENDING`: La transferencia sigue en curso
* `FAILED`: La transferencia falló

### Caso de uso 2: Mostrar el historial de transferencias de un vendedor

Muestra todas las transferencias de un vendedor en un dashboard de marketplace.

1. **Cargar la página de perfil del vendedor**: `seller_id = "770e8400-..."`
2. **Obtener el historial de transferencias**

```http theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
GET /v1/recipients/770e8400-.../transfers
```

**Respuesta**

```json theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
[
  { "id": "T1", "created_at": "2026-01-15T16:59:22Z", ... },
  { "id": "T2", "created_at": "2026-01-10T08:30:00Z", ... }
]
```

3. **Mostrar en la interfaz**

| Fecha | Origen | Destino | Estado |
| - | - | - | - |
| 2026-01-15 | seller-123 | seller-456 | Succeeded |
| 2026-01-10 | seller-123 | seller-789 | Succeeded |

### Caso de uso 3: Auditar una cadena de transferencias con reversiones

Haz el seguimiento de un onboarding que fue transferido y luego revertido.

1. **Transferencia original**: O1 del destinatario A al destinatario B, se creó la transferencia T1
2. **Revertida después**: O1 de vuelta del destinatario B al destinatario A, se creó la transferencia T2 (reversión)
3. **Registro de auditoría**

```http theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
GET /v1/onboardings/O1/transfers
```

Respuesta:

```json theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
[
  {
    "id": "T1",
    "origin_onboarding": { "id": "O1", "recipient": { "id": "A" } },
    "destination_onboarding": { "id": "O2", "recipient": { "id": "B" } },
    "created_at": "2026-01-15T10:00:00Z"
  },
  {
    "id": "T2",
    "origin_onboarding": { "id": "O2", "recipient": { "id": "B" } },
    "destination_onboarding": { "id": "O1", "recipient": { "id": "A" } },
    "created_at": "2026-01-16T11:00:00Z"
  }
]
```

4. **Análisis**: El onboarding se transfirió y luego se revirtió

### Caso de uso 4: Investigación de un ticket de soporte

Busca una transferencia fallida para identificar y resolver la causa raíz.

1. **"La transferencia T1 falló, ¿pueden ayudarme?"**
2. **Buscar la transferencia**

```http theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
GET /v1/transfers/T1
```

**Respuesta**

```json theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
{
  "id": "T1",
  "origin_onboarding": {
    "id": "O1",
    "status": "TRANSFERRED",
    "recipient": { "id": "A", "email": "seller@example.com" }
  },
  "destination_onboarding": {
    "id": "O2",
    "status": "FAILED",
    "response_message": "Invalid bank account",
    "recipient": { "id": "B", "email": "newseller@example.com" }
  }
}
```

3. **Causa raíz identificada**: Cuenta bancaria no válida en el destino
4. **Acción**: Pedir al destinatario B que actualice sus datos bancarios

### Caso de uso 5: Auditoría de cumplimiento

Verifica todas las transferencias de un destinatario.

1. **Solicitar el reporte de transferencias**

```http theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
GET /v1/recipients/770e8400-.../transfers
```

2. **El sistema devuelve todas las transferencias**

```json theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
[
  { "id": "T1", "created_at": "...", ... },
  { "id": "T2", "created_at": "...", ... },
  { "id": "T3", "created_at": "...", ... }
]
```

3. **Exportar a CSV para los registros de cumplimiento**
4. **El reporte incluye**:
   * Fechas de las transferencias
   * Detalles de origen y destino
   * Estado actual
   * Información del proveedor

## Referencia de códigos de error

| Código | Estado HTTP | Descripción |
| :-: | :-: | :-: |
| `TRANSFER_NOT_FOUND` | 404 | La transferencia no existe |
| `RECIPIENT_NOT_FOUND` | 404 | El destinatario no existe |
| `ONBOARDING_NOT_FOUND` | 404 | El onboarding no existe |
| `FORBIDDEN` | 403 | El recurso pertenece a otra organización |
| `UNAUTHORIZED` | 401 | Credenciales de autenticación no válidas |


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