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

# onInstallmentSelected

> Se invoca cuando el comprador elige una opción de cuotas en el formulario de tarjeta.

`onInstallmentSelected` se invoca cuando el comprador elige una opción de cuotas en el formulario de tarjeta, incluida la selección automática de la primera opción cuando se carga la lista. Es informativo: la selección viaja con el pago de todos modos, por lo que sobrescribirlo es opcional. Úsalo para reflejar la financiación elegida en tu propia interfaz (por ejemplo, para actualizar el resumen del pedido).

Disponible en Web, iOS, Android y React Native. En Web, defínelo dentro del campo `card` de la configuración de la transacción. El SDK lo llama desde cada formulario de tarjeta que muestra.

## Qué recibes

| Campo | Tipo | Descripción |
| - | - | - |
| `installment` | Int | Número de cuotas elegido. |
| `label` | String | La etiqueta de la opción exactamente como se muestra al comprador. |
| `amount.currency` | String | Código de moneda de los montos. |
| `amount.value` | String | Monto por cuota. |
| `amount.totalValue` (`amount.total_value` en Web) | String | Monto total de todas las cuotas. |
| `installmentId` | String? | Solo en Web (1.11.28+ y 2.4.0+). ID del plan de cuotas al que pertenece la opción. Las opciones del mismo plan lo comparten, así que combínalo con `installment` para identificar la opción. Se envía con el token de un solo uso. |
| `type` | String? | Solo en Web (1.11.28+ y 2.4.0+). El tipo de plan de cuotas. |
| `rate` | Number? | Solo en Web (1.11.28+ y 2.4.0+). TAE de la opción, tomada de la entrada `APR` de `financialCosts`. `undefined` cuando no hay ninguna. |
| `financialCosts` | Array? | Solo en Web (1.11.28+ y 2.4.0+). Desglose de los costos financieros de la opción de cuotas, con `type`, `rate` y `formattedValue`. |
| `additionalData` | Map? | En iOS (`[String: Any]?`), el objeto `additional_data` sin procesar del plan, tal como lo envió el backend, `nil` cuando el backend no envió ninguno o está vacío. Reservado en Android y Web; actualmente `null` (`undefined` en Web). |
| `isMerchantInstallment` | Boolean? | Reservado en iOS y Android; actualmente `null`. En Web, `true` cuando los planes provienen de tu hook `card.onGetInstallments` y `false` para los planes de Yuno. |

`amount` es `null` (`undefined` en Web) cuando el backend no proporcionó montos para la opción. Cuando los planes provienen de `card.onGetInstallments` (`isMerchantInstallment: true`), `installmentId`, `type`, `rate` y `financialCosts` son `undefined`, y el token de un solo uso se crea con `installment: null`.

## La entrega de `null`

El controlador recibe `null` (`nil` en iOS) cuando una selección informada anteriormente deja de ser válida: las cuotas disponibles cambiaron, normalmente porque el comprador editó el número de tarjeta y la nueva tarjeta no tiene planes de cuotas. Trátalo como "ya no hay ninguna cuota seleccionada". Se dispara como máximo una vez por invalidación; una nueva selección lo vuelve a habilitar.

## Firma

> [tab] Web
>
> ```typescript theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
> const transaction = sdkPayments.transaction({
>   checkoutSession,
>   countryCode: 'CO',
>   elementSelector: '#payment-form',
>   onStatus: (result) => console.log(result.status),
>   card: {
>     onInstallmentSelected: (installment) => {
>       if (installment) orderSummary.showFinancing(installment.label)
>       else orderSummary.clearFinancing()
>     },
>   },
> })
> ```

> [tab] iOS
>
> ```swift theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
> func onInstallmentSelected(_ installment: InstallmentSelected?) {
>     if let installment {
>         orderSummary.showFinancing(installment.label)
>     } else {
>         orderSummary.clearFinancing()
>     }
> }
> ```

> [tab] Android
>
> ```kotlin theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
> override fun onInstallmentSelected(installment: InstallmentSelected?) {
>     installment?.let {
>         orderSummary.showFinancing(it.label)
>     } ?: orderSummary.clearFinancing()
> }
> ```

> [tab] React Native
>
> ```tsx theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
> onInstallmentSelected: (installment) => {
>   if (installment) {
>     orderSummary.showFinancing(installment.label);
>   } else {
>     orderSummary.clearFinancing();
>   }
> },
> ```

## Relacionado

* [Escuchar eventos](https://docs.y.uno/docs/yuno-sdk/controllers/listen-to-events). Los demás controladores informativos.
* [`onStatus`](https://docs.y.uno/es/docs/yuno-sdk/controllers/on-status). El resultado final de la transacción.
* [Resumen de los controladores](https://docs.y.uno/es/docs/yuno-sdk/controllers/overview.md). Cómo se conectan los controladores en cada plataforma.


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