Conectar Wompi a tu tienda en línea

Conecta tu comercio de Wompi para recibir pagos desde tu Storefront. El comprador elige PSE, Bancolombia, Nequi y otros medios, identificado como procesado por Wompi, y completa el pago en su checkout.

Abrir Storefront.

Antes de comenzar

Necesitas acceso a la configuración de tu Storefront y al panel del comercio en Wompi. Esta conexión admite tiendas con moneda COP.

Prepara una tienda publicada, productos disponibles y una forma de entrega. Si ofreces recogida, completa la Dirección de recogida. También necesitas una cuenta de tipo banco en Cajas y bancos para registrar el recaudo.

Estas instrucciones corresponden a Storefront. Las credenciales del e-commerce clásico no se copian automáticamente.

1. Abrir la conexión en Wahio

1. Entra en Configuración → Tienda online → Storefront y abre tu tienda.
2. Selecciona Pagos y entregas.
3. En Medios de pago, pulsa Conectar junto a Wompi.
4. Selecciona Pruebas en Ambiente.
5. Copia la URL de eventos que muestra el formulario y déjalo abierto.

La URL termina en /api/payments/wompi/events. Copia la dirección completa de tu formulario; no uses la página de regreso del comprador ni la URL de otra integración.

2. Preparar las credenciales y los eventos en Wompi

Entra en Wompi Comercios con la cuenta que recibirá los pagos.

1. Abre Desarrollo → Programadores.
2. Pulsa Activar modo de pruebas. Confirma que el panel indique Sandbox (modo de pruebas).
3. Copia la Llave pública del sandbox, que comienza por pub_test_.
4. En Secretos para integración técnica, muestra y copia Eventos e Integridad. Usa los secretos del mismo ambiente que la llave pública.
5. En URL de Eventos, pega la URL copiada de Wahio y pulsa Guardar.

La URL de eventos permite que Wompi avise a Wahio del resultado de cada transacción, incluso si el comprador cierra el navegador. En Debugger puedes consultar las entregas de transaction.updated. Consulta las guías oficiales de ambientes y llaves y eventos.

Si ya hay una URL de eventos utilizada por otra tienda o integración, no la reemplaces sin revisar cómo conservar sus notificaciones. Contacta con soporte para coordinar la conexión. No necesitas regenerar las llaves existentes para conectar Storefront.

3. Guardar y ofrecer Wompi a tus clientes

Vuelve al formulario de Wahio y completa:

Esta conexión no requiere la llave privada de Wompi. El secreto de integridad y el secreto de eventos son datos diferentes: pega cada uno en su campo.

1. Pulsa Guardar dentro de la conexión. Debe aparecer Configurado · Pruebas.
2. Marca Ofrecer Wompi.
3. Selecciona la Cuenta de recaudo de Wompi.
4. Pulsa Guardar en el encabezado de Pagos y entregas.

La cuenta de recaudo registra el pago dentro de Wahio; no cambia la cuenta bancaria de abono que tengas en Wompi. Cada pasarela tiene su propia cuenta de recaudo. Puedes elegir cuentas diferentes para Stripe y Wompi o usar la misma en ambas. Cada pedido conserva la cuenta que tenía Wompi al confirmarlo; cambiarla después solo afecta a pedidos nuevos.

Guardar las credenciales y habilitar el medio son dos pasos distintos. Los ajustes de pagos y entregas se aplican al guardar, sin volver a publicar el diseño. Configurado confirma que guardaste los datos; una compra de prueba comprueba la conexión completa.

4. Comprobar el pago en sandbox

1. Abre la tienda pública, agrega un producto al carrito y completa tus datos de prueba.
2. Elige PSE, Bancolombia, Nequi y otros medios (procesado por Wompi) y confirma el pedido.
3. En la página del pedido, pulsa Pagar con Wompi.
4. Confirma que el checkout indique Modo de pruebas, el comercio correcto y el importe esperado.
5. Elige Tarjeta débito o crédito. Completa los datos del comprador y utiliza una tarjeta de la guía oficial de sandbox de Wompi:

Usa una fecha futura y un CVC de tres dígitos. Completa los demás campos con datos de prueba. Estas tarjetas se utilizan únicamente en sandbox, sin dinero real.

Si el pago se aprueba, abre Pedidos en Wahio: debe figurar Pagado y el perfil debe mostrar el pago recibido y saldo pendiente de cero. En Desarrollo → Debugger de Wompi, comprueba que el evento de esa transacción figure Exitoso y la respuesta del comercio sea 200. Exitoso en Debugger indica la entrega del aviso; revisa también si la transacción fue aprobada o rechazada.

Si el pago se rechaza, Wahio debe conservar el pedido pendiente y permitir otro intento. El nuevo intento se realiza sobre el mismo pedido.

El pedido se crea antes de abrir Wompi. Su pago puede confirmarse aunque el comprador no pulse Volver al comercio. La aceptación del pedido es independiente del pago y depende de Aceptar automáticamente o de la revisión manual del comercio.

Pasar a producción

Cuando termines las pruebas, desactiva el modo de pruebas en Wompi. En Programadores, configura la URL de eventos para producción y obtén la llave pub_prod_ y los secretos Eventos e Integridad de ese ambiente.

En Wahio, edita la conexión, selecciona Producción y reemplaza los tres datos por los del ambiente real. Guarda, revisa Ofrecer Wompi y la cuenta de recaudo. Si hay pagos pendientes y Wahio bloquea el cambio de credenciales, resuélvelos con soporte antes de reemplazarlas.

Resolver problemas

No registres otro pago manual para compensar una confirmación pendiente. Los reembolsos de Wompi no se tramitan automáticamente desde esta conexión: revisa la devolución con soporte para conciliarla. Mantén las llaves y los secretos privados; no los envíes en capturas ni mensajes.

Consulta también conectar Stripe y configurar medios de pago.