Point Shopify at your capture URL
1
Copy your capture URL
It is on Arrivals:
https://in.webhooktrap.dev/c/ followed by a 12-character key.2
Create the webhook
In the Shopify admin, open Settings › Notifications › Webhooks › Create webhook. Choose format JSON, set the URL to the capture URL, and pick API version 2025-10.
3
Trigger events
Use Send test on the webhook, or create a test order.
X-Shopify-Topic header, takes the event type from that header and the event id from X-Shopify-Webhook-Id, and groups events by order and product.
Configure the agent
webhooktrap.yml
secret, the agent looks for SHOPIFY_API_SECRET, the name in the Shopify pack.
Your signing secret stays on your machine.
webhooktrap.yml holds only the name of the environment variable (secret: env:NAME). The agent reads the value when it signs a delivery, strips every known secret variable from the environment of probe and reset commands, and refuses to write or upload a run document that contains the secret. The server learns the variable’s name, never its value.X-Shopify-Hmac-Sha256 still verify later. Without the secret the agent sends valid deliveries with the captured signature header; with it, it re-signs them.
What the scenarios do for Shopify
The 5 s budget comes from Shopify’s docs. A
budget: above it in webhooktrap.yml is refused as a configuration error.