Webhooks

Webhooks

Los Webhooks permiten a la plataforma notificar a servicios externos cuando ocurren eventos importantes — no se requiere polling.

Eventos Soportados

• order.created — Se realiza un nuevo pedido
• order.status_changed — El estado del pedido se actualiza
• order.paid — Pago confirmado
• order.shipped — Pedido enviado con seguimiento
• order.refunded — Reembolso emitido
• customer.registered — Nueva cuenta de cliente creada
• license.activated — Se activa una clave de licencia en un dominio
• license.deactivated — Se elimina un dominio de una licencia
• inventory.low_stock — Una variante de producto cae por debajo del punto de reorden

Configurando Webhooks

1. Ir a Configuración → Webhooks → Agregar Endpoint
2. Ingresa la URL del receptor (debe ser HTTPS)
3. Selecciona los eventos a los que suscribirte
4. Opcionalmente, establece un secreto para la verificación de la firma del payload
5. Guardar

Verificación de Firma

Cada payload de webhook está firmado con HMAC-SHA256 usando tu secreto. Verifica el X-Webhook-Signature header para asegurar que la solicitud proviene de tu tienda.