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

# Escuchar eventos

> Los controllers que solo informan lo que ocurre durante una transacción: la cuota que eligió el comprador, la tarjeta que está escribiendo y la dirección de envío que seleccionó.

Estos controllers te dicen lo que está ocurriendo. El SDK se comporta igual si los implementas o no: úsalos para dirigir tu propia interfaz o para responder a la hoja de la wallet con nuevos totales.

| Controller | Se activa cuando | Plataformas |
| - | - | - |
| [`onInstallmentSelected`](https://docs.y.uno/es/docs/yuno-sdk/controllers/on-installment-selected) | El comprador elige o cambia una opción de cuotas en el formulario de tarjeta. | Web (`card.onInstallmentSelected`), iOS, Android, React Native |
| [`onCardInfoChanged`](https://docs.y.uno/es/docs/yuno-sdk/controllers/on-card-info-changed) | La consulta de la tarjeta devuelve la marca, el tipo, la categoría, el emisor y el país de la tarjeta que el comprador está escribiendo, o esa tarjeta deja de aplicar. | iOS, Android (`TransactionConfig.onCardInfoChanged`) |
| [`onShippingAddressChanged`](https://docs.y.uno/es/docs/yuno-sdk/controllers/on-shipping-address-changed) | El comprador selecciona o cambia la dirección de envío en una hoja de pago de wallet. | Web (`externalButtons.onShippingAddressChanged`), iOS, Android, React Native |
| `onChange` | Cambia la validez del formulario que renderizó el SDK. El handler recibe `{ form: { isValid } }` cuando inicia la transacción y en cada cambio. Cuando ocultas el botón Pay del SDK con `showPayButton: false`, úsalo para habilitar tu propio botón antes de llamar a `transaction.submit()`. | Web |

`onInstallmentSelected`, `onCardInfoChanged` y `onShippingAddressChanged` tienen cada uno una página con lo que recibes, lo que devuelves y la firma por plataforma.

## Relacionado

* [`onStatus`](https://docs.y.uno/es/docs/yuno-sdk/controllers/on-status). El resultado final de la transacción.
* [Toma el control del SDK](https://docs.y.uno/es/docs/yuno-sdk/controllers/take-over-the-sdk). Los controllers que reemplazan un comportamiento predeterminado.
* [Descripción general](https://docs.y.uno/es/docs/yuno-sdk/controllers/overview.md). Cómo se conectan los controllers en cada plataforma.


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