Un webhook es un aviso automático que Conekta envía a tu sistema en el momento en que algo relevante sucede en tu cuenta. En lugar de que tu sitio pregunte una y otra vez "¿ya pagaron?", Conekta le avisa en cuanto ocurre.
Por qué es importante
Muchos pagos no se confirman al instante: una transferencia SPEI puede llegar horas después y un pago en efectivo, días después de generar la referencia. El webhook es lo que permite que tu tienda marque el pedido como pagado en cuanto el dinero llega, sin que nadie esté vigilando el Panel.
Cómo funciona
- Tu desarrollador registra una URL de tu sistema como destino de notificaciones.
- Cuando ocurre un evento — un pago se acredita, un reembolso procede, un contracargo llega — Conekta envía a esa URL un mensaje con los datos del evento.
- Tu sistema recibe el mensaje y reacciona: actualiza el pedido, notifica al cliente o registra el movimiento.
- Si tu sistema no responde, Conekta reintenta el envío durante un tiempo para no perder el aviso.
Ejemplo
Un cliente paga en efectivo con una referencia. Dos días después acude a la tienda y paga. En ese momento Conekta dispara el evento de pago acreditado hacia tu sistema, tu tienda marca el pedido como pagado y el cliente recibe su confirmación — sin intervención manual.
Qué te toca hacer
Si tienes integración propia o un plugin, pide a tu desarrollador configurar los webhooks siguiendo la guía técnica de developers.conekta.com. Para entender cuándo valen la pena, sigue con Por qué necesito webhooks si ya puedo consultar el Panel.