Webhooks are a critical component of the payment process, serving as a real-time notification system for transaction outcomes. They provide immediate updates on payment statuses, allowing your application to respond promptly to successful, failed, or expired transactions.
Webhooks ensure that your system stays synchronized with the payment process, enabling you to take appropriate actions based on transaction results.
You have two options for configuring your webhook URL:
Per-Transaction Basis: Specify the callback_url parameter when creating a payment intent using either ExpressPay or Checkout.
ExpressPay
Set callback URL for ExpressPay transactions
Checkout
Configure callback URL for Checkout payments
Global Setting: Configure a default webhook URL in your Fenan Pay dashboard settings.
If you don’t specify a callback_url in your payment intent request, Fenan Pay will use the URL set in your dashboard settings. Ensure this URL is always up-to-date to avoid missing critical notifications.
By leveraging webhooks effectively, you can create a robust, responsive payment system that enhances the overall user experience and maintains data integrity across your application.
{"docsConfig":{"$schema":"https://mintlify.com/docs.json","theme":"mint","name":"FenanPay | Ethiopian payment gateway","colors":{"primary":"#6B3BFF","light":"#EEE9FB","dark":"#1A1D3E"},"favicon":"/fenan-favicon.svg","logo":{"light":"https://mintcdn.com/aquilaict/tBPG3wBNdA5C1BHy/logo/light.svg?fit=max\u0026auto=format\u0026n=tBPG3wBNdA5C1BHy\u0026q=85\u0026s=6e79226ef8e4afc381ab71ebfb00796e","dark":"https://mintcdn.com/aquilaict/tBPG3wBNdA5C1BHy/logo/dark.svg?fit=max\u0026auto=format\u0026n=tBPG3wBNdA5C1BHy\u0026q=85\u0026s=a84d2615ed93fd89e021717ce60c65c1"},"navbar":{"links":[{"label":"Support","href":"mailto:support@fenanpay.com"}],"primary":{"type":"button","label":"Dashboard","href":"https://dashboard.fenanpay.com"}},"footer":{"socials":{"x":"https://x.com/fenanapay","github":"https://github.com/fenanpay","linkedin":"https://www.linkedin.com/company/fenanpay"}},"navigation":{"global":{"anchors":[{"anchor":"Documentation","href":"https://docs.fenanpay.com/","icon":"book-open-cover"},{"anchor":"Community","href":"https://t.me/fenandev","icon":"slack"},{"anchor":"Website","href":"https://landing.fenanpay.com/","icon":"globe"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"aquilaict","hasAudioNarration":false,"actualSubdomain":"aquilaict","customDomains":["docs.fenanpay.com"],"gitSource":{"type":"github","owner":"aquilaict","repo":"fenanpay-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6a20c5c8fcd0b581d3e6a9dc","collectionId":"9a9c609c-acf9-4edc-99fd-2fd484f8a107","schemaVersion":"v2"},"entitlements":{},"buildId":"6a20c5c8fcd0b581d3e6a9dc:success","clientVersion":"0.0.4044","searchFilterCounts":[{"language":"default","tag":"Documentation","count":12},{"language":"default","tag":"API Reference","count":7},{"language":"default","tag":"Payment","count":4},{"language":"default","tag":"Webhook","count":4},{"language":"default","tag":"Production API","count":3},{"language":"default","tag":"Sandbox API","count":3},{"language":"default","tag":"Get Started","count":2},{"language":"default","tag":"Transaction","count":2},{"language":"default","tag":"API Documentation","count":1}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","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":"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":"llms-txt-v2","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":"byok-sep-25","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":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","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":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"webhook/overview","slug":"/webhook/overview","pageMetadata":{"title":"Webhook Overview","description":"How to handle webhooks the right way","href":"/webhook/overview"},"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: \"How to handle webhooks the right way\"\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={code:`code`,li:`li`,ol:`ol`,p:`p`,strong:`strong`,..._provideComponents(),...props.components},{Card,CardGroup,Frame,Heading,Note,OptimizedImage,Warning}=_components;if(!Card)_missingMdxReference(`Card`,true);if(!CardGroup)_missingMdxReference(`CardGroup`,true);if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Webhooks are a critical component of the payment process, serving as a real-time notification system for transaction outcomes. They provide immediate updates on payment statuses, allowing your application to respond promptly to successful, failed, or expired transactions.`}),`\n`,_jsx(Note,{children:_jsx(_components.p,{children:`Webhooks ensure that your system stays synchronized with the payment process, enabling you to take appropriate actions based on transaction results.`})}),`\n`,_jsx(Heading,{level:`2`,id:`setting-up-webhooks`,children:`Setting Up Webhooks`}),`\n`,_jsx(_components.p,{children:`You have two options for configuring your webhook URL:`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Per-Transaction Basis`}),`: Specify the `,_jsx(_components.code,{children:`callback_url`}),` parameter when creating a payment intent using either ExpressPay or Checkout.`]}),`\n`]}),`\n`,_jsxs(CardGroup,{cols:2,children:[_jsx(Card,{title:`ExpressPay`,icon:`bolt`,href:`/payment/expresspay`,children:_jsx(_components.p,{children:`Set callback URL for ExpressPay transactions`})}),_jsx(Card,{title:`Checkout`,icon:`cart-shopping`,href:`/payment/checkout`,children:_jsx(_components.p,{children:`Configure callback URL for Checkout payments`})})]}),`\n`,_jsxs(_components.ol,{start:`2`,children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Global Setting`}),`: Configure a default webhook URL in your Fenan Pay dashboard settings.`]}),`\n`]}),`\n`,_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/aquilaict/tBPG3wBNdA5C1BHy/images/webhook-setting-dashboard.png?fit=max\u0026auto=format\u0026n=tBPG3wBNdA5C1BHy\u0026q=85\u0026s=1a0086f1607730d5768167633907821b`,alt:`Webhook Settings in Dashboard`,\"data-og-width\":`3022`,width:`3022`,\"data-og-height\":`1616`,height:`1616`,\"data-path\":`images/webhook-setting-dashboard.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/aquilaict/tBPG3wBNdA5C1BHy/images/webhook-setting-dashboard.png?w=280\u0026fit=max\u0026auto=format\u0026n=tBPG3wBNdA5C1BHy\u0026q=85\u0026s=dd221dcb09370668ee4bd8c278ab0361 280w, https://mintcdn.com/aquilaict/tBPG3wBNdA5C1BHy/images/webhook-setting-dashboard.png?w=560\u0026fit=max\u0026auto=format\u0026n=tBPG3wBNdA5C1BHy\u0026q=85\u0026s=47c88eb3f66e2e3565ab2ad6f61859e6 560w, https://mintcdn.com/aquilaict/tBPG3wBNdA5C1BHy/images/webhook-setting-dashboard.png?w=840\u0026fit=max\u0026auto=format\u0026n=tBPG3wBNdA5C1BHy\u0026q=85\u0026s=d29aaacffa072e6be7c56542f0165062 840w, https://mintcdn.com/aquilaict/tBPG3wBNdA5C1BHy/images/webhook-setting-dashboard.png?w=1100\u0026fit=max\u0026auto=format\u0026n=tBPG3wBNdA5C1BHy\u0026q=85\u0026s=0265ace56e09ecc9195fcd62129cb0c9 1100w, https://mintcdn.com/aquilaict/tBPG3wBNdA5C1BHy/images/webhook-setting-dashboard.png?w=1650\u0026fit=max\u0026auto=format\u0026n=tBPG3wBNdA5C1BHy\u0026q=85\u0026s=7406b9d54bc8828be6d4df97a10335b0 1650w, https://mintcdn.com/aquilaict/tBPG3wBNdA5C1BHy/images/webhook-setting-dashboard.png?w=2500\u0026fit=max\u0026auto=format\u0026n=tBPG3wBNdA5C1BHy\u0026q=85\u0026s=5ecf8949e199541a222f5f7ff575171f 2500w`})}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`If you don’t specify a `,_jsx(_components.code,{children:`callback_url`}),` in your payment intent request, Fenan Pay will use the URL set in your dashboard settings. Ensure this URL is always up-to-date to avoid missing critical notifications.`]})}),`\n`,_jsx(_components.p,{children:`By leveraging webhooks effectively, you can create a robust, responsive payment system that enhances the overall user experience and maintains data integrity across your application.`})]})}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":"Webhook Overview","description":"How to handle webhooks the right way","href":"/webhook/overview"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Setting Up Webhooks","slug":"setting-up-webhooks","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"aquilaict","siteName":"FenanPay | Ethiopian payment gateway","title":"Webhook Overview - FenanPay | Ethiopian payment gateway","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-01-07T03:55:45.110Z","originalFileLocation":"webhook/overview.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=\"How to handle webhooks the right way\">\u003cmeta data-mint-head name=\"application-name\" content=\"FenanPay | Ethiopian payment gateway\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/aquilaict/-b8Mz1tyGbB4QR8O/_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/aquilaict/-b8Mz1tyGbB4QR8O/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/aquilaict/-b8Mz1tyGbB4QR8O/_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/aquilaict/-b8Mz1tyGbB4QR8O/_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/aquilaict/-b8Mz1tyGbB4QR8O/_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/aquilaict/-b8Mz1tyGbB4QR8O/_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/aquilaict/-b8Mz1tyGbB4QR8O/_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/aquilaict/-b8Mz1tyGbB4QR8O/_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/aquilaict/-b8Mz1tyGbB4QR8O/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Webhook Overview - FenanPay | Ethiopian payment gateway\">\u003cmeta data-mint-head property=\"og:description\" content=\"How to handle webhooks the right way\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"FenanPay | Ethiopian payment gateway\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.fenanpay.com/webhook/overview\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://aquilaict.mintlify.app/_mintlify/api/og/v2?division=Webhook\u0026amp;title=Webhook+Overview\u0026amp;description=How+to+handle+webhooks+the+right+way\u0026amp;theme=4dae9bb38e4af7104df8cb17\u0026amp;signature=37dc9aeec55e242927a95c123bfc14f5a2964ad845e1b32efc06f9d06b3cb0fb\">\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=\"Webhook Overview - FenanPay | Ethiopian payment gateway\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"How to handle webhooks the right way\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://aquilaict.mintlify.app/_mintlify/api/og/v2?division=Webhook\u0026amp;title=Webhook+Overview\u0026amp;description=How+to+handle+webhooks+the+right+way\u0026amp;theme=4dae9bb38e4af7104df8cb17\u0026amp;signature=37dc9aeec55e242927a95c123bfc14f5a2964ad845e1b32efc06f9d06b3cb0fb\">\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/aquilaict/-b8Mz1tyGbB4QR8O/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"FenanPay | Ethiopian payment gateway\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#6B3BFF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.fenanpay.com/webhook/overview\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/webhook/overview.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.fenanpay.com/#organization\",\"name\":\"FenanPay | Ethiopian payment gateway\",\"url\":\"https://docs.fenanpay.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/aquilaict/tBPG3wBNdA5C1BHy/logo/light.svg?fit=max\u0026auto=format\u0026n=tBPG3wBNdA5C1BHy\u0026q=85\u0026s=6e79226ef8e4afc381ab71ebfb00796e\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.fenanpay.com#website\",\"name\":\"FenanPay | Ethiopian payment gateway\",\"url\":\"https://docs.fenanpay.com\",\"publisher\":{\"@id\":\"https://docs.fenanpay.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.fenanpay.com/webhook/overview#webpage\",\"url\":\"https://docs.fenanpay.com/webhook/overview\",\"name\":\"Webhook Overview\",\"description\":\"How to handle webhooks the right way\",\"dateModified\":\"2026-01-07T03:55:45.110Z\",\"isPartOf\":{\"@id\":\"https://docs.fenanpay.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.fenanpay.com/webhook/overview#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.fenanpay.com/webhook/overview#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"FenanPay | Ethiopian payment gateway\",\"item\":\"https://docs.fenanpay.com\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Webhook Overview\",\"item\":\"https://docs.fenanpay.com/webhook/overview\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.fenanpay.com/webhook/overview#article\",\"headline\":\"Webhook Overview\",\"name\":\"Webhook Overview\",\"description\":\"How to handle webhooks the right way\",\"url\":\"https://docs.fenanpay.com/webhook/overview\",\"mainEntityOfPage\":{\"@id\":\"https://docs.fenanpay.com/webhook/overview#webpage\"},\"dateModified\":\"2026-01-07T03:55:45.110Z\",\"publisher\":{\"@id\":\"https://docs.fenanpay.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.fenanpay.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"FenanPay | Ethiopian payment gateway\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"FenanPay | Ethiopian payment gateway","nav":{"global":{"anchors":[{"anchor":"Documentation","href":"https://docs.fenanpay.com/","icon":"book-open-cover"},{"anchor":"Community","href":"https://t.me/fenandev","icon":"slack"},{"anchor":"Website","href":"https://landing.fenanpay.com/","icon":"globe"}]},"tabs":[{"tab":"Documentation","groups":[{"group":"Get Started","pages":[{"title":"Get Started","href":"/introduction"},{"title":"Quickstart","href":"/quickstart"}]},{"group":"Payment","pages":[{"title":"Payment Overview","href":"/payment/overview"},{"title":"API and Authentication","href":"/payment/apikey"},{"title":null,"href":"/payment/expresspay"},{"title":null,"description":null,"href":"/payment/checkout"}]},{"group":"Webhook","pages":[{"title":"Webhook Overview","href":"/webhook/overview"},{"title":"Handling Webhooks","description":"Learn how to securely process Fenan Pay webhook notifications","href":"/webhook/handling-webhook"},{"title":null,"href":"/webhook/verifying-webhook"},{"title":"Generate Key Pairs","href":"/webhook/generate-keys"}]},{"group":"Transaction","pages":[{"title":null,"href":"/transaction/single-payment-intent"},{"title":null,"href":"/transaction/payment-intent-object"}]}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/api-reference/introduction"}]}]},"basePath":"","title":"Webhook Overview - FenanPay | Ethiopian payment gateway","buildId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","deploymentId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","dynamics":["07c022d89b","a74be98ba7"],"chunks":["Frame-DXXFP6nH.js","DynamicMarkdown-B54_zNBF.js","zoom-image-lightbox-BG6oD64b.js","lightbox-handle-r17bVUz3.js"]}