{"templateId":"markdown","versions":[{"version":"opendelivery","label":"Open Delivery API","link":"/en/apis/docs/development-guides/orders/webhook","default":true,"active":true,"folderId":"62a846bf"},{"version":"standard","label":"Standard Keeta API","link":"/en/apis/standard/docs/development-guides/orders/webhook","default":false,"active":false,"folderId":"62a846bf"},{"version":"grocery","label":"Grocery Keeta API","link":"/en/apis/grocery/docs/development-guides/orders/webhook","default":false,"active":false,"folderId":"62a846bf"}],"sharedDataIds":{"sidebar":"sidebar-@l10n/en/apis/@opendelivery/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Webhook"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"id":"webhook","level":1,"__idx":0},"children":["Webhook "]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Receiving events via Webhook works as follows:"]},{"$$mdtype":"Tag","name":"div","attributes":{"align":"center"},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"https://abrasel-nacional.github.io/opendelivery/images/webhook.png"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"order-event-notification","__idx":1},"children":["Order Event Notification"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["\n  Webhook is sent to notify the merchant ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Software Service"]}," that an new order event has happened on  ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Keeta"]},".\n"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The merchant ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Software Service"]}," that implements this webhook, should return an HTTP ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["200"]}," response code with an empty response body to acknowledge receipt of the webhook event."," ","If  ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Keeta"]}," does not receive a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["200"]}," acknowledgement response, than the webhook event will be resent based on  ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Keeta"]}," policies."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Keeta Webhook Retry Policy"]}," ","The Keeta webhook retry policy is designed to ensure reliable delivery of webhook events. If the merchant ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Software Service"]}," does not acknowledge receipt of a webhook event with a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["200"]}," response, Keeta will retry sending the event up to 3 times. The retries will occur at intervals of 1 minute, 2 minutes and finally 3 minutes. If the merchant ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Software Service"]}," still does not acknowledge the event after these retries, the event will be considered undelivered."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"webhook-headers","__idx":2},"children":["Webhook Headers"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Open Delivery"]}," will include security headers for all requests made to the merchant ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Software Service"]}," webhook URL."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Header Description"]}]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Header"},"children":["Header"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["X-App-Id"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["An Unique Identificator of  ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Keeta"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["X-App-MerchantId"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["An Unique Identificator of the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Merchant"]}," receiving the order"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["X-App-Signature"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["SHA256 hash of the request body, using the client secret as the key"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Webhook Security"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Webhook messages are signed so that the merchant Software Service can verify that the sender is a valid Keeta. Webhooks requests contain an X-App-Signature header."]}]},"headings":[{"value":"Webhook","id":"webhook","depth":1},{"value":"Order Event Notification","id":"order-event-notification","depth":2},{"value":"Webhook Headers","id":"webhook-headers","depth":2}],"frontmatter":{"slug":"/apis/opendelivery/development-guides/orders/webhook","seo":{"title":"Webhook"}},"lastModified":"2026-11-12T19:50:41.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/en/apis/opendelivery/development-guides/orders/webhook","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}