¿Qué es un webhook?
Un webhook es un mensaje automatizado que se envía de un sistema o aplicación a otro cuando ocurre un evento, de esta forma se comunican. A nivel más técnico, un webhook es una llamada o una petición HTTP POST generada por la notificación de un evento. Estos entregan rapidez y eficiencia a tu conexión para pagos fáciles y rápidos.
MACH permite configurar webhook endpoints para notificar a una URL acerca de eventos que ocurren en su cuenta MACH para comercios, de está forma puedes ver tus transacciones y su estado en el portal MACH y en plataforma de e-commerce.
Por ejemplo, cuando un usuario autoriza una compra en tu e-commerce, creada con el conector de MACH a través de la API Key (Revisa aquí ¿Cómo crear una API Key?), MACH puede notificarle a una URL registrada la ocurrencia del evento, con su información correspondiente y este tendrá una respuesta de que fue recibida correctamente.
Si no hay respuesta del webhook estas son re-intentadas 2 veces más en intervalos de tiempo de 25 y 125 segundos respectivamente, para luego ser marcadas como fallidas.
|
Para crear un webhook
|
👉Esta configuración, al igual que las API Key (tokens de autenticación), es dependiente del ambiente en que se crean ya sea producción o Sandbox (Modo de prueba).
¿Qué es un evento de webhook?
Es data acerca de algo que ocurrió en un sistema. Esto se usa para identificar y poder por ejemplo, realizar automatizaciones que se gatillan a partir de este evento, en este caso, completar compras o realizar reembolsos.
Los posibles eventos de un webhook en tu cuenta MACH
- Pago completado: Cuando una compra ha sido exitosa
- Pago expirado: Cuando se intentó realizar la compra pero no se completó en el tiempo determinado
- Pago fallido: Cuando la compra no se realizó
- Pago reversado: Cuando la comunicación entre sistemas no se completa, se reversa el dinero al cliente, automaticamente.
- Reembolso completado: Cuando realizas un reembolso de una compra a tu cliente
Otros eventos
- Compensación iniciada: Cuando ha comenzado el proceso de compensación a tu cuenta (Este será necesario para comunicación sólo en algunos sistemas o plataformas)
- Cliente Activado: Para registrar los datos de tu cliente y realizar cobros recurrentes o suscripciones (esta función no se encuentra disponible en este momento)
- Cliente desactivado: Cuando desactivas un pago recurrente o suscripción (esta función no se encuentra disponible en este momento).
¿Dónde puedo encontrar la URL para crear mi webhook?
Este es un identificador creado por la plataforma en la cual se está integrando el medio de pago, podría ser también una IP y dependerá de cada sistema donde puedes encontrar la información.
Para más detalles de integración revisa nuestra Documentación de API MACH pinchando aquí.
En caso de dudas contáctanos en: