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

# Valida tu integración con VTEX

> Listas de verificación en Markdown que un agente de programación con IA ejecuta sobre un storefront headless o una app de VTEX, más una verificación del CSS y JS personalizado antes de la actualización a Web SDK 1.11.

Un validador es una lista de verificación en Markdown escrita para un agente de programación con IA. Se la entregas al agente que trabaja en tu repositorio y el agente lee tu código según cada verificación de la lista. Por cada verificación informa PASS, FAIL o N/A, cita el archivo y la línea que demuestran el resultado, y explica qué se rompe y cómo solucionarlo.

Los validadores son de solo lectura. El agente busca y lee tu código y no cambia nada a menos que se lo pidas.

Estos validadores son para integraciones headless, en las que tu propio front end o tu app se comunica con Yuno. Las tiendas con el flujo estándar del plugin descrito en [Configura Yuno en VTEX](https://docs.y.uno/es/docs/plugins/vtex/set-up-yuno-on-vtex.md) no los necesitan. Toda tienda con CSS o JS personalizado en el checkout debería ejecutar la verificación de actualización.

## Qué ejecutar

| Tu integración | Ejecuta | Archivo sin formato |
| - | - | - |
| Storefront headless o página WebView que monta Yuno SDK Web para VTEX | [Headless Web](https://docs.y.uno/es/docs/plugins/vtex/validators/headless-web.md) | `https://docs.y.uno/docs/plugins/vtex/validators/headless-web.md` |
| App Flutter con Google Pay, Apple Pay o Click to Pay mediante el flujo preflight | [Wallets headless (Flutter)](https://docs.y.uno/es/docs/plugins/vtex/validators/headless-wallets-flutter.md) | `https://docs.y.uno/docs/plugins/vtex/validators/headless-wallets-flutter.md` |
| App React Native con Google Pay, Apple Pay o Click to Pay mediante el flujo preflight | [Wallets headless (React Native)](https://docs.y.uno/es/docs/plugins/vtex/validators/headless-wallets-react-native.md) | `https://docs.y.uno/docs/plugins/vtex/validators/headless-wallets-react-native.md` |
| Servicio backend que llama a las rutas preflight del conector para wallets en nombre de una app o un sitio web | [Wallets headless (backend)](https://docs.y.uno/es/docs/plugins/vtex/validators/headless-wallets-backend.md) | `https://docs.y.uno/docs/plugins/vtex/validators/headless-wallets-backend.md` |
| Cualquier tienda con CSS o JS personalizado en el checkout (`checkout6-custom.css`, `checkout6-custom.js`, código de tema o de app) | [Verificación de actualización a Web SDK 1.11](https://docs.y.uno/es/docs/plugins/vtex/validators/upgrade-check-1-6-to-1-11.md) | Fragmento de consola y escáner en esa página |

## Quién ejecuta qué

* **Los desarrolladores del comercio** ejecutan el validador que corresponde a su storefront, app o backend en su propio repositorio, y el escáner de la verificación de actualización sobre sus archivos de checkout personalizados.
* **Los gerentes técnicos de cuenta** ejecutan el fragmento de consola de la verificación de actualización en el checkout en vivo de una tienda, ejecutan el escáner sobre los archivos que comparte el comercio y ejecutan un validador cuando revisan con él el repositorio de un comercio.

## Ejecuta un validador con Claude Code

**1. Guarda el validador en la raíz de tu repositorio**

```bash theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
curl -o CLAUDE.md https://docs.y.uno/docs/plugins/vtex/validators/headless-web.md
```

**2. Pide a Claude Code que valide**

```text theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
Validate my Yuno VTEX headless integration following CLAUDE.md
```

**3. Lee el informe**

Claude Code responde con una línea por verificación y una lista de fallas ordenadas por impacto, cada una con una solución de una línea.

> [!WARNING]
>
> Si tu repositorio ya tiene un `CLAUDE.md` o un `AGENTS.md`, no lo sobrescribas. Guarda el validador con otro nombre, como `yuno-validator.md`, y pide al agente que valide tu integración siguiendo ese archivo.

## Ejecuta un validador con Cursor, Codex o Copilot

Guarda el validador como `AGENTS.md` en la raíz del repositorio y pide al agente que valide tu integración con Yuno siguiendo `AGENTS.md`. También puedes pegar el archivo completo en el chat como prompt.

## Cuando falla una verificación

Corrige las fallas en el orden en que las enumera el informe. Si necesitas ayuda del soporte de Yuno o de tu gerente técnico de cuenta, envía:

* El informe completo del validador.
* Los diagnósticos enumerados en la sección "Diagnostics to capture" del validador que ejecutaste. Incluyen el ID de pedido o el grupo de pedidos de VTEX, la hora UTC del intento y los errores de red y de consola.

Elimina las claves de API, los datos de tarjetas y los datos personales antes de enviar cualquier cosa.

## Cómo se crearon las verificaciones

Las verificaciones se derivaron del código fuente del SDK y de tickets de soporte reales. Cuando un validador y la documentación pública no coinciden, sigue el validador. Yuno está corrigiendo esas páginas de la documentación.


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