Fires as a cardholder’s transaction moves through its lifecycle. TRANSACTION_PROCESSED
is the single, canonical event type for card transactions — you may receive it more
than once for the same purchase as it progresses.Every payload has two fields you branch on:
type — what kind of transaction it is: PURCHASE, REVERSAL, REFUND, or ADJUSTMENT.
status — which lifecycle phase / outcome it represents.
They always pair together as follows:
type
status
Meaning
PURCHASE
AUTHORIZED
The charge was authorized — a hold. Funds are reserved but not yet final.
PURCHASE
CLEARED
The charge settled. This is the final, captured amount — mark the transaction successful here.
REVERSAL
REVERSED
An authorization was voided before it cleared — the hold is released.
REFUND
REFUNDED
A merchant refund after the charge cleared — funds returned to the card.
ADJUSTMENT
ADJUSTED
An FX settlement adjustment was applied to a prior charge.
A PURCHASE therefore progresses AUTHORIZED → CLEARED; the other types are terminal.
The authorization → clearing flow
A typical purchase produces twoTRANSACTION_PROCESSED events:
status: AUTHORIZED when the cardholder pays (a hold is placed).
status: CLEARED when the merchant settles — often a few days later, and sometimes
for a slightly different amount (currency conversion, tips). The CLEARED amount
is the real, final figure.
Both events carry the same relatedTransactionId, so you can correlate the phases and
act on the CLEARED one.
Some merchants settle almost immediately (you’ll see CLEARED right away); others
authorize and settle days apart. Always key your “transaction complete” logic off
status: CLEARED, never AUTHORIZED.
Correlation fields
relatedTransactionId is the field to group by. It is present on every transaction event,
it is the same value on an authorization and on its clearing however far apart they arrive, and
it is not derived from anything optional.transactionId is not a correlation key: it identifies the event, so the authorization and
the clearing of one purchase carry different values. This is deliberate — it is what makes a
redelivery recognisable — but it means two events about one purchase will never share it.
Field
Present on
Description
relatedTransactionId
every transaction event
The purchase key. Group events by this. The same value on an authorization and its clearing; on a reversal or a fee, the charge it derives from.
chargeId
REVERSED
The specific charge that a reversal undoes. Equal to relatedTransactionId.
references.authorizationCode
when the card network supplies one
The network’s approval code. Optional — the network does not always return it, and it must not be used as a correlation key.
references.referenceNumber
most events
The acquirer’s reference for the transaction, for reconciling against a statement.
references.rrn
most events
Retrieval reference number.
references.merchantId, .network, .maskedPan
when supplied
Merchant identifier, card network, and the masked PAN the charge was made on.
authorizationCode is optional and may be absent. It is passed through from the card
network exactly as received; the network stopped returning it on most transactions in October
2026. An integration that correlates on authorizationCode will fail. Use
relatedTransactionId, which is always present.
Every references key is omitted when the network did not supply it, rather than sent empty, so
an absent key means “not supplied” and never “supplied as blank”.
Events arriving out of order
Deliveries are independent and are retried separately, so a CLEARED event can reach you before
its AUTHORIZED one. Treat relatedTransactionId as the purchase’s primary key and upsert on
it: create the record on whichever event arrives first, and let the CLEARED amount overwrite
the authorized one. Do not require the authorization to exist before accepting a clearing.
A reversal carries chargeId (the charge it undoes) and relatedTransactionId; a
REFUNDED payload has the same shape with status: REFUNDED and type: REFUND.
The cardholder (best-effort — may be absent if not resolvable)
externalId
string or null
Your internal user ID from the cardholder profile
type
string
PURCHASE, REVERSAL, REFUND, or ADJUSTMENT
status
string
AUTHORIZED, CLEARED, REVERSED, REFUNDED, or ADJUSTED
amount
number
Transaction amount in dollars. On CLEARED, this is the final settled amount.
currency
string
Transaction currency (ISO 4217)
billingAmount
number
Amount in the card’s billing currency, in dollars
billingCurrency
string
Billing currency — may differ for cross-border transactions
transactionId
string
Identifies this event, not the purchase. Differs between an authorization and its clearing — see Correlation fields
relatedTransactionId
string
The purchase key. Same value on an authorization and its clearing; the charge a reversal or fee derives from
references
object
Network identifiers as supplied: authorizationCode, referenceNumber, rrn, merchantId, network, maskedPan. Keys absent when not supplied
authorizationCode
string
Optional. The network’s approval code, also in references. Not a correlation key
chargeId
string
On a reversal, the charge being reversed
merchant
object
Merchant details — may be absent for non-purchase transactions
merchant.name
string
Merchant name
merchant.id
string
Merchant identifier from the network (may be empty)
merchant.city
string
Merchant city (may be empty)
merchant.country
string
Merchant country (ISO 3166-1 alpha-2)
merchant.mcc
string
ISO 18245 Merchant Category Code
merchant.mccDescription
string
Human-readable MCC description (empty when the MCC is unmapped)
Common Use Cases
Mark a transaction successful on status: CLEARED, using its amount as the final charge.
Correlate an authorization with its settlement via relatedTransactionId, so a hold and its later capture aren’t double-counted.
Handle REVERSED (authorization voided) and REFUNDED (merchant refund) to restore balance in your ledger — a REVERSED payload’s chargeId tells you exactly which charge it undoes.
Send real-time notifications and implement MCC-based spending controls.
TRANSACTION_PROCESSED supersedes the deprecated granular events
(TRANSACTION_AUTHORIZED,
TRANSACTION_CLEARED,
TRANSACTION_REVERSED, and
TRANSACTION_REFUNDED). They remain fully supported for existing integrations — no
migration required — but new integrations should subscribe to TRANSACTION_PROCESSED
and branch on status.
{"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":[{"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":"site-roles","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":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"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/webhooks/events/transaction-processed","slug":"/v3.20/webhooks/events/transaction-processed","pageMetadata":{"title":"Transaction Processed","description":"The card-transaction lifecycle event. The status field carries the phase — AUTHORIZED, CLEARED, REVERSED, REFUNDED, or ADJUSTED.","openapi":"v3.20/webhooks.json webhook TRANSACTION_PROCESSED","href":"/v3.20/webhooks/events/transaction-processed"},"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: \"The card-transaction lifecycle event. The status field carries the phase — AUTHORIZED, CLEARED, REVERSED, REFUNDED, or ADJUSTED.\"\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`,em:`em`,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,Note,Table,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Fires as a cardholder’s transaction moves through its lifecycle. `,_jsx(_components.code,{children:`TRANSACTION_PROCESSED`}),`\nis the single, canonical event type for card transactions — you may receive it `,_jsx(_components.strong,{children:`more\nthan once for the same purchase`}),` as it progresses.`]}),`\n`,_jsx(_components.p,{children:`Every payload has two fields you branch on:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:_jsx(_components.code,{children:`type`})}),` — `,_jsx(_components.em,{children:`what kind`}),` of transaction it is: `,_jsx(_components.code,{children:`PURCHASE`}),`, `,_jsx(_components.code,{children:`REVERSAL`}),`, `,_jsx(_components.code,{children:`REFUND`}),`, or `,_jsx(_components.code,{children:`ADJUSTMENT`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:_jsx(_components.code,{children:`status`})}),` — `,_jsx(_components.em,{children:`which lifecycle phase / outcome`}),` it represents.`]}),`\n`]}),`\n`,_jsx(_components.p,{children:`They always pair together as follows:`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:_jsx(_components.code,{children:`type`})}),_jsx(_components.th,{children:_jsx(_components.code,{children:`status`})}),_jsx(_components.th,{children:`Meaning`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`PURCHASE`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`AUTHORIZED`})}),_jsxs(_components.td,{children:[`The charge was authorized — a hold. Funds are reserved but `,_jsx(_components.strong,{children:`not yet final`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`PURCHASE`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`CLEARED`})}),_jsxs(_components.td,{children:[`The charge `,_jsx(_components.strong,{children:`settled`}),`. This is the final, captured amount — `,_jsx(_components.strong,{children:`mark the transaction successful here`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`REVERSAL`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`REVERSED`})}),_jsxs(_components.td,{children:[`An authorization was voided `,_jsx(_components.strong,{children:`before`}),` it cleared — the hold is released.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`REFUND`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`REFUNDED`})}),_jsxs(_components.td,{children:[`A merchant `,_jsx(_components.strong,{children:`refund`}),` after the charge cleared — funds returned to the card.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ADJUSTMENT`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`ADJUSTED`})}),_jsx(_components.td,{children:`An FX settlement adjustment was applied to a prior charge.`})]})]})]}),`\n`,_jsxs(_components.p,{children:[`A `,_jsx(_components.code,{children:`PURCHASE`}),` therefore progresses `,_jsx(_components.code,{children:`AUTHORIZED`}),` → `,_jsx(_components.code,{children:`CLEARED`}),`; the other types are terminal.`]}),`\n`,_jsx(Heading,{level:`2`,id:`the-authorization-→-clearing-flow`,children:`The authorization → clearing flow`}),`\n`,_jsxs(_components.p,{children:[`A typical purchase produces `,_jsx(_components.strong,{children:`two`}),` `,_jsx(_components.code,{children:`TRANSACTION_PROCESSED`}),` events:`]}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`status: AUTHORIZED`}),` when the cardholder pays (a hold is placed).`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`status: CLEARED`}),` when the merchant settles — often a few days later, and sometimes\nfor a `,_jsx(_components.strong,{children:`slightly different amount`}),` (currency conversion, tips). The `,_jsx(_components.code,{children:`CLEARED`}),` amount\nis the real, final figure.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`Both events carry the same `,_jsx(_components.strong,{children:_jsx(_components.code,{children:`relatedTransactionId`})}),`, so you can correlate the phases and\nact on the `,_jsx(_components.code,{children:`CLEARED`}),` one.`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Some merchants settle almost immediately (you’ll see `,_jsx(_components.code,{children:`CLEARED`}),` right away); others\nauthorize and settle days apart. Always key your “transaction complete” logic off\n`,_jsx(_components.code,{children:`status: CLEARED`}),`, never `,_jsx(_components.code,{children:`AUTHORIZED`}),`.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`correlation-fields`,children:`Correlation fields`}),`\n`,_jsxs(_components.p,{children:[_jsxs(_components.strong,{children:[_jsx(_components.code,{children:`relatedTransactionId`}),` is the field to group by.`]}),` It is present on every transaction event,\nit is the same value on an authorization and on its clearing however far apart they arrive, and\nit is not derived from anything optional.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`transactionId`}),` is `,_jsx(_components.strong,{children:`not`}),` a correlation key: it identifies the `,_jsx(_components.em,{children:`event`}),`, so the authorization and\nthe clearing of one purchase carry different values. This is deliberate — it is what makes a\nredelivery recognisable — but it means two events about one purchase will never share it.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Present on`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`relatedTransactionId`})}),_jsx(_components.td,{children:`every transaction event`}),_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`The purchase key. Group events by this.`}),` The same value on an authorization and its clearing; on a reversal or a fee, the charge it derives from.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`chargeId`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`REVERSED`})}),_jsxs(_components.td,{children:[`The specific charge that a reversal undoes. Equal to `,_jsx(_components.code,{children:`relatedTransactionId`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`references.authorizationCode`})}),_jsx(_components.td,{children:`when the card network supplies one`}),_jsxs(_components.td,{children:[`The network’s approval code. `,_jsx(_components.strong,{children:`Optional`}),` — the network does not always return it, and it must not be used as a correlation key.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`references.referenceNumber`})}),_jsx(_components.td,{children:`most events`}),_jsx(_components.td,{children:`The acquirer’s reference for the transaction, for reconciling against a statement.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`references.rrn`})}),_jsx(_components.td,{children:`most events`}),_jsx(_components.td,{children:`Retrieval reference number.`})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`references.merchantId`}),`, `,_jsx(_components.code,{children:`.network`}),`, `,_jsx(_components.code,{children:`.maskedPan`})]}),_jsx(_components.td,{children:`when supplied`}),_jsx(_components.td,{children:`Merchant identifier, card network, and the masked PAN the charge was made on.`})]})]})]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsxs(_components.strong,{children:[_jsx(_components.code,{children:`authorizationCode`}),` is optional and may be absent.`]}),` It is passed through from the card\nnetwork exactly as received; the network stopped returning it on most transactions in October\n2026. An integration that correlates on `,_jsx(_components.code,{children:`authorizationCode`}),` will fail. Use\n`,_jsx(_components.code,{children:`relatedTransactionId`}),`, which is always present.`]})}),`\n`,_jsxs(_components.p,{children:[`Every `,_jsx(_components.code,{children:`references`}),` key is omitted when the network did not supply it, rather than sent empty, so\nan absent key means “not supplied” and never “supplied as blank”.`]}),`\n`,_jsx(Heading,{level:`3`,id:`events-arriving-out-of-order`,children:`Events arriving out of order`}),`\n`,_jsxs(_components.p,{children:[`Deliveries are independent and are retried separately, so a `,_jsx(_components.code,{children:`CLEARED`}),` event can reach you before\nits `,_jsx(_components.code,{children:`AUTHORIZED`}),` one. Treat `,_jsx(_components.code,{children:`relatedTransactionId`}),` as the purchase’s primary key and upsert on\nit: create the record on whichever event arrives first, and let the `,_jsx(_components.code,{children:`CLEARED`}),` amount overwrite\nthe authorized one. Do not require the authorization to exist before accepting a clearing.`]}),`\n`,_jsxs(Heading,{level:`2`,id:`payload-—-settlement-status-cleared`,children:[`Payload — settlement (`,_jsx(_components.code,{children:`status: CLEARED`}),`)`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`33`,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:`33`,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:`\"TRANSACTION_PROCESSED\"`}),_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:`\"EVT2W9SK2233S4C\"`}),_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-07-07T21:55:41Z\"`}),_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:` \"transactionId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"237bc8d1-5b20-4d6b-8ade-059e8dd903ca\"`}),_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:` \"cardholderId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"chl_01HXYZ1234ABCDEF5678\"`}),_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:` \"externalId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"my-user-id-789\"`}),_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:` \"type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"PURCHASE\"`}),_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:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"CLEARED\"`}),_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:`13.68`}),_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:` \"billingAmount\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`13.68`}),_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:` \"billingCurrency\"`}),_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:` \"relatedTransactionId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"21e2c774-66ac-4b09-9d9d-3abe0f944bda\"`}),_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:` \"references\"`}),_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:` \"referenceNumber\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"102300313422\"`}),_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:` \"rrn\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"f0e85fb9-eaf8-4a62-8d58-e581fe332e40\"`}),_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:` \"merchantId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"IRKGOG97WMYUONX\"`}),_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:` \"network\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"MASTERCARD\"`}),_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:` \"maskedPan\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"XXXXXXXXXXXX4786\"`})]}),`\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:` \"merchant\"`}),_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:` \"name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"ZYNGA - EMPIRES \u0026 PUZZ\"`}),_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:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"EUXEITE8IZPSUAW\"`}),_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:` \"country\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"IE\"`}),_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:` \"mcc\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"5816\"`})]}),`\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`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(Heading,{level:`2`,id:`payload-—-reversal-status-reversed`,children:[`Payload — reversal (`,_jsx(_components.code,{children:`status: REVERSED`}),`)`]}),`\n`,_jsxs(_components.p,{children:[`A reversal carries `,_jsx(_components.code,{children:`chargeId`}),` (the charge it undoes) and `,_jsx(_components.code,{children:`relatedTransactionId`}),`; a\n`,_jsx(_components.code,{children:`REFUNDED`}),` payload has the same shape with `,_jsx(_components.code,{children:`status: REFUNDED`}),` and `,_jsx(_components.code,{children:`type: REFUND`}),`.`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`27`,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:`27`,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:`\"TRANSACTION_PROCESSED\"`}),_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:`\"EVT7Q2X9K4M8ND3\"`}),_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-07-08T19:45:06Z\"`}),_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:` \"transactionId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"57f1ffae-e0af-41be-9e02-3517bc737661\"`}),_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:` \"cardholderId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"chl_01HXYZ1234ABCDEF5678\"`}),_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:` \"externalId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"my-user-id-789\"`}),_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:` \"type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"REVERSAL\"`}),_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:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"REVERSED\"`}),_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:`0.85`}),_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:` \"billingAmount\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`0.85`}),_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:` \"billingCurrency\"`}),_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:` \"authorizationCode\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2d3d8c5a-66bf-479f-abd3-18efd32dfa65\"`}),_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:` \"chargeId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"64ddcacc-e73f-4046-9aa3-8a067cd9f67b\"`}),_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:` \"relatedTransactionId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"64ddcacc-e73f-4046-9aa3-8a067cd9f67b\"`}),_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:` \"merchant\"`}),_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:` \"name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"XSOLLA *ONLINE GAMES\"`}),_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:` \"country\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"US\"`}),_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:` \"mcc\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"5816\"`})]}),`\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`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`payload-fields`,children:`Payload Fields`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`transactionId`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Provider transaction identifier for this phase`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`cardId`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`The card used for the transaction`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`cardholderId`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`The cardholder (best-effort — may be absent if not resolvable)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`externalId`})}),_jsx(_components.td,{children:`string or null`}),_jsx(_components.td,{children:`Your internal user ID from the cardholder profile`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`type`})}),_jsx(_components.td,{children:`string`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`PURCHASE`}),`, `,_jsx(_components.code,{children:`REVERSAL`}),`, `,_jsx(_components.code,{children:`REFUND`}),`, or `,_jsx(_components.code,{children:`ADJUSTMENT`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`status`})}),_jsx(_components.td,{children:`string`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`AUTHORIZED`}),`, `,_jsx(_components.code,{children:`CLEARED`}),`, `,_jsx(_components.code,{children:`REVERSED`}),`, `,_jsx(_components.code,{children:`REFUNDED`}),`, or `,_jsx(_components.code,{children:`ADJUSTED`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`amount`})}),_jsx(_components.td,{children:`number`}),_jsxs(_components.td,{children:[`Transaction amount in dollars. On `,_jsx(_components.code,{children:`CLEARED`}),`, this is the final settled amount.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`currency`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Transaction currency (ISO 4217)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`billingAmount`})}),_jsx(_components.td,{children:`number`}),_jsx(_components.td,{children:`Amount in the card’s billing currency, in dollars`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`billingCurrency`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Billing currency — may differ for cross-border transactions`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`transactionId`})}),_jsx(_components.td,{children:`string`}),_jsxs(_components.td,{children:[`Identifies this `,_jsx(_components.strong,{children:`event`}),`, not the purchase. Differs between an authorization and its clearing — see Correlation fields`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`relatedTransactionId`})}),_jsx(_components.td,{children:`string`}),_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`The purchase key.`}),` Same value on an authorization and its clearing; the charge a reversal or fee derives from`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`references`})}),_jsx(_components.td,{children:`object`}),_jsxs(_components.td,{children:[`Network identifiers as supplied: `,_jsx(_components.code,{children:`authorizationCode`}),`, `,_jsx(_components.code,{children:`referenceNumber`}),`, `,_jsx(_components.code,{children:`rrn`}),`, `,_jsx(_components.code,{children:`merchantId`}),`, `,_jsx(_components.code,{children:`network`}),`, `,_jsx(_components.code,{children:`maskedPan`}),`. Keys absent when not supplied`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`authorizationCode`})}),_jsx(_components.td,{children:`string`}),_jsxs(_components.td,{children:[`Optional. The network’s approval code, also in `,_jsx(_components.code,{children:`references`}),`. `,_jsx(_components.strong,{children:`Not a correlation key`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`chargeId`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`On a reversal, the charge being reversed`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`merchant`})}),_jsx(_components.td,{children:`object`}),_jsx(_components.td,{children:`Merchant details — may be absent for non-purchase transactions`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`merchant.name`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Merchant name`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`merchant.id`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Merchant identifier from the network (may be empty)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`merchant.city`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Merchant city (may be empty)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`merchant.country`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Merchant country (ISO 3166-1 alpha-2)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`merchant.mcc`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`ISO 18245 Merchant Category Code`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`merchant.mccDescription`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Human-readable MCC description (empty when the MCC is unmapped)`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`common-use-cases`,children:`Common Use Cases`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsxs(_components.strong,{children:[`Mark a transaction successful on `,_jsx(_components.code,{children:`status: CLEARED`})]}),`, using its `,_jsx(_components.code,{children:`amount`}),` as the final charge.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Correlate`}),` an authorization with its settlement via `,_jsx(_components.code,{children:`relatedTransactionId`}),`, so a hold and its later capture aren’t double-counted.`]}),`\n`,_jsxs(_components.li,{children:[`Handle `,_jsx(_components.code,{children:`REVERSED`}),` (authorization voided) and `,_jsx(_components.code,{children:`REFUNDED`}),` (merchant refund) to restore balance in your ledger — a `,_jsx(_components.code,{children:`REVERSED`}),` payload’s `,_jsx(_components.code,{children:`chargeId`}),` tells you exactly which charge it undoes.`]}),`\n`,_jsx(_components.li,{children:`Send real-time notifications and implement MCC-based spending controls.`}),`\n`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`TRANSACTION_PROCESSED`}),` supersedes the deprecated granular events\n(`,_jsx(_components.a,{href:`/v3.20/webhooks/events/transaction-authorized`,children:_jsx(_components.code,{children:`TRANSACTION_AUTHORIZED`})}),`,\n`,_jsx(_components.a,{href:`/v3.20/webhooks/events/transaction-cleared`,children:_jsx(_components.code,{children:`TRANSACTION_CLEARED`})}),`,\n`,_jsx(_components.a,{href:`/v3.20/webhooks/events/transaction-reversed`,children:_jsx(_components.code,{children:`TRANSACTION_REVERSED`})}),`, and\n`,_jsx(_components.code,{children:`TRANSACTION_REFUNDED`}),`). They remain fully supported for existing integrations — no\nmigration required — but new integrations should subscribe to `,_jsx(_components.code,{children:`TRANSACTION_PROCESSED`}),`\nand branch on `,_jsx(_components.code,{children:`status`}),`.`]})})]})}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":"Transaction Processed","description":"The card-transaction lifecycle event. The status field carries the phase — AUTHORIZED, CLEARED, REVERSED, REFUNDED, or ADJUSTED.","openapi":"v3.20/webhooks.json webhook TRANSACTION_PROCESSED","href":"/v3.20/webhooks/events/transaction-processed"}}},"mdxSourceWithNoJs":null,"noJsSplices":[[396,405,"RequestExample,ResponseExample,Table,War"],[572,584,"RequestExample)_missingMdxReference(`RequestExample`,true);if(!ResponseExample)_missingMdxReference(`ResponseExample`,true);if(!Table)_missi"],[42690,43118,",`\n`,_jsx(RequestExample,{children:_jsx(CodeBlock,{filename:`Webhook Payload (CLEARED)`,numberOfLines:`33`,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:`33`,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:`\"TRANSACTION_PROCESSED\"`}),_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:`\"EVT2W9SK2233S4C\"`}),_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-07-07T21:55:41Z\"`}),_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:` \"transactionId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"237bc8d1-5b20-4d6b-8ade-059e8dd903ca\"`}),_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:` \"cardholderId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"chl_01HXYZ1234ABCDEF5678\"`}),_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:` \"externalId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"my-user-id-789\"`}),_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:` \"type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"PURCHASE\"`}),_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:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"CLEARED\"`}),_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:`13.68`}),_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:` \"billingAmount\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`13.68`}),_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:` \"billingCurrency\"`}),_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:` \"relatedTransactionId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"21e2c774-66ac-4b09-9d9d-3abe0f944bda\"`}),_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:` \"references\"`}),_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:` \"referenceNumber\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"102300313422\"`}),_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:` \"rrn\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"f0e85fb9-eaf8-4a62-8d58-e581fe332e40\"`}),_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:` \"merchantId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"IRKGOG97WMYUONX\"`}),_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:` \"network\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"MASTERCARD\"`}),_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:` \"maskedPan\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"XXXXXXXXXXXX4786\"`})]}),`\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:` \"merchant\"`}),_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:` \"name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"ZYNGA - EMPIRES \u0026 PUZZ\"`}),_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:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"EUXEITE8IZPSUAW\"`}),_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:` \"country\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"IE\"`}),_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:` \"mcc\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"5816\"`})]}),`\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`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})})}),`\n`,_jsx(ResponseExample,{children:_jsx(CodeBlock,{filename:`200`,numberOfLines:`1`,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:`1`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{}`})}),`\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.\")}"]]},"mdxExtracts":{"tableOfContents":[{"title":"The authorization → clearing flow","slug":"the-authorization-→-clearing-flow","depth":2,"children":[]},{"title":"Correlation fields","slug":"correlation-fields","depth":2,"children":[{"title":"Events arriving out of order","slug":"events-arriving-out-of-order","depth":3,"children":[]}]},{"title":"Payload — settlement (status: CLEARED)","slug":"payload-—-settlement-status-cleared","depth":2,"children":[]},{"title":"Payload — reversal (status: REVERSED)","slug":"payload-—-reversal-status-reversed","depth":2,"children":[]},{"title":"Payload Fields","slug":"payload-fields","depth":2,"children":[]},{"title":"Common Use Cases","slug":"common-use-cases","depth":2,"children":[]}],"codeExamples":{"request":{"type":"RequestExample","children":[{"filename":"Webhook Payload (CLEARED)","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"33\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"event\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"TRANSACTION_PROCESSED\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"eventId\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"EVT2W9SK2233S4C\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"businessId\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"BUS1A2B3C4D5E6F\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"environment\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"LIVE\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"timestamp\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"2026-07-07T21:55:41Z\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"data\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"transactionId\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"237bc8d1-5b20-4d6b-8ade-059e8dd903ca\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"cardId\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"crd_01HXYZ5555ABCDEF1111\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"cardholderId\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"chl_01HXYZ1234ABCDEF5678\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"externalId\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"my-user-id-789\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"type\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"PURCHASE\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"status\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"CLEARED\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"amount\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">13.68\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"currency\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"USD\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"billingAmount\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">13.68\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"billingCurrency\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"USD\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"relatedTransactionId\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"21e2c774-66ac-4b09-9d9d-3abe0f944bda\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"references\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"referenceNumber\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"102300313422\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"rrn\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"f0e85fb9-eaf8-4a62-8d58-e581fe332e40\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"merchantId\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"IRKGOG97WMYUONX\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"network\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"MASTERCARD\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"maskedPan\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"XXXXXXXXXXXX4786\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> },\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"merchant\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"name\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"ZYNGA - EMPIRES \u0026#x26; PUZZ\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"EUXEITE8IZPSUAW\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"country\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"IE\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"mcc\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"5816\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[]},"response":{"type":"ResponseExample","children":[{"filename":"200","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"1\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[]}}},"jsLinks":["/_mintlify/custom/fyatu/5ce54d4312ebdc4f/footer.js"],"openApiReferenceData":{"operation":{"summary":"Transaction Processed","description":"The card-transaction lifecycle event. The status field carries the phase — AUTHORIZED, CLEARED, REVERSED, REFUNDED, or ADJUSTED.","tags":["Transaction Events"],"requestBody":"31dbca4b-8b1b-4da9-8d29-0bee8389b0ef","responses":{"200":"f0df98fa-9f2e-4641-ad81-abd45c953e84"},"method":"post","type":"webhook","servers":[],"security":[],"path":"TRANSACTION_PROCESSED","baseUrlOptions":[],"title":"Transaction Processed","codeSamples":[],"requiredOnlyExamples":false,"requestExamples":[{"dropdown":false,"language":"json","code":{"type":"pre","key":null,"ref":null,"props":{"className":"shiki shiki-themes github-light-default dark-plus","style":{"backgroundColor":"#ffffff","--shiki-dark-bg":"#0B0C0E","color":"#1f2328","--shiki-dark":"#D4D4D4"},"language":"json","children":{"type":"code","key":null,"ref":null,"props":{"language":"json","numberOfLines":"33","children":[{"type":"span","key":"0","ref":null,"props":{"className":"line","children":{"type":"span","key":null,"ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":"{"}}}},"\n",{"type":"span","key":"2","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"event\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":"\"TRANSACTION_PROCESSED\""}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":","}}]}},"\n",{"type":"span","key":"4","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"eventId\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":"\"EVT2W9SK2233S4C\""}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":","}}]}},"\n",{"type":"span","key":"6","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"businessId\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":"\"BUS1A2B3C4D5E6F\""}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":","}}]}},"\n",{"type":"span","key":"8","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"environment\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":"\"LIVE\""}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":","}}]}},"\n",{"type":"span","key":"10","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"timestamp\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":"\"2026-07-07T21:55:41Z\""}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":","}}]}},"\n",{"type":"span","key":"12","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"data\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": {"}}]}},"\n",{"type":"span","key":"14","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"transactionId\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":"\"237bc8d1-5b20-4d6b-8ade-059e8dd903ca\""}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":","}}]}},"\n",{"type":"span","key":"16","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"cardId\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":"\"crd_01HXYZ5555ABCDEF1111\""}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":","}}]}},"\n",{"type":"span","key":"18","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"cardholderId\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":"\"chl_01HXYZ1234ABCDEF5678\""}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":","}}]}},"\n",{"type":"span","key":"20","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"externalId\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":"\"my-user-id-789\""}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":","}}]}},"\n",{"type":"span","key":"22","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"type\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":"\"PURCHASE\""}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":","}}]}},"\n",{"type":"span","key":"24","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"status\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":"\"CLEARED\""}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":","}}]}},"\n",{"type":"span","key":"26","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"amount\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0550AE","--shiki-dark":"#B5CEA8"},"children":"13.68"}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":","}}]}},"\n",{"type":"span","key":"28","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"currency\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":"\"USD\""}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":","}}]}},"\n",{"type":"span","key":"30","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"billingAmount\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0550AE","--shiki-dark":"#B5CEA8"},"children":"13.68"}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":","}}]}},"\n",{"type":"span","key":"32","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"billingCurrency\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":"\"USD\""}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":","}}]}},"\n",{"type":"span","key":"34","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"relatedTransactionId\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":"\"21e2c774-66ac-4b09-9d9d-3abe0f944bda\""}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":","}}]}},"\n",{"type":"span","key":"36","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"references\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": {"}}]}},"\n",{"type":"span","key":"38","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"referenceNumber\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":"\"102300313422\""}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":","}}]}},"\n",{"type":"span","key":"40","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"rrn\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":"\"f0e85fb9-eaf8-4a62-8d58-e581fe332e40\""}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":","}}]}},"\n",{"type":"span","key":"42","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"merchantId\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":"\"IRKGOG97WMYUONX\""}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":","}}]}},"\n",{"type":"span","key":"44","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"network\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":"\"MASTERCARD\""}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":","}}]}},"\n",{"type":"span","key":"46","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"maskedPan\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":"\"XXXXXXXXXXXX4786\""}}]}},"\n",{"type":"span","key":"48","ref":null,"props":{"className":"line","children":{"type":"span","key":null,"ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":" },"}}}},"\n",{"type":"span","key":"50","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"merchant\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": {"}}]}},"\n",{"type":"span","key":"52","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"name\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":"\"ZYNGA - EMPIRES \u0026 PUZZ\""}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":","}}]}},"\n",{"type":"span","key":"54","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"id\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":"\"EUXEITE8IZPSUAW\""}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":","}}]}},"\n",{"type":"span","key":"56","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"country\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":"\"IE\""}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":","}}]}},"\n",{"type":"span","key":"58","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"mcc\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":"\"5816\""}}]}},"\n",{"type":"span","key":"60","ref":null,"props":{"className":"line","children":{"type":"span","key":null,"ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":" }"}}}},"\n",{"type":"span","key":"62","ref":null,"props":{"className":"line","children":{"type":"span","key":null,"ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":" }"}}}},"\n",{"type":"span","key":"64","ref":null,"props":{"className":"line","children":{"type":"span","key":null,"ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":"}"}}}},"\n"]}}}},"filename":"Webhook Payload (CLEARED)"}],"requestExampleType":"mdx","responseExamples":[{"dropdown":false,"language":"json","code":{"type":"pre","key":null,"ref":null,"props":{"className":"shiki shiki-themes github-light-default dark-plus","style":{"backgroundColor":"#ffffff","--shiki-dark-bg":"#0B0C0E","color":"#1f2328","--shiki-dark":"#D4D4D4"},"language":"json","children":{"type":"code","key":null,"ref":null,"props":{"language":"json","numberOfLines":"1","children":[{"type":"span","key":"0","ref":null,"props":{"className":"line","children":{"type":"span","key":null,"ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":"{}"}}}},"\n"]}}}},"filename":"200"}],"responseExampleType":"mdx"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"event":{"type":"string","example":"TRANSACTION_PROCESSED","uniqueKey":"event","typeLabel":"string"},"eventId":{"type":"string","uniqueKey":"eventId","typeLabel":"string"},"businessId":{"type":"string","uniqueKey":"businessId","typeLabel":"string"},"environment":{"type":"string","enum":["LIVE","SANDBOX"],"uniqueKey":"environment","typeLabel":"enum\u003cstring>"},"timestamp":{"type":"string","format":"date-time","uniqueKey":"timestamp","typeLabel":"string\u003cdate-time>"},"data":{"type":"object","properties":{"transactionId":{"type":"string","description":"Identifies this EVENT, not the purchase. An authorization and its clearing carry different values — correlate on relatedTransactionId.","example":"f94c6d97-f54c-4479-b590-3d97d65e2e92","uniqueKey":"data.transactionId","typeLabel":"string"},"cardId":{"type":"string","uniqueKey":"data.cardId","typeLabel":"string"},"cardholderId":{"type":"string","uniqueKey":"data.cardholderId","typeLabel":"string"},"externalId":{"oneOf":[{"type":"string","uniqueKey":"data.externalId.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.externalId.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.externalId","typeLabel":"string | null"},"type":{"type":"string","enum":["PURCHASE","REVERSAL","REFUND","ADJUSTMENT"],"example":"PURCHASE","uniqueKey":"data.type","typeLabel":"enum\u003cstring>"},"status":{"type":"string","enum":["AUTHORIZED","CLEARED","REVERSED","REFUNDED","ADJUSTED"],"example":"CLEARED","uniqueKey":"data.status","typeLabel":"enum\u003cstring>"},"amount":{"type":"number","description":"Transaction amount in dollars","uniqueKey":"data.amount","typeLabel":"number"},"currency":{"type":"string","uniqueKey":"data.currency","typeLabel":"string"},"billingAmount":{"type":"number","description":"Amount in the card billing currency, in dollars","uniqueKey":"data.billingAmount","typeLabel":"number"},"billingCurrency":{"type":"string","uniqueKey":"data.billingCurrency","typeLabel":"string"},"authorizationCode":{"type":"string","description":"Optional. The network's approval code, also present in references. NOT a correlation key — the network often omits it.","example":"021234","uniqueKey":"data.authorizationCode","typeLabel":"string"},"relatedTransactionId":{"type":"string","description":"The purchase key — group events by this. The same value on an authorization and its clearing; on a reversal or fee, the charge it derives from. Always present.","example":"2d4df94e-5fc1-4f5b-ab26-f4e4b756e272","uniqueKey":"data.relatedTransactionId","typeLabel":"string"},"chargeId":{"type":"string","description":"On a reversal, the charge being reversed","uniqueKey":"data.chargeId","typeLabel":"string"},"merchant":{"oneOf":[{"type":"object","properties":{"name":{"type":"string","uniqueKey":"data.merchant.oneOf.0.name","typeLabel":"string"},"id":{"type":"string","uniqueKey":"data.merchant.oneOf.0.id","typeLabel":"string"},"city":{"type":"string","uniqueKey":"data.merchant.oneOf.0.city","typeLabel":"string"},"country":{"type":"string","uniqueKey":"data.merchant.oneOf.0.country","typeLabel":"string"},"mcc":{"type":"string","uniqueKey":"data.merchant.oneOf.0.mcc","typeLabel":"string"},"mccDescription":{"type":"string","uniqueKey":"data.merchant.oneOf.0.mccDescription","typeLabel":"string"}},"uniqueKey":"data.merchant.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"name":{"type":"string"},"id":{"type":"string"},"city":{"type":"string"},"country":{"type":"string"},"mcc":{"type":"string"},"mccDescription":{"type":"string"}},"uniqueKey":"data.merchant.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.merchant","typeLabel":"object | null"},"references":{"type":"object","description":"Network identifiers exactly as supplied by the card network. A key is omitted when the network did not supply it, never sent empty.","properties":{"authorizationCode":{"type":"string","description":"The network's approval code. Optional — often absent, and never a correlation key.","example":"021234","uniqueKey":"data.references.authorizationCode","typeLabel":"string"},"referenceNumber":{"type":"string","description":"The acquirer's reference for the transaction, for reconciling against a statement.","example":"102300313422","uniqueKey":"data.references.referenceNumber","typeLabel":"string"},"rrn":{"type":"string","description":"Retrieval reference number.","example":"f0e85fb9-eaf8-4a62-8d58-e581fe332e40","uniqueKey":"data.references.rrn","typeLabel":"string"},"merchantId":{"type":"string","description":"The acquirer's merchant identifier.","example":"IRKGOG97WMYUONX","uniqueKey":"data.references.merchantId","typeLabel":"string"},"network":{"type":"string","description":"Card network that carried the transaction.","example":"MASTERCARD","uniqueKey":"data.references.network","typeLabel":"string"},"maskedPan":{"type":"string","description":"Masked PAN the charge was made on.","example":"XXXXXXXXXXXX4786","uniqueKey":"data.references.maskedPan","typeLabel":"string"}},"uniqueKey":"data.references","typeLabel":"object"}},"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"event":"TRANSACTION_PROCESSED","eventId":"evt_01HXY123456ABCDEF","businessId":"BUS1A2B3C4D5E6F","environment":"LIVE","timestamp":"2026-06-21T16:05:00Z","data":{"transactionId":"txn_01HXYZ3333ABCDEF0000","cardId":"crd_01HXYZ5555ABCDEF1111","cardholderId":"chd_01HXYZ1111ABCDEF0000","externalId":"ext_user_42","type":"PURCHASE","status":"CLEARED","amount":42.5,"currency":"USD","billingAmount":42.5,"billingCurrency":"USD","authorizationCode":"21e2c774-66ac-4b09-9d9d-3abe0f944bda","relatedTransactionId":"21e2c774-66ac-4b09-9d9d-3abe0f944bda","merchant":{"name":"OPENAI *CHATGPT SUBSCR","id":"SXONGQUGQWWJUTM","city":"SAN FRANCISCO","country":"US","mcc":"5734","mccDescription":"Computer Software Stores"}}},"examples":{"Example":{"title":"Example","value":{"event":"TRANSACTION_PROCESSED","eventId":"evt_01HXY123456ABCDEF","businessId":"BUS1A2B3C4D5E6F","environment":"LIVE","timestamp":"2026-06-21T16:05:00Z","data":{"transactionId":"txn_01HXYZ3333ABCDEF0000","cardId":"crd_01HXYZ5555ABCDEF1111","cardholderId":"chd_01HXYZ1111ABCDEF0000","externalId":"ext_user_42","type":"PURCHASE","status":"CLEARED","amount":42.5,"currency":"USD","billingAmount":42.5,"billingCurrency":"USD","authorizationCode":"21e2c774-66ac-4b09-9d9d-3abe0f944bda","relatedTransactionId":"21e2c774-66ac-4b09-9d9d-3abe0f944bda","merchant":{"name":"OPENAI *CHATGPT SUBSCR","id":"SXONGQUGQWWJUTM","city":"SAN FRANCISCO","country":"US","mcc":"5734","mccDescription":"Computer Software Stores"}}}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"f0df98fa-9f2e-4641-ad81-abd45c953e84":{"description":"Acknowledge the event.","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}}},"security":{},"servers":{}},"originalFileLocation":"v3.20/webhooks.json"},"subdomain":"fyatu","siteName":"FYATU API Docs","title":"Transaction Processed - FYATU API Docs","navMaps":{"firstHrefInVersion":{"v3.20 — CaaS":{"href":"/v3.20/webhooks/events/transaction-processed","matchLevel":0},"v3 — Business":{"href":"/home","matchLevel":4}},"firstHrefInLanguage":{}},"lastModified":"2026-11-15T22:31:12.241Z","originalFileLocation":"v3.20/webhooks/events/transaction-processed.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=\"The card-transaction lifecycle event. The status field carries the phase — AUTHORIZED, CLEARED, REVERSED, REFUNDED, or ADJUSTED.\">\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=\"Transaction Processed - FYATU API Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"The card-transaction lifecycle event. The status field carries the phase — AUTHORIZED, CLEARED, REVERSED, REFUNDED, or ADJUSTED.\">\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/webhooks/events/transaction-processed\">\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=Transaction+Events\u0026amp;title=Transaction+Processed\u0026amp;description=The+card-transaction+lifecycle+event.+The+status+field+carries+the+phase+%E2%80%94+AUTHORIZED%2C+CLEARED%2C+REVERSED%2C+REFUNDED%2C+or+ADJUSTED.\u0026amp;theme=4a91f0fc566d34e9acdb9cbb\u0026amp;signature=ee0da9b8d66341d0ff9a0c30098a8317f4d38b5a0720839d085c5c96c4ffd003\">\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=\"Transaction Processed - FYATU API Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"The card-transaction lifecycle event. The status field carries the phase — AUTHORIZED, CLEARED, REVERSED, REFUNDED, or ADJUSTED.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://fyatu.mintlify.site/_mintlify/api/og/v2?division=Transaction+Events\u0026amp;title=Transaction+Processed\u0026amp;description=The+card-transaction+lifecycle+event.+The+status+field+carries+the+phase+%E2%80%94+AUTHORIZED%2C+CLEARED%2C+REVERSED%2C+REFUNDED%2C+or+ADJUSTED.\u0026amp;theme=4a91f0fc566d34e9acdb9cbb\u0026amp;signature=ee0da9b8d66341d0ff9a0c30098a8317f4d38b5a0720839d085c5c96c4ffd003\">\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/webhooks/events/transaction-processed\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/v3.20/webhooks/events/transaction-processed.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/webhooks/events/transaction-processed#webpage\",\"url\":\"https://docs.fyatu.com/v3.20/webhooks/events/transaction-processed\",\"name\":\"Transaction Processed\",\"description\":\"The card-transaction lifecycle event. The status field carries the phase — AUTHORIZED, CLEARED, REVERSED, REFUNDED, or ADJUSTED.\",\"dateModified\":\"2026-11-15T22:31:12.241Z\",\"isPartOf\":{\"@id\":\"https://docs.fyatu.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.fyatu.com/v3.20/webhooks/events/transaction-processed#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.fyatu.com/v3.20/webhooks/events/transaction-processed#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"FYATU API Docs\",\"item\":\"https://docs.fyatu.com\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Transaction Processed\",\"item\":\"https://docs.fyatu.com/v3.20/webhooks/events/transaction-processed\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.fyatu.com/v3.20/webhooks/events/transaction-processed#apireference\",\"headline\":\"Transaction Processed\",\"name\":\"Transaction Processed\",\"description\":\"The card-transaction lifecycle event. The status field carries the phase — AUTHORIZED, CLEARED, REVERSED, REFUNDED, or ADJUSTED.\",\"url\":\"https://docs.fyatu.com/v3.20/webhooks/events/transaction-processed\",\"mainEntityOfPage\":{\"@id\":\"https://docs.fyatu.com/v3.20/webhooks/events/transaction-processed#webpage\"},\"dateModified\":\"2026-11-15T22:31:12.241Z\",\"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/webhooks/events/transaction-processed.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","pages":[{"title":"Documentation","href":"/v3.20/documentation/introduction"}]},{"tab":"API Reference","icon":"square-terminal","pages":[{"title":"API Reference","href":"/v3.20/api-reference/account/info"}]},{"tab":"Webhooks","icon":"webhook","groups":[{"group":"Guides","pages":[{"title":"Signature Verification","href":"/v3.20/webhooks/signature-verification"}]},{"group":"JIT Authorization","pages":[{"title":"Card Authorization Verify","openapi":"v3.20/webhooks.json webhook CARD_AUTHORIZATION_VERIFY","href":"/v3.20/webhooks/events/card-authorization-verify"}]},{"group":"Card Events","pages":[{"title":"Card Issued","openapi":"v3.20/webhooks.json webhook CARD_ISSUED","href":"/v3.20/webhooks/events/card-issued"},{"title":"Card Frozen","openapi":"v3.20/webhooks.json webhook CARD_FROZEN","href":"/v3.20/webhooks/events/card-frozen"},{"title":"Card Unfrozen","openapi":"v3.20/webhooks.json webhook CARD_UNFROZEN","href":"/v3.20/webhooks/events/card-unfrozen"},{"title":"Card Terminated","openapi":"v3.20/webhooks.json webhook CARD_TERMINATED","href":"/v3.20/webhooks/events/card-terminated"},{"title":"Card Status Corrected","openapi":"v3.20/webhooks.json webhook CARD_STATUS_CORRECTED","href":"/v3.20/webhooks/events/card-status-corrected"},{"title":"Card Termination Refund","openapi":"v3.20/webhooks.json webhook CARD_TERMINATION_REFUND","href":"/v3.20/webhooks/events/card-termination-refund"},{"title":"Card Termination Refund Post","openapi":"v3.20/webhooks.json webhook CARD_TERMINATION_REFUND_POST","href":"/v3.20/webhooks/events/card-termination-refund-post"},{"title":"Card Funded","openapi":"v3.20/webhooks.json webhook CARD_FUNDED","href":"/v3.20/webhooks/events/card-funded"},{"title":"Card Fund Failed","openapi":"v3.20/webhooks.json webhook CARD_FUND_FAILED","href":"/v3.20/webhooks/events/card-fund-failed"},{"title":"Card Unloaded","openapi":"v3.20/webhooks.json webhook CARD_UNLOADED","href":"/v3.20/webhooks/events/card-unloaded"},{"title":"Card Unload Failed","openapi":"v3.20/webhooks.json webhook CARD_UNLOAD_FAILED","href":"/v3.20/webhooks/events/card-unload-failed"},{"title":"Card Negative Balance","openapi":"v3.20/webhooks.json webhook CARD_NEGATIVE_BALANCE","href":"/v3.20/webhooks/events/card-negative-balance"},{"title":"Card Negative Balance Settled","openapi":"v3.20/webhooks.json webhook CARD_NEGATIVE_BALANCE_SETTLED","href":"/v3.20/webhooks/events/card-negative-balance-settled"},{"title":"Card 3DS OTP","openapi":"v3.20/webhooks.json webhook CARD_3DS_OTP","href":"/v3.20/webhooks/events/card-3ds-otp"},{"title":"Card Tokenization OTP","description":"Fired when a tokenization code is generated for adding the card to Apple Pay or Google Pay.","openapi":"v3.20/webhooks.json webhook CARD_TOKENIZATION_OTP","href":"/v3.20/webhooks/events/card-tokenization-otp"}]},{"group":"Transaction Events","pages":[{"title":"Transaction Processed","openapi":"v3.20/webhooks.json webhook TRANSACTION_PROCESSED","href":"/v3.20/webhooks/events/transaction-processed"},{"title":"Transaction Declined","description":"Fired when a card authorization is declined. No funds are moved.","openapi":"v3.20/webhooks.json webhook TRANSACTION_DECLINED","href":"/v3.20/webhooks/events/transaction-declined"},{"title":"Transaction Fee","openapi":"v3.20/webhooks.json webhook TRANSACTION_FEE","href":"/v3.20/webhooks/events/transaction-fee"},{"title":"Transaction Authorized","openapi":"v3.20/webhooks.json webhook TRANSACTION_AUTHORIZED","href":"/v3.20/webhooks/events/transaction-authorized"},{"title":"Transaction Cleared","openapi":"v3.20/webhooks.json webhook TRANSACTION_CLEARED","href":"/v3.20/webhooks/events/transaction-cleared"},{"title":"Transaction Reversed","openapi":"v3.20/webhooks.json webhook TRANSACTION_REVERSED","href":"/v3.20/webhooks/events/transaction-reversed"}]},{"group":"Cardholder Events","pages":[{"title":"Cardholder Created","openapi":"v3.20/webhooks.json webhook CARDHOLDER_CREATED","href":"/v3.20/webhooks/events/cardholder-created"},{"title":"Cardholder Suspended","openapi":"v3.20/webhooks.json webhook CARDHOLDER_SUSPENDED","href":"/v3.20/webhooks/events/cardholder-suspended"},{"title":"Cardholder Reactivated","openapi":"v3.20/webhooks.json webhook CARDHOLDER_REACTIVATED","href":"/v3.20/webhooks/events/cardholder-reactivated"},{"title":"Cardholder Deleted","openapi":"v3.20/webhooks.json webhook CARDHOLDER_DELETED","href":"/v3.20/webhooks/events/cardholder-deleted"},{"title":"Cardholder KYC Approved","openapi":"v3.20/webhooks.json webhook CARDHOLDER_KYC_APPROVED","href":"/v3.20/webhooks/events/cardholder-kyc-approved"},{"title":"Cardholder KYC Rejected","openapi":"v3.20/webhooks.json webhook CARDHOLDER_KYC_REJECTED","href":"/v3.20/webhooks/events/cardholder-kyc-rejected"}]},{"group":"Account Events","pages":[{"title":"Account Low Balance","openapi":"v3.20/webhooks.json webhook ACCOUNT_LOW_BALANCE","href":"/v3.20/webhooks/events/account-low-balance"},{"title":"Account Withdrawal Initiated","openapi":"v3.20/webhooks.json webhook ACCOUNT_WITHDRAWAL_INITIATED","href":"/v3.20/webhooks/events/account-withdrawal-initiated"},{"title":"Account Withdrawal Completed","openapi":"v3.20/webhooks.json webhook ACCOUNT_WITHDRAWAL_COMPLETED","href":"/v3.20/webhooks/events/account-withdrawal-completed"},{"title":"Account Withdrawal Failed","openapi":"v3.20/webhooks.json webhook ACCOUNT_WITHDRAWAL_FAILED","href":"/v3.20/webhooks/events/account-withdrawal-failed"}]},{"group":"Billing Events","pages":[{"title":"Billing Invoice Created","openapi":"v3.20/webhooks.json webhook BILLING_INVOICE_CREATED","href":"/v3.20/webhooks/events/billing-invoice-created"},{"title":"Billing Invoice Paid","openapi":"v3.20/webhooks.json webhook BILLING_INVOICE_PAID","href":"/v3.20/webhooks/events/billing-invoice-paid"},{"title":"Billing Deposit Detected","openapi":"v3.20/webhooks.json webhook BILLING_DEPOSIT_DETECTED","href":"/v3.20/webhooks/events/billing-deposit-detected"},{"title":"Billing Deposit Confirmed","openapi":"v3.20/webhooks.json webhook BILLING_DEPOSIT_CONFIRMED","href":"/v3.20/webhooks/events/billing-deposit-confirmed"}]}]}]},{"version":"v3 — Business","pages":[{"title":"v3 — Business","href":"/home"}]}]},"basePath":"","title":"Transaction Processed - FYATU API Docs","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CiUHMMOm.js","snippetPresets-BgfXU7Bw.js","utils-DWvOwgy_.js","style-to-object-BY3JEAdk.js","utils-BN7RXSMJ.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-CFw8bq89.js","conditional-requirements-CFM0id0Q.js","cloneDeep-CAwdfOU2.js","_Uint8Array-BJr8e-ZL.js","isObject-FP1Yky1u.js","ApiExamples-XX0UgMZK.js","usePlaygroundInputsStore-DXDFSa1V.js","shallow-CdX5aREi.js","isEqual-CoOaxexF.js","CodeSnippets-Cg2wpzWm.js","CodeSnippet-D_HwgQO_.js","getApiPlaygroundDisplay-CmCoerhe.js","Page-CVJ-f_k1.js","DynamicMarkdown-CQM9Bhbv.js","SectionHeading-DpbrP8nQ.js","icon-BPCgijHy.js","MethodPill-GQ8DuY0c.js","getPastedJson-Cb5mT31m.js","Check2Icon-a7bUI6e8.js","axios-CsQoIw0U.js","Markdown-CX2QY19L.js","AssistantPageLink-CY3bFglh.js","dist-Dl6_zDnT.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}