SellAuth allows you to receive shop notifications via an HTTP webhook.
These notifications inform you about important events such as invoices, stock changes, feedback, tickets, and system errors.HTTP notifications are designed to be lightweight: only minimal data (usually IDs) is sent.
You are expected to fetch full details using the SellAuth API.
How It Works
An event occurs on your shop.
SellAuth sends a POST request to your configured webhook URL.
Your server validates the request signature.
You use the provided IDs to fetch full data via the API.
Each notification is sent as a single request per event.
Webhook Request
HTTP Details
Method:POST
Content-Type:application/json
Connect timeout: 5 seconds
Request timeout: 10 seconds
Retries: 3 total attempts
Retry interval: 5 seconds between each attempt
Redirects: not followed. A 3xx response is treated as a failed delivery.
SHOP_INVOICE_LATE_PAYMENT fires when a payment provider confirms money for an invoice that no longer accepts it. reason is closed (the invoice expired, was cancelled or failed), switched (the buyer moved to another payment method) or duplicate (the invoice was already paid). The payment is not credited and nothing is delivered until you resolve it from the dashboard or with the Resolve Late Payment endpoint.
Product & Stock Events
Event Name
Data
NOTIFICATION.SHOP_PRODUCT_OUT_OF_STOCK
product_id, variant_id
Feedback Events
Event Name
Data
NOTIFICATION.SHOP_FEEDBACK_RECEIVED
feedback_id
NOTIFICATION.SHOP_FEEDBACK_UPDATED
feedback_id
NOTIFICATION.SHOP_FEEDBACK_DISPUTE_ACCEPTED
feedback_id
NOTIFICATION.SHOP_FEEDBACK_DISPUTE_REJECTED
feedback_id
Dispute Events
Sent on the Scale plan only. See Disputes for what each stage, status and reason value means.
OPENED is sent each time a dispute needs a response, so a dispute that reaches pre-arbitration sends it again with a new stage and evidence_due_at. evidence_due_at is an ISO 8601 timestamp, or null when the processor gives no deadline. Fetch the full dispute with the Get Dispute endpoint.
Ticket Events
Event Name
Data
NOTIFICATION.SHOP_TICKET_CREATED
ticket_id
NOTIFICATION.SHOP_TICKET_MESSAGE
ticket_id, message_id
Subscription Events
Event Name
Data
NOTIFICATION.SHOP_SUBSCRIPTION_ENDING
plan_name, expires_at
System Events
Event Name
Data
NOTIFICATION.SHOP_ERROR
title, description
Error Handling
If your webhook fails, times out, or returns a non-200 status:
The notification will be retried automatically
Delivery errors may appear in your shop dashboard
Additional notification channels will be used if configured
Your webhook must return HTTP 200 to acknowledge successful receipt.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"SellAuth Documentation","description":"SellAuth documentation: platform guides, developer resources, and API reference.","colors":{"primary":"#6571ff","light":"#848dff","dark":"#4d59e8"},"logo":{"light":"https://mintcdn.com/sellauth/Dq1oE-lANJrfJFE8/logo/light.svg?fit=max\u0026auto=format\u0026n=Dq1oE-lANJrfJFE8\u0026q=85\u0026s=0f8409250ac15145849345e282eacf00","dark":"https://mintcdn.com/sellauth/Dq1oE-lANJrfJFE8/logo/dark.svg?fit=max\u0026auto=format\u0026n=Dq1oE-lANJrfJFE8\u0026q=85\u0026s=6e35657f61d1cb33ec6e139d9bb1beb2"},"favicon":"https://mintcdn.com/sellauth/XkxMYNi1n-nqK1r2/favicon.svg?fit=max\u0026auto=format\u0026n=XkxMYNi1n-nqK1r2\u0026q=85\u0026s=215235e796b64867d10c3e2e91fd069e","navbar":{"primary":{"type":"button","label":"Dashboard","href":"https://dash.sellauth.com"}},"footer":{"socials":{"discord":"https://discord.sellauth.com","telegram":"https://t.me/+fnqPXgnz0VA4ODRk"}},"fonts":{"family":"Geist"},"contextual":{"options":["copy","view","chatgpt","claude","cursor","vscode"],"display":"header"},"markdown":{"schema":false},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"sellauth","hasAudioNarration":false,"actualSubdomain":"sellauth","customDomains":["docs.sellauth.com"],"gitSource":{"type":"github","owner":"patriksh","repo":"sellauth-mintlify","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6af196e16ed814e4b8edde7e","clientVersion":"0.0.4167","searchFilterCounts":[{"language":"default","tag":"Endpoints","count":375},{"language":"default","tag":"API Reference","count":343},{"language":"default","tag":"Guides","count":54},{"language":"default","tag":"Products","count":50},{"language":"default","tag":"Customer API","count":28},{"language":"default","tag":"Invoices","count":26},{"language":"default","tag":"Payments","count":25},{"language":"default","tag":"Resellers","count":24},{"language":"default","tag":"Developers","count":16},{"language":"default","tag":"Disputes","count":15}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[],"page":{"pagePath":"developers/http-notifications","slug":"/developers/http-notifications","pageMetadata":{"title":"HTTP Notifications","description":"Receive shop notifications via HTTP webhooks.","icon":"webhook","href":"/developers/http-notifications"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Receive shop notifications via HTTP webhooks.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Tab,Table,Tabs,Tip,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Tab)_missingMdxReference(`Tab`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tabs)_missingMdxReference(`Tabs`,true);if(!Tip)_missingMdxReference(`Tip`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`2`,id:`overview`,children:`Overview`}),`\n`,_jsxs(_components.p,{children:[`SellAuth allows you to receive `,_jsx(_components.strong,{children:`shop notifications via an HTTP webhook`}),`.\nThese notifications inform you about important events such as invoices, stock changes, feedback, tickets, and system errors.`]}),`\n`,_jsxs(_components.p,{children:[`HTTP notifications are designed to be `,_jsx(_components.strong,{children:`lightweight`}),`: only minimal data (usually IDs) is sent.\nYou are expected to fetch full details using the SellAuth API.`]}),`\n`,_jsx(Heading,{level:`2`,id:`how-it-works`,children:`How It Works`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsx(_components.li,{children:`An event occurs on your shop.`}),`\n`,_jsxs(_components.li,{children:[`SellAuth sends a `,_jsx(_components.strong,{children:`POST request`}),` to your configured webhook URL.`]}),`\n`,_jsx(_components.li,{children:`Your server validates the request signature.`}),`\n`,_jsx(_components.li,{children:`You use the provided IDs to fetch full data via the API.`}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`Each notification is sent as a `,_jsx(_components.strong,{children:`single request per event`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`webhook-request`,children:`Webhook Request`}),`\n`,_jsx(Heading,{level:`3`,id:`http-details`,children:`HTTP Details`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Method:`}),` `,_jsx(_components.code,{children:`POST`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Content-Type:`}),` `,_jsx(_components.code,{children:`application/json`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Connect timeout:`}),` 5 seconds`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Request timeout:`}),` 10 seconds`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Retries:`}),` 3 total attempts`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Retry interval:`}),` 5 seconds between each attempt`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Redirects:`}),` not followed. A `,_jsx(_components.code,{children:`3xx`}),` response is treated as a failed delivery.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`example-request-body`,children:`Example Request Body`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`7`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`7`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"event\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"NOTIFICATION.SHOP_INVOICE_CREATED\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"data\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"invoice_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1218`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"shop_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`The `,_jsx(_components.code,{children:`data`}),` object usually contains `,_jsx(_components.strong,{children:`only IDs`}),` relevant to the event.`]}),`\n`,_jsx(Heading,{level:`2`,id:`signature-verification`,children:`Signature Verification`}),`\n`,_jsxs(_components.p,{children:[`HTTP notifications use the `,_jsx(_components.strong,{children:`same headers and signature logic`}),` as `,_jsx(_components.a,{href:`/developers/dynamic-delivery`,children:`Dynamic Delivery`}),` webhooks.`]}),`\n`,_jsx(Heading,{level:`3`,id:`headers`,children:`Headers`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`4`,language:`http`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`http`,children:_jsxs(_components.code,{language:`http`,numberOfLines:`4`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`Idempotency-Key`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` c47107fff54fd943db6939b9935af39a7753b7dc9a3bd227de71d032a725bb47`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`X-Timestamp`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 1769945465`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`X-Signature`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 9c64b5dcf02dfbe918357f4bf92731f28d7ba6988e9af3dec821840367f420fb`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`Content-Type`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` application/json`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`3`,id:`webhook-secret`,children:`Webhook Secret`}),`\n`,_jsxs(_components.p,{children:[`The webhook secret is listed per shop under `,_jsx(_components.strong,{children:`Developers > Overview`}),`: `,_jsx(_components.a,{href:`https://dash.sellauth.com/api`,children:`dash.sellauth.com/api`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`If the secret is not visible, click `,_jsx(_components.strong,{children:`Regenerate`}),` to create one.`]}),`\n`,_jsx(Heading,{level:`3`,id:`signature-logic`,children:`Signature Logic`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`5`,language:`php`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`php`,children:_jsxs(_components.code,{language:`php`,numberOfLines:`5`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`hash_hmac(`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'sha256'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` json_encode($requestData),`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` $webhookSecret`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})}),`\n`]})})}),`\n`,_jsxs(Tabs,{children:[_jsx(Tab,{title:`JavaScript`,id:`javascript`,children:_jsx(CodeBlock,{filename:``,numberOfLines:`12`,language:`javascript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`javascript`,children:_jsxs(_components.code,{language:`javascript`,numberOfLines:`12`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` crypto `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`from`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'crypto'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`;`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`const`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` payload = JSON.stringify(req.body);`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`const`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` signature = crypto`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` .createHmac(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'sha256'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, WEBHOOK_SECRET)`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` .update(payload)`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` .digest(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'hex'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`if`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` (signature !== req.headers[`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'x-signature'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`]) {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` throw`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` new`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` Error(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'Invalid signature'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})})}),_jsx(Tab,{title:`PHP`,id:`php`,children:_jsx(CodeBlock,{filename:``,numberOfLines:`7`,language:`php`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`php`,children:_jsxs(_components.code,{language:`php`,numberOfLines:`7`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`$payload = file_get_contents(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'php://input'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`$signature = hash_hmac(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'sha256'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, $payload, $webhookSecret);`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`if`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ($signature !== $_SERVER[`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'HTTP_X_SIGNATURE'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`]) {`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` http_response_code(401);`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` exit(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'Invalid signature'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})})}),_jsx(Tab,{title:`Python`,id:`python`,children:_jsx(CodeBlock,{filename:``,numberOfLines:`12`,language:`python`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`python`,children:_jsxs(_components.code,{language:`python`,numberOfLines:`12`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` hmac`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` hashlib`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`payload = request.get_data()`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`signature = hmac.new(`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` WEBHOOK_SECRET.encode(),`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` payload,`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` hashlib.sha256`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`).hexdigest()`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`if`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` signature != request.headers.get(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"X-Signature\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`):`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` raise`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` Exception(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Invalid signature\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})]}),`\n`]})})})})]}),`\n`,_jsx(Heading,{level:`2`,id:`fetching-full-data`,children:`Fetching Full Data`}),`\n`,_jsxs(_components.p,{children:[`Because notifications only contain IDs, you must retrieve the full data using the `,_jsx(_components.a,{href:`/api-reference/introduction`,children:`SellAuth API`}),`.`]}),`\n`,_jsx(Heading,{level:`3`,id:`example`,children:`Example`}),`\n`,_jsx(_components.p,{children:`If you receive:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`4`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`4`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"event\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"NOTIFICATION.SHOP_INVOICE_CREATED\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"data\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: { `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"invoice_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1218`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`You can fetch the invoice details using the `,_jsx(_components.a,{href:`/api-reference/invoices/get-invoice`,children:`Get Invoice endpoint`}),`.`]}),`\n`,_jsx(Tip,{children:`This design keeps notifications fast and reliable while giving you full control over what data you load.`}),`\n`,_jsx(Heading,{level:`2`,id:`event-types`,children:`Event Types`}),`\n`,_jsx(_components.p,{children:`Below is a list of all HTTP notification events and their payload structure.`}),`\n`,_jsx(Heading,{level:`3`,id:`invoice-events`,children:`Invoice Events`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Event Name`}),_jsx(_components.th,{children:`Data`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`NOTIFICATION.SHOP_INVOICE_CREATED`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`invoice_id`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`NOTIFICATION.SHOP_INVOICE_PROCESSED`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`invoice_id`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`NOTIFICATION.SHOP_INVOICE_CONFIRMING`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`invoice_id`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`NOTIFICATION.SHOP_INVOICE_LATE_PAYMENT`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`payment_id`}),`, `,_jsx(_components.code,{children:`invoice_id`}),`, `,_jsx(_components.code,{children:`reason`}),`, `,_jsx(_components.code,{children:`invoice_status`}),`, `,_jsx(_components.code,{children:`amount`}),`, `,_jsx(_components.code,{children:`currency`}),`, `,_jsx(_components.code,{children:`payment_method_id`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`NOTIFICATION.SHOP_INVOICE_OUT_OF_STOCK`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`invoice_id`})})]})]})]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`SHOP_INVOICE_LATE_PAYMENT`}),` fires when a payment provider confirms money for an invoice that no longer accepts it. `,_jsx(_components.code,{children:`reason`}),` is `,_jsx(_components.code,{children:`closed`}),` (the invoice expired, was cancelled or failed), `,_jsx(_components.code,{children:`switched`}),` (the buyer moved to another payment method) or `,_jsx(_components.code,{children:`duplicate`}),` (the invoice was already paid). The payment is not credited and nothing is delivered until you resolve it from the dashboard or with the Resolve Late Payment endpoint.`]}),`\n`,_jsx(Heading,{level:`3`,id:`product-\u0026-stock-events`,children:`Product \u0026 Stock Events`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Event Name`}),_jsx(_components.th,{children:`Data`})]})}),_jsx(_components.tbody,{children:_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`NOTIFICATION.SHOP_PRODUCT_OUT_OF_STOCK`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`product_id`}),`, `,_jsx(_components.code,{children:`variant_id`})]})]})})]}),`\n`,_jsx(Heading,{level:`3`,id:`feedback-events`,children:`Feedback Events`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Event Name`}),_jsx(_components.th,{children:`Data`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`NOTIFICATION.SHOP_FEEDBACK_RECEIVED`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`feedback_id`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`NOTIFICATION.SHOP_FEEDBACK_UPDATED`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`feedback_id`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`NOTIFICATION.SHOP_FEEDBACK_DISPUTE_ACCEPTED`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`feedback_id`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`NOTIFICATION.SHOP_FEEDBACK_DISPUTE_REJECTED`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`feedback_id`})})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`dispute-events`,children:`Dispute Events`}),`\n`,_jsxs(_components.p,{children:[`Sent on the Scale plan only. See `,_jsx(_components.a,{href:`/guides/disputes`,children:`Disputes`}),` for what each `,_jsx(_components.code,{children:`stage`}),`, `,_jsx(_components.code,{children:`status`}),` and `,_jsx(_components.code,{children:`reason`}),` value means.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Event Name`}),_jsx(_components.th,{children:`Data`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`NOTIFICATION.SHOP_PAYMENT_DISPUTE_OPENED`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`dispute_id`}),`, `,_jsx(_components.code,{children:`invoice_id`}),`, `,_jsx(_components.code,{children:`gateway`}),`, `,_jsx(_components.code,{children:`stage`}),`, `,_jsx(_components.code,{children:`status`}),`, `,_jsx(_components.code,{children:`reason`}),`, `,_jsx(_components.code,{children:`amount`}),`, `,_jsx(_components.code,{children:`currency`}),`, `,_jsx(_components.code,{children:`evidence_due_at`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`NOTIFICATION.SHOP_PAYMENT_DISPUTE_CLOSED`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`dispute_id`}),`, `,_jsx(_components.code,{children:`invoice_id`}),`, `,_jsx(_components.code,{children:`gateway`}),`, `,_jsx(_components.code,{children:`status`}),`, `,_jsx(_components.code,{children:`reason`}),`, `,_jsx(_components.code,{children:`amount`}),`, `,_jsx(_components.code,{children:`currency`})]})]})]})]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`OPENED`}),` is sent each time a dispute needs a response, so a dispute that reaches pre-arbitration sends it again with a new `,_jsx(_components.code,{children:`stage`}),` and `,_jsx(_components.code,{children:`evidence_due_at`}),`. `,_jsx(_components.code,{children:`evidence_due_at`}),` is an ISO 8601 timestamp, or `,_jsx(_components.code,{children:`null`}),` when the processor gives no deadline. Fetch the full dispute with the `,_jsx(_components.a,{href:`/api-reference/disputes/get-dispute`,children:`Get Dispute endpoint`}),`.`]}),`\n`,_jsx(Heading,{level:`3`,id:`ticket-events`,children:`Ticket Events`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Event Name`}),_jsx(_components.th,{children:`Data`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`NOTIFICATION.SHOP_TICKET_CREATED`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`ticket_id`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`NOTIFICATION.SHOP_TICKET_MESSAGE`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`ticket_id`}),`, `,_jsx(_components.code,{children:`message_id`})]})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`subscription-events`,children:`Subscription Events`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Event Name`}),_jsx(_components.th,{children:`Data`})]})}),_jsx(_components.tbody,{children:_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`NOTIFICATION.SHOP_SUBSCRIPTION_ENDING`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`plan_name`}),`, `,_jsx(_components.code,{children:`expires_at`})]})]})})]}),`\n`,_jsx(Heading,{level:`3`,id:`system-events`,children:`System Events`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Event Name`}),_jsx(_components.th,{children:`Data`})]})}),_jsx(_components.tbody,{children:_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`NOTIFICATION.SHOP_ERROR`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`title`}),`, `,_jsx(_components.code,{children:`description`})]})]})})]}),`\n`,_jsx(Heading,{level:`2`,id:`error-handling`,children:`Error Handling`}),`\n`,_jsxs(_components.p,{children:[`If your webhook fails, times out, or returns a non-`,_jsx(_components.code,{children:`200`}),` status:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`The notification will be retried automatically`}),`\n`,_jsx(_components.li,{children:`Delivery errors may appear in your shop dashboard`}),`\n`,_jsx(_components.li,{children:`Additional notification channels will be used if configured`}),`\n`]}),`\n`,_jsxs(Warning,{children:[`Your webhook `,_jsx(_components.strong,{children:`must return HTTP 200`}),` to acknowledge successful receipt.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"HTTP Notifications","description":"Receive shop notifications via HTTP webhooks.","icon":"webhook","href":"/developers/http-notifications"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Overview","slug":"overview","depth":2,"children":[]},{"title":"How It Works","slug":"how-it-works","depth":2,"children":[]},{"title":"Webhook Request","slug":"webhook-request","depth":2,"children":[{"title":"HTTP Details","slug":"http-details","depth":3,"children":[]},{"title":"Example Request Body","slug":"example-request-body","depth":3,"children":[]}]},{"title":"Signature Verification","slug":"signature-verification","depth":2,"children":[{"title":"Headers","slug":"headers","depth":3,"children":[]},{"title":"Webhook Secret","slug":"webhook-secret","depth":3,"children":[]},{"title":"Signature Logic","slug":"signature-logic","depth":3,"children":[]}]},{"title":"Fetching Full Data","slug":"fetching-full-data","depth":2,"children":[{"title":"Example","slug":"example","depth":3,"children":[]}]},{"title":"Event Types","slug":"event-types","depth":2,"children":[{"title":"Invoice Events","slug":"invoice-events","depth":3,"children":[]},{"title":"Product \u0026 Stock Events","slug":"product-\u0026-stock-events","depth":3,"children":[]},{"title":"Feedback Events","slug":"feedback-events","depth":3,"children":[]},{"title":"Dispute Events","slug":"dispute-events","depth":3,"children":[]},{"title":"Ticket Events","slug":"ticket-events","depth":3,"children":[]},{"title":"Subscription Events","slug":"subscription-events","depth":3,"children":[]},{"title":"System Events","slug":"system-events","depth":3,"children":[]}]},{"title":"Error Handling","slug":"error-handling","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/sellauth/5c630959ac3e379f/embed-demo.js"],"subdomain":"sellauth","siteName":"SellAuth Documentation","title":"HTTP Notifications - SellAuth Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-25T12:58:43.504Z","originalFileLocation":"developers/http-notifications.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Receive shop notifications via HTTP webhooks.\">\u003cmeta data-mint-head name=\"application-name\" content=\"SellAuth Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/sellauth/fvJIhSymQFoF7OCt/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/sellauth/fvJIhSymQFoF7OCt/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/sellauth/fvJIhSymQFoF7OCt/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/sellauth/fvJIhSymQFoF7OCt/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/sellauth/fvJIhSymQFoF7OCt/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/sellauth/fvJIhSymQFoF7OCt/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/sellauth/fvJIhSymQFoF7OCt/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/sellauth/fvJIhSymQFoF7OCt/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/sellauth/fvJIhSymQFoF7OCt/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"HTTP Notifications - SellAuth Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Receive shop notifications via HTTP webhooks.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"SellAuth Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.sellauth.com/developers/http-notifications\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://sellauth.mintlify.site/_mintlify/api/og/v2?division=Integrations\u0026amp;title=HTTP+Notifications\u0026amp;description=Receive+shop+notifications+via+HTTP+webhooks.\u0026amp;theme=2b4252450dadd9590f0d7594\u0026amp;signature=0da43d39f7abbb27e0e4db7038807f7b420ea41664007b19e8ae0f03c9f28ded\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"HTTP Notifications - SellAuth Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Receive shop notifications via HTTP webhooks.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://sellauth.mintlify.site/_mintlify/api/og/v2?division=Integrations\u0026amp;title=HTTP+Notifications\u0026amp;description=Receive+shop+notifications+via+HTTP+webhooks.\u0026amp;theme=2b4252450dadd9590f0d7594\u0026amp;signature=0da43d39f7abbb27e0e4db7038807f7b420ea41664007b19e8ae0f03c9f28ded\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/sellauth/fvJIhSymQFoF7OCt/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"SellAuth Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#6571ff\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.sellauth.com/developers/http-notifications\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/developers/http-notifications.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.sellauth.com/#organization\",\"name\":\"SellAuth Documentation\",\"url\":\"https://docs.sellauth.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/sellauth/Dq1oE-lANJrfJFE8/logo/light.svg?fit=max\u0026auto=format\u0026n=Dq1oE-lANJrfJFE8\u0026q=85\u0026s=0f8409250ac15145849345e282eacf00\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.sellauth.com#website\",\"name\":\"SellAuth Documentation\",\"url\":\"https://docs.sellauth.com\",\"publisher\":{\"@id\":\"https://docs.sellauth.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.sellauth.com/developers/http-notifications#webpage\",\"url\":\"https://docs.sellauth.com/developers/http-notifications\",\"name\":\"HTTP Notifications\",\"description\":\"Receive shop notifications via HTTP webhooks.\",\"dateModified\":\"2026-10-25T12:58:43.504Z\",\"isPartOf\":{\"@id\":\"https://docs.sellauth.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.sellauth.com/developers/http-notifications#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.sellauth.com/developers/http-notifications#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Integrations\",\"item\":\"https://docs.sellauth.com/developers/dynamic-delivery\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"HTTP Notifications\",\"item\":\"https://docs.sellauth.com/developers/http-notifications\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.sellauth.com/developers/http-notifications#article\",\"headline\":\"HTTP Notifications\",\"name\":\"HTTP Notifications\",\"description\":\"Receive shop notifications via HTTP webhooks.\",\"url\":\"https://docs.sellauth.com/developers/http-notifications\",\"mainEntityOfPage\":{\"@id\":\"https://docs.sellauth.com/developers/http-notifications#webpage\"},\"dateModified\":\"2026-10-25T12:58:43.504Z\",\"publisher\":{\"@id\":\"https://docs.sellauth.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.sellauth.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"SellAuth Documentation\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"SellAuth Documentation\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/developers/http-notifications.md","siteName":"SellAuth Documentation","nav":{"global":null,"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":""}]},{"tab":"Developers","groups":[{"group":"Storefront","pages":[{"title":"Checkout Links","icon":"link","href":"/developers/checkout-links"},{"title":"Checkout Embed","icon":"window","href":"/developers/embed"},{"title":"Checkout API","icon":"server","href":"/developers/checkout-api"}]},{"group":"Integrations","pages":[{"title":"Dynamic Delivery","description":"Automatically deliver product content using a secure webhook integration.","icon":"bolt","href":"/developers/dynamic-delivery"},{"title":"HTTP Notifications","icon":"webhook","href":"/developers/http-notifications"}]},{"group":"Theming","pages":[{"title":"Themes Overview","description":"How SellAuth storefront themes work, how they are rendered, and how to edit them.","icon":"palette","href":"/developers/themes"},{"title":"Theme Quickstart","icon":"rocket","href":"/developers/theme-quickstart"},{"title":"Theme CLI","icon":"terminal","href":"/developers/theme-cli"},{"title":"Theme Structure","icon":"folder-tree","href":"/developers/theme-structure"},{"title":"Theme Settings and Schema","sidebarTitle":"Settings and Schema","icon":"sliders","href":"/developers/theme-settings"},{"title":"Nunjucks Templating","icon":"code","href":"/developers/nunjucks"},{"title":"Theme Filters and Globals","sidebarTitle":"Filters and Globals","icon":"filter","href":"/developers/theme-filters"},{"title":"Theme Template Variables","sidebarTitle":"Template Variables","icon":"table-list","href":"/developers/theme-variables"},{"title":"Theme Assets and Styling","sidebarTitle":"Assets and Styling","icon":"paintbrush","href":"/developers/theme-assets"},{"title":"Email Templates","icon":"envelope-open-text","href":"/developers/email-templates"}]},{"group":"Localization","pages":[{"title":"Translations (i18n)","icon":"language","href":"/developers/translations"}]}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/api-reference/introduction"}]},{"tab":"Resellers","pages":[{"title":"Resellers","href":"/resellers/overview"}]},{"tab":"Customer API","pages":[{"title":"Customer API","href":"/customer-api/introduction"}]}]},"basePath":"","title":"HTTP Notifications - SellAuth Documentation","buildId":"dpl_9RFrWkXdFTJCytfx6jAofvAaEXr6","deploymentId":"dpl_9RFrWkXdFTJCytfx6jAofvAaEXr6","dynamics":[],"chunks":[]}