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.
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.
El siguiente video te guiará paso a paso en esta configuración:
2.
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.
Notificaciones adicionales
Si tu integración requiere notificaciones específicas de devoluciones de cargo (chargebacks), solicita a tu contacto técnico en Kushki habilitar este tipo de notificaciones en la siguiente URL de producción: https://prod.y.uno/kushki-webhook/v1/confirmations
*En Ecuador, American Express está disponible de acuerdo con la negociación comercial.
Importante
Los métodos de pago disponibles pueden variar según el país y la configuración de tu comercio. Confirma con tu asesor de Kushki antes de activar nuevas opciones.
