Guía de integración VTEX

16 septiembre 2025

Acepta pagos de tus productos y servicios con el plugin de Kushki en tu tienda VTEX.

Descripción general

Con el plugin de pagos de Kushki en VTEX puedes aceptar tarjetas de crédito, débito y transferencias bancarias directamente en tu tienda online. La integración es rápida y flexible, y la activación se completa en pocos pasos.

Pasos para habilitar el plugin

Activar el proveedor de pagos en VTEX
1.1. En VTEX, dirígete a Store Settings > Providers.
1.2. Haz clic en New Provider y selecciona Yuno*.
1.3. Completa todos los campos requeridos (App Key, App Token y credenciales de integración).
Nota: El equipo de Kushki te proporcionará estas credenciales durante el proceso de integración.
1.4. Luego, dirígete a Store Settings > Payment Conditions y configura cada medio de pago que quieras habilitar:
- Haz clic en + para crear una nueva condición.
- Busca el método de pago:
  - Para transferencias, selecciona el disponible según tu país (ejemplo: PSE en Colombia o SPEI en México).
  - Para tarjetas, selecciona la franquicia con la que aceptarás pagos (ejemplo: Visa, MasterCard o American Express).
- Activa la condición de pago desde el interruptor de Status.
- En Procesar con afiliación, selecciona Yuno.
- (Opcional) Configura condiciones especiales como fecha de expiración, políticas comerciales o cuotas para tarjetas.
- Haz clic en Guardar.
Repite este procedimiento de forma individual para cada medio de pago que desees habilitar (por ejemplo, cada franquicia de tarjeta y cada transferencia bancaria).
👉 Para más información, consulta la documentación oficial de Yuno para VTEX.
*Yuno es nuestro aliado tecnológico para esta integración.
Configurar Webhooks
Para recibir notificaciones sobre el estado de las transacciones, es necesario configurar webhooks tanto en VTEX como en Kushki:
- En VTEX, define la Webhook URL con el formato:
  https://store_name.myvtex.com/_v/yunopartnerbr.yuno/v4/webhook
- Establece valores en los campos x-api-key y x-secret. Puedes usar un valor simple, por ejemplo: VTEX.
- Activa todos los eventos disponibles para asegurarte de recibir las actualizaciones.
Una vez configurados los webhooks, los estados de las transacciones quedarán sincronizados entre VTEX y Kushki.

Medios de pago disponibles

Medio de pago	CL	CO	EC	MX	PE
Tarjetas crédito/débito	✅ Visa, MasterCard	✅ Visa, MasterCard, Diners Club, Amex	✅ Visa, MasterCard, Amex*	✅ Visa, MasterCard	✅ Visa, MasterCard, Diners Club, Amex
Transferencias bancarias	-	✅ PSE	-	✅ SPEI	-
Reembolsos totales	✅	✅	✅	✅	✅
Reembolsos parciales	✅	✅	✅	✅	✅
Pagos en cuotas	✅	✅	✅	✅	✅
Tarjetas de regalo	✅	✅	✅	✅	✅

*En Ecuador, American Express está disponible de acuerdo con la negociación comercial.

Operación del plugin

Administra tu catálogo, precios y promociones desde VTEX.
Consulta tus reportes transaccionales en la Consola Kushki y en la consola de VTEX.

Soporte

En caso de consultas o incidencias relacionadas con pagos:

Escríbenos a soporte@kushkipagos.com
Ingresa a nuestro 🌐 Centro de Soporte Kushki