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

# Estados del onboarding

> Consulta los posibles estados del onboarding y las acciones requeridas para cada uno

El onboarding registra el ciclo de vida del registro de destinatarios (submerchants) con los proveedores para pagos con split. Usa el `status` del onboarding para saber en qué punto del proceso está un destinatario y si se requiere alguna acción.

Consulta también:

* [Crear onboarding](https://docs.y.uno/es/reference/recipients-for-marketplace/create-onboarding.md)
* [Continuar onboarding](https://docs.y.uno/es/reference/recipients-for-marketplace/continue-onboarding.md)

## Estados del onboarding

El flujo de onboarding puede tener los siguientes estados.

<table>
  <thead>
    <tr>
      <th>Estado</th>
      <th>Descripción</th>
      <th>Acción requerida</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>`CREATED`</td>
      <td>Registro inicial creado; la validación no ha comenzado (a menudo pasa rápidamente a `PENDING`).</td>
      <td>Asegúrate de proporcionar todos los datos y documentos requeridos; de lo contrario, espera a que comience la revisión.</td>
    </tr>

    <tr>
      <td>`PENDING`</td>
      <td>En revisión por Yuno y/o el proveedor.</td>
      <td>No se requiere ninguna acción.</td>
    </tr>

    <tr>
      <td>`PENDING_ADDITIONAL_DOCUMENTATION`</td>
      <td>Se requiere más documentación o aclaraciones.</td>
      <td>Sube los documentos solicitados y vuelve a enviar.</td>
    </tr>

    <tr>
      <td>`PENDING_RECIPIENT_ACTION`</td>
      <td>El destinatario debe completar pasos (por ejemplo, aceptar términos, KYC, verificación).</td>
      <td>Completa los pasos pendientes y continúa.</td>
    </tr>

    <tr>
      <td>`SUCCEEDED`</td>
      <td>Onboarding completado con éxito; el destinatario está listo para split payouts.</td>
      <td>Empieza a usar al destinatario en splits/payouts.</td>
    </tr>

    <tr>
      <td>`FAILED`</td>
      <td>El procesamiento falló; el onboarding no fue aprobado.</td>
      <td>Revisa el motivo y reintenta o crea un nuevo onboarding después de corregir los problemas.</td>
    </tr>

    <tr>
      <td>`DECLINED`</td>
      <td>El proveedor revisó y rechazó el onboarding.</td>
      <td>Actualiza la información o la documentación y luego crea un nuevo onboarding.</td>
    </tr>

    <tr>
      <td>`BLOCKED`</td>
      <td>Bloqueado temporalmente por política de riesgo/cumplimiento o por revisión.</td>
      <td>Desbloquéalo mediante el endpoint correspondiente o contacta a soporte.</td>
    </tr>

    <tr>
      <td>`REJECTED`</td>
      <td>La validación previa al envío falló antes de llegar al proveedor.</td>
      <td>Corrige los problemas y reintenta/envía de nuevo.</td>
    </tr>

    <tr>
      <td>`ERROR`</td>
      <td>Error de procesamiento transitorio (por ejemplo, timeout o conectividad).</td>
      <td>Reintenta la operación; contacta a soporte si persiste.</td>
    </tr>

    <tr>
      <td>`CANCELLED`</td>
      <td>El onboarding fue cancelado por el comercio/destinatario o automáticamente por el flujo de trabajo.</td>
      <td>Crea un nuevo onboarding cuando estés listo.</td>
    </tr>

    <tr>
      <td>`EXPIRED`</td>
      <td>No se completó a tiempo; la ventana expiró.</td>
      <td>Reinicia creando un nuevo onboarding.</td>
    </tr>

    <tr>
      <td>`TRANSFERRED`</td>
      <td>El onboarding se movió a otro destinatario mediante una transferencia de onboarding.</td>
      <td>No se requiere ninguna acción. Usa el onboarding del destinatario de destino.</td>
    </tr>

    <tr>
      <td>`INACTIVE`</td>
      <td>Reemplazado por otro onboarding para el mismo proveedor tras una transferencia de onboarding o su reversión. Ya no se usa para pagos con split.</td>
      <td>No se requiere ninguna acción. Usa el onboarding activo del destinatario para ese proveedor.</td>
    </tr>

    <tr>
      <td>`TERMINATED`</td>
      <td>Cerrado de forma permanente en el proveedor. No se puede reabrir, actualizar, continuar ni cancelar.</td>
      <td>Crea un nuevo onboarding si el destinatario necesita seguir recibiendo pagos con split.</td>
    </tr>
  </tbody>
</table>


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