Docs / Webhooks

Sincronización confiable en tiempo real

Implementa verificación de firma HMAC, deduplicación e ingeniería de retries para mantener consistencia bajo carga.

Firmas y secretos Errores comunes

Firma HMAC

Header esperado: x-bridge-signature con hash SHA-256 del payload.

Idempotencia

Usa x-event-id para ignorar eventos repetidos en ventanas cortas.

Retries

Aplica exponential backoff con jitter para evitar tormentas de reintento.

Payload de ejemplo

{
  "event": "inventory.updated",
  "store_uuid": "store_abc123",
  "event_id": "evt_91fa",
  "occurred_at": "2026-02-28T20:10:00Z",
  "data": {
    "sku": "SKU-001",
    "stock": 10
  }
}

Respuesta recomendada

HTTP/1.1 202 Accepted
{
  "accepted": true,
  "event_id": "evt_91fa"
}

Si no puedes procesar en línea, encola y responde `202` para preservar disponibilidad.