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

> Actualiza el Yuno Web SDK de v1.0 a v1.1.0 en tu checkout

# Migración a Web SDK v1.1

La versión 1.1.0 hace que `initialize()`, `mountCheckout()` y `startCheckout()` sean asíncronos e introduce `continuePayment()` como un paso obligatorio para los flujos de pago dinámicos (3DS, redirecciones de PayPal y similares).

## Qué cambió

* `Yuno.initialize()`, `yuno.mountCheckout()` y `yuno.startCheckout()` ahora devuelven Promises y deben esperarse con await.
* `continuePayment()` ahora es obligatorio cuando la API de pagos devuelve `checkout.sdk_action_required: true`.
* Ya no se necesitan llamadas separadas al servicio de configuración de 3DS: la configuración de 3DS ahora está integrada en la creación del pago.

## Pasos

### Actualiza la etiqueta script

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

### Espera con await todas las llamadas a métodos del SDK

**Antes:**

```js theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
const yuno = Yuno.initialize(publicApiKey, config)
yuno.mountCheckout({ checkoutSession, elementSelector: '#root', countryCode: 'US' })
yuno.startCheckout({ checkoutSession, countryCode: 'US' })
```

**Después:**

```js theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
const yuno = await Yuno.initialize(publicApiKey, config)
await yuno.mountCheckout({ checkoutSession, elementSelector: '#root', countryCode: 'US' })
await yuno.startCheckout({ checkoutSession, countryCode: 'US' })
```

### Implementa `continuePayment` para los flujos dinámicos

Después de crear un pago desde tu backend, verifica si el SDK necesita continuar el flujo (por ejemplo, un desafío 3DS o una redirección de PayPal):

```js theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
// After payment creation
if (paymentResponse.checkout?.sdk_action_required) {
  const result = await yuno.continuePayment({
    checkoutSession,
    showPaymentStatus: true,
    yunoPaymentResult,
    yunoError,
    countryCode: 'US',
  })
  // result may contain a redirect object; handle appropriately
}
```

Si `checkout.sdk_action_required` no es `true`, no es necesario llamar a `continuePayment`.

### Elimina las llamadas separadas de configuración de 3DS

Si tu integración de la v1.0 llamaba a un servicio de configuración de 3DS por separado antes de crear el pago, elimina esa llamada. En la v1.1, la recopilación de datos de 3DS se maneja automáticamente durante la creación del pago.

## Lista de verificación

* [ ] Actualicé la etiqueta script a v1.1
* [ ] Agregué `await` a `Yuno.initialize()`, `yuno.mountCheckout()` y `yuno.startCheckout()`
* [ ] Implementé el manejo de `continuePayment()` para los flujos dinámicos
* [ ] Confirmé que el callback `yunoPaymentResult()` está configurado correctamente
* [ ] Eliminé cualquier llamada independiente al servicio de configuración de 3DS


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