Download the PHP package igedeon/laravel-wompi without Composer
On this page you can find all versions of the php package igedeon/laravel-wompi. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package laravel-wompi
Wompi Laravel
Paquete Laravel para integrar Wompi Colombia en modalidad Web Checkout: links de pago, widget embebido, redirección, consulta de transacciones y webhooks con verificación de firma.
Requisitos
- PHP 8.4+
- Laravel 12+
Instalación
Publicar la configuración:
Configuración
Agrega las siguientes variables a tu archivo .env:
Para producción, cambia el ambiente y usa las llaves correspondientes:
Opciones adicionales
Uso
Links de pago
Crear un link de pago
Parámetros opcionales
Consultar un link de pago
Transacciones
Consultar una transacción
Estados de transacción
| Estado | Descripción | Final |
|---|---|---|
PENDING |
En proceso | No |
APPROVED |
Pago exitoso | Sí |
DECLINED |
Rechazada | Sí |
VOIDED |
Anulada | Sí |
ERROR |
Error interno | Sí |
Información del comercio
Widget de pago (Blade)
Incluye el widget de Wompi directamente en tus vistas Blade. La firma de integridad se genera automáticamente en el servidor.
Con datos del cliente y expiración
Formulario de redirección (Blade)
Si prefieres redirigir al usuario a la página de Wompi en lugar de usar el widget embebido:
Firma de integridad (manual)
Si necesitas generar la firma de integridad manualmente (por ejemplo, para una integración JavaScript personalizada):
Webhooks
El paquete registra automáticamente una ruta POST en /wompi/webhook (configurable) que:
- Verifica la firma SHA-256 del evento
- Despacha eventos de Laravel según el estado de la transacción
Configuración en Wompi
En el dashboard de Wompi, configura la URL de eventos apuntando a:
Escuchar eventos
Registra listeners en tu aplicación para reaccionar a los eventos:
Eventos disponibles
| Evento | Cuándo se dispara |
|---|---|
WompiWebhookReceived |
Siempre (para logging/auditoría) |
TransactionApproved |
Transacción aprobada |
TransactionDeclined |
Transacción rechazada |
TransactionVoided |
Transacción anulada |
TransactionError |
Error en la transacción |
Middleware adicional
Puedes agregar middleware adicional a la ruta del webhook vía configuración:
Personalización de vistas
Publica las vistas para personalizarlas:
Las vistas se copiarán a resources/views/vendor/wompi/.
Manejo de errores
El paquete lanza excepciones específicas:
Testing
Para usar en tus propios tests con Http::fake():
Licencia
MIT
All versions of laravel-wompi with dependencies
illuminate/contracts Version ^12.0 || ^13.0
illuminate/http Version ^12.0 || ^13.0
illuminate/support Version ^12.0 || ^13.0