wompi/magento-payment

Wompi Colombia Web Checkout for Magento 2 (Plan Agregador and Gateway).

2.0.7 2026-06-17 23:35 UTC

Requires

• php: ^8.1 || ^8.2 || ^8.3 || ^8.4
• magento/framework: *
• magento/module-checkout: *
• magento/module-payment: *
• magento/module-sales: *
• magento/module-store: *

Requires (Dev)

• phpunit/phpunit: ^10.5 || ^11.0

OSL-3.0, AFL-3.0

• Wompi

README

Extensión oficial Wompi_Payment para Magento 2: integración con Wompi Colombia mediante Web Checkout (planes Agregador y Gateway).

Campo	Valor
Paquete Composer	wompi/magento-payment
Módulo Magento	Wompi_Payment
Namespace	Wompi\Payment\
Vendor	Wompi
Soporte	[e-mail]

Documentación completa en docs/README.md.

¿Qué hace?

1. Muestra Wompi como método de pago en checkout Luma.
2. Tras confirmar el pedido, redirige al cliente a Web Checkout (checkout.wompi.co).
3. Wompi notifica el resultado vía webhook (fuente de verdad) y retorno del navegador (callback).
4. Magento marca el pedido como Pagado y registra la captura sin falsos positivos de fraude en pagos offsite.

Instalación

composer require wompi/magento-payment
bin/magento module:enable Wompi_Payment
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:flush

Configuración

Admin: Stores → Configuration → Sales → Payment Methods → Wompi (Colombia)

• Plan Wompi: Agregador (recomendado) o Gateway
• Modo de prueba: alterna entre llaves sandbox y producción (ambas pueden guardarse a la vez)
• Webhook: registrar {base_url}wompi/payment/webhook en comercios.wompi.co

Rutas

Ruta	Uso
wompi/checkout/start	Redirect a Web Checkout
wompi/payment/callback	Retorno del navegador
wompi/payment/webhook	Eventos Wompi

Licencia

OSL-3.0 / AFL-3.0

Desarrollo

Todo archivo de texto del módulo (PHP, CSV, XML, Markdown, etc.) debe estar en UTF-8 sin BOM. Validar antes de commit o release:

bash dev/verify-utf8.sh