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

# Cuotas del comercio

> Configura tú mismo las opciones de cuotas cuando tus acuerdos comerciales con los procesadores de pago ya definen los planes disponibles

Puedes usar las opciones de cuotas del comercio cuando tú, como comercio, tienes tus propios acuerdos comerciales y capacidades de cuotas definidos en tus procesadores de pago. En este caso, eres responsable de manejar la lógica de las opciones de cuotas disponibles para cada transacción. Al crear el pago, informarás a Yuno el número de cuotas disponibles entre las que los clientes pueden elegir.

![](https://mintcdn.com/yuno-3979e326/CeL_8iNMmYV6B_wt/images/reference/merchant-installments/installments.gif?s=421e2b03029ee80b73b7a9c9342a54da)

## ¿Cómo usar las cuotas del comercio?

Según la forma en que te conectas a Yuno, el proceso para configurar las cuotas puede variar. A continuación, presentamos cómo informar a Yuno la opción de cuotas para el flujo Direct y la integración con el SDK.

### Flujo Direct

Cuando usas una [integración Direct](https://docs.y.uno/es/docs/direct-integration-use-cases/direct-flow.md), tú gestionas la experiencia de checkout del front-end. En este caso, informarás a Yuno el número de cuotas al crear el pago con el endpoint [Create Payment](https://docs.y.uno/es/reference/payments/create-payment.md). El número de cuotas se definirá mediante el parámetro `payment_method.detail.card.installments`.

### Integración con el SDK

Cuando usas el SDK de Yuno, Yuno es responsable de presentar al cliente las opciones de cuotas disponibles para cada pago. Por lo tanto, debes informar a Yuno qué cuotas estarán disponibles para tu cuenta. En este caso, la configuración de cuotas se realiza desde el [Dashboard de Yuno](https://auth.y.uno/u/login?). Para realizar esta configuración, ejecuta los dos pasos que se describen a continuación.

1. Primero, al configurar la [conexión](https://docs.y.uno/es/docs/using-yuno/dashboard-overview/connections.md) de tu proveedor en el Dashboard de Yuno, debes habilitar la opción de cuotas. Así, Yuno mostrará la opción de cuotas cuando el cliente elija la opción de tarjeta de crédito en el formulario del checkout con SDK.

![](https://mintcdn.com/yuno-3979e326/CeL_8iNMmYV6B_wt/images/reference/merchant-installments/image1.png?fit=max\&auto=format\&n=CeL_8iNMmYV6B_wt\&q=85\&s=06c01a2af3d9b1b204c1494c2c8485e1)

2. Después de habilitar las cuotas, debes crear un plan de cuotas con el endpoint [Create Installments Plan](https://docs.y.uno/reference/installments/create-installments-plan.md). Al crear un plan, especificarás la moneda aceptada, los montos, las marcas de tarjeta, las fechas, etc. Una vez que el plan esté activo, Yuno lo aplica automáticamente a los pagos que coincidan y presenta al cliente las opciones de cuotas correspondientes.

> [!WARNING]
>
> **Integración con Secure Fields SDK**
>
> Cuando uses la integración con Secure Fields SDK, deberás [habilitar la opción de cuotas](https://docs.y.uno/docs/sdks/customization/secure-fields/payment-secure-fields) al iniciar el proceso de checkout.

Para las cuotas creadas por el comercio, también tienes la posibilidad de especificar el plan para cada sesión mediante una de estas opciones:

* el `plan_id` al [crear la sesión](https://docs.y.uno/es/reference/checkout-sessions/create-checkout-session.md).
* una `plan structure` al [crear la sesión de checkout](https://docs.y.uno/es/reference/checkout-sessions/create-checkout-session.md).

> [!CAUTION]
>
> **Enrutamiento con proveedores de respaldo**
>
> Al configurar tu [ruta](https://docs.y.uno/es/docs/using-yuno/dashboard-overview/routing.md) para el método de pago Tarjeta, es importante recordar que, si tienes un proveedor de respaldo mientras usas cuotas, intentaremos realizar un pago de respaldo si la primera transacción es rechazada. Por lo tanto, es fundamental asegurarte de que ambos proveedores admitan la cantidad de cuotas configurada para tu cuenta. Si no es así, puedes configurar rutas distintas para cada escenario y evitar problemas.


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