Platform-specific integration
- WooCommerce
- BigCommerce
- Magento 2.x
- Custom storefront
Configure webhooks from WP Admin → WooCommerce → Settings → Advanced → Webhooks. Point each event at the droplinked WooCommerce ingestion endpoint and copy the shared HMAC secret you generated in Step 1 below.
WooCommerce uses a webhook secret in the URL signing scheme — droplinked’s WooCommerce adapter does HMAC-SHA256 validation parity on the raw body using the secret you provided at connect time. Format: JSON.
| WooCommerce topic | Destination |
|---|---|
product.created | https://apiv3.droplinked.com/v2/integrations/woo/webhook/product |
product.updated | https://apiv3.droplinked.com/v2/integrations/woo/webhook/product |
product.deleted | https://apiv3.droplinked.com/v2/integrations/woo/webhook/product |
order.created | https://apiv3.droplinked.com/v2/integrations/woo/webhook/order |
order.updated | https://apiv3.droplinked.com/v2/integrations/woo/webhook/order |
A dedicated WordPress plugin for one-click install is on the InventoryOS roadmap. Until then, the WP Admin webhook config above is the supported integration path.
What you need before connecting
Regardless of platform, the connect handshake gives you the three things every webhook receiver needs:- Your droplinked merchant ID — assigned at operator-onboarding time (
mch_…) - A shared HMAC secret — generated when you call
POST /admin/integrations/connectwith your origin platform domain + preferred shop-slug - Origin-platform webhook configuration access — admin rights on the origin platform to wire up the webhook endpoints above
Validation pattern
Droplinked validates each origin platform’s webhooks using the signing scheme that platform emits — the validation logic is per-adapter but the security posture is uniform:| Platform | Signing scheme | Validation |
|---|---|---|
| Shopify | SHA256 HMAC over raw body | X-Shopify-Hmac-Sha256 header vs computed HMAC |
| WooCommerce | SHA256 HMAC parity | X-WC-Webhook-Signature header vs computed HMAC |
| BigCommerce | Signed JWT payload | JWT signature verified against per-merchant signing key |
| Magento | RSA signature | Extension-emitted signature verified against per-merchant public key |
| Custom storefront | SHA256 HMAC over raw body | X-Droplinked-Hmac-Sha256 header vs computed HMAC |
401 Unauthorized — no partial state is written into InventoryOS.
What you gain — same as Shopify
The droplinked-side surfaces every connector unlocks are identical to what Shopify merchants get:- Agent-shoppable distribution via your per-merchant MCP at
mcp.droplinked.com/{shop-slug}/... - ACP feed inclusion at
apiv3.droplinked.com/feed/acp.json - Lender-routing eligibility via the LenderRegistry + recommendation endpoint
- Brand attestation (Schema A) — operator-gated, makes your brand cryptographically verifiable to agents and verifiers
- Built-in affiliate network with x402 settlement on the 70/20/10 split
- Cross-channel reconciliation if you connect more than one origin platform (see below)
Cross-channel posture
A merchant connecting both Shopify and WooCommerce — or BigCommerce + a custom Next.js site, or any other combination — gets a unified InventoryOS view: one normalized catalog, one repayment-history rollup, one lender-routing decision, one per-merchant MCP. The brand attestation is issued once and applies across every connected channel. See InventoryOS — cross-channel reconciliation for the architectural deep-dive on why we bridge channels rather than silo them.Related
- Connect your Shopify store — the live, fully-built reference adapter
- InventoryOS — the bridge layer every connector feeds into
- Trust fabric — Schema A/B/C/D attestation architecture
- For merchants — how droplinked composes with your existing commerce stack