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

# Descripción general del plugin de VTEX

> Entiende cómo funciona el plugin de Yuno para VTEX y los métodos de pago disponibles para tu tienda.

Yuno y VTEX unieron fuerzas para simplificar los procesos de pago de los comercios de todo el mundo. Al integrar la plataforma de orquestación de pagos de Yuno con la plataforma de comercio electrónico de VTEX, las empresas obtienen acceso a una amplia variedad de métodos de pago y funciones de seguridad avanzadas.

![Integración de Yuno y VTEX](https://mintcdn.com/yuno-3979e326/z8Jixp_IwgkBlbdW/images/plugins/vtex/image-20260429-131114.png?fit=max\&auto=format\&n=z8Jixp_IwgkBlbdW\&q=85\&s=19f4901bdb12874fbfc418725e6450cf)

Con Yuno, tu tienda de VTEX puede ofrecer a los compradores tarjetas de crédito y débito, y métodos de pago alternativos como Pix y Boleto Bancário. También admite billeteras digitales como Apple Pay, Google Pay, Samsung Pay y Click to Pay, además de opciones de Buy Now, Pay Later, todo a través de una única integración. La capa de orquestación de Yuno se encarga del enrutamiento y el procesamiento en segundo plano, para que puedas escalar a nuevos mercados sin reconstruir la infraestructura de pagos cada vez.

Yuno también cumple con PCI, y alcanza estándares de seguridad rigurosos al manejar datos de tarjetas. La integración está diseñada para mantener a los compradores dentro del checkout de VTEX de principio a fin. No hay redirecciones a páginas de pago externas, lo que elimina la fricción en el punto más sensible del recorrido de compra y ayuda a aumentar la conversión.

## Métodos de pago disponibles

A través de Yuno, tu tienda de VTEX puede aceptar pagos en las siguientes categorías:

| Categoría | Ejemplos |
| :- | :- |
| **Tarjetas de crédito** | Visa, Mastercard, American Express, Diners, Elo, Hipercard, Alelo y otras marcas regionales. |
| **Tarjetas de débito** | Visa Electron, Maestro, Mastercard Debit, Elo Débito y otras marcas regionales. |
| **Pagos instantáneos** | Pix (Brasil). |
| **Transferencias bancarias** | PSE (Colombia) y otros métodos de transferencia bancaria admitidos por Yuno. |
| **Billeteras digitales** | Apple Pay, Google Pay, Samsung Pay, Click to Pay, Nubank, PicPay, Mercado Pago y otras billeteras regionales. |
| **Vouchers de efectivo** | Boleto Bancário (Brasil), Safetypay, PagoEfectivo y otros métodos de voucher admitidos por Yuno. |
| **Buy Now, Pay Later** | Métodos BNPL admitidos por Yuno. |
| **Métodos genéricos de Yuno** | Métodos a nivel de categoría (Yuno Card, Yuno Wallet, Yuno Bank Transfer, Yuno BNPL, Yuno Ticket, Yuno Payment Link). |

> [!NOTE]
>
> Los métodos que se ofrecen realmente a tus compradores dependen de los métodos que actives en el **dashboard de VTEX** y de los proveedores que hayas habilitado en tu **dashboard de Yuno**.

## Cómo funciona el plugin

El plugin se compone de tres piezas que trabajan juntas en segundo plano:

* **Yuno Payment Connector**: El componente que configuras en tu dashboard de VTEX. Gestiona la comunicación entre VTEX y Yuno: autoriza transacciones, las captura o reembolsa y reporta el estado a VTEX.
* **Yuno Payment App**: Renderiza la experiencia de checkout de Yuno dentro del checkout de VTEX. Cuando un comprador elige un método de pago, la Payment App muestra el formulario correcto (formulario de tarjeta, QR de Pix, botón de billetera) y envía el pago.
* **Yuno SDK Web for VTEX**: La biblioteca que usa la Payment App para renderizar la interfaz de Yuno donde el comprador ingresa sus datos de pago.

Configuras el **Payment Connector** en VTEX. La **Payment App** se instala después, y el **SDK Web** se carga automáticamente durante el checkout. No requiere una configuración independiente.

## Pagos recurrentes, varios vendedores, pedidos modificados y network tokens

Además del checkout de una sola compra, la integración de Yuno también gestiona estos escenarios habituales de VTEX:

* **Suscripciones de VTEX (pagos recurrentes)**: para productos que se venden de forma recurrente, Yuno procesa tanto la primera compra como las renovaciones automáticas que siguen. Consulta las [Preguntas frecuentes](https://docs.y.uno/es/docs/plugins/vtex/faqs.md) para más detalles.
* **Pedidos de varios vendedores (divididos)**: cuando un carrito combina productos de distintos vendedores o franquicias, VTEX lo divide en pedidos separados y Yuno cobra cada uno de ellos, no solo el primero. Consulta [Advanced Features](https://docs.y.uno/es/docs/plugins/vtex/advanced-features.md#split-orders-multiple-sellers).
* **Pedidos modificados (totales cambiados)**: cuando el total de un pedido cambia después del checkout (por ejemplo, en productos vendidos por peso), Yuno se ajusta al monto final. Si **baja**, solo se captura el monto final (menor); si **sube**, la diferencia se cobra automáticamente (cuando está habilitado). Consulta [Advanced Features](https://docs.y.uno/es/docs/plugins/vtex/advanced-features.md#order-modifications-changed-order-totals).
* **Network tokens para compradores recurrentes**: cuando está habilitado, las compras repetidas con la misma tarjeta se procesan con un network token en lugar del número de la tarjeta, lo que mejora las tasas de aprobación. Consulta [Advanced Features](https://docs.y.uno/es/docs/plugins/vtex/advanced-features.md#network-tokens-repeat-card-purchases).

***

## ¿Cuál es el siguiente paso?

> [card] [Configura Yuno en VTEX](https://docs.y.uno/es/docs/plugins/vtex/set-up-yuno-on-vtex.md)
>
> Configuración paso a paso en los dashboards de VTEX y Yuno.

> [card] [Referencia de campos de afiliación](https://docs.y.uno/es/docs/plugins/vtex/affiliation-fields.md)
>
> Cada campo del formulario de proveedor de Yuno, con formatos, valores predeterminados y ejemplos.

> [card] [Enhanced Wallets](https://docs.y.uno/es/docs/plugins/vtex/apple-pay-google-pay-enhanced-experience.md)
>
> Habilita los botones de Apple Pay, Google Pay y Samsung Pay directamente en el checkout de VTEX.

> [card] [Headless SDK](https://docs.y.uno/es/docs/plugins/vtex/direct-sdk-integration.md)
>
> Para tiendas que necesitan renderizar el checkout de Yuno en su propio front-end, incluidos los WebViews móviles.

> [card] [Preguntas frecuentes](https://docs.y.uno/es/docs/plugins/vtex/faqs.md)
>
> Respuestas a las preguntas que los comercios hacen con más frecuencia.


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