VTEX

La integración de ePayco con VTEX permite a los comercios aceptar pagos en línea de forma segura, eficiente y completamente automatizada. Esta conexión se realiza directamente desde el panel administrativo de VTEX mediante un conector oficial, y ofrece una experiencia fluida tanto para el comercio como para el cliente.

Requisitos previos

Para habilitar ePayco como medio de pago, necesitas:

• Tener una tienda activa y operativa en la plataforma VTEX.
• Contar con una cuenta verificada en ePayco.
• Acceso a las llaves de integración (APP KEY, APP TOKEN, P_KEY y PUBLIC_KEY) desde tu cuenta ePayco.

Modos de integración disponibles

En VTEX, el proceso de pago se realiza a través de un checkout embebido, donde todos los medios de pago disponibles se presentan directamente dentro del formulario de la tienda.

Este modelo ofrece múltiples ventajas:

• El cliente realiza el pago directamente desde la tienda, sin ser redireccionado.
• Se reducen pasos en el proceso de compra, mejorando la conversión.
• Cumple con los más altos estándares de seguridad como PCI DSS.
• Experiencia de usuario fluida, centralizada e integrada.
• Compatible con más de 22 medios de pago: tarjetas de crédito y débito, PSE, efectivo, billeteras digitales, entre otros.
• El estado del pedido se actualiza automáticamente en la tienda en tiempo real tras la transacción.

Gracias a este enfoque, los clientes pueden pagar de forma cómoda y segura, sin salir del entorno de tu tienda VTEX.

¿Cómo integrar ePayco en VTEX?

Sigue estos pasos para activar ePayco en tu tienda VTEX:

1. Accede al panel administrativo
   • Accede como administrador al panel de tu tienda VTEX.  
2. Ingresa a la configuración de pagos
   • Dirígete a Configuración de la tienda 
   • Luego selecciona la opción Pago > Proveedores. 

3. Crea el nuevo proveedor de pagos 

Haz clic en "Nuevo proveedor" y selecciona ePayco.  

4. Autoriza el proveedor ePayco con tus claves VTEX para la gestión de la actualización de las ordenes.

Serás redirigido a la sección de Autorización del proveedor, donde deberás ingresar dos valores:

• APP KEY
• APP TOKEN

¿Cómo obtener la APP KEY y el APP TOKEN?

4.1. En el menú superior, haz clic en el ícono de tu cuenta o de la tienda y selecciona Configuraciones de la cuenta.

4.2. Ingresa a la sección Claves API.

4.3. Haz clic en Generar clave.

4.4. Asigna un nombre identificador a la clave. Define los permisos necesarios (Se recomienda limitar accesos a los estrictamente requeridos).

4.5. Haz clic en Generar.

4.6. Se generará los valores que puedes utilizar para los campos de  APP KEY y APP TOKEN

⚠️ Importante: El token generado (APP TOKEN) se mostrará una sola vez. Asegúrate de copiarlo y almacenarlo de forma segura para su uso posterior.

5. Completa la configuración del proveedor 

Una vez ingreses tu APP KEY y APP TOKEN, configura los siguientes campos adicionales:

• Nombre: Define cómo deseas identificar este proveedor en tu tienda.
• Modo pruebas: Actívalo si estás en fase de testeo. Asegúrate de que tu cuenta ePayco también esté en modo pruebas.
• Llaves de ePayco: PUBLIC_KEY P_KEY

Puedes obtener estas llaves desde tu cuenta de ePayco (ver más abajo).

Guarda los cambios haciendo clic en el botón Guardar.

¿Dónde puedo conseguir las llaves de mi comercio?

Configuración de medios de pago

¿Como configurar el medio de pago Tarjeta de Crédito?

ePayco es un conector nativo dentro de VTEX, lo que permite activar fácilmente pagos con tarjeta de crédito desde tu tienda. La integración admite múltiples franquicias (Visa, Mastercard, American Express, etc.), las cuales puedes configurar de manera individual.

Pasos para activar Tarjeta de Crédito:

1. Accede al panel administrativo de VTEX.

2. Ve a Configuración de la tienda > Pagos > Configuración.

3. Selecciona la pestaña Condiciones de pago.

4. Allí verás las franquicias disponibles. Selecciona la que deseas habilitar.
   

5. Asigna:

   • Un nombre identificador para el medio de pago

   • La afiliacion de ePayco (La que configuraste previamente)

   • Las condiciones de pago deseadas

6. Haz clic en Guardar. 

7. Repite el proceso para cada franquicia adicional que quieras activar.

✅ Solo puedes tener una condición activa por cada franquicia.

¿Como configurar el medio de pago PSE?

La activación de PSE en VTEX requiere dos pasos: instalar una extensión y luego habilitar el método de pago en la configuración de la tienda. El flujo redirige al cliente a una landing de ePayco para validar el pago con su banco (ACH Colombia).

1. Ve al módulo Aplicaciones > Centro de extensiones > Gestión de aplicaciones.
   

2. Busca e instala la app "Bancos para PSE".
   

3. Durante la instalación, selecciona ePayco como proveedor.

4. Ingresa tu llave pública y privada de ePayco (disponibles en tu dashboard).
   

5. Luego ve a Configuración de la tienda > Pagos > Configuración.

6. En la pestaña Condiciones de pago, selecciona PSE.
   

7. Asigna:

   • Un nombre al método de pago.

   • La afiliación de ePayco.

8. Haz clic en Guardar.

✅ Al finalizar, el método quedará activado y disponible para tus clientes.

¿Cómo configurar el medio de pago Efecty?

Con esta opción, tus clientes podrán generar un recibo para pagar en puntos Efecty físicos, ideal para quienes no cuentan con cuentas bancarias.

Pasos para activar Efecty:

1. Ve a Configuración de la tienda > Pagos > Configuración.

2. Usa el buscador para encontrar Efecty.

3. Haz clic en el medio de pago y actívalo.
   

4. Configura:

   • Condiciones de pago según tu negocio.

   • La afiliación de ePayco.

5. Haz clic en Guardar.
   
   

✅ Verás el método habilitado en la lista de medios activos.

¿Cómo configurar el medio de pago DaviPlata?

Este método permite recibir pagos desde la billetera digital DaviPlata de forma rápida y segura.

Pasos para activar DaviPlata:

1. Dirígete a Configuración de la tienda > Pagos > Configuración.

2. Selecciona la pestaña Condiciones de pago.

3. Busca y haz clic en DaviPlata.
   

4. Asigna un nombre y configura las condiciones de pago.

5. Selecciona la afiliación ePayco.
   

6. Haz clic en Guardar.

✅ El método quedará activo para que tus clientes lo usen en el checkout.

💡 Importante
Cada vez que configures un medio de pago o franquicia, debes esperar aproximadamente 10 minutos para que VTEX actualice dichos métodos en tu tienda.

Prueba la integración

Realiza una compra en tu tienda para verificar el funcionamiento del plugin:

1. Añade productos al carrito.
2. Avanza al proceso de pago diligenciando los datos de entrega.
3. Seleccione y diligencie los datos del medio de pago seleccionado en el checkout

4. La transacción se procesará y se confirmará el pedido.

• La confirmación del pago será enviada al correo electrónico del comprador. 

Beneficios y aspectos clave

Consideraciones importantes

Soporte

¿Necesitas ayuda?

Puedes comunicarte con el equipo de soporte de ePayco:

📩 soporte@epayco.co
📚 Documentación técnica: docs.epayco.co