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

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

- 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.
Referencia de campos
Referencia de campos
Cada campo se explica en detalle, con ejemplos, en la referencia de campos de afiliación.
Settlement Options
Settlement Options
El campo Automatic Settlement determina el momento de la captura de los pagos con tarjeta y billetera.
Entornos: El entorno de Yuno se determina por el prefijo de tu Public API Key:
dev_, staging_, sandbox_ o prod_.2
Instala la Yuno Payment App
Después de guardar la configuración del proveedor, instala la Yuno Payment App desde tu VTEX dashboard.
- En el VTEX dashboard, ve a Apps → App Management.
- Busca Yuno, selecciona la Yuno Payment App en la lista de apps disponibles y abre su Settings.

- Haz clic en Install para completar la configuración.
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.


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

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

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

Repite el proceso para cada método que quieras ofrecer. Puedes consultar la lista completa de métodos disponibles en la página Overview.
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.
- En el Yuno dashboard, abre Developers → Webhooks y haz clic en Add webhook.
- 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).
- Name: Por ejemplo,
- 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.Advanced Features
Multiafiliación, varias cuentas, pedidos divididos, sesiones antifraude, modificaciones de pedidos, network tokens y compras corporativas.