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

# Configura Yuno en VTEX

> Comienza a aceptar pagos con Yuno en tu tienda VTEX siguiendo esta guía de configuración de principio a fin.

Esta página te guía por cada paso necesario para comenzar a aceptar pagos con Yuno en tu tienda VTEX. La configuración se realiza en dos lugares. Tu **VTEX dashboard** es donde registras Yuno como proveedor de pago, instalas la Payment App y activas los métodos de pago. Tu **Yuno dashboard** es donde configuras el webhook que mantiene sincronizado el estado de los pedidos.

### Antes de comenzar

Ten lo siguiente a mano:

* Un usuario con acceso de administrador a tu VTEX dashboard.
* Tus credenciales de Yuno, que puedes encontrar en tu Yuno dashboard en **Developers → API Credentials**: **Account ID**, **Public API Key** y **Private Secret Key**.

***

**1. Configura Yuno como proveedor de pago**

1. En el **VTEX dashboard**, abre el menú de la izquierda y ve a **Store Settings → Payment → Providers**, y luego haz clic en **New Provider** en la parte superior derecha.

![New Provider en VTEX](https://mintcdn.com/yuno-3979e326/z8Jixp_IwgkBlbdW/images/plugins/vtex/image-065c1400.png?fit=max\&auto=format\&n=z8Jixp_IwgkBlbdW\&q=85\&s=8337a6566dd698dc04a51133a16a4429)

2. En el cuadro de diálogo **Select a provider**, escribe `Yuno` en el cuadro de búsqueda y selecciona **Yuno** en los resultados.

![Buscar el proveedor Yuno](https://mintcdn.com/yuno-3979e326/z8Jixp_IwgkBlbdW/images/plugins/vtex/image-d4b7cb65.png?fit=max\&auto=format\&n=z8Jixp_IwgkBlbdW\&q=85\&s=dbec2bacc93f98073c25116c82e6cb26)

3. Completa el formulario de configuración del proveedor y guarda. Una vez guardado, el proveedor queda registrado, pero todavía no hay métodos de pago activos.

> [accordion] Referencia de campos
>
> Cada campo se explica en detalle, con ejemplos, en la [referencia de campos de afiliación](https://docs.y.uno/es/docs/plugins/vtex/affiliation-fields.md).
>
> | Campo | Obligatorio | Qué hace |
> | :- | :- | :- |
> | **Application Key / Application Token** | Sí | Credenciales de administrador de VTEX que el plugin usa para actuar en tu nombre. Consulta la guía de VTEX sobre [cómo generar Application Keys](https://help.vtex.com/docs/tutorials/api-keys#generating-internal-application-keys). |
> | **Automatic Settlement** | Sí | Cuándo se capturan los pagos con tarjeta y billetera. Consulta **Settlement Options** más abajo. |
> | **Affiliation Name** | Sí | Un nombre para esta integración de Yuno. [Detalles](https://docs.y.uno/es/docs/plugins/vtex/affiliation-fields.md#affiliation-name) |
> | **Account ID** | Sí | Tu Account ID de Yuno. [Detalles](https://docs.y.uno/es/docs/plugins/vtex/affiliation-fields.md#account-id) |
> | **Public API Key** | Sí | Tu Public API Key de Yuno; su prefijo define el entorno. [Detalles](https://docs.y.uno/es/docs/plugins/vtex/affiliation-fields.md#public-api-key) |
> | **Private Secret Key** | Sí | Tu Private Secret Key de Yuno. [Detalles](https://docs.y.uno/es/docs/plugins/vtex/affiliation-fields.md#private-secret-key) |
> | **Main Account Name** | Opcional | La cuenta de VTEX propietaria de los pedidos en configuraciones con varias cuentas. [Detalles](https://docs.y.uno/es/docs/plugins/vtex/affiliation-fields.md#main-account-name) |
> | **Main Account App key** | Opcional | Application Key de la cuenta principal de VTEX. [Detalles](https://docs.y.uno/es/docs/plugins/vtex/affiliation-fields.md#main-account-app-key) |
> | **Main Account App token** | Opcional | Application Token de la cuenta principal de VTEX. [Detalles](https://docs.y.uno/es/docs/plugins/vtex/affiliation-fields.md#main-account-app-token) |
> | **Soft Descriptor** | Opcional | Texto que se muestra en el resumen de la tarjeta del comprador. [Detalles](https://docs.y.uno/es/docs/plugins/vtex/affiliation-fields.md#soft-descriptor) |
> | **Create Customer** | Opcional | Crea un registro de cliente en Yuno por cada comprador. [Detalles](https://docs.y.uno/es/docs/plugins/vtex/affiliation-fields.md#create-customer) |
> | **VTEX IO orderPlaced page URL** | Opcional | Dónde se redirige a los compradores después del pago. [Detalles](https://docs.y.uno/es/docs/plugins/vtex/affiliation-fields.md#vtex-io-orderplaced-page-url) |
> | **Payment Mode** | Opcional | Payment App dentro del checkout, o redirección Legacy. [Detalles](https://docs.y.uno/es/docs/plugins/vtex/affiliation-fields.md#payment-mode) |
> | **Transaction Identification From** | Opcional | Muestra el ID de transacción de Yuno o del proveedor. [Detalles](https://docs.y.uno/es/docs/plugins/vtex/affiliation-fields.md#transaction-identification-from) |
> | **Antifraud Providers for Split Orders** | Opcional | Proveedores antifraude que reciben la sesión compartida en pedidos divididos. [Detalles](https://docs.y.uno/es/docs/plugins/vtex/affiliation-fields.md#antifraud-providers-for-split-orders) |
> | **Vault Card for Order Modification** | Opcional | Cobra la diferencia cuando aumenta el total de un pedido. [Detalles](https://docs.y.uno/es/docs/plugins/vtex/affiliation-fields.md#vault-card-for-order-modification) |
> | **Enable Network Tokens** | Opcional | Almacena tarjetas para que las compras repetidas puedan usar un network token. [Detalles](https://docs.y.uno/es/docs/plugins/vtex/affiliation-fields.md#enable-network-tokens) |
> | **Use Corporate Buyer Data** | Opcional | Paga los pedidos de empresas con el nombre y el CNPJ de la empresa (Brasil). [Detalles](https://docs.y.uno/es/docs/plugins/vtex/affiliation-fields.md#use-corporate-buyer-data) |
> | **Headless Payment Handoff** | Opcional | Para marketplaces cuyo propio checkout headless crea el pago. [Detalles](https://docs.y.uno/es/docs/plugins/vtex/affiliation-fields.md#headless-payment-handoff) |
> | **Store Base Path** | Opcional | Prefijo de ruta de URL de una tienda que no se sirve desde la raíz del dominio. [Detalles](https://docs.y.uno/es/docs/plugins/vtex/affiliation-fields.md#store-base-path) |
> | **Send Order Sequence as Merchant Reference** | Opcional | Envía la secuencia de pedido de VTEX como referencia del pago. [Detalles](https://docs.y.uno/es/docs/plugins/vtex/affiliation-fields.md#send-order-sequence-as-merchant-reference) |
> | **Sales Channel Domains** | Opcional | Asigna cada canal de venta al dominio de su tienda. [Detalles](https://docs.y.uno/es/docs/plugins/vtex/affiliation-fields.md#sales-channel-domains) |
> | **Delay To Cancel** | Opcional | Cuánto tiempo espera VTEX un pago pendiente, por método. [Detalles](https://docs.y.uno/es/docs/plugins/vtex/affiliation-fields.md#delay-to-cancel) |

> [accordion] Settlement Options
>
> El campo **Automatic Settlement** determina el momento de la captura de los pagos con tarjeta y billetera.
>
> | Opción | Comportamiento práctico |
> | :- | :- |
> | **Use behavior recommended by payment processor** | **Immediate Capture**: La transacción se captura inmediatamente después de la autorización. (Predeterminado) |
> | **Automatic capture immediately after payment authorization** | **Immediate Capture**: La transacción se captura inmediatamente después de la autorización. Igual que el predeterminado. |
> | **Automatic capture immediately after anti-fraud analysis** | **Immediate Capture**: La transacción se captura inmediatamente después de la autorización. |
> | **Disabled** | **Authorize Only**: La transacción solo se autoriza. La captura ocurre más tarde, cuando se **factura** el pedido. |

> [!NOTE]
>
> **Entornos**: El entorno de Yuno se determina por el prefijo de tu **Public API Key**: `dev_`, `staging_`, `sandbox_` o `prod_`.

> [!TIP]
>
> Te sugerimos usar **Use behavior recommended by payment processor**, a menos que tu negocio requiera específicamente la captura después de la facturación.

**2. Instala la Yuno Payment App**

Después de guardar la configuración del proveedor, instala la Yuno Payment App desde tu VTEX dashboard.

1. En el **VTEX dashboard**, ve a **Apps → App Management**.
2. Busca **Yuno**, selecciona la **Yuno Payment App** en la lista de apps disponibles y abre su **Settings**.

![Instalar la Yuno Payment App](https://mintcdn.com/yuno-3979e326/z8Jixp_IwgkBlbdW/images/plugins/vtex/image-c64bef9b.png?fit=max\&auto=format\&n=z8Jixp_IwgkBlbdW\&q=85\&s=cb08f018fbbabe5978937d6ae2f3ec85)

3. Haz clic en **Install** para completar la configuración.

Una vez instalada, la Payment App se encarga de mostrar la experiencia de checkout de Yuno dentro de tu checkout de VTEX.

**3. Activa los métodos de pago**

Ahora elige qué métodos de pago quieres ofrecer a tus compradores y enrútalos a través de Yuno.

1. En el **VTEX dashboard**, ve a **Store Settings → Payment → Settings → Payment Conditions**. Haz clic en el botón **+** para agregar una condición de pago.

![Agregar condición de pago](https://mintcdn.com/yuno-3979e326/z8Jixp_IwgkBlbdW/images/plugins/vtex/image-68c9e7f2.png?fit=max\&auto=format\&n=z8Jixp_IwgkBlbdW\&q=85\&s=113ff69653f5e2bc3516f474e8c950b2)

2. Selecciona el método de pago que quieres activar (por ejemplo, Visa, Mastercard, Pix, Apple Pay, Samsung Pay o cualquiera de los métodos genéricos de **Yuno**, como Yuno Card o Yuno Wallet).

![Seleccionar método de pago](https://mintcdn.com/yuno-3979e326/z8Jixp_IwgkBlbdW/images/plugins/vtex/image-309cec4b.png?fit=max\&auto=format\&n=z8Jixp_IwgkBlbdW\&q=85\&s=1b231665433a72bc349afc1520d54446)

3. En el campo **Process with provider**, selecciona la afiliación de Yuno que configuraste en el Paso 1. Establece el **Status** en **Active** y guarda.

![Configurar la afiliación de pago](https://mintcdn.com/yuno-3979e326/z8Jixp_IwgkBlbdW/images/plugins/vtex/image-73d8fe62.png?fit=max\&auto=format\&n=z8Jixp_IwgkBlbdW\&q=85\&s=68cb827a7c70b3c8b9b8e6b360a9e89d)

> [!NOTE]
>
> Repite el proceso para cada método que quieras ofrecer. Puedes consultar la lista completa de métodos disponibles en la página [Overview](https://docs.y.uno/es/docs/plugins/vtex.md).

**4. Configura el webhook en tu Yuno dashboard**

El webhook mantiene sincronizados tus pedidos de VTEX con las actualizaciones de estado de los pagos de Yuno.

1. En el **Yuno dashboard**, abre **Developers → Webhooks** y haz clic en **Add webhook**.
2. Completa el formulario:
   * **Name**: Por ejemplo, `VTEX webhook`.
   * **Endpoint URL**: `https://{store_name}.myvtex.com/_v/yunopartnerbr.yuno/v4/webhook`, reemplazando `{store_name}` por el nombre de tu cuenta de VTEX.
   * **x-api-key** y **x-secret**: Ingresa cualquier valor de relleno (por ejemplo, `VTEX`).
3. Selecciona todos los eventos y haz clic en **Add**.

***

## Escenarios avanzados

Los escenarios que van más allá de la configuración básica (multiafiliación, varias cuentas, pedidos divididos, sesiones antifraude, modificaciones de pedidos, network tokens y compras corporativas) se tratan en su propia página.

> [card] [Advanced Features](https://docs.y.uno/es/docs/plugins/vtex/advanced-features.md)
>
> Multiafiliación, varias cuentas, pedidos divididos, sesiones antifraude, modificaciones de pedidos, network tokens y compras corporativas.


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