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

# Flujo de pago

> Recorre los pasos de cliente, sesión de checkout, datos de pago y creación del pago en una transacción de Yuno

Aunque Yuno ofrece opciones de pago muy diversas, el proceso básico de pago siempre sigue la misma secuencia. Esta guía desglosa paso a paso el proceso y los elementos clave involucrados, y aclara cómo fluyen los pagos cuando usas los SDKs o la API de Yuno.

## El proceso de pago de Yuno

El proceso de pago consta de los siguientes pasos:

**1. Crea un cliente**

En Yuno, los pagos normalmente se vinculan a un [cliente](https://docs.y.uno/es/docs/basic-concepts/customers.md). El sistema guarda datos del cliente como el nombre, la dirección y el número de teléfono. Yuno usa esta información para procesar pagos con distintos [métodos de pago](https://docs.y.uno/docs/basic-concepts/payment-methods.md) y procesadores.
Cuando creas un cliente, Yuno genera un identificador único que se usa en los pasos siguientes.

> [!NOTE]
>
> Se puede crear un pago sin un cliente. Si creas la sesión de checkout con un `customer_id`, envía el mismo cliente en `customer_payer.id` cuando crees el pago.

**2. Crea una sesión de checkout**

Para procesar un pago con el Yuno SDK o el Checkout, crea una [sesión de checkout](https://docs.y.uno/es/docs/basic-concepts/sessions.md#checkout-session). Esta sesión conecta al cliente con el pago y guarda los datos clave de la transacción. Yuno carga todos los [métodos de pago](https://docs.y.uno/docs/basic-concepts/payment-methods.md) disponibles vinculados a tu cuenta.

> [!NOTE]
>
> Las integraciones directas (servidor a servidor) omiten este paso y envían los datos de la transacción directamente al crear el pago. Define `workflow` como `DIRECT` (o `REDIRECT`) en la solicitud de pago. Sin ese valor, la API pide el objeto `checkout`.

**3. Recopila los datos de pago**

Para procesar un pago, necesitas recopilar la información de pago del cliente.

* **Integración con SDK**: los SDKs de Yuno capturan los datos sensibles de forma segura y generan un token de un solo uso (OTT).
* **Integración directa**: recopilas los datos de pago directamente en tus servidores (lo que requiere cumplimiento PCI) y los envías al endpoint de pagos.

> [!NOTE]
>
> Un OTT es un código temporal de un solo uso que los SDKs de Yuno usan para reforzar la seguridad de los comercios.

**4. Crea el pago**

Un [pago](https://docs.y.uno/es/docs/basic-concepts/payments-1.md) representa la transacción final. Usa los datos recopilados en los pasos anteriores (el ID del cliente y la información de pago) para procesar la transacción final.

> [!NOTE]
>
> Algunos campos son opcionales, pero pueden mejorar la experiencia del usuario. Ten en cuenta los campos obligatorios si decides incluir esta información.

> [!NOTE]
>
> La solicitud de creación de pago requiere el encabezado `X-Idempotency-Key`. Envía un valor único (por ejemplo, un UUID) para poder reintentar la solicitud de forma segura. Consulta [Idempotencia](https://docs.y.uno/reference/getting-started/authentication.md#idempotency).

Después de crear el pago, Yuno te mantiene al tanto de las actualizaciones mediante [webhooks](https://docs.y.uno/es/docs/basic-concepts/webhooks-1.md). Además, Yuno ofrece soluciones de [prevención de fraude](https://docs.y.uno/docs/basic-concepts/fraud) que puedes integrar en el proceso de pago.


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