Integración Wompi en tu Página Web: Guía Colombia 2026

Una integración Wompi bien ejecutada es, para muchos negocios colombianos, la mejor relación costo-conversión entre las pasarelas de pago disponibles. Wompi es el servicio de pagos del grupo Bancolombia, con comisiones competitivas, soporte local y cobertura de todos los métodos usados en el país. Esta guía explica cómo integrarla correctamente.

1. Tabla de contenidos

• Qué es Wompi
• Métodos de pago soportados
• Productos para integrar
• Proceso de integración
• Webhooks y validación
• Costos y comisiones
• Preguntas frecuentes

2. Qué es Wompi

Wompi es la plataforma de pagos del grupo Bancolombia, lanzada en 2020 con enfoque en comercios colombianos. Puedes revisar el contexto del grupo financiero en el artículo de Wikipedia sobre Bancolombia, que cubre la historia y operaciones del banco líder del país.

Ventajas:

• Respaldo bancario sólido
• Infraestructura Colombia con soporte local
• Comisiones competitivas
• PSE, Nequi, tarjetas, Bancolombia Botón
• API moderna y documentación clara
• Plataforma de pagos y de cobros recurrentes
• Integración nativa con Bancolombia para conciliación

3. Métodos de pago soportados

• Tarjetas de crédito y débito (Visa, Mastercard, Amex)
• PSE (débito directo de cuenta bancaria)
• Nequi
• Bancolombia Botón (transferencia directa)
• Corresponsales bancarios (efectivo)
• Cuotas diferidas con bancos aliados
• Daviplata (según plan)

✅ Checklist de integración correcta

• ✅ Cuenta Wompi activa y verificada
• ✅ API keys (test y live) en variables de entorno
• ✅ Firma de integridad configurada
• ✅ Widget de Wompi, Redirección o API según necesidad
• ✅ Webhook endpoint con HTTPS
• ✅ Validación de firma en webhook
• ✅ Manejo de todos los estados del pago
• ✅ Confirmación por correo al cliente
• ✅ Reportes de conciliación
• ✅ Cumplimiento PCI DSS (con SDK oficial)

4. Productos para integrar

Widget: JavaScript embebido en tu sitio. El usuario paga sin salir y tú no tocas datos de tarjeta.

Redirección: envías al usuario a la página de Wompi, vuelve tras pagar.

API REST: total flexibilidad, construyes tu propio checkout. Requiere PCI compliance.

Suscripciones: cobros recurrentes automáticos.

Links de pago: generas URL única para cobrar sin sitio web.

Checkout embebido: iframe dentro de tu sitio.

5. Proceso de integración

1. Crear cuenta Wompi y validar NIT/Cámara de Comercio
2. Verificar documentación (KYC empresarial)
3. Obtener llaves API (public, private, integridad, eventos)
4. Elegir producto (Widget, Redirección, API)
5. Implementar frontend: cargar el widget o redirigir
6. Implementar backend: crear transacción con monto y referencia única
7. Configurar webhook para recibir eventos
8. Validar firma del webhook con Hash SHA-256
9. Probar con tarjetas y cuentas de prueba
10. Pasar a producción tras validación QA

Ejemplo básico de uso del Widget en JavaScript:

```html

```

La firma de integridad se calcula con SHA-256 de `reference + amount + currency + secret`.

6. Webhooks y validación

Configuración esencial:

• Endpoint HTTPS con certificado válido
• Validación de firma SHA-256 con Llave de Eventos
• Respuesta 200 en menos de 10 segundos
• Idempotencia por `transaction.id`
• Logs completos para auditoría

```javascript

const crypto = require('crypto');

function validateSignature(body, signature, eventKey) {

const text = `${body.data.transaction.id}${body.data.transaction.status}${body.data.transaction.amount_in_cents}${body.timestamp}${eventKey}`;

const hash = crypto.createHash('sha256').update(text).digest('hex');

return hash === signature;

}

```

Estados posibles: `APPROVED`, `DECLINED`, `VOIDED`, `ERROR`, `PENDING`.

7. Costos y comisiones

Comisiones típicas 2026 (varían por volumen y método):

• Tarjetas: 3.49% + IVA + 700 COP por transacción
• PSE: 3.49% + IVA + 700 COP
• Nequi: 1.99% + IVA + 700 COP
• Bancolombia Botón: 1.19% + IVA
• Sin costos fijos mensuales en el plan base

Para volumen alto, se negocian tarifas reducidas.

8. Preguntas frecuentes

¿Necesito ser cliente Bancolombia para usar Wompi?

No. Wompi paga a cualquier cuenta bancaria colombiana.

¿Cuánto tarda recibir el dinero?

Mismo día o siguiente hábil según método y cuenta destino.

¿Maneja facturación electrónica?

Genera recibo propio. Para FE DIAN, integra con software contable colombiano.

¿Compatible con WooCommerce, Shopify, etc.?

Tiene plugins oficiales para WooCommerce, PrestaShop, Magento, Shopify y API para cualquier otro.

¿Cuánto tarda activar la cuenta?

3-10 días hábiles, dependiendo de validación de documentos.

9. Cuánto cuesta la integración

10. Conclusión: pasarela local con solidez bancaria

Wompi combina competitividad de comisiones con el respaldo de Bancolombia, lo que en 2026 la convierte en elección natural para muchos e-commerce y SaaS colombianos. Una integración bien hecha reduce fricción de pago y aumenta conversión sin complejidad excesiva.