Integración Wompi (Bancolombia) para pagos

Wompi es la pasarela oficial de Bancolombia. Te permite recibir pagos con:

• Tarjeta crédito/débito
• PSE
• Nequi
• Bancolombia Transfer

Credenciales

Necesitas 4 credenciales diferentes desde el dashboard de Wompi:

| Variable | Origen | |---|---| | WOMPI_PUBLIC_KEY | Pública, va en el frontend | | WOMPI_PRIVATE_KEY | Privada, solo backend | | WOMPI_INTEGRITY_SECRET | Para firmar la transacción | | WOMPI_EVENTS_SECRET | Para validar webhooks |

Firma de integridad

Wompi exige una firma SHA256 antes de redirigir al checkout:

signature = sha256(referencia + amount_in_cents + COP + integrity_secret)

El sistema la genera automáticamente.

Webhook

Configura en Wompi la URL: https://tu-sitio.com/webhooks/wompi. El sistema valida HMAC contra WOMPI_EVENTS_SECRET.

Estados

| Estado Wompi | Acción del sistema | |---|---| | APPROVED | Marca pago, factura y notifica | | DECLINED | Marca rechazo, notifica al cliente | | VOIDED | Reversa, restablece carrito |

Solo se aceptan pagos en COP (no USD).