Cómo crear una tienda virtual con Wompi paso a paso en Colombia

Montar una tienda virtual con Wompi es una de las rutas más directas para que una pyme colombiana deje de confirmar transferencias por captura de pantalla en WhatsApp y pase a vender las 24 horas con conciliación automática. Wompi, la pasarela de pagos desarrollada por el Grupo Bancolombia, se ha vuelto un estándar en el país porque reúne en un solo checkout los métodos que más usan los compradores locales: Nequi, PSE, tarjetas y efectivo en corresponsales.
Sin embargo, abrir la cuenta en la pasarela es apenas una parte del proceso. Para que la tienda funcione sin pedidos perdidos ni cobros duplicados, necesitas preparar tu catálogo, superar la validación documental, elegir el método de conexión adecuado y configurar las notificaciones automáticas de pago. En esta guía recorremos el paso a paso completo desde cero hasta la primera venta en firme.
1. Requisitos previos antes de abrir la cuenta en Wompi
Antes de iniciar el registro técnico, asegúrate de tener listos dos frentes: el bancario y el comercial. Si te falta alguno, el proceso de activación quedará detenido en revisión.
En el frente documental y bancario necesitarás:
- Cuenta bancaria en Bancolombia: debe ser una cuenta de ahorros o corriente activa a nombre de la misma persona natural o empresa que se registra en la pasarela.
- RUT actualizado: expedido por la DIAN con fecha de generación reciente y con la actividad económica acorde a la venta de tus productos o servicios.
- Cámara de Comercio (si eres persona jurídica): certificado de existencia y representación legal con menos de 30 días de expedición, junto con el documento de identidad del representante legal.
- Certificación bancaria: documento emitido por el banco no mayor a 30 días donde conste la titularidad y el número de la cuenta de desembolso.
En el frente digital, tu sitio web ya debe estar publicado bajo un dominio propio con certificado de seguridad SSL (
1https://2. Elegir la base tecnológica de tu tienda virtual
Wompi no es una tienda por sí sola; es el cajero que procesa el pago cuando el cliente ya armó su carrito. Dependiendo del tamaño de tu catálogo y de tu operación logística, tienes tres caminos principales para construir la tienda donde irá conectada la pasarela:
| Opción de plataforma | Cuándo conviene | Cómo se conecta con Wompi |
|---|---|---|
| Tienda a medida (Next.js, React, Node, Python) | Cuando manejas reglas propias de precios por volumen, múltiples bodegas, facturación integrada o catálogos muy rápidos | Mediante el Widget de Checkout web o la API REST directa de Wompi |
| WooCommerce (WordPress) | Catálogos pequeños o medianos de hasta 500 referencias con flujo de venta estándar | Con el plugin oficial de Wompi para WooCommerce |
| Shopify / VTEX | Marcas de comercio minorista que prefieren pagar suscripción mensual en dólares y comisiones por plataforma | Mediante la aplicación oficial de Wompi en el marketplace respectivo |
Si tu negocio vende productos sencillos sin conexión a un sistema de inventario externo, un plugin estándar cumple su función. Si necesitas que cada venta descuente existencias en tu bodega local, liquide fletes por municipio o genere documentos contables al instante, un desarrollo de comercio electrónico a medida evita que la tienda se vuelva lenta a medida que creces.
3. Registro y verificación del comercio en Wompi
Con los documentos en PDF y la tienda visible en su dominio, el registro en el portal de comercios de Wompi sigue cuatro etapas:
- Creación de usuario y perfil de negocio: ingresas a Wompi, registras el correo corporativo del administrador, defines el nombre comercial que verán tus clientes en el extracto bancario y seleccionas el modelo de tarifas (recuerda que existen planes según la frecuencia con que quieras recibir el dinero en tu cuenta, desde abono diario hasta semanal).
- Carga de documentos legales: subes el RUT, la cédula, la certificación bancaria y el certificado de Cámara de Comercio. El sistema valida que el NIT o cédula coincida exactamente en todos los archivos.
- Revisión de seguridad del sitio web: el equipo de riesgo de la pasarela entra a la URL de tu tienda para verificar que los productos sean lícitos, que los precios sean claros y que existan canales de atención al cliente.
- Habilitación del comercio: una vez aprobado (suele tardar entre 1 y 4 días hábiles), tu panel tendrá acceso tanto al ambiente de pruebas (Sandbox) como al ambiente de producción.
4. Cómo integrar Wompi en tu tienda paso a paso
Aquí es donde ocurren la mayoría de los errores cuando no hay acompañamiento técnico. Una integración completa no consiste en pegar un enlace de pago estático, porque con un enlace suelto tú no sabes qué productos compró cada persona ni en qué talla o color.
La integración profesional de carrito sigue cinco pasos técnicos:
Paso A: Obtener las llaves del ambiente de pruebas (Sandbox)
En el panel de desarrolladores de Wompi encontrarás cuatro credenciales de prueba (
1_test_- Llave pública (): identifica a tu comercio cuando se abre la ventana de pago en el navegador.
1pub_test_... - Llave privada (): se guarda en el servidor (nunca en el código público) para consultar transacciones desde el backend.
1prv_test_... - Secreto de integridad: clave oculta con la que tu servidor firma con SHA-256 la referencia del pedido, el monto en centavos y la moneda (), impidiendo que alguien altere el precio antes de pagar.
1COP - Secreto de eventos: sirve para verificar que los avisos de pago aprobado provienen realmente de Wompi.
Paso B: Generar la referencia única y la firma de integridad
Cada vez que un comprador hace clic en «Ir a pagar», tu tienda debe crear una orden con código único (por ejemplo,
1PED-2026-0048115000000Paso C: Desplegar el Widget o redirigir al Web Checkout
Con esos datos, tu página abre el Widget de Wompi o redirige al Web Checkout. El cliente elige si paga con Nequi, PSE, tarjeta o Botón Bancolombia, completa la autenticación bancaria y finaliza la operación.
Paso D: Configurar la URL de eventos (Webhook)
Muchos compradores cierran la pestaña apenas aprueban el pago en Nequi o PSE, sin esperar a volver a tu tienda. Si solo confirmas el pedido cuando el usuario regresa a la pantalla de agradecimiento, perderás el rastro de ventas ya cobradas.
Para evitarlo, configura en el panel de Wompi la URL de Eventos (Webhook): una dirección de tu servidor que recibe en segundo plano el aviso oficial
1transaction.updated1APPROVEDPaso E: Pruebas de aprobación, rechazo y paso a producción
En el modo Sandbox puedes simular todos los escenarios sin dinero real:
- Prueba un pago con PSE en estado aprobado y verifica que el pedido cambie de estado en tu panel.
- Prueba una transacción rechazada () o con error (
1DECLINED) y confirma que el inventario no se descuente y permita reintentar el pago.1ERROR - Cuando todo responda sin fallos, reemplaza las llaves por las de producción (
1_test_,1pub_prod_y sus secretos) y realiza una compra real de bajo monto para certificar el ciclo.1prv_prod_
Errores frecuentes al conectar Wompi y cómo evitarlos
En los proyectos de comercio electrónico que auditamos o reconstruimos en V1TR0, vemos repetirse cuatro fallas que frenan las ventas:
- No enviar el monto en centavos: enviar en lugar de
145000hace que la pasarela cobre $450 pesos o rechace la firma de integridad.14500000 - Reutilizar referencias de pago: Wompi exige que cada intento de cobro tenga una referencia única. Si un cliente falla en su primer intento con tarjeta y vuelve a intentar con PSE, tu tienda debe generar un sufijo o una nueva referencia vinculada al mismo pedido.
- Exponer el secreto de integridad en el navegador: si calculas la firma SHA-256 en el JavaScript público del navegador, cualquier persona con conocimientos básicos puede ver tu secreto y modificar precios. Ese cálculo siempre va en el servidor.
- Olvidar los pagos pendientes en efectivo o PSE: un pago por corresponsal bancario queda en estado hasta que la persona va al punto físico. Tu tienda debe reservar el inventario por un tiempo prudencial o avisar al comprador que el despacho se activa al confirmarse el recaudo.
1PENDING
Cuánto cuesta mantener y operar la tienda
Operar una tienda con Wompi tiene dos tipos de costos: la comisión por transacción exitosa (usualmente entre el 2,65 % y el 3,29 % más un fijo cercano a $700 u $800 COP más IVA por cobro aprobado, sin mensualidad fija en planes estándar) y la inversión en el desarrollo y alojamiento web. Si quieres revisar cuánto vale la construcción completa del sistema, consulta cuánto cuesta un software a medida en Colombia.
Si estás listo para lanzar tu canal de ventas propio con Wompi bien integrado desde el primer día, con control real de inventario, cálculo de envíos por ciudad y panel administrativo rápido, en V1TR0 diseñamos y programamos tu tienda lista para vender. Puedes cotizar tu tienda virtual o escribirnos directamente por Telegram a @V1tr0.
Preguntas frecuentes
¿Necesito tener cuenta en Bancolombia para usar Wompi en mi tienda virtual?
Sí. Wompi es la pasarela de pagos del Grupo Bancolombia y exige que la cuenta bancaria donde se deposita el dinero recaudado por tus ventas sea una cuenta de ahorros o corriente de Bancolombia a nombre del titular del comercio.
¿Puedo registrarme en Wompi como persona natural o necesito empresa constituida?
Puedes registrarte tanto como persona natural con RUT actualizado como con persona jurídica (SAS, Ltda. u otra sociedad) con certificado de existencia y representación legal de la Cámara de Comercio.
¿Cómo sabe mi tienda virtual que un cliente ya pagó en Wompi?
Mediante una notificación automática llamada webhook o URL de eventos. Cuando el banco aprueba la transacción, Wompi envía un mensaje cifrado a tu servidor para que el pedido pase a estado pagado y se descuente el inventario sin intervención manual.
¿Qué medios de pago habilita Wompi para mis compradores?
Permite cobrar con tarjetas de crédito y débito (Visa, Mastercard, American Express), PSE desde cualquier banco colombiano, botón directo de Nequi, Botón Bancolombia, pago en efectivo en corresponsales bancarios y cuotas con BNPL (compra ahora y paga después).