Desarrolladores

Webhooks

El webhook handler debe ser seguro ante entregas repetidas y fallos temporales de sistemas downstream.

Resumen

Eventos de pago, fiscalización y conciliación con firmas, reintentos y manejo idempotente.

Manejo de eventos

Acepte el evento, verifique la firma, guarde el event id, responda rápido y mueva la lógica pesada a una cola.

Fallos

Si CRM o ERP no está disponible temporalmente, el evento no debe perderse: use retry y logs de errores de integración.

Cómo usar esta página

Webhooks ayuda a alinear el escenario de pago entre negocio, desarrollo y operaciones. Antes del lanzamiento conviene fijar el canal de venta, la ruta del proveedor, responsables de webhook, verificación de estado y soporte al cliente tras el pago.

FAQ

What must a webhook handler do before changing an order?

It must verify the signature, store the event id and payload, confirm that the event was not processed before and only then update orders, invoices, fiscal jobs or CRM status.

Why should heavy business logic go to a queue?

A webhook endpoint should respond quickly. A queue makes it possible to retry CRM, ERP, e-mail or fiscal actions after temporary failures without losing the event.