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

# El objeto de sesión de checkout

> Describe el objeto de sesión de checkout y sus atributos, incluidos el monto, el país y las cuotas

Este objeto representa una sesión de checkout que se puede crear para realizar un pago. Puedes crear una sesión de checkout con el id generado cuando se creó el recurso Customer.

> [!NOTE]
>
> Crear una sesión de checkout solo es necesario para el flujo **SDK\_CHECKOUT**.\
> Solo se admite un pago por cada sesión de checkout.
> Una sesión de checkout expira 2.5 horas después de su creación. La expiración no se puede cambiar mediante la API, y actualizar una sesión de checkout no la extiende.\
> En el entorno de sandbox, una sesión de checkout expira 3.5 horas después de su creación.

## Atributos

**checkout\_session** `string`

El identificador único de la sesión de checkout (MAX 64; MIN 36).

Ejemplo: 9104911d-5df9-429e-8488-ad41abea1a4b

**customer\_id** `string`

El identificador único del cliente (MAX 64; MIN 36).

Ejemplo: 9104911d-5df9-429e-8488-ad41abea1a4b

**merchant\_order\_id** `string`

El identificador único del pedido del cliente (MAX 255; MIN 3).

Ejemplo: 1234

**payment\_description** `string`

La descripción del pago (MAX 255; MIN 3).

Ejemplo: Purchase in Pepito market

**callback\_url** `string`

La URL a la que se redirige al cliente después del pago (MAX 526; MIN 3).

Ejemplo: [https://www.company.com/customer\_1231324](https://www.company.com/customer_1231324)

**country** `enum`

País donde se debe procesar la transacción (MAX 2; MIN 2; [ISO 3166-1](https://en.wikipedia.org/wiki/ISO_3166-1) ).

Valores posibles del enum: consulta la [referencia de países](https://docs.y.uno/es/reference/country-reference.md).

**created\_at** `timestamp`

Fecha y hora de creación de la sesión de checkout (MAX 27; MIN 27; [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) ).

Ejemplo: 2022-05-09T20:46:54.786342Z

**amount** `object`

Especifica el objeto de monto del pago, con el valor y la moneda.

**propiedades**

**currency** `enum`

La moneda utilizada para realizar el pago (MAX 3; MIN 3; [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) ).

Valores posibles del enum: consulta la [referencia de países](https://docs.y.uno/es/reference/country-reference.md).

**value** `float`

El monto del pago (múltiplo de 0.0001).

Ejemplo: 23.5676

**metadata** `array of objects`

Especifica una lista de objetos de metadata. Puedes agregar hasta 50 objetos de metadata. Cuando una regla de enrutamiento tiene una condición de metadata, esta metadata decide qué métodos de pago y cuotas lista la sesión. El enrutamiento de pagos no la lee: define también la metadata en el pago o en el cliente.

**propiedades**

**metadata object** `object`

Especifica una clave de metadata y su valor correspondiente.

**propiedades**

**key** `string`

Especifica una clave de metadata (MAX 48).

Ejemplo: age

**value** `string`

Especifica el valor de la clave de metadata definida (MAX 512).

Ejemplo: 28

**installments** `array of objects`

\[Opcional] El objeto para enviar el plan de cuotas creado en Yuno, para mostrarlo a los clientes y permitirles elegir. Este campo opcional se usa cuando se necesita un plan de cuotas particular en la sesión. Si no se envía, se muestra el plan de cuotas creado para la cuenta en cada escenario, si existe.

**propiedades**

**plan\_id** `string`

Especifica un id de plan creado en Yuno para mostrar a tu cliente en la sesión de checkout. Si no se define, se usan los creados para la cuenta, si aplica (MAX 64; MIN 64).

**plan** `array of objects`

Cuotas que se muestran al cliente con la checkout\_session. Esta estructura opcional se usa cuando se necesita un plan de cuotas particular en la sesión y no tiene un plan de cuotas creado.

**propiedades**

**installment object** `object`

Especifica una cuota disponible para la sesión de checkout.

**propiedades**

**installment** `int`

El número de cuotas mensuales que pueden elegir los compradores

Ejemplo: 3

**rate** `float`

La tasa que ve el usuario final en el checkout.

Ejemplo: 1.5

**wallet\_card\_acceptance** `object`

\[Opcional] Limita qué tarjetas puede seleccionar el cliente en la hoja de pago de Apple Pay. Las tarjetas que no coinciden se muestran en gris. Todos los campos son opcionales; un campo que no se envía mantiene el comportamiento predeterminado. Solo se puede definir cuando se crea la sesión de checkout. Consulta [Filtrar tarjetas elegibles](https://docs.y.uno/es/docs/wallets/apple-pay/sdk-integration/card-filters-and-good-to-know.md#filter-eligible-cards).

**propiedades**

**supported\_countries** `array of strings`

Países que emitieron la tarjeta ([ISO 3166-1](https://en.wikipedia.org/wiki/ISO_3166-1) alpha-2, en mayúsculas). Es el país emisor de la tarjeta, no la ubicación del cliente.

Ejemplo: \["BR"]

**supported\_networks** `array of strings`

Redes de tarjetas que el cliente puede seleccionar, en mayúsculas. Reemplaza la lista predeterminada.

Ejemplo: \["VISA", "MASTERCARD"]

**supported\_funding\_types** `array of enum`

Tipos de fondeo que el cliente puede seleccionar.

Valores posibles del enum: `CREDIT`, `DEBIT`.


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