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

# Web SDK: Migración a v1.5

> Actualiza el Yuno Web SDK de v1.4 a v1.5.0, incluido el cambio de mountExternalButtons en el Lite SDK

# Migración a Web SDK v1.5

La versión 1.5.0 cambia la forma en que se muestran Google Pay y Apple Pay en el **Lite SDK**. Las integraciones con el Full SDK no se ven afectadas.

## Qué cambió

En la v1.5.0, los usuarios del Lite SDK deben llamar explícitamente a `mountExternalButtons()` para mostrar los botones de Google Pay y Apple Pay. Estos métodos de pago ya no se muestran automáticamente como botones de opción dentro de la lista de métodos de pago.

Las integraciones con el Full SDK **no tienen cambios incompatibles**: Google Pay y Apple Pay se mostrarán automáticamente como botones directos en lugar de botones de opción, sin necesidad de cambiar el código.

## Quién se ve afectado

* **Usuarios del Lite SDK**: se requiere acción (consulta los pasos a continuación)
* **Usuarios del Full SDK**: no se requiere acción

## Pasos (solo Lite SDK)

### Actualiza la etiqueta script

```html theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
<script src="https://sdk-web.y.uno/v1.5/main.js"></script>
```

### Agrega elementos HTML para los botones de billetera

Agrega elementos contenedor en tu HTML donde quieras que aparezcan los botones:

```html theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
<div id="apple-pay"></div>
<div id="google-pay"></div>
```

### Llama a `mountExternalButtons()` después de `startCheckout`

**Antes:**

```js theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
// Lite SDK — wallet buttons rendered automatically
await yuno.startCheckout({ checkoutSession, countryCode, elementSelector: '#root' })
```

**Después:**

```js theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
// Explicitly mount wallet buttons after startCheckout
await yuno.startCheckout({ checkoutSession, countryCode, elementSelector: '#root' })

await yuno.mountExternalButtons([
  {
    paymentMethodType: 'APPLE_PAY',
    elementSelector: '#apple-pay',
  },
  {
    paymentMethodType: 'GOOGLE_PAY',
    elementSelector: '#google-pay',
  },
])
```

### (Opcional) Desmonta los botones cuando sea necesario

Para desmontar un solo botón:

```js theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
yuno.unmountExternalButton('APPLE_PAY')
```

Para desmontar todos los botones externos a la vez:

```js theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
yuno.unmountAllExternalButtons()
```


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