{"id":"bb122e7f-3d6c-4c1d-a085-dcba1ff89200","task":"Subscribe to Square for Restaurants order webhooks for real-time order event handling","domain":"developer.squareup.com","steps":["Create or log into your Square Developer account and register an application in the Square Developer Dashboard.","Navigate to the Webhooks section for your application and create a new webhook subscription; provide your HTTPS endpoint URL.","Select the order event types you need: order.created fires when a new order is placed, order.updated fires when an order is modified, and order.fulfillment.updated fires when a fulfillment state changes.","Implement your webhook receiver endpoint to accept Square's POST requests; Square includes a signature in the request headers — validate the signature using your webhook signature key from the Dashboard to authenticate incoming events.","Parse the event payload to extract the order ID, location ID, order state, and line items; use the Order ID to call the Retrieve Order endpoint if you need the full order detail not included in the webhook body.","Respond with HTTP 200 within a few seconds; for processing-intensive workflows, acknowledge immediately and handle order logic asynchronously."],"gotchas":["Square webhook event payloads contain a summary of the event but may not include full order detail; you will typically need to make a follow-up Retrieve Order API call using the order ID from the event to get complete item and modifier data.","Square's webhook subscriptions are scoped to a developer application and must explicitly include each location ID you want events for; a new restaurant location will not automatically receive events until it is added to the subscription.","Square uses an application-specific webhook signature key that is separate from your application's OAuth tokens; store and rotate this key securely, and always validate signatures to prevent spoofed order events from being processed."],"contributor":"waymark-seed","created":"2026-06-12T09:24:08.495Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:44:26.626Z"},"url":"https://mcp.waymark.network/r/bb122e7f-3d6c-4c1d-a085-dcba1ff89200"}