VTEX

¡Acepta pagos en tu tienda VTEX en segundos!

Requisitos

Lo único que necesitas para configurar la integración es:

1. Para poder utilizar Wompi como medio de pago, es necesario que estés registrado como partner de Wompi. Si aún no lo estás, completa el siguiente formulario y un asesor comercial te contactará para darte de alta y brindarte las credenciales necesarias para la integración de Wompi a tu tienda VTEX.

Instalación

Para instalar Wompi en tu tienda, inicia sesión en la plataforma VTEX y dirígete a la sección TRANSACCIONES -> Pagos -> Configuración.

Seguidamente, haz clic en la pestaña Afiliaciones de Gateway y presiona el ícono + para agregar Wompi como conector y recibir tus pagos.

Nota: con Wompi deberás configurar tres (3) afiliaciones en tu tienda VTEX: Wompi - Corresponsales, Wompi - PSE y Wompi - Nequi, es decir, debes repetir el proceso que se te describe más adelante para cada una. Las tres (3) afiliaciones tendrán el modo pruebas y producción para configurar en tu tienda VTEX.

Busca Wompi en el listado y haz clic sobre dicha opción para continuar el proceso.

Luego podrás ver la siguiente pantalla donde se solicitan las credenciales necesarias para la integración.

Recuerda que para realizar la integración, debes contar con las credenciales de Wompi.

• Cuenta Wompi: para obtener las credenciales deberás iniciar sesión en el dashboard de comercios, ir a la sección Desarrolladores y tomar las llaves públicas y privadas tanto productivas como de pruebas.

Ya completado el proceso anterior, regresa a tu tienda VTEX e ingresa las credenciales de Wompi solicitadas en pantalla y presiona el botón Guardar.

Luego, tendrás que configurar las condiciones de pago para Wompi. Dirígete a la pestaña Condiciones de pago y presiona el ícono +. Ubica la opción Wompi, activa la condición y haz clic en el botón Guardar para finalizar la configuración.

Nota: en la sección de condiciones de pago, para el caso de PSE, se busca la condición de pago llamada PSE y luego se selecciona en la lista desplegable el conector específico Wompi - PSE que fue creado y configurado anteriormente.

Nota: los cambios en las condiciones de pago pueden tardar hasta 10 minutos para aplicarse en el checkout de tu tienda VTEX.

Instalación de la aplicación Banks for PSE

A continuación, se detalla el paso a paso para instalar la aplicación Banks for PSE y activar el listado de bancos:

1. Debe descargar e instalar VTEX IO CLI. Visualice más detalles en la siguiente documentación.
2. Ubique la Terminal (de Windows u otro sistema operativo) en su PC y ejecute con permisos de administrador haciendo clic con el botón derecho en el icono de la Terminal y seleccionando Ejecutar como administrador.
3. Con la VTEX IO CLI instalada, use el comando vtex login seguido del nombre de la cuenta de VTEX para entrar en su cuenta VTEX. Esto abrirá una ventana de su navegador que solicitará sus credenciales.

$ vtex login {Nombre de cuenta VTEX}

4. Una vez que haya iniciado sesión, puede cerrar la ventana del navegador y volver a la Terminal, puede usar el comando vtex whoami para verificar cuál cuenta y workspace están siendo utilizados por la Terminal.
5. Escriba vtex y presione Enter para comprobar la instalación de VTEX IO CLI.

6. Proceda a instalar Banks for PSE escribiendo el comando vtex install vtex.banks-for-pse@0.3.1 a través de la Terminal usando el VTEX IO CLI. Confirme los cambios, escriba y o Y para confirmar la instalación. Se visualizará un mensaje de éxito de la instalación.

7. Diríjase a su tienda VTEX, consulte el apartado CONFIGURACIÓN DE LA CUENTA -> Apps -> Mis Apps. Visualizará la aplicación Banks for PSE instalada. Seguidamente, haga clic en la opción Configuración.

8. En la sección Connector used to process the PSE seleccione Wompi y finalmente presione el botón GUARDAR.

Configura la siguiente URL

Para configurar la URL de Eventos y recibir las notificaciones de estado correctamente, te detallamos los siguientes pasos:

1. Inicia sesión en Wompi con tus credenciales. Seguidamente, dirígete a la sección Desarrolladores y visualiza el apartado Seguimiento de transacciones.

2. Agrega la URL https://wompi-vtex-events.conexa.ai/ipn/event en el campo URL de Eventos y presiona el botón Guardar.

Nota: si activas el modo de pruebas, la URL que debes configurar es la siguiente: https://wompi-vtex-events-stage.conexa.ai/ipn/event.

¡Listo! El proceso de configuración ha finalizado correctamente.

Tutoriales

• Credenciales de Wompi y tu tienda VTEX

En el siguiente video explicamos cómo obtener tus credenciales de Wompi y tu tienda VTEX.

• Instalación de la integración

En el siguiente video explicamos detalladamente el proceso de instalación y configuración, así podrás integrar fácilmente Wompi a tu tienda VTEX.

• Realizar una compra y visualizar en tu tienda VTEX y Wompi

En el siguiente video te describimos cómo se podrá realizar una compra desde tu tienda y su visualización en tu tienda VTEX y en el panel de Wompi.

Modo Prueba

Para activar el modo de pruebas de Wompi en VTEX, te detallamos los siguientes pasos:

1. Inicia sesión en Wompi con tus credenciales.

2. Dirígete a la sección Desarrolladores y presiona el botón Activar modo de pruebas.

3. Usa las credenciales que se visualizan en la sección Llaves del API para integración técnica en tu integración.

Si ya no deseas usar el modo de pruebas presiona el botón Desactivar modo de pruebas y usa las credenciales productivas en tu integración.

Nota: cada ambiente tiene un par de llaves relacionado, cada una de estas llaves tiene un prefijo prod o test, que representan el ambiente producción o sandbox respectivamente, con el cual puedes identificar fácilmente a qué ambiente corresponde.

Flujo de cliente

Para realizar un pago, una vez elegido el producto y agregado al carrito, tus clientes visualizarán la opción de Wompi como medio de pago disponible.

Wompi - Corresponsales

Corresponsales Bancarios es una forma de pago offline, es decir, se realiza de forma presencial.

El comprador selecciona el método de pago en el checkout de tu tienda VTEX y presiona el botón Comprar ahora.

Seguidamente deberá aprobar los términos y condiciones y presionar el botón Continuar con el pago.

Se mostrará un código único. El comprador deberá ir a un Corresponsal Bancario y usando el código de referencia le permitirá finalizar la operación. El estado de la transacción deberá visualizarse actualizado.

Wompi - PSE

PSE es la red bancaria en Colombia que le permitirá al comprador hacer una transferencia de dinero eligiendo cualquier banco de preferencia.

El comprador selecciona el método de pago PSE y el banco de su preferencia en el checkout de tu tienda VTEX.

Seguidamente, presione el botón Continuar y hacer el pago y se redirecciona a la página de PSE.

Finalizada la operación se retorna al checkout de tu tienda VTEX con la confirmación del pedido.

Wompi - Nequi

Nequi es una billetera bancaria. El comprador se debe identificar con el número telefónico de su cuenta Nequi y seleccionar el medio de pago en el checkout.

Luego debe presionar el botón Comprar ahora.El comprador recibirá una notificación para confirmar la transacción y una vez confirmada finalizará la compra.

Flujo de administrador

Como administrador de tu tienda, podrás visualizar un listado de tus transacciones con el medio de pago utilizado.

De igual forma, desde el listado de pedidos puedes consultar el detalle de los mismos: observarás si el pago fue realizado mediante Wompi y el id de transacción correspondiente.

También, como merchant desde el dashboard de Wompi, podrás visualizar el pago realizado.

Preguntas frecuentes

1. ¿Por qué no se muestra el medio de pago en mi tienda?

• Las credenciales usadas en el proceso de configuración no son las correctas. Te recomendamos asegurarte que las credenciales configuradas son correctas y que se hayan realizado todos los pasos mencionados en esta documentación. Si el problema persiste, contacta a soporte.

2. ¿Cómo puedo visualizar más información de mis transacciones?

• Desde tu tienda VTEX y/o panel de Wompi, podrás obtener más detalles sobre tus transacciones.

3. ¿El estado del pago realizado se actualiza en mi tienda?

• Una vez el comprador realice el pago de la orden, deberías visualizar el pago aprobado en tu tienda.

4. ¿Dónde puedo obtener más información sobre el registro de afiliaciones de gateway?

• Visita Registrar afiliaciones de gateway desde Tutoriales y Soluciones de la plataforma VTEX.

5. ¿Dónde puedo obtener más información para configurar condiciones de pago?

• Visita Configurar condiciones de pago desde Tutoriales y Soluciones de la plataforma VTEX.

6. ¿Puedo dejar de ofrecer el medio de pago?

• Sí, siempre que desees puedes desactivar el medio de pago, simplemente dirígite a la sección TRANSACCIONES -> Pagos -> Configuración, haz clic en la pestaña Condiciones de pago y desactiva la condición de pago para Wompi. Luego, desde la misma pantalla puedes reactivar la condición si deseas volver a usarlo en tu tienda VTEX.