How FYATU tells your server that something happened: subscribing, verifying the signature, answering, retries, and handling an event more than once.
Most of what matters happens after your request returns: a card finishes provisioning, a funding is
confirmed, a cardholder is verified, a purchase is approved. A webhook is how you hear about it:
FYATU sends an HTTPS POST to your server for every event you subscribed to.Build on webhooks rather than polling: polling spends your rate limit,
and a webhook reaches you as soon as the event happens.
Subscribing
Register an endpoint with the events it should receive:
The response carries the endpoint’s signing secret, shown once. Store it now.
A live endpoint must use https://, and it cannot point at a private or internal address.
Up to 10 endpoints per business. One endpoint may take every event.
An endpoint receives the events of its own environment: sandbox events go to sandbox endpoints.
GET /event-types returns every event you can subscribe to, and the
event list describes each one; every event also has its own
page under Webhooks.
Manage endpoints with GET, PATCH
and DELETE /webhooks/{id}. Sending a test event, resending a
delivery, rotating the secret and reading the delivery history are in the CaaS portal under
Developers → Webhooks.
event names the event and data carries its details; each event’s page documents its data.
Verifying the signature
Every delivery is signed with your endpoint’s secret, so you can prove it came from FYATU and was not
altered. Verify it on the raw request body, before parsing it, and reject anything that fails:
Read t and v1 from X-Fyatu-Signature.
Derive the signing key: the SHA-256 hex digest of your secret.
Compute HMAC-SHA256 of "{t}.{raw body}" with that key, and compare it with v1 in constant time.
Reject a t more than a few minutes old, so an intercepted delivery cannot be replayed later.
Answer 2xx within 30 seconds. Anything else counts as a failure.
Answer first, then do the work: store the event and process it in the background, so a slow
database or a third-party call never makes you miss the deadline.
The response body is ignored.
Retries
A delivery your endpoint answers with a non-2xx status is tried 5 times in all: at once, then
after 15 seconds, 2 minutes, 15 minutes and 1 hour.A delivery that gets no answer at all — your endpoint refuses the connection, its host name does not
resolve, or it does not answer within 30 seconds — is retried on the same schedule. The delivery log
in Developers → Webhooks shows why each attempt failed, and anything that ran out of attempts can
be resent from there.
An endpoint on a private or internal address (loopback, private ranges, link-local, cloud
metadata) is refused when you save it, with 422 WEBHOOK_URL_BLOCKED, and is never delivered to.
Handling an event twice, or out of order
Delivery is at least once. The same event can arrive more than once, for example when we retry
after your server processed it but answered late, or when a delivery is resent.
Deduplicate on X-Fyatu-Event-ID (the eventId in the body). It is the same on every retry and
resend of one event; X-Fyatu-Delivery changes with each attempt.
Do not rely on order. A CARD_FUNDED can arrive before the CARD_ISSUED it follows. Treat each
event as “this happened”, and read the resource with the API when you need its current state.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"FYATU API Docs","colors":{"primary":"#721D5D","light":"#D877C7","dark":"#721D5D"},"logo":{"light":"https://mintcdn.com/fyatu/1Y4pa7wxF_kMnOCq/logo/light.png?fit=max\u0026auto=format\u0026n=1Y4pa7wxF_kMnOCq\u0026q=85\u0026s=da06db892390b1d64a6da61ed20cf95e","dark":"https://mintcdn.com/fyatu/1Y4pa7wxF_kMnOCq/logo/dark.png?fit=max\u0026auto=format\u0026n=1Y4pa7wxF_kMnOCq\u0026q=85\u0026s=4699a651f759eba858eeebf169065ec2"},"favicon":"https://mintcdn.com/fyatu/bV6pmu3sbyQM-yrA/favicon.png?fit=max\u0026auto=format\u0026n=bV6pmu3sbyQM-yrA\u0026q=85\u0026s=8da36463646e8abbfbdff7ecb626062a","api":{"playground":{}},"navbar":{"primary":{"type":"button","label":"Get API Keys","href":"https://platform.fyatu.com/developers/api-keys"}},"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/fyatu","x":"https://x.com/fyatucard","instagram":"https://www.instagram.com/fyatucard","facebook":"https://www.facebook.com/fyatucard","youtube":"https://www.youtube.com/@fyatu","telegram":"https://t.me/fyatupay"},"links":[{"header":"Products","items":[{"label":"Card Issuing","href":"https://fyatu.com/card-issuing"},{"label":"Virtual Cards","href":"https://fyatu.com/virtual-cards"},{"label":"Credit Cards","href":"https://fyatu.com/credit-cards"},{"label":"Digital Wallet","href":"https://fyatu.com/digital-wallet-cards"},{"label":"Prepaid Cards","href":"https://fyatu.com/prepaid-cards"},{"label":"One Time Card","href":"https://fyatu.com/one-time-card"}]},{"header":"Coverage","items":[{"label":"Africa","href":"https://fyatu.com/region/africa"},{"label":"Eastern Europe","href":"https://fyatu.com/region/eastern-europe"},{"label":"Latin America","href":"https://fyatu.com/region/latin-america"},{"label":"Middle East","href":"https://fyatu.com/region/middle-east"}]},{"header":"Company","items":[{"label":"Contact","href":"https://fyatu.com/contact"},{"label":"Security","href":"https://fyatu.com/security"},{"label":"Terms of Service","href":"https://fyatu.com/terms"},{"label":"Refund Policy","href":"https://fyatu.com/refund-policy"}]},{"header":"Tools","items":[{"label":"BIN Checker","href":"https://fyatu.com/tools/bin-checker"},{"label":"Bank Directory","href":"https://fyatu.com/banks"},{"label":"Country Data","href":"https://fyatu.com/countries"},{"label":"Decline Codes","href":"https://fyatu.com/tools/decline-codes"}]}]},"search":{"prompt":"Search FYATU API docs..."},"seo":{"metatags":{"og:site_name":"Fyatu API Documentation — Card Issuing API","og:type":"website","og:locale":"en_US","twitter:card":"summary_large_image","twitter:site":"@fyatu","robots":"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1","googlebot":"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1","keywords":"card issuing API, virtual card API, Mastercard API, Visa API, prepaid card issuing, 3D Secure cards, Apple Pay API, Google Pay API, fintech API Africa, payment API, payout API, webhook API, REST API card issuing, programmatic card issuing, virtual debit card API, card program API, mobile money API, payment gateway Africa"}},"metadata":{"timestamp":false},"styling":{"latex":true},"navigation":{"global":{"anchors":[{"anchor":"Website","icon":"globe","href":"https://fyatu.com"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"fyatu","hasAudioNarration":false,"actualSubdomain":"fyatu","customDomains":["docs.fyatu.com"],"gitSource":{"type":"github","owner":"fyatu","repo":"api-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6b00b00e964ab5c3f5ff2960","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"Webhooks","count":77},{"language":"default","tag":"API Reference","count":72},{"language":"default","tag":"Cards","count":61},{"language":"default","tag":"Documentation","count":22},{"language":"default","tag":"Cardholders","count":19},{"language":"default","tag":"Card Events","count":15},{"language":"default","tag":"Account","count":14},{"language":"default","tag":"Cardholder Events","count":10},{"language":"default","tag":"Getting Started","count":9},{"language":"default","tag":"Concepts","count":6}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"@font-face{font-family:'Clash Grotesk';src:url('/fonts/ClashGrotesk-Variable.woff2') format('woff2');font-weight:200 700;font-style:normal;font-display:swap}#footer[data-fyatu-footer]{--ff-bg:#f9fafb;--ff-head:#111827;--ff-link:#4b5563;--ff-link-hover:#721D5D;--ff-line:rgba(17,24,39,.10);--ff-soft-line:rgba(17,24,39,.08);--ff-icon:#6b7280;--ff-icon-hover:#721D5D;--ff-muted:#6b7280;--ff-legal-sep:#d1d5db;--ff-legal-under:#d1d5db;--ff-legal-hover:#111827;--ff-fine:#6b7280}html.dark #footer[data-fyatu-footer]{--ff-bg:#111827;--ff-head:#fff;--ff-link:#9ca3af;--ff-link-hover:#fff;--ff-line:rgba(255,255,255,.10);--ff-soft-line:rgba(255,255,255,.08);--ff-icon:#6b7280;--ff-icon-hover:#fff;--ff-muted:#6b7280;--ff-legal-sep:#374151;--ff-legal-under:#4b5563;--ff-legal-hover:#d1d5db;--ff-fine:#4b5563}#footer[data-fyatu-footer]{background:var(--ff-bg)!important;border-top:1px solid var(--ff-line)!important;max-width:none!important;width:100%!important;margin:0!important;padding:0!important;display:block!important}[data-fyatu-footer] *{box-sizing:border-box}[data-fyatu-footer] .ff-wrap{max-width:1440px;margin:0 auto;padding:0 16px}@media (min-width:640px){[data-fyatu-footer] .ff-wrap{padding:0 24px}}@media (min-width:1024px){[data-fyatu-footer] .ff-wrap{padding:0 40px}}[data-fyatu-footer] h3{margin:0 0 20px;font-size:16px;line-height:24px;font-weight:700;color:var(--ff-head)}[data-fyatu-footer] a{color:var(--ff-link);font-size:16px;line-height:1.375;font-weight:600;text-decoration:none;transition:color .15s}[data-fyatu-footer] a:hover{color:var(--ff-link-hover)}[data-fyatu-footer] ul{list-style:none;margin:0;padding:0;display:flex;flex-direction:column;gap:10px}[data-fyatu-footer] li{margin:0;padding:0}[data-fyatu-footer] .ff-nav{padding:56px 0 32px;display:flex;flex-direction:column;gap:32px}[data-fyatu-footer] .ff-products{padding-bottom:32px;border-bottom:1px solid var(--ff-line)}[data-fyatu-footer] .ff-grid2{display:grid;grid-template-columns:1fr 1fr;gap:10px 24px}[data-fyatu-footer] .ff-cols{display:grid;grid-template-columns:1fr 1fr;gap:32px}@media (min-width:640px){[data-fyatu-footer] .ff-cols{grid-template-columns:repeat(3,1fr);gap:40px}}@media (min-width:1024px){[data-fyatu-footer] .ff-nav{flex-direction:row;gap:0}[data-fyatu-footer] .ff-products{width:38%;padding:0 48px 0 0;border-bottom:0;border-right:1px solid var(--ff-line)}[data-fyatu-footer] .ff-cols{width:62%;padding-left:48px;gap:0}[data-fyatu-footer] .ff-col{padding:0 16px}[data-fyatu-footer] .ff-col:first-child{padding:0 32px 0 0}[data-fyatu-footer] .ff-col:last-child{padding:0 0 0 32px}}[data-fyatu-footer] .ff-social{display:flex;align-items:center;gap:20px;padding:32px 0 24px}[data-fyatu-footer] .ff-social>span{flex:1;height:1px;background:var(--ff-soft-line)}[data-fyatu-footer] .ff-social>div{display:flex;align-items:center;gap:16px}[data-fyatu-footer] .ff-social a{color:var(--ff-icon);display:inline-flex}[data-fyatu-footer] .ff-social a:hover{color:var(--ff-icon-hover)}[data-fyatu-footer] .ff-social svg{width:24px;height:24px}@media (min-width:640px){[data-fyatu-footer] .ff-social>div{gap:32px}[data-fyatu-footer] .ff-social svg{width:32px;height:32px}}[data-fyatu-footer] .ff-base{display:flex;flex-direction:column;align-items:center;gap:12px;padding-bottom:24px}[data-fyatu-footer] .ff-base img{height:64px;width:auto;opacity:.7;margin:0!important}[data-fyatu-footer] .ff-base p{margin:0;font-size:14px;color:var(--ff-muted)}[data-fyatu-footer] .ff-legal{display:flex;flex-wrap:wrap;justify-content:center;row-gap:8px;margin-top:12px}[data-fyatu-footer] .ff-legal a{font-size:14px;font-weight:400;color:var(--ff-muted);text-decoration:underline;text-underline-offset:2px;text-decoration-color:var(--ff-legal-under)}[data-fyatu-footer] .ff-legal a:hover{color:var(--ff-legal-hover)}[data-fyatu-footer] .ff-legal a:not(:last-child)::after{content:'|';margin:0 12px;color:var(--ff-legal-sep);display:inline-block;text-decoration:none}[data-fyatu-footer] .ff-disclosure{border-top:1px solid var(--ff-soft-line);padding:24px 0}[data-fyatu-footer] .ff-disclosure p{max-width:768px;margin:0 auto 8px;text-align:center;font-size:14px;line-height:1.625;color:var(--ff-fine)}[data-fyatu-footer] .ff-disclosure p:last-child{margin-bottom:0}[data-fyatu-footer] .ff-logo-dark{display:none}html.dark [data-fyatu-footer] .ff-logo-dark{display:inline}html.dark [data-fyatu-footer] .ff-logo-light{display:none}[data-fyatu-footer] .ff-base img.ff-logo-light{opacity:1}"}]}
{"page":{"pagePath":"v3.20/documentation/concepts/webhooks","slug":"/v3.20/documentation/concepts/webhooks","pageMetadata":{"title":"Webhooks","description":"How FYATU tells your server that something happened: subscribing, verifying the signature, answering, retries, and handling an event more than once.","href":"/v3.20/documentation/concepts/webhooks"},"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 FYATU tells your server that something happened: subscribing, verifying the signature, answering, retries, and handling an event more than once.\"\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,Table,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Most of what matters happens after your request returns: a card finishes provisioning, a funding is\nconfirmed, a cardholder is verified, a purchase is approved. A `,_jsx(_components.strong,{children:`webhook`}),` is how you hear about it:\nFYATU sends an HTTPS `,_jsx(_components.code,{children:`POST`}),` to your server for every event you subscribed to.`]}),`\n`,_jsxs(_components.p,{children:[`Build on webhooks rather than polling: polling spends your `,_jsx(_components.a,{href:`/v3.20/documentation/rate-limits`,children:`rate limit`}),`,\nand a webhook reaches you as soon as the event happens.`]}),`\n`,_jsx(Heading,{level:`2`,id:`subscribing`,children:`Subscribing`}),`\n`,_jsx(_components.p,{children:`Register an endpoint with the events it should receive:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`15`,language:`shellscript`,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:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`15`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` -X POST https://api.fyatu.com/api/v3.20/webhooks \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` -H `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Authorization: Bearer $FYATU_API_KEY\"`}),_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:` -H `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Content-Type: application/json\"`}),_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:` -d `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"url\": \"https://api.yourcompany.com/webhooks/fyatu\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"events\": [`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"CARD_ISSUED\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"CARD_FUNDED\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"CARD_FUND_FAILED\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"CARDHOLDER_KYC_APPROVED\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"CARDHOLDER_KYC_REJECTED\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"TRANSACTION_PROCESSED\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"TRANSACTION_DECLINED\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` ]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`The response carries the endpoint’s signing `,_jsx(_components.strong,{children:_jsx(_components.code,{children:`secret`})}),`, shown `,_jsx(_components.strong,{children:`once`}),`. Store it now.`]}),`\n`,_jsxs(_components.li,{children:[`A live endpoint must use `,_jsx(_components.code,{children:`https://`}),`, and it cannot point at a private or internal address.`]}),`\n`,_jsxs(_components.li,{children:[`Up to `,_jsx(_components.strong,{children:`10 endpoints`}),` per business. One endpoint may take every event.`]}),`\n`,_jsx(_components.li,{children:`An endpoint receives the events of its own environment: sandbox events go to sandbox endpoints.`}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`GET /event-types`}),` returns every event you can subscribe to, and the\n`,_jsx(_components.a,{href:`/v3.20/api-reference/webhooks/events`,children:`event list`}),` describes each one; every event also has its own\npage under `,_jsx(_components.strong,{children:`Webhooks`}),`.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`Manage endpoints with `,_jsx(_components.a,{href:`/v3.20/api-reference/webhooks/list`,children:_jsx(_components.code,{children:`GET`})}),`, `,_jsx(_components.a,{href:`/v3.20/api-reference/webhooks/update`,children:_jsx(_components.code,{children:`PATCH`})}),`\nand `,_jsx(_components.a,{href:`/v3.20/api-reference/webhooks/delete`,children:_jsx(_components.code,{children:`DELETE /webhooks/{id}`})}),`. Sending a test event, resending a\ndelivery, rotating the secret and reading the delivery history are in the CaaS portal under\n`,_jsx(_components.strong,{children:`Developers → Webhooks`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`what-a-delivery-looks-like`,children:`What a delivery looks like`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`24`,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:`24`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`POST`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` /webhooks/fyatu `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`HTTP`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`/`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1.1`})]}),`\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`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`User-Agent`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` Fyatu-Webhook/3.20`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`X-Fyatu-Event`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` CARD_FUNDED`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`X-Fyatu-Event-ID`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` evt_01HXY123456ABCDEF`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`X-Fyatu-Delivery`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` wdl_01HXY987654FEDCBA`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`X-Fyatu-Environment`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` LIVE`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`X-Fyatu-Timestamp`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 1763215200`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`X-Fyatu-Signature`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` t=1763215200,v1=5c0f...`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\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:` \"event\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"CARD_FUNDED\"`}),_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:` \"eventId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"evt_01HXY123456ABCDEF\"`}),_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:` \"businessId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"BUS1A2B3C4D5E6F\"`}),_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:` \"environment\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"LIVE\"`}),_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:` \"timestamp\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-11-15T14:00:00Z\"`}),_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:` \"cardId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"crd_01HXYZ5555ABCDEF1111\"`}),_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:` \"amount\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`50.00`}),_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:` \"currency\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"USD\"`}),_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:` \"reference\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"order-001\"`}),_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:` \"transactionId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"ltx_01HXYZ9999ABCDEF2222\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_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:[_jsx(_components.code,{children:`event`}),` names the event and `,_jsx(_components.code,{children:`data`}),` carries its details; each event’s page documents its `,_jsx(_components.code,{children:`data`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`verifying-the-signature`,children:`Verifying the signature`}),`\n`,_jsxs(_components.p,{children:[`Every delivery is signed with your endpoint’s secret, so you can prove it came from FYATU and was not\naltered. Verify it on the `,_jsx(_components.strong,{children:`raw`}),` request body, before parsing it, and reject anything that fails:`]}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`Read `,_jsx(_components.code,{children:`t`}),` and `,_jsx(_components.code,{children:`v1`}),` from `,_jsx(_components.code,{children:`X-Fyatu-Signature`}),`.`]}),`\n`,_jsx(_components.li,{children:`Derive the signing key: the SHA-256 hex digest of your secret.`}),`\n`,_jsxs(_components.li,{children:[`Compute HMAC-SHA256 of `,_jsx(_components.code,{children:`\"{t}.{raw body}\"`}),` with that key, and compare it with `,_jsx(_components.code,{children:`v1`}),` in constant time.`]}),`\n`,_jsxs(_components.li,{children:[`Reject a `,_jsx(_components.code,{children:`t`}),` more than a few minutes old, so an intercepted delivery cannot be replayed later.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.a,{href:`/v3.20/webhooks/signature-verification`,children:`Signature Verification`}),` has the code in Node.js, Python,\nPHP, Go and Ruby.`]}),`\n`,_jsx(Heading,{level:`2`,id:`answering`,children:`Answering`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Answer `,_jsxs(_components.strong,{children:[_jsx(_components.code,{children:`2xx`}),` within 30 seconds`]}),`. Anything else counts as a failure.`]}),`\n`,_jsx(_components.li,{children:`Answer first, then do the work: store the event and process it in the background, so a slow\ndatabase or a third-party call never makes you miss the deadline.`}),`\n`,_jsx(_components.li,{children:`The response body is ignored.`}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`retries`,children:`Retries`}),`\n`,_jsxs(_components.p,{children:[`A delivery your endpoint answers with a non-`,_jsx(_components.code,{children:`2xx`}),` status is tried `,_jsx(_components.strong,{children:`5 times`}),` in all: at once, then\nafter 15 seconds, 2 minutes, 15 minutes and 1 hour.`]}),`\n`,_jsxs(_components.p,{children:[`A delivery that gets no answer at all — your endpoint refuses the connection, its host name does not\nresolve, or it does not answer within 30 seconds — is retried on the same schedule. The delivery log\nin `,_jsx(_components.strong,{children:`Developers → Webhooks`}),` shows why each attempt failed, and anything that ran out of attempts can\nbe resent from there.`]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`An endpoint on a private or internal address (loopback, private ranges, link-local, cloud\nmetadata) is refused when you save it, with `,_jsx(_components.code,{children:`422 WEBHOOK_URL_BLOCKED`}),`, and is never delivered to.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`handling-an-event-twice-or-out-of-order`,children:`Handling an event twice, or out of order`}),`\n`,_jsxs(_components.p,{children:[`Delivery is `,_jsx(_components.strong,{children:`at least once`}),`. The same event can arrive more than once, for example when we retry\nafter your server processed it but answered late, or when a delivery is resent.`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Deduplicate on `,_jsx(_components.code,{children:`X-Fyatu-Event-ID`}),` (the `,_jsx(_components.code,{children:`eventId`}),` in the body). It is the same on every retry and\nresend of one event; `,_jsx(_components.code,{children:`X-Fyatu-Delivery`}),` changes with each attempt.`]}),`\n`,_jsxs(_components.li,{children:[`Do not rely on order. A `,_jsx(_components.code,{children:`CARD_FUNDED`}),` can arrive before the `,_jsx(_components.code,{children:`CARD_ISSUED`}),` it follows. Treat each\nevent as “this happened”, and read the resource with the API when you need its current state.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`which-events-to-start-with`,children:`Which events to start with`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`You want to know when…`}),_jsx(_components.th,{children:`Subscribe to`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`A cardholder can be issued cards`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`CARDHOLDER_KYC_APPROVED`}),`, `,_jsx(_components.code,{children:`CARDHOLDER_KYC_REJECTED`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`A card is ready`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`CARD_ISSUED`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`A funding or unload went through`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`CARD_FUNDED`}),`, `,_jsx(_components.code,{children:`CARD_FUND_FAILED`}),`, `,_jsx(_components.code,{children:`CARD_UNLOADED`}),`, `,_jsx(_components.code,{children:`CARD_UNLOAD_FAILED`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`A cardholder spent, or was declined`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`TRANSACTION_PROCESSED`}),`, `,_jsx(_components.code,{children:`TRANSACTION_DECLINED`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`A closed card’s balance came back`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`CARD_TERMINATION_REFUND`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`A card’s status was corrected`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`CARD_STATUS_CORRECTED`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`A 3D Secure code must reach the cardholder`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`CARD_3DS_OTP`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Your balance is running low`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`ACCOUNT_LOW_BALANCE`})})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`endpoints`,children:`Endpoints`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/v3.20/api-reference/webhooks/create`,children:_jsx(_components.code,{children:`POST /webhooks`})}),`, `,_jsx(_components.a,{href:`/v3.20/api-reference/webhooks/list`,children:_jsx(_components.code,{children:`GET /webhooks`})}),`, `,_jsx(_components.a,{href:`/v3.20/api-reference/webhooks/get`,children:_jsx(_components.code,{children:`GET /webhooks/{id}`})}),`, `,_jsx(_components.a,{href:`/v3.20/api-reference/webhooks/update`,children:_jsx(_components.code,{children:`PATCH /webhooks/{id}`})}),`, `,_jsx(_components.a,{href:`/v3.20/api-reference/webhooks/delete`,children:_jsx(_components.code,{children:`DELETE /webhooks/{id}`})})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`GET /event-types`}),`, with the `,_jsx(_components.a,{href:`/v3.20/api-reference/webhooks/events`,children:`event list`})]}),`\n`]})]})}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":"Webhooks","description":"How FYATU tells your server that something happened: subscribing, verifying the signature, answering, retries, and handling an event more than once.","href":"/v3.20/documentation/concepts/webhooks"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Subscribing","slug":"subscribing","depth":2,"children":[]},{"title":"What a delivery looks like","slug":"what-a-delivery-looks-like","depth":2,"children":[]},{"title":"Verifying the signature","slug":"verifying-the-signature","depth":2,"children":[]},{"title":"Answering","slug":"answering","depth":2,"children":[]},{"title":"Retries","slug":"retries","depth":2,"children":[]},{"title":"Handling an event twice, or out of order","slug":"handling-an-event-twice-or-out-of-order","depth":2,"children":[]},{"title":"Which events to start with","slug":"which-events-to-start-with","depth":2,"children":[]},{"title":"Endpoints","slug":"endpoints","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/fyatu/5ce54d4312ebdc4f/footer.js"],"subdomain":"fyatu","siteName":"FYATU API Docs","title":"Webhooks - FYATU API Docs","navMaps":{"firstHrefInVersion":{"v3.20 — CaaS":{"href":"/v3.20/documentation/concepts/webhooks","matchLevel":0},"v3 — Business":{"href":"/home","matchLevel":4}},"firstHrefInLanguage":{}},"lastModified":"2026-11-19T10:05:00.778Z","originalFileLocation":"v3.20/documentation/concepts/webhooks.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 FYATU tells your server that something happened: subscribing, verifying the signature, answering, retries, and handling an event more than once.\">\u003cmeta data-mint-head name=\"keywords\" content=\"card issuing API, virtual card API, Mastercard API, Visa API, prepaid card issuing, 3D Secure cards, Apple Pay API, Google Pay API, fintech API Africa, payment API, payout API, webhook API, REST API card issuing, programmatic card issuing, virtual debit card API, card program API, mobile money API, payment gateway Africa\">\u003cmeta data-mint-head name=\"application-name\" content=\"FYATU API Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003cmeta data-mint-head name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/fyatu/b3wN_qy-N1otkCBP/_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/fyatu/b3wN_qy-N1otkCBP/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/fyatu/b3wN_qy-N1otkCBP/_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/fyatu/b3wN_qy-N1otkCBP/_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/fyatu/b3wN_qy-N1otkCBP/_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/fyatu/b3wN_qy-N1otkCBP/_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/fyatu/b3wN_qy-N1otkCBP/_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/fyatu/b3wN_qy-N1otkCBP/_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/fyatu/b3wN_qy-N1otkCBP/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Webhooks - FYATU API Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"How FYATU tells your server that something happened: subscribing, verifying the signature, answering, retries, and handling an event more than once.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Fyatu API Documentation — Card Issuing API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.fyatu.com/v3.20/documentation/concepts/webhooks\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://fyatu.mintlify.site/_mintlify/api/og/v2?division=Concepts\u0026amp;title=Webhooks\u0026amp;description=How+FYATU+tells+your+server+that+something+happened%3A+subscribing%2C+verifying+the+signature%2C+answering%2C+retries%2C+and+handling+an+event+more+than+once.\u0026amp;theme=4a91f0fc566d34e9acdb9cbb\u0026amp;signature=c0e0eaca338060a3112e73d5a6f5c6a4daecfe37d70bdde2ac12d48fc2ab2287\">\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=\"Webhooks - FYATU API Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"How FYATU tells your server that something happened: subscribing, verifying the signature, answering, retries, and handling an event more than once.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://fyatu.mintlify.site/_mintlify/api/og/v2?division=Concepts\u0026amp;title=Webhooks\u0026amp;description=How+FYATU+tells+your+server+that+something+happened%3A+subscribing%2C+verifying+the+signature%2C+answering%2C+retries%2C+and+handling+an+event+more+than+once.\u0026amp;theme=4a91f0fc566d34e9acdb9cbb\u0026amp;signature=c0e0eaca338060a3112e73d5a6f5c6a4daecfe37d70bdde2ac12d48fc2ab2287\">\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/fyatu/b3wN_qy-N1otkCBP/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"FYATU API Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#721D5D\">\u003cmeta data-mint-head name=\"og:locale\" content=\"en_US\">\u003cmeta data-mint-head name=\"googlebot\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.fyatu.com/v3.20/documentation/concepts/webhooks\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/v3.20/documentation/concepts/webhooks.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.fyatu.com/#organization\",\"name\":\"FYATU API Docs\",\"url\":\"https://docs.fyatu.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/fyatu/1Y4pa7wxF_kMnOCq/logo/light.png?fit=max\u0026auto=format\u0026n=1Y4pa7wxF_kMnOCq\u0026q=85\u0026s=da06db892390b1d64a6da61ed20cf95e\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.fyatu.com#website\",\"name\":\"FYATU API Docs\",\"url\":\"https://docs.fyatu.com\",\"publisher\":{\"@id\":\"https://docs.fyatu.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.fyatu.com/v3.20/documentation/concepts/webhooks#webpage\",\"url\":\"https://docs.fyatu.com/v3.20/documentation/concepts/webhooks\",\"name\":\"Webhooks\",\"description\":\"How FYATU tells your server that something happened: subscribing, verifying the signature, answering, retries, and handling an event more than once.\",\"dateModified\":\"2026-11-19T10:05:00.778Z\",\"isPartOf\":{\"@id\":\"https://docs.fyatu.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.fyatu.com/v3.20/documentation/concepts/webhooks#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.fyatu.com/v3.20/documentation/concepts/webhooks#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Concepts\",\"item\":\"https://docs.fyatu.com/v3.20/documentation/concepts/bins\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Webhooks\",\"item\":\"https://docs.fyatu.com/v3.20/documentation/concepts/webhooks\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.fyatu.com/v3.20/documentation/concepts/webhooks#article\",\"headline\":\"Webhooks\",\"name\":\"Webhooks\",\"description\":\"How FYATU tells your server that something happened: subscribing, verifying the signature, answering, retries, and handling an event more than once.\",\"url\":\"https://docs.fyatu.com/v3.20/documentation/concepts/webhooks\",\"mainEntityOfPage\":{\"@id\":\"https://docs.fyatu.com/v3.20/documentation/concepts/webhooks#webpage\"},\"dateModified\":\"2026-11-19T10:05:00.778Z\",\"publisher\":{\"@id\":\"https://docs.fyatu.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.fyatu.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"FYATU API Docs\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"FYATU API Docs\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/v3.20/documentation/concepts/webhooks.md","siteName":"FYATU API Docs","nav":{"global":{"anchors":[{"anchor":"Website","icon":"globe","href":"https://fyatu.com"}]},"versions":[{"version":"v3.20 — CaaS","default":true,"tabs":[{"tab":"Home","icon":"house","pages":[{"title":"Home","href":"/home"}]},{"tab":"Documentation","icon":"book-open","groups":[{"group":"Getting Started","pages":[{"title":"Introduction","href":"/v3.20/documentation/introduction"},{"title":"Quickstart","href":"/v3.20/documentation/quickstart"},{"title":"Authentication","href":"/v3.20/documentation/authentication"},{"title":"Rate Limiting","href":"/v3.20/documentation/rate-limits"},{"title":"Error Handling","href":"/v3.20/documentation/errors"}]},{"group":"Concepts","pages":[{"title":"BINs","href":"/v3.20/documentation/concepts/bins"},{"title":"Cardholders","href":"/v3.20/documentation/concepts/cardholders"},{"title":"Cards","href":"/v3.20/documentation/concepts/cards"},{"title":"Negative balances","href":"/v3.20/documentation/concepts/negative-balances"},{"title":"Transactions","description":"Two views of money: what happened on a card at a merchant, and what moved on your balance. How a purchase goes from authorization to clearing, how declines are explained, and how to reconcile.","href":"/v3.20/documentation/concepts/transactions"},{"title":"Webhooks","href":"/v3.20/documentation/concepts/webhooks"}]}]},{"tab":"API Reference","icon":"square-terminal","pages":[{"title":"API Reference","href":"/v3.20/api-reference/account/info"}]},{"tab":"Webhooks","icon":"webhook","pages":[{"title":"Webhooks","href":"/v3.20/webhooks/signature-verification"}]}]},{"version":"v3 — Business","pages":[{"title":"v3 — Business","href":"/home"}]}]},"basePath":"","title":"Webhooks - FYATU API Docs","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":[],"chunks":[]}