Docs/Integrations

Real-Time Webhooks

Webhooks are the primary mechanism for real-time sync between WooCommerce and Fulfiro.

Registered webhook topics

  • product.created -- New product added in WooCommerce
  • product.updated -- Product details changed
  • product.deleted -- Product deleted
  • product.restored -- Product restored from trash
  • order.created -- New order placed
  • order.updated -- Order status or details changed

Security

Each webhook is verified using HMAC-SHA256 signature verification. Fulfiro generates a secret when registering webhooks and verifies the X-WC-Webhook-Signature header on every incoming request. See Sync Architecture for details.

Processing

Webhooks are processed asynchronously. The endpoint accepts the payload quickly (returns 200), then a background worker handles the actual data processing. This prevents slow processing from causing WooCommerce timeouts. See Sync Architecture.

Deduplication

The same webhook can arrive multiple times (WooCommerce retries on timeout). Fulfiro deduplicates using a two-layer system. See Idempotency and Deduplication.

Not receiving webhooks? See Webhooks Not Firing.