Para qué sirve un webhook
Un webhook permite que tu sistema reciba notificaciones automáticas cuando ocurre un evento en MACHBANK.
Por ejemplo:
- Cuando un pago se completa
- Cuando un pago falla
- Cuando se realiza una devolución
Esto permite actualizar automáticamente el estado de tus pedidos o sistemas.
Qué necesitas antes de crear un webhook
Antes de configurar un webhook debes tener:
- Una API Key creada
- Una URL de tu sistema que recibirá las notificaciones.
👉🏼 Revisa: Cómo crear una API Key desde el Portal MACH
Cómo crear un webhook paso a paso
- Ingresa al Portal MACH Comercios
- Ve a Configuraciones
- Selecciona Para desarrolladores
- Haz clic en Webhooks
- Selecciona + Crear webhook
- Ingresa la URL donde recibirás los eventos
- Selecciona los eventos que quieres recibir
- Haz clic en Crear webhook
Ambientes de prueba y producción
Los webhooks dependen del ambiente en donde se crean:
Ambiente de prueba
- Se usa para testear integraciones.
- No genera pagos reales.
Ambiente productivo
- Se usa cuando tu integración está lista.
- Envía eventos de pagos reales.
Debes configurar webhooks en ambos ambientes si los utilizas.
Eventos disponibles en los webhooks
Eventos de pago
- Pago completado.
- Pago expirado.
- Pago fallido.
- Pago reservado.
Eventos de devolución
- Devolución completada.
- Devolución fallida.
Otros eventos disponibles
- Compensación iniciada.
- Cliente activado (no disponible actualmente)
- Cliente desactivado (no disponible actualmente)
¿Dónde obtengo la URL para el webhook?
La URL es proporcionada por el sistema dónde estás integrando MACH.
Por ejemplo:
- Tu backend.
- Tu plataforma de e-commerce.
- Tu middleware de pagos.
Más información técnica
👉 Para detalles avanzados revisa nuestra Documentación API MACHBANK
🆘 ¿Necesitas más ayuda?
Si tienes otras dudas, nuestro equipo de soporte está listo para ayudarte en: