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

# Crea pagos

> Explica cómo crear un cliente y un pago básico con el endpoint Create Payment de Yuno.

Esta guía explica cómo crear un pago básico mediante la integración Direct.

## Requisitos

Antes de comenzar con los pasos descritos en esta guía, debes:

* Acceder a tus [credenciales de API](https://docs.y.uno/es/docs/using-yuno/settings/developers-credentials.md) en el Dashboard de Yuno, que se componen de:
  * `public-api-key`
  * `private-secret-key`
  * `account_id`
* [Configurar tus conexiones](https://docs.y.uno/es/docs/using-yuno/dashboard-overview/connections.md) en tu cuenta del Dashboard de Yuno.
* [Crear una ruta](https://docs.y.uno/es/docs/using-yuno/dashboard-overview/routing.md) para el método de pago y definir cómo se procesará.

Asegúrate de completar estos requisitos antes de seguir la guía de creación de pagos.

> [!NOTE]
>
> **Explora las colecciones de Postman de Yuno**
>
> Yuno ofrece [colecciones de Postman](https://docs.y.uno/reference/getting-started/postman-collections.md) que puedes usar para replicar los casos de uso de forma local.

> [!WARNING]
>
> **Habilita Yuno Test Payment Gateway**
>
> Para probar un pago simple con tarjeta en el **entorno sandbox**, primero debes habilitar [Yuno Test Payment Gateway](https://docs.y.uno/es/docs/direct-integration-use-cases/yuno-testing-gateway.md). Esta conexión simula un proveedor y te permite verificar tu integración Direct sin usar datos reales de tarjetas.

## Resumen de pasos

El proceso de creación de un pago normalmente requiere completar los dos pasos que se indican a continuación.

1. [Crea un cliente](https://docs.y.uno/reference/customers/create-customer.md)
2. [Crea el pago](#step-2-create-a-payment)

> [!NOTE]
>
> **Métodos de pago y funcionalidades adicionales**
>
> Algunos métodos de pago, como los que usan billeteras específicas o BNPL, o funcionalidades, como los pagos divididos, pueden requerir pasos adicionales antes de crear el pago.

## Crea un pago

### Paso 1: crea un cliente

Usa el endpoint [Create Customer](https://docs.y.uno/reference/customers/create-customer.md) para registrar la información del cliente. Debes proporcionar la información personal del cliente. Además, debes enviar el `merchant_customer_id`, un identificador único del cliente usado en tu sistema.

> [!NOTE]
>
> **Información complementaria del cliente**
>
> Al crear un **Customer**, cierta información no es obligatoria, pero puede mejorar la experiencia de pago del usuario si la proporcionas. El teléfono, la dirección de facturación y la dirección de envío son ejemplos de datos no obligatorios que puedes proporcionar.
>
> Si agregas información opcional, ten en cuenta los campos obligatorios correspondientes.

Al final del proceso de creación del cliente, recibirás un `id`, que identifica al usuario dentro del sistema de Yuno. Usa el `id` para inicializar el checkout.

Si vas a crear un pago para un usuario existente que ya fue creado previamente y ya tiene un `id`, puedes omitir este paso.

### Paso 2: crea un pago

Crearás un pago con el endpoint [Create Payment](https://docs.y.uno/es/reference/payments/create-payment.md). Con Yuno, puedes crear pagos con varios métodos de pago, usando 3DS o pagos divididos. Sin embargo, esta guía se centra en un pago simple, sin requisitos adicionales de autenticación, validación o inscripción.

A continuación, encuentras una descripción más detallada de cómo crear un pago.

#### 2.1 Proporciona los atributos requeridos

Proporciona la información relacionada con el cliente, incluido el objeto `customer_payer`, que contiene el `id` del Paso 1.

Algunos objetos no son obligatorios al crear un pago. Sin embargo, si proporcionas esta información, mejorarás la experiencia de pago del usuario. Ten en cuenta los campos obligatorios si deseas proporcionar esta información.

#### 2.2 Elige el tipo de captura

Yuno ofrece dos opciones para la captura del pago:

* Un solo paso: La autorización y la captura se realizan al mismo tiempo. Solo necesitas crear el pago. La autorización y la captura se realizan automáticamente. Para la opción de un solo paso, debes enviar el atributo `capture` como `true` en la solicitud.
* Dos pasos: La autorización y la captura se realizan en momentos distintos. Si deseas procesar el pago en dos pasos, envía `capture` como `false` cuando [crees el pago](https://docs.y.uno/es/reference/payments/create-payment.md) y luego usa la solicitud [Capture Authorization](https://docs.y.uno/reference/payments/capture-authorization.md) para completar el proceso.

#### 2.3 Funcionalidades adicionales

Yuno también te permite usar algunas funcionalidades adicionales compatibles con el proceso básico de creación de pagos:

* `vault_on_success`: Si tu cliente usa una tarjeta de crédito para pagar, te permitimos inscribir ese método de pago para el cliente en el mismo paso, para compras futuras.
* `installments`: Si ofreces cuotas a tus clientes para sus pagos y el procesador que elegiste las acepta, puedes enviarnos la cantidad de cuotas con la que se creará el pago.

Ambos campos se encuentran en la sección de detalle de payment\_method del pago.

> [!NOTE]
>
> Para generar y recibir un `vaulted_token` cuando `vault_on_success = true`, el pago debe hacer referencia a un cliente existente de Yuno mediante `customer_payer.id`. Crear o enviar los datos del cliente dentro de la solicitud del pago no crea al cliente de nuestro lado, por lo que no se realizará el vaulting. Cuando se cumplen estas condiciones y el estado del pago es `SUCCEEDED`, el `vaulted_token` se devuelve en la respuesta del pago y puede usarse para transacciones futuras.

### Paso 3: revisa el estado del pago

Después de realizar la solicitud al endpoint [Create Payment](https://docs.y.uno/es/reference/payments/create-payment.md), puedes revisar el estado del pago analizando el `status` y el `sub_status` de la respuesta. Consulta la página [Estado del pago](https://docs.y.uno/reference/payments/status-and-response-codes/payment.md) para ver todas las opciones que puedes recibir en respuesta a la solicitud de creación del pago.

Según el procesador y el método de pago, el estado puede tardar en actualizarse. Por eso, es posible que necesites usar endpoints para recuperar el estado del pago. Para ello, puedes usar [Retrieve Payment by ID](https://docs.y.uno/reference/payments/retrieve-payment-by-id) o [Retrieve Payment by merchant\_order\_id](https://docs.y.uno/reference/payments/retrieve-payment-by-merchant-order-id.md). Otra opción es usar webhooks para recibir notificaciones después de cada evento. Yuno recomienda usar webhooks para monitorear mejor los pagos asíncronos. Consulta la guía de [Webhooks](https://docs.y.uno/docs/webhooks.md) para aprender a configurar la solución de webhooks de Yuno.

> [!NOTE]
>
> **Pruebas de pagos con tarjeta**
>
> Si necesitas probar pagos con tarjeta en general, Yuno ofrece Yuno Test Payment Gateway. Funciona como una conexión, pero solo está disponible en el entorno sandbox. Consulta la [página de Yuno Test Payment Gateway](https://docs.y.uno/es/docs/direct-integration-use-cases/yuno-testing-gateway.md) para conocer todas sus funcionalidades, o ve directamente a la guía sobre [cómo probar pagos con tarjeta](https://docs.y.uno/es/docs/direct-integration-use-cases/yuno-testing-gateway.md#test-card-payments-with-yuno-testing-gateway).


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