Saltar al contenido principal
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
  1. 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
  1. 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.
Cada campo se explica en detalle, con ejemplos, en la referencia de campos de afiliación.
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_.
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
  1. 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
  1. 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
  1. 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
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.
  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.

Advanced Features

Multiafiliación, varias cuentas, pedidos divididos, sesiones antifraude, modificaciones de pedidos, network tokens y compras corporativas.