Meridian sends this webhook whenever money moves into or out of a customer’s virtual account on any rail: ACH, wire, SWIFT, or stablecoin. Two events share one payload:
virtual_account_transaction_created when the transaction is first recorded.
virtual_account_transaction_updated when it reaches a final status.
The X-Meridian-Event-Type header tells you which one you received. Retry timing, signature verification, and endpoint configuration are covered in the webhooks overview.
Deposits by funding rail
Deposits can arrive over several rails, and the same fields carry different content depending on which one was used.
"", the sender’s wallet address, and "NOTPROVIDED"
[]
Stablecoin sender fields
On stablecoin deposits, the sender fields hold wallet data, not bank data.
Field
Value on a stablecoin deposit
originatorAccount
The sender’s wallet address, for example 0x5aAe…BeAed (42 characters)
originatorName
The sender’s name when the sending VASP discloses it, otherwise "", an empty string
originatorInstitution
The sending VASP’s name when it is known, otherwise "NOTPROVIDED"
Neither originatorName nor originatorInstitution is ever null on a stablecoin deposit, so a null check will not tell you the sender is unknown. Check for the empty string and the NOTPROVIDED sentinel.
Stablecoin currency values such as USDC_ETH name both the asset and its network. They are up to 9 characters and are not ISO 4217 codes, so a 3-character currency column will reject them.
Examples
Use the picker in the top-right corner of the JSON block below to switch between these examples:
ACH deposit (SUCCESS)
Wire deposit with fee (SUCCESS)
USDC deposit, sender not disclosed (SUCCESS)
USDC deposit, sender disclosed (SUCCESS)
Withdrawal (PENDING)
Withdrawal (SUCCESS)
ACH deposit (FAILED)
Authorizations
X-Meridian-Signature
string
header
required
Meridian signs every webhook request it sends you.
Headers on every delivery:
X-Meridian-Api-Key
X-Meridian-Timestamp
X-Meridian-Signature
X-Meridian-Signature is the hex-encoded HMAC-SHA256 of apiKey + timestamp + method + path + body, computed with your webhook secret. The webhook API key and secret are issued separately from your REST API credentials. Recompute it from the request you received and reject the delivery if it does not match. See Security in the webhooks overview.
Headers
X-Meridian-Resource-Type
string
required
The resource this event is about. Always virtual_account_transaction for this webhook.
Allowed value: "virtual_account_transaction"
X-Meridian-Event-Type
enum<string>
required
Which event fired. virtual_account_transaction_created when the transaction is first recorded, virtual_account_transaction_updated when it reaches a terminal status.
Available options:
virtual_account_transaction_created,
virtual_account_transaction_updated
X-Meridian-Api-Key
string
required
Your webhook API key. Meridian issues this separately from the API key you use to call the REST API, so do not expect the two to match. Use it to select the matching webhook secret when verifying the signature.
X-Meridian-Timestamp
string
required
Time the request was signed, in milliseconds since the Unix epoch. Reject deliveries whose timestamp is too far from your clock to guard against replay.
Body
application/json
Webhook body. A single top-level key, virtualAccountTransaction, wraps the transaction. No event envelope, ID, or timestamp is added around it.
virtualAccountTransaction
object
required
A virtual account transaction as delivered by the webhook. Every field is present on every event. Fields that do not apply to the transaction's direction or funding rail are sent as an explicit null, never omitted. Length limits are the current storage widths, useful for sizing your own columns, not contractual guarantees.
Show child attributes
Response
200
Success
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Meridian","colors":{"primary":"#0A0A0A","light":"#fff","dark":"#0A0A0A"},"logo":{"light":"https://mintcdn.com/meridian-18e67158/VgZYEMrM1D9FVN_L/logo/meridian-light.svg?fit=max\u0026auto=format\u0026n=VgZYEMrM1D9FVN_L\u0026q=85\u0026s=165e274c2a61a48b1bbeb002a86899a0","dark":"https://mintcdn.com/meridian-18e67158/VgZYEMrM1D9FVN_L/logo/meridian-dark.svg?fit=max\u0026auto=format\u0026n=VgZYEMrM1D9FVN_L\u0026q=85\u0026s=52efdc7868532b4b80bcc6d6accd2f7a"},"favicon":"https://mintcdn.com/meridian-18e67158/hVhmegI9RGtyj60_/favicon.svg?fit=max\u0026auto=format\u0026n=hVhmegI9RGtyj60_\u0026q=85\u0026s=e0c3605c4133c3121025a59016bad7f8","api":{"playground":{"display":"simple"}},"appearance":{"default":"light"},"background":{"color":{"dark":"#0A0A0A"}},"navbar":{"links":[{"href":"https://www.mnai.com/","label":"Company"},{"href":"https://www.mnai.com/privacy","label":"Privacy"}],"primary":{"type":"button","label":"Contact Support","href":"https://meridian.support.site"}},"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/meridiantechnologies","website":"https://www.mnai.com/"}},"seo":{"metatags":{"robots":"noindex"}},"fonts":{"family":"Manrope"},"contextual":{"options":["copy","view","download-spec","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Changelog","icon":"list","href":"/changelog"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"meridian-18e67158","hasAudioNarration":false,"actualSubdomain":"meridian-18e67158","customDomains":["docs.mnai.com"],"gitSource":{"type":"github","owner":"meridian-software","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":false,"contextualFeedback":{"allowEmail":true}},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"REMOVE_BRANDING":{"status":"ENABLED"},"CONTEXTUAL_FEEDBACK":{"status":"ENABLED","enabled":"DISABLED"},"CODE_SNIPPET_FEEDBACK":{"status":"ENABLED","enabled":"DISABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6afee2b65735af7f41cf7b5a","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"Meridian Accounts for Business","count":42},{"language":"default","tag":"API Reference","count":39},{"language":"default","tag":"Retail U.S. Accounts","count":16},{"language":"default","tag":"Realtime Collections","count":14},{"language":"default","tag":"Payout Origination","count":13},{"language":"default","tag":"Getting Started","count":13},{"language":"default","tag":"Bank Transfers","count":11},{"language":"default","tag":"Webhooks","count":10},{"language":"default","tag":"Credit API Example","count":8},{"language":"default","tag":"Integration Guide","count":8}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":true,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true,"deflection":{"enabled":true,"email":"support@meridianpay.com","showHelpButton":true}},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"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":"control","enabled":true,"payload":{"type":"string","value":"control"},"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}],"starterQuestions":[{"_id":"69cb173d27b882b01903afac","deploymentId":"69af73ecd3d5be6fd07ee56e","questionText":"How do I set up the Virtual Accounts WebView in my app?","status":"active","generatedBy":"manual","createdAt":"2026-03-31T00:37:17.640Z","updatedAt":"2026-03-31T00:37:17.640Z","__v":0},{"_id":"69cb172e27b882b01903af7d","deploymentId":"69af73ecd3d5be6fd07ee56e","questionText":"How do withdrawals and the Credit API work?","status":"active","generatedBy":"manual","createdAt":"2026-03-31T00:37:02.071Z","updatedAt":"2026-03-31T00:37:02.071Z","__v":0},{"_id":"69cb171227b882b01903af39","deploymentId":"69af73ecd3d5be6fd07ee56e","questionText":"How do I authenticate my API requests?","status":"active","generatedBy":"manual","createdAt":"2026-03-31T00:36:34.719Z","updatedAt":"2026-03-31T00:36:34.719Z","__v":0}],"googleFontsInlined":true},"customCss":[]}
{"page":{"pagePath":"products/retail-va/api-reference/webhooks/webhooks-transaction","slug":"/products/retail-va/api-reference/webhooks/webhooks-transaction","pageMetadata":{"title":"Virtual Account Transaction","description":"Learn when the virtual account transaction webhook is sent and what data it includes.","openapi":"products/retail-va/api-reference/retail-rtd.json webhook virtual_account_transaction","href":"/products/retail-va/api-reference/webhooks/webhooks-transaction"},"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: \"Learn when the virtual account transaction webhook is sent and what data it includes.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Heading,Table,Warning}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Meridian sends this webhook whenever money moves into or out of a customer’s virtual account on any rail: ACH, wire, SWIFT, or stablecoin. Two events share one payload:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:_jsx(_components.code,{children:`virtual_account_transaction_created`})}),` when the transaction is first recorded.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:_jsx(_components.code,{children:`virtual_account_transaction_updated`})}),` when it reaches a final status.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`The `,_jsx(_components.code,{children:`X-Meridian-Event-Type`}),` header tells you which one you received. Retry timing, signature verification, and endpoint configuration are covered in the `,_jsx(_components.a,{href:`/products/retail-va/webhooks-overview`,children:`webhooks overview`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`deposits-by-funding-rail`,children:`Deposits by funding rail`}),`\n`,_jsx(_components.p,{children:`Deposits can arrive over several rails, and the same fields carry different content depending on which one was used.`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{style:{textAlign:`left`},children:`Rail`}),_jsx(_components.th,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`depositType`})}),_jsx(_components.th,{style:{textAlign:`left`},children:`Currency values`}),_jsx(_components.th,{style:{textAlign:`left`},children:`Amount scale`}),_jsxs(_components.th,{style:{textAlign:`left`},children:[_jsx(_components.code,{children:`originatorName`}),` / `,_jsx(_components.code,{children:`originatorAccount`}),` / `,_jsx(_components.code,{children:`originatorInstitution`})]}),_jsx(_components.th,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`fees`})})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:`ACH`}),_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`ACH`})}),_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`USD`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`2 decimal places`}),_jsx(_components.td,{style:{textAlign:`left`},children:`Sender’s name, bank account number, and bank name`}),_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`[]`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:`Domestic wire`}),_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`WIRE`})}),_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`USD`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`2 decimal places`}),_jsx(_components.td,{style:{textAlign:`left`},children:`Sender’s name, bank account number, and bank name`}),_jsxs(_components.td,{style:{textAlign:`left`},children:[`One `,_jsx(_components.code,{children:`WIRE_PROCESSING_FEE`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:`International wire`}),_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`SWIFT`})}),_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`USD`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`2 decimal places`}),_jsx(_components.td,{style:{textAlign:`left`},children:`Sender’s name, bank account number, and bank name`}),_jsxs(_components.td,{style:{textAlign:`left`},children:[`One `,_jsx(_components.code,{children:`SWIFT_PROCESSING_FEE`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:`Stablecoin (on-chain)`}),_jsxs(_components.td,{style:{textAlign:`left`},children:[_jsx(_components.code,{children:`ETHEREUM`}),`, `,_jsx(_components.code,{children:`BASE`}),`, or `,_jsx(_components.code,{children:`POLYGON`})]}),_jsxs(_components.td,{style:{textAlign:`left`},children:[_jsx(_components.code,{children:`USDC_ETH`}),`, `,_jsx(_components.code,{children:`USDC_BASE`}),`, `,_jsx(_components.code,{children:`USDC_POLY`}),`, `,_jsx(_components.code,{children:`USDT_ETH`}),`, `,_jsx(_components.code,{children:`USDT_BASE`}),`, `,_jsx(_components.code,{children:`USDT_POLY`})]}),_jsx(_components.td,{style:{textAlign:`left`},children:`6 decimal places`}),_jsxs(_components.td,{style:{textAlign:`left`},children:[_jsx(_components.code,{children:`\"\"`}),`, the sender’s wallet address, and `,_jsx(_components.code,{children:`\"NOTPROVIDED\"`})]}),_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`[]`})})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`stablecoin-sender-fields`,children:`Stablecoin sender fields`}),`\n`,_jsx(_components.p,{children:`On stablecoin deposits, the sender fields hold wallet data, not bank data.`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{style:{textAlign:`left`},children:`Field`}),_jsx(_components.th,{style:{textAlign:`left`},children:`Value on a stablecoin deposit`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`originatorAccount`})}),_jsxs(_components.td,{style:{textAlign:`left`},children:[`The sender’s wallet address, for example `,_jsx(_components.code,{children:`0x5aAe…BeAed`}),` (42 characters)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`originatorName`})}),_jsxs(_components.td,{style:{textAlign:`left`},children:[`The sender’s name when the sending VASP discloses it, otherwise `,_jsx(_components.code,{children:`\"\"`}),`, an empty string`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`originatorInstitution`})}),_jsxs(_components.td,{style:{textAlign:`left`},children:[`The sending VASP’s name when it is known, otherwise `,_jsx(_components.code,{children:`\"NOTPROVIDED\"`})]})]})]})]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`Neither `,_jsx(_components.code,{children:`originatorName`}),` nor `,_jsx(_components.code,{children:`originatorInstitution`}),` is ever `,_jsx(_components.code,{children:`null`}),` on a stablecoin deposit, so a null check will not tell you the sender is unknown. Check for the empty string and the `,_jsx(_components.code,{children:`NOTPROVIDED`}),` sentinel.`]})}),`\n`,_jsxs(_components.p,{children:[`Stablecoin currency values such as `,_jsx(_components.code,{children:`USDC_ETH`}),` name both the asset and its network. They are up to 9 characters and are not ISO 4217 codes, so a 3-character currency column will reject them.`]}),`\n`,_jsx(Heading,{level:`2`,id:`examples`,children:`Examples`}),`\n`,_jsx(_components.p,{children:`Use the picker in the top-right corner of the JSON block below to switch between these examples:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:_jsx(_components.strong,{children:`ACH deposit (SUCCESS)`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.strong,{children:`Wire deposit with fee (SUCCESS)`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.strong,{children:`USDC deposit, sender not disclosed (SUCCESS)`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.strong,{children:`USDC deposit, sender disclosed (SUCCESS)`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.strong,{children:`Withdrawal (PENDING)`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.strong,{children:`Withdrawal (SUCCESS)`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.strong,{children:`ACH deposit (FAILED)`})}),`\n`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Virtual Account Transaction","description":"Learn when the virtual account transaction webhook is sent and what data it includes.","openapi":"products/retail-va/api-reference/retail-rtd.json webhook virtual_account_transaction","href":"/products/retail-va/api-reference/webhooks/webhooks-transaction"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Deposits by funding rail","slug":"deposits-by-funding-rail","depth":2,"children":[{"title":"Stablecoin sender fields","slug":"stablecoin-sender-fields","depth":3,"children":[]}]},{"title":"Examples","slug":"examples","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/meridian-18e67158/625a1f69d47615a4/postman/build.js","/_mintlify/custom/meridian-18e67158/a6d3c14b21f9dc8f/postman/scripts/meridian-accounts.pre-request.js","/_mintlify/custom/meridian-18e67158/92d5577deff5b613/postman/scripts/payout-origination.pre-request.js","/_mintlify/custom/meridian-18e67158/d2d8072a808f0876/postman/scripts/shared.tests.js"],"openApiReferenceData":{"operation":{"x-hidden":true,"summary":"Virtual Account Transaction","description":"Learn when the virtual account transaction webhook is sent and what data it includes.","parameters":["be54d65c-2d91-40ac-942a-41e53052d18b","62d5b2ac-da98-4452-818d-84cd8883411f","14da6057-61e2-4a61-b1a2-33091ad61fdb","12255111-ca3d-4d51-b7c5-7c1551a33d02"],"requestBody":"aa57089c-f925-4b36-b468-ec2fea221181","responses":{"200":"42b2024b-63e0-4a47-856b-7d255d0ee90e"},"operationId":"virtualAccountTransaction","security":["a7689b61-1d49-4724-ac19-d74fccad9a36"],"method":"post","type":"webhook","servers":["45a62985-c3bc-4b30-bebd-d67fe7438d94","be777e9f-518e-42f7-afd2-c847075201e8"],"path":"virtual_account_transaction","baseUrlOptions":["https://sandbox.api.mnai.com","https://api.mnai.com"],"title":"Virtual Account Transaction","codeSamples":[],"requiredOnlyExamples":false,"requestExamples":[{"language":"json","filename":"ACH deposit (SUCCESS)","code":"{\n \"virtualAccountTransaction\": {\n \"id\": \"ustxn-4h8n2kq7wm3xp9rt6vbc1dfz\",\n \"createdAt\": \"2026-09-14T13:02:11.000Z\",\n \"updatedAt\": \"2026-09-15T09:30:45.000Z\",\n \"transactionRef\": \"M8K3N2P7QW\",\n \"externalRef\": null,\n \"userId\": \"ususr-7k2mqp4v9yc3xr8swld6bne\",\n \"virtualAccountId\": \"uspay-pyj5tywsw7v0pzuyjirxvso2\",\n \"type\": \"DEPOSIT\",\n \"status\": \"SUCCESS\",\n \"statusReason\": null,\n \"debitAmount\": \"250.00\",\n \"debitCurrency\": \"USD\",\n \"fromAmount\": \"250.00\",\n \"fromCurrency\": \"USD\",\n \"toAmount\": \"250.00\",\n \"toCurrency\": \"USD\",\n \"exchangeRate\": \"1\",\n \"fees\": [],\n \"depositType\": \"ACH\",\n \"originatorMemo\": \"PAYROLL SEP 2026\",\n \"originatorName\": \"Maria Santos\",\n \"originatorAccount\": \"000123456789\",\n \"originatorInstitution\": \"First Example Bank\",\n \"receiverName\": null,\n \"receiverAccount\": null,\n \"receiverInstitution\": null\n }\n}"},{"language":"json","filename":"Wire deposit with fee (SUCCESS)","code":"{\n \"virtualAccountTransaction\": {\n \"id\": \"ustxn-9m3rw8kd2fq7xn5tj4ve6hyz\",\n \"createdAt\": \"2026-09-15T15:41:03.000Z\",\n \"updatedAt\": \"2026-09-15T16:02:19.000Z\",\n \"transactionRef\": \"M2QW7N8K3P\",\n \"externalRef\": null,\n \"userId\": \"ususr-7k2mqp4v9yc3xr8swld6bne\",\n \"virtualAccountId\": \"uspay-pyj5tywsw7v0pzuyjirxvso2\",\n \"type\": \"DEPOSIT\",\n \"status\": \"SUCCESS\",\n \"statusReason\": null,\n \"debitAmount\": \"1000.00\",\n \"debitCurrency\": \"USD\",\n \"fromAmount\": \"985.00\",\n \"fromCurrency\": \"USD\",\n \"toAmount\": \"985.00\",\n \"toCurrency\": \"USD\",\n \"exchangeRate\": \"1\",\n \"fees\": [\n {\n \"type\": \"WIRE_PROCESSING_FEE\",\n \"amount\": \"15.00\",\n \"currency\": \"USD\",\n \"label\": \"Wire processing fee\"\n }\n ],\n \"depositType\": \"WIRE\",\n \"originatorMemo\": \"INVOICE 4471\",\n \"originatorName\": \"Acme Trading LLC\",\n \"originatorAccount\": \"4401002233\",\n \"originatorInstitution\": \"Example National Bank\",\n \"receiverName\": null,\n \"receiverAccount\": null,\n \"receiverInstitution\": null\n }\n}"},{"language":"json","filename":"USDC deposit, sender not disclosed (SUCCESS)","code":"{\n \"virtualAccountTransaction\": {\n \"id\": \"ustxn-6tq2vd8xk4wn9pr3zm7hc5jb\",\n \"createdAt\": \"2026-09-15T18:07:52.000Z\",\n \"updatedAt\": \"2026-09-15T18:09:14.000Z\",\n \"transactionRef\": \"M5P9K2W7NQ\",\n \"externalRef\": null,\n \"userId\": \"ususr-7k2mqp4v9yc3xr8swld6bne\",\n \"virtualAccountId\": \"uspay-pyj5tywsw7v0pzuyjirxvso2\",\n \"type\": \"DEPOSIT\",\n \"status\": \"SUCCESS\",\n \"statusReason\": null,\n \"debitAmount\": \"100.250000\",\n \"debitCurrency\": \"USDC_ETH\",\n \"fromAmount\": \"100.250000\",\n \"fromCurrency\": \"USDC_ETH\",\n \"toAmount\": \"100.25\",\n \"toCurrency\": \"USD\",\n \"exchangeRate\": \"1\",\n \"fees\": [],\n \"depositType\": \"ETHEREUM\",\n \"originatorMemo\": null,\n \"originatorName\": \"\",\n \"originatorAccount\": \"0x5aAeb6053F3E94C9b9A09f33669435E7Ef1BeAed\",\n \"originatorInstitution\": \"NOTPROVIDED\",\n \"receiverName\": null,\n \"receiverAccount\": null,\n \"receiverInstitution\": null\n }\n}"},{"language":"json","filename":"USDC deposit, sender disclosed (SUCCESS)","code":"{\n \"virtualAccountTransaction\": {\n \"id\": \"ustxn-3wn8kq5xd7tp2vr9zm4hc6jf\",\n \"createdAt\": \"2026-09-15T19:12:30.000Z\",\n \"updatedAt\": \"2026-09-15T19:13:48.000Z\",\n \"transactionRef\": \"M6Q3P8W2NK\",\n \"externalRef\": null,\n \"userId\": \"ususr-7k2mqp4v9yc3xr8swld6bne\",\n \"virtualAccountId\": \"uspay-pyj5tywsw7v0pzuyjirxvso2\",\n \"type\": \"DEPOSIT\",\n \"status\": \"SUCCESS\",\n \"statusReason\": null,\n \"debitAmount\": \"500.000000\",\n \"debitCurrency\": \"USDC_ETH\",\n \"fromAmount\": \"500.000000\",\n \"fromCurrency\": \"USDC_ETH\",\n \"toAmount\": \"500.00\",\n \"toCurrency\": \"USD\",\n \"exchangeRate\": \"1\",\n \"fees\": [],\n \"depositType\": \"ETHEREUM\",\n \"originatorMemo\": null,\n \"originatorName\": \"Ana Lim\",\n \"originatorAccount\": \"0x8Ba1f109551bD432803012645Ac136ddd64DBA72\",\n \"originatorInstitution\": \"Coinbase\",\n \"receiverName\": null,\n \"receiverAccount\": null,\n \"receiverInstitution\": null\n }\n}"},{"language":"json","filename":"Withdrawal (PENDING)","code":"{\n \"virtualAccountTransaction\": {\n \"id\": \"ustxn-8kd3nq7wm2xp5rt9vb4cf6hz\",\n \"createdAt\": \"2026-09-15T09:31:02.000Z\",\n \"updatedAt\": \"2026-09-15T09:31:02.000Z\",\n \"transactionRef\": \"M3W8P2K7NQ\",\n \"externalRef\": null,\n \"userId\": \"ususr-7k2mqp4v9yc3xr8swld6bne\",\n \"virtualAccountId\": \"uspay-pyj5tywsw7v0pzuyjirxvso2\",\n \"type\": \"WITHDRAWAL\",\n \"status\": \"PENDING\",\n \"statusReason\": null,\n \"debitAmount\": \"250.00\",\n \"debitCurrency\": \"USD\",\n \"fromAmount\": \"250.00\",\n \"fromCurrency\": \"USD\",\n \"toAmount\": \"0\",\n \"toCurrency\": \"PHP\",\n \"exchangeRate\": \"0\",\n \"fees\": [],\n \"depositType\": null,\n \"originatorMemo\": null,\n \"originatorName\": null,\n \"originatorAccount\": \"9876543210\",\n \"originatorInstitution\": null,\n \"receiverName\": \"Juan Dela Cruz\",\n \"receiverAccount\": \"1234567890\",\n \"receiverInstitution\": \"Example Bank\"\n }\n}"},{"language":"json","filename":"Withdrawal (SUCCESS)","code":"{\n \"virtualAccountTransaction\": {\n \"id\": \"ustxn-8kd3nq7wm2xp5rt9vb4cf6hz\",\n \"createdAt\": \"2026-09-15T09:31:02.000Z\",\n \"updatedAt\": \"2026-09-15T09:45:37.000Z\",\n \"transactionRef\": \"M3W8P2K7NQ\",\n \"externalRef\": null,\n \"userId\": \"ususr-7k2mqp4v9yc3xr8swld6bne\",\n \"virtualAccountId\": \"uspay-pyj5tywsw7v0pzuyjirxvso2\",\n \"type\": \"WITHDRAWAL\",\n \"status\": \"SUCCESS\",\n \"statusReason\": null,\n \"debitAmount\": \"250.00\",\n \"debitCurrency\": \"USD\",\n \"fromAmount\": \"250.00\",\n \"fromCurrency\": \"USD\",\n \"toAmount\": \"14000.00\",\n \"toCurrency\": \"PHP\",\n \"exchangeRate\": \"56.00\",\n \"fees\": [],\n \"depositType\": null,\n \"originatorMemo\": null,\n \"originatorName\": null,\n \"originatorAccount\": \"9876543210\",\n \"originatorInstitution\": null,\n \"receiverName\": \"Juan Dela Cruz\",\n \"receiverAccount\": \"1234567890\",\n \"receiverInstitution\": \"Example Bank\"\n }\n}"},{"language":"json","filename":"ACH deposit (FAILED)","code":"{\n \"virtualAccountTransaction\": {\n \"id\": \"ustxn-5vb9tr2kf7xn4pq8wm3dc6hj\",\n \"createdAt\": \"2026-09-14T11:15:40.000Z\",\n \"updatedAt\": \"2026-09-15T07:02:08.000Z\",\n \"transactionRef\": \"M9K2N7W3PQ\",\n \"externalRef\": null,\n \"userId\": \"ususr-7k2mqp4v9yc3xr8swld6bne\",\n \"virtualAccountId\": \"uspay-pyj5tywsw7v0pzuyjirxvso2\",\n \"type\": \"DEPOSIT\",\n \"status\": \"FAILED\",\n \"statusReason\": \"BANK_REJECTION\",\n \"debitAmount\": \"75.00\",\n \"debitCurrency\": \"USD\",\n \"fromAmount\": \"75.00\",\n \"fromCurrency\": \"USD\",\n \"toAmount\": \"75.00\",\n \"toCurrency\": \"USD\",\n \"exchangeRate\": \"1\",\n \"fees\": [],\n \"depositType\": \"ACH\",\n \"originatorMemo\": null,\n \"originatorName\": \"Jose Reyes\",\n \"originatorAccount\": \"\",\n \"originatorInstitution\": \"Example Credit Union\",\n \"receiverName\": null,\n \"receiverAccount\": null,\n \"receiverInstitution\": null\n }\n}"}],"requestExampleType":"webhook","responseExampleType":"generated"},"dependencies":{"parameters":{"be54d65c-2d91-40ac-942a-41e53052d18b":{"name":"X-Meridian-Resource-Type","in":"header","required":true,"description":"The resource this event is about. Always `virtual_account_transaction` for this webhook.","schema":{"type":"string","const":"virtual_account_transaction","isRequired":true,"description":"The resource this event is about. Always `virtual_account_transaction` for this webhook.","uniqueKey":"","typeLabel":"string"}},"62d5b2ac-da98-4452-818d-84cd8883411f":{"name":"X-Meridian-Event-Type","in":"header","required":true,"description":"Which event fired. `virtual_account_transaction_created` when the transaction is first recorded, `virtual_account_transaction_updated` when it reaches a terminal status.","schema":{"type":"string","enum":["virtual_account_transaction_created","virtual_account_transaction_updated"],"isRequired":true,"description":"Which event fired. `virtual_account_transaction_created` when the transaction is first recorded, `virtual_account_transaction_updated` when it reaches a terminal status.","uniqueKey":"","typeLabel":"enum\u003cstring>"}},"14da6057-61e2-4a61-b1a2-33091ad61fdb":{"name":"X-Meridian-Api-Key","in":"header","required":true,"description":"Your **webhook** API key. Meridian issues this separately from the API key you use to call the REST API, so do not expect the two to match. Use it to select the matching webhook secret when verifying the signature.","schema":{"type":"string","isRequired":true,"description":"Your **webhook** API key. Meridian issues this separately from the API key you use to call the REST API, so do not expect the two to match. Use it to select the matching webhook secret when verifying the signature.","uniqueKey":"","typeLabel":"string"},"example":"your-webhook-api-key"},"12255111-ca3d-4d51-b7c5-7c1551a33d02":{"name":"X-Meridian-Timestamp","in":"header","required":true,"description":"Time the request was signed, in milliseconds since the Unix epoch. Reject deliveries whose timestamp is too far from your clock to guard against replay.","schema":{"type":"string","isRequired":true,"description":"Time the request was signed, in milliseconds since the Unix epoch. Reject deliveries whose timestamp is too far from your clock to guard against replay.","uniqueKey":"","typeLabel":"string"},"example":"1757952000000"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["virtualAccountTransaction"],"properties":{"virtualAccountTransaction":{"type":"object","description":"A virtual account transaction as delivered by the webhook. Every field is present on every event. Fields that do not apply to the transaction's direction or funding rail are sent as an explicit `null`, never omitted. Length limits are the current storage widths, useful for sizing your own columns, not contractual guarantees.","additionalProperties":false,"required":["id","createdAt","updatedAt","transactionRef","userId","virtualAccountId","type","status"],"properties":{"id":{"type":"string","description":"Meridian-generated unique identifier for the transaction. Up to 64 characters.","isRequired":true,"uniqueKey":"virtualAccountTransaction.id","typeLabel":"string"},"createdAt":{"type":"string","description":"When the transaction was first recorded, formatted `yyyy-MM-dd'T'HH:mm:ss.SSS'Z'` in UTC, for example `2026-09-15T14:20:00.000Z`. Always 24 characters.","format":"date-time","isRequired":true,"uniqueKey":"virtualAccountTransaction.createdAt","typeLabel":"string\u003cdate-time>"},"updatedAt":{"type":"string","description":"When the transaction was last updated. Same format as `createdAt`. Always 24 characters.","format":"date-time","isRequired":true,"uniqueKey":"virtualAccountTransaction.updatedAt","typeLabel":"string\u003cdate-time>"},"transactionRef":{"type":"string","description":"Meridian's human-readable transaction reference, suitable for showing to your customer. Up to 64 characters.","isRequired":true,"uniqueKey":"virtualAccountTransaction.transactionRef","typeLabel":"string"},"userId":{"type":"string","description":"Meridian identifier of the customer who owns the virtual account. Up to 64 characters.","isRequired":true,"uniqueKey":"virtualAccountTransaction.userId","typeLabel":"string"},"virtualAccountId":{"type":"string","description":"Identifier of the virtual account (payment instrument) the transaction belongs to. Up to 64 characters.","isRequired":true,"uniqueKey":"virtualAccountTransaction.virtualAccountId","typeLabel":"string"},"type":{"type":"string","description":"Direction of funds relative to the virtual account. `DEPOSIT` is money arriving on any rail. `WITHDRAWAL` is money leaving, either triggered by the customer in the hosted experience or by Meridian as an auto-sweep after a deposit settles.","enum":["DEPOSIT","WITHDRAWAL"],"isRequired":true,"uniqueKey":"virtualAccountTransaction.type","typeLabel":"enum\u003cstring>"},"status":{"type":"string","description":"Current status. `PENDING`: recorded but not yet settled or credited; the `created` event always carries this status. `SUCCESS`: funds credited to the destination. `FAILED`: terminal failure, see `statusReason`. `ERROR`: defensive fallback for an internal state that should never apply to a virtual account transaction; treat it as a failure and contact Meridian support.","enum":["PENDING","SUCCESS","FAILED","ERROR"],"isRequired":true,"uniqueKey":"virtualAccountTransaction.status","typeLabel":"enum\u003cstring>"},"externalRef":{"oneOf":[{"type":"string","description":"Your reference for a customer-triggered withdrawal, echoed back unchanged. This is typically your own internal transaction identifier, so you can match the webhook to the record in your system without a lookup. Always `null` on deposits and auto-sweeps. Up to 64 characters.","example":"order-2026-00142","uniqueKey":"virtualAccountTransaction.externalRef.oneOf.0","typeLabel":"string"},{"type":"null","description":"Your reference for a customer-triggered withdrawal, echoed back unchanged. This is typically your own internal transaction identifier, so you can match the webhook to the record in your system without a lookup. Always `null` on deposits and auto-sweeps. Up to 64 characters.","example":"order-2026-00142","uniqueKey":"virtualAccountTransaction.externalRef.oneOf.1","typeLabel":"null"}],"uniqueKey":"virtualAccountTransaction.externalRef","typeLabel":"string | null"},"statusReason":{"oneOf":[{"type":"string","description":"Why the transaction failed. Set only when `status` is `FAILED`, `null` otherwise. A closed set, not free text. `OUTCOME_UNDER_INVESTIGATION` means the money may have moved: do not retry or re-issue the transaction. See [Failure reasons](/products/retail-va/failure-reasons) for what each code means and what to do.","enum":["INSUFFICIENT_FUNDS","ACCOUNT_FROZEN","RISK_REJECTION","DECLINED_AFTER_REVIEW","BANK_REJECTION","WITHDRAWAL_ACCOUNT_NOT_SUPPORTED","PROCESSING_FAILED","OUTCOME_UNDER_INVESTIGATION","REVERSAL_IN_PROGRESS","EXCEEDS_SEND_LIMIT","EXCEEDS_RECEIVE_LIMIT","WITHDRAWAL_SYSTEM_ERROR","DEPOSIT_SYSTEM_ERROR","AUTOSWEEP_SYSTEM_ERROR","INTERNAL_ERROR",null],"uniqueKey":"virtualAccountTransaction.statusReason.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","description":"Why the transaction failed. Set only when `status` is `FAILED`, `null` otherwise. A closed set, not free text. `OUTCOME_UNDER_INVESTIGATION` means the money may have moved: do not retry or re-issue the transaction. See [Failure reasons](/products/retail-va/failure-reasons) for what each code means and what to do.","enum":["INSUFFICIENT_FUNDS","ACCOUNT_FROZEN","RISK_REJECTION","DECLINED_AFTER_REVIEW","BANK_REJECTION","WITHDRAWAL_ACCOUNT_NOT_SUPPORTED","PROCESSING_FAILED","OUTCOME_UNDER_INVESTIGATION","REVERSAL_IN_PROGRESS","EXCEEDS_SEND_LIMIT","EXCEEDS_RECEIVE_LIMIT","WITHDRAWAL_SYSTEM_ERROR","DEPOSIT_SYSTEM_ERROR","AUTOSWEEP_SYSTEM_ERROR","INTERNAL_ERROR",null],"uniqueKey":"virtualAccountTransaction.statusReason.oneOf.1","typeLabel":"null"}],"uniqueKey":"virtualAccountTransaction.statusReason","typeLabel":"enum\u003cstring> | null"},"debitAmount":{"oneOf":[{"type":"string","description":"Gross amount debited from the source, before fees. Decimal string in plain notation, never a JSON number. Fiat amounts carry two decimal places (`\"100.00\"`); stablecoin amounts carry six (`\"100.123456\"`).","uniqueKey":"virtualAccountTransaction.debitAmount.oneOf.0","typeLabel":"string"},{"type":"null","description":"Gross amount debited from the source, before fees. Decimal string in plain notation, never a JSON number. Fiat amounts carry two decimal places (`\"100.00\"`); stablecoin amounts carry six (`\"100.123456\"`).","uniqueKey":"virtualAccountTransaction.debitAmount.oneOf.1","typeLabel":"null"}],"uniqueKey":"virtualAccountTransaction.debitAmount","typeLabel":"string | null"},"debitCurrency":{"oneOf":[{"type":"string","description":"Currency of `debitAmount`. Fiat values are ISO 4217. Stablecoin values encode the asset and network (`USDC_ETH`, `USDC_BASE`, `USDT_POLY`, and so on), are up to 9 characters, and are not ISO 4217 codes. `null` when the leg does not apply.","enum":["EUR","USD","GBP","PHP","MXN","ZAR","USDC_ETH","USDC_SOL","USDT_ETH","USDT_SOL","USDC_BASE","USDT_BASE","USDC_POLY","USDT_POLY",null],"uniqueKey":"virtualAccountTransaction.debitCurrency.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","description":"Currency of `debitAmount`. Fiat values are ISO 4217. Stablecoin values encode the asset and network (`USDC_ETH`, `USDC_BASE`, `USDT_POLY`, and so on), are up to 9 characters, and are not ISO 4217 codes. `null` when the leg does not apply.","enum":["EUR","USD","GBP","PHP","MXN","ZAR","USDC_ETH","USDC_SOL","USDT_ETH","USDT_SOL","USDC_BASE","USDT_BASE","USDC_POLY","USDT_POLY",null],"uniqueKey":"virtualAccountTransaction.debitCurrency.oneOf.1","typeLabel":"null"}],"uniqueKey":"virtualAccountTransaction.debitCurrency","typeLabel":"enum\u003cstring> | null"},"fromAmount":{"oneOf":[{"type":"string","description":"Net amount after fees, and the basis for any FX conversion. Equals `debitAmount` minus the sum of `fees[].amount`; equals `debitAmount` when `fees` is empty. Decimal string in plain notation, never a JSON number. Fiat amounts carry two decimal places (`\"100.00\"`); stablecoin amounts carry six (`\"100.123456\"`).","uniqueKey":"virtualAccountTransaction.fromAmount.oneOf.0","typeLabel":"string"},{"type":"null","description":"Net amount after fees, and the basis for any FX conversion. Equals `debitAmount` minus the sum of `fees[].amount`; equals `debitAmount` when `fees` is empty. Decimal string in plain notation, never a JSON number. Fiat amounts carry two decimal places (`\"100.00\"`); stablecoin amounts carry six (`\"100.123456\"`).","uniqueKey":"virtualAccountTransaction.fromAmount.oneOf.1","typeLabel":"null"}],"uniqueKey":"virtualAccountTransaction.fromAmount","typeLabel":"string | null"},"fromCurrency":{"oneOf":[{"type":"string","description":"Currency of `fromAmount`. Same as `debitCurrency`. Fiat values are ISO 4217. Stablecoin values encode the asset and network (`USDC_ETH`, `USDC_BASE`, `USDT_POLY`, and so on), are up to 9 characters, and are not ISO 4217 codes. `null` when the leg does not apply.","enum":["EUR","USD","GBP","PHP","MXN","ZAR","USDC_ETH","USDC_SOL","USDT_ETH","USDT_SOL","USDC_BASE","USDT_BASE","USDC_POLY","USDT_POLY",null],"uniqueKey":"virtualAccountTransaction.fromCurrency.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","description":"Currency of `fromAmount`. Same as `debitCurrency`. Fiat values are ISO 4217. Stablecoin values encode the asset and network (`USDC_ETH`, `USDC_BASE`, `USDT_POLY`, and so on), are up to 9 characters, and are not ISO 4217 codes. `null` when the leg does not apply.","enum":["EUR","USD","GBP","PHP","MXN","ZAR","USDC_ETH","USDC_SOL","USDT_ETH","USDT_SOL","USDC_BASE","USDT_BASE","USDC_POLY","USDT_POLY",null],"uniqueKey":"virtualAccountTransaction.fromCurrency.oneOf.1","typeLabel":"null"}],"uniqueKey":"virtualAccountTransaction.fromCurrency","typeLabel":"enum\u003cstring> | null"},"toAmount":{"oneOf":[{"type":"string","description":"Net amount credited to the destination: `fromAmount` × `exchangeRate`, in `toCurrency`. May be `\"0\"` on a withdrawal's `created` event, before the credit leg has been priced. Decimal string in plain notation, never a JSON number. Fiat amounts carry two decimal places (`\"100.00\"`); stablecoin amounts carry six (`\"100.123456\"`).","uniqueKey":"virtualAccountTransaction.toAmount.oneOf.0","typeLabel":"string"},{"type":"null","description":"Net amount credited to the destination: `fromAmount` × `exchangeRate`, in `toCurrency`. May be `\"0\"` on a withdrawal's `created` event, before the credit leg has been priced. Decimal string in plain notation, never a JSON number. Fiat amounts carry two decimal places (`\"100.00\"`); stablecoin amounts carry six (`\"100.123456\"`).","uniqueKey":"virtualAccountTransaction.toAmount.oneOf.1","typeLabel":"null"}],"uniqueKey":"virtualAccountTransaction.toAmount","typeLabel":"string | null"},"toCurrency":{"oneOf":[{"type":"string","description":"Currency of `toAmount`. Fiat values are ISO 4217. Stablecoin values encode the asset and network (`USDC_ETH`, `USDC_BASE`, `USDT_POLY`, and so on), are up to 9 characters, and are not ISO 4217 codes. `null` when the leg does not apply.","enum":["EUR","USD","GBP","PHP","MXN","ZAR","USDC_ETH","USDC_SOL","USDT_ETH","USDT_SOL","USDC_BASE","USDT_BASE","USDC_POLY","USDT_POLY",null],"uniqueKey":"virtualAccountTransaction.toCurrency.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","description":"Currency of `toAmount`. Fiat values are ISO 4217. Stablecoin values encode the asset and network (`USDC_ETH`, `USDC_BASE`, `USDT_POLY`, and so on), are up to 9 characters, and are not ISO 4217 codes. `null` when the leg does not apply.","enum":["EUR","USD","GBP","PHP","MXN","ZAR","USDC_ETH","USDC_SOL","USDT_ETH","USDT_SOL","USDC_BASE","USDT_BASE","USDC_POLY","USDT_POLY",null],"uniqueKey":"virtualAccountTransaction.toCurrency.oneOf.1","typeLabel":"null"}],"uniqueKey":"virtualAccountTransaction.toCurrency","typeLabel":"enum\u003cstring> | null"},"exchangeRate":{"oneOf":[{"type":"string","description":"Customer-facing rate applied to `fromAmount` to produce `toAmount`. Decimal string with no fixed number of decimal places; do not assume a scale. May be `\"0\"` on a withdrawal's `created` event, before the credit leg has been priced.","uniqueKey":"virtualAccountTransaction.exchangeRate.oneOf.0","typeLabel":"string"},{"type":"null","description":"Customer-facing rate applied to `fromAmount` to produce `toAmount`. Decimal string with no fixed number of decimal places; do not assume a scale. May be `\"0\"` on a withdrawal's `created` event, before the credit leg has been priced.","uniqueKey":"virtualAccountTransaction.exchangeRate.oneOf.1","typeLabel":"null"}],"uniqueKey":"virtualAccountTransaction.exchangeRate","typeLabel":"string | null"},"fees":{"type":"array","description":"Fees applied to the transaction. Always present. Only `WIRE` and `SWIFT` deposits carry a processing fee; every other rail, including all on-chain deposits and all withdrawals, returns `[]`. An empty array means no fee applies, not that fee data is missing.","items":{"type":"object","description":"A fee applied to the transaction.","properties":{"amount":{"type":"string","description":"Fee amount, in the fee currency","example":"5.00","title":"String","isRequired":true,"uniqueKey":"virtualAccountTransaction.fees.items.[INDEX].amount","typeLabel":"string"},"currency":{"type":"string","enum":["EUR","USD","GBP","PHP","MXN","ZAR","USDC_ETH","USDC_SOL","USDT_ETH","USDT_SOL","USDC_BASE","USDT_BASE","USDC_POLY","USDT_POLY"],"title":"MeridianCurrency","description":"Currency of the fee. Always the same as the transaction's `debitCurrency`.","example":"USD","isRequired":true,"uniqueKey":"virtualAccountTransaction.fees.items.[INDEX].currency","typeLabel":"enum\u003cstring>"},"label":{"type":"string","description":"Human-readable label describing the fee: `Wire processing fee` or `SWIFT processing fee`.","example":"Wire processing fee","title":"String","isRequired":true,"uniqueKey":"virtualAccountTransaction.fees.items.[INDEX].label","typeLabel":"string"},"type":{"type":"string","enum":["WIRE_PROCESSING_FEE","SWIFT_PROCESSING_FEE"],"title":"TransactionFeeType","description":"Machine-readable fee type identifier. `WIRE_PROCESSING_FEE` for domestic wires, `SWIFT_PROCESSING_FEE` for international wires.","isRequired":true,"uniqueKey":"virtualAccountTransaction.fees.items.[INDEX].type","typeLabel":"enum\u003cstring>"}},"required":["amount","currency","label","type"],"title":"VirtualAccountTransactionFeeDto","uniqueKey":"virtualAccountTransaction.fees.items.[INDEX]","typeLabel":"VirtualAccountTransactionFeeDto · object"},"uniqueKey":"virtualAccountTransaction.fees","typeLabel":"VirtualAccountTransactionFeeDto · object[]"},"depositType":{"oneOf":[{"type":"string","description":"Rail the deposit arrived on. `ACH` and `WIRE` are domestic US bank transfers, `SWIFT` is an international wire, and `ETHEREUM`, `BASE`, and `POLYGON` are on-chain stablecoin deposits to the account's wallet address. `null` on withdrawals.","enum":["ACH","WIRE","SWIFT","ETHEREUM","BASE","POLYGON",null],"uniqueKey":"virtualAccountTransaction.depositType.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","description":"Rail the deposit arrived on. `ACH` and `WIRE` are domestic US bank transfers, `SWIFT` is an international wire, and `ETHEREUM`, `BASE`, and `POLYGON` are on-chain stablecoin deposits to the account's wallet address. `null` on withdrawals.","enum":["ACH","WIRE","SWIFT","ETHEREUM","BASE","POLYGON",null],"uniqueKey":"virtualAccountTransaction.depositType.oneOf.1","typeLabel":"null"}],"uniqueKey":"virtualAccountTransaction.depositType","typeLabel":"enum\u003cstring> | null"},"originatorMemo":{"oneOf":[{"type":"string","description":"Free-text memo supplied by the sender, such as an ACH addenda record or wire reference. `null` when none was provided. Up to 255 characters.","uniqueKey":"virtualAccountTransaction.originatorMemo.oneOf.0","typeLabel":"string"},{"type":"null","description":"Free-text memo supplied by the sender, such as an ACH addenda record or wire reference. `null` when none was provided. Up to 255 characters.","uniqueKey":"virtualAccountTransaction.originatorMemo.oneOf.1","typeLabel":"null"}],"uniqueKey":"virtualAccountTransaction.originatorMemo","typeLabel":"string | null"},"originatorName":{"oneOf":[{"type":"string","description":"Who sent the funds. **Fiat deposit:** the sender's account holder name as reported by the sending bank. **On-chain deposit:** the sender's name when the sending VASP discloses it; otherwise an empty string `\"\"`, not `null`. **Withdrawal:** `null`. Up to 255 characters.","uniqueKey":"virtualAccountTransaction.originatorName.oneOf.0","typeLabel":"string"},{"type":"null","description":"Who sent the funds. **Fiat deposit:** the sender's account holder name as reported by the sending bank. **On-chain deposit:** the sender's name when the sending VASP discloses it; otherwise an empty string `\"\"`, not `null`. **Withdrawal:** `null`. Up to 255 characters.","uniqueKey":"virtualAccountTransaction.originatorName.oneOf.1","typeLabel":"null"}],"uniqueKey":"virtualAccountTransaction.originatorName","typeLabel":"string | null"},"originatorAccount":{"oneOf":[{"type":"string","description":"Account the funds came from. **Fiat deposit:** the sender's bank account number, or an empty string `\"\"` or `null` when the sending bank did not disclose it. **On-chain deposit:** the sender's wallet address, not a bank account number; Ethereum, Base, and Polygon addresses are 42 characters starting `0x`. **Withdrawal:** the virtual account's own account number, identifying where the funds left from. Up to 128 characters.","uniqueKey":"virtualAccountTransaction.originatorAccount.oneOf.0","typeLabel":"string"},{"type":"null","description":"Account the funds came from. **Fiat deposit:** the sender's bank account number, or an empty string `\"\"` or `null` when the sending bank did not disclose it. **On-chain deposit:** the sender's wallet address, not a bank account number; Ethereum, Base, and Polygon addresses are 42 characters starting `0x`. **Withdrawal:** the virtual account's own account number, identifying where the funds left from. Up to 128 characters.","uniqueKey":"virtualAccountTransaction.originatorAccount.oneOf.1","typeLabel":"null"}],"uniqueKey":"virtualAccountTransaction.originatorAccount","typeLabel":"string | null"},"originatorInstitution":{"oneOf":[{"type":"string","description":"Institution the funds came from. **Fiat deposit:** the sending bank's name. **On-chain deposit:** the sending VASP's name when it is known; otherwise the literal string `\"NOTPROVIDED\"`, not `null`, which is the usual case. **Withdrawal:** `null`. Up to 255 characters.","uniqueKey":"virtualAccountTransaction.originatorInstitution.oneOf.0","typeLabel":"string"},{"type":"null","description":"Institution the funds came from. **Fiat deposit:** the sending bank's name. **On-chain deposit:** the sending VASP's name when it is known; otherwise the literal string `\"NOTPROVIDED\"`, not `null`, which is the usual case. **Withdrawal:** `null`. Up to 255 characters.","uniqueKey":"virtualAccountTransaction.originatorInstitution.oneOf.1","typeLabel":"null"}],"uniqueKey":"virtualAccountTransaction.originatorInstitution","typeLabel":"string | null"},"receiverName":{"oneOf":[{"type":"string","description":"Account holder name at the destination. Populated only for withdrawals to a bank account, such as an auto-sweep. Up to 255 characters.","uniqueKey":"virtualAccountTransaction.receiverName.oneOf.0","typeLabel":"string"},{"type":"null","description":"Account holder name at the destination. Populated only for withdrawals to a bank account, such as an auto-sweep. Up to 255 characters.","uniqueKey":"virtualAccountTransaction.receiverName.oneOf.1","typeLabel":"null"}],"uniqueKey":"virtualAccountTransaction.receiverName","typeLabel":"string | null"},"receiverAccount":{"oneOf":[{"type":"string","description":"Account number at the destination. Populated only for withdrawals to a bank account. Up to 140 characters.","uniqueKey":"virtualAccountTransaction.receiverAccount.oneOf.0","typeLabel":"string"},{"type":"null","description":"Account number at the destination. Populated only for withdrawals to a bank account. Up to 140 characters.","uniqueKey":"virtualAccountTransaction.receiverAccount.oneOf.1","typeLabel":"null"}],"uniqueKey":"virtualAccountTransaction.receiverAccount","typeLabel":"string | null"},"receiverInstitution":{"oneOf":[{"type":"string","description":"Name of the destination institution. Populated only for withdrawals to a bank account. Up to 64 characters.","uniqueKey":"virtualAccountTransaction.receiverInstitution.oneOf.0","typeLabel":"string"},{"type":"null","description":"Name of the destination institution. Populated only for withdrawals to a bank account. Up to 64 characters.","uniqueKey":"virtualAccountTransaction.receiverInstitution.oneOf.1","typeLabel":"null"}],"uniqueKey":"virtualAccountTransaction.receiverInstitution","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"virtualAccountTransaction","typeLabel":"object"}},"description":"Webhook body. A single top-level key, `virtualAccountTransaction`, wraps the transaction. No event envelope, ID, or timestamp is added around it.","uniqueKey":"","typeLabel":"object"},"examples":{"ACH deposit (SUCCESS)":{"title":"ACH deposit (SUCCESS)","summary":"ACH deposit — updated, SUCCESS","description":"A settled domestic ACH deposit. No fee applies, so `fromAmount` equals `debitAmount`. The `originator*` fields carry the sender's bank details.","value":{"virtualAccountTransaction":{"id":"ustxn-4h8n2kq7wm3xp9rt6vbc1dfz","createdAt":"2026-09-14T13:02:11.000Z","updatedAt":"2026-09-15T09:30:45.000Z","transactionRef":"M8K3N2P7QW","externalRef":null,"userId":"ususr-7k2mqp4v9yc3xr8swld6bne","virtualAccountId":"uspay-pyj5tywsw7v0pzuyjirxvso2","type":"DEPOSIT","status":"SUCCESS","statusReason":null,"debitAmount":"250.00","debitCurrency":"USD","fromAmount":"250.00","fromCurrency":"USD","toAmount":"250.00","toCurrency":"USD","exchangeRate":"1","fees":[],"depositType":"ACH","originatorMemo":"PAYROLL SEP 2026","originatorName":"Maria Santos","originatorAccount":"000123456789","originatorInstitution":"First Example Bank","receiverName":null,"receiverAccount":null,"receiverInstitution":null}}},"Wire deposit with fee (SUCCESS)":{"title":"Wire deposit with fee (SUCCESS)","summary":"Wire deposit — updated, SUCCESS","description":"A settled domestic wire. A processing fee is deducted, so `fromAmount` (net) is `debitAmount` (gross) minus `fees[].amount`.","value":{"virtualAccountTransaction":{"id":"ustxn-9m3rw8kd2fq7xn5tj4ve6hyz","createdAt":"2026-09-15T15:41:03.000Z","updatedAt":"2026-09-15T16:02:19.000Z","transactionRef":"M2QW7N8K3P","externalRef":null,"userId":"ususr-7k2mqp4v9yc3xr8swld6bne","virtualAccountId":"uspay-pyj5tywsw7v0pzuyjirxvso2","type":"DEPOSIT","status":"SUCCESS","statusReason":null,"debitAmount":"1000.00","debitCurrency":"USD","fromAmount":"985.00","fromCurrency":"USD","toAmount":"985.00","toCurrency":"USD","exchangeRate":"1","fees":[{"type":"WIRE_PROCESSING_FEE","amount":"15.00","currency":"USD","label":"Wire processing fee"}],"depositType":"WIRE","originatorMemo":"INVOICE 4471","originatorName":"Acme Trading LLC","originatorAccount":"4401002233","originatorInstitution":"Example National Bank","receiverName":null,"receiverAccount":null,"receiverInstitution":null}}},"USDC deposit, sender not disclosed (SUCCESS)":{"title":"USDC deposit, sender not disclosed (SUCCESS)","summary":"USDC deposit (Ethereum), sender not disclosed — updated, SUCCESS","description":"A settled on-chain stablecoin deposit where the sending VASP did not disclose the sender. Note the six-decimal amounts, the `USDC_ETH` currency, the wallet address in `originatorAccount`, the empty-string `originatorName`, and the `NOTPROVIDED` sentinel in `originatorInstitution`. On-chain deposits never carry fees.","value":{"virtualAccountTransaction":{"id":"ustxn-6tq2vd8xk4wn9pr3zm7hc5jb","createdAt":"2026-09-15T18:07:52.000Z","updatedAt":"2026-09-15T18:09:14.000Z","transactionRef":"M5P9K2W7NQ","externalRef":null,"userId":"ususr-7k2mqp4v9yc3xr8swld6bne","virtualAccountId":"uspay-pyj5tywsw7v0pzuyjirxvso2","type":"DEPOSIT","status":"SUCCESS","statusReason":null,"debitAmount":"100.250000","debitCurrency":"USDC_ETH","fromAmount":"100.250000","fromCurrency":"USDC_ETH","toAmount":"100.25","toCurrency":"USD","exchangeRate":"1","fees":[],"depositType":"ETHEREUM","originatorMemo":null,"originatorName":"","originatorAccount":"0x5aAeb6053F3E94C9b9A09f33669435E7Ef1BeAed","originatorInstitution":"NOTPROVIDED","receiverName":null,"receiverAccount":null,"receiverInstitution":null}}},"USDC deposit, sender disclosed (SUCCESS)":{"title":"USDC deposit, sender disclosed (SUCCESS)","summary":"USDC deposit (Ethereum), sender disclosed — updated, SUCCESS","description":"The same kind of deposit where the sending VASP disclosed the sender, so `originatorName` and `originatorInstitution` are populated. `originatorAccount` is still the wallet address.","value":{"virtualAccountTransaction":{"id":"ustxn-3wn8kq5xd7tp2vr9zm4hc6jf","createdAt":"2026-09-15T19:12:30.000Z","updatedAt":"2026-09-15T19:13:48.000Z","transactionRef":"M6Q3P8W2NK","externalRef":null,"userId":"ususr-7k2mqp4v9yc3xr8swld6bne","virtualAccountId":"uspay-pyj5tywsw7v0pzuyjirxvso2","type":"DEPOSIT","status":"SUCCESS","statusReason":null,"debitAmount":"500.000000","debitCurrency":"USDC_ETH","fromAmount":"500.000000","fromCurrency":"USDC_ETH","toAmount":"500.00","toCurrency":"USD","exchangeRate":"1","fees":[],"depositType":"ETHEREUM","originatorMemo":null,"originatorName":"Ana Lim","originatorAccount":"0x8Ba1f109551bD432803012645Ac136ddd64DBA72","originatorInstitution":"Coinbase","receiverName":null,"receiverAccount":null,"receiverInstitution":null}}},"Withdrawal (PENDING)":{"title":"Withdrawal (PENDING)","summary":"Withdrawal — created, PENDING","description":"A withdrawal to a bank account at the moment it is recorded. `toAmount` and `exchangeRate` are `\"0\"` because the credit leg has not been priced yet. `depositType` is `null` and `originatorAccount` is the virtual account's own account number.","value":{"virtualAccountTransaction":{"id":"ustxn-8kd3nq7wm2xp5rt9vb4cf6hz","createdAt":"2026-09-15T09:31:02.000Z","updatedAt":"2026-09-15T09:31:02.000Z","transactionRef":"M3W8P2K7NQ","externalRef":null,"userId":"ususr-7k2mqp4v9yc3xr8swld6bne","virtualAccountId":"uspay-pyj5tywsw7v0pzuyjirxvso2","type":"WITHDRAWAL","status":"PENDING","statusReason":null,"debitAmount":"250.00","debitCurrency":"USD","fromAmount":"250.00","fromCurrency":"USD","toAmount":"0","toCurrency":"PHP","exchangeRate":"0","fees":[],"depositType":null,"originatorMemo":null,"originatorName":null,"originatorAccount":"9876543210","originatorInstitution":null,"receiverName":"Juan Dela Cruz","receiverAccount":"1234567890","receiverInstitution":"Example Bank"}}},"Withdrawal (SUCCESS)":{"title":"Withdrawal (SUCCESS)","summary":"Withdrawal — updated, SUCCESS","description":"The same withdrawal after the funds were credited to the destination. `toAmount` and `exchangeRate` now carry the final values, and the `receiver*` fields describe the destination bank account.","value":{"virtualAccountTransaction":{"id":"ustxn-8kd3nq7wm2xp5rt9vb4cf6hz","createdAt":"2026-09-15T09:31:02.000Z","updatedAt":"2026-09-15T09:45:37.000Z","transactionRef":"M3W8P2K7NQ","externalRef":null,"userId":"ususr-7k2mqp4v9yc3xr8swld6bne","virtualAccountId":"uspay-pyj5tywsw7v0pzuyjirxvso2","type":"WITHDRAWAL","status":"SUCCESS","statusReason":null,"debitAmount":"250.00","debitCurrency":"USD","fromAmount":"250.00","fromCurrency":"USD","toAmount":"14000.00","toCurrency":"PHP","exchangeRate":"56.00","fees":[],"depositType":null,"originatorMemo":null,"originatorName":null,"originatorAccount":"9876543210","originatorInstitution":null,"receiverName":"Juan Dela Cruz","receiverAccount":"1234567890","receiverInstitution":"Example Bank"}}},"ACH deposit (FAILED)":{"title":"ACH deposit (FAILED)","summary":"ACH deposit — updated, FAILED","description":"A deposit rejected by the sending bank. `statusReason` is populated only on `FAILED`.","value":{"virtualAccountTransaction":{"id":"ustxn-5vb9tr2kf7xn4pq8wm3dc6hj","createdAt":"2026-09-14T11:15:40.000Z","updatedAt":"2026-09-15T07:02:08.000Z","transactionRef":"M9K2N7W3PQ","externalRef":null,"userId":"ususr-7k2mqp4v9yc3xr8swld6bne","virtualAccountId":"uspay-pyj5tywsw7v0pzuyjirxvso2","type":"DEPOSIT","status":"FAILED","statusReason":"BANK_REJECTION","debitAmount":"75.00","debitCurrency":"USD","fromAmount":"75.00","fromCurrency":"USD","toAmount":"75.00","toCurrency":"USD","exchangeRate":"1","fees":[],"depositType":"ACH","originatorMemo":null,"originatorName":"Jose Reyes","originatorAccount":"","originatorInstitution":"Example Credit Union","receiverName":null,"receiverAccount":null,"receiverInstitution":null}}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"42b2024b-63e0-4a47-856b-7d255d0ee90e":{"description":"Success","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}}},"security":{"a7689b61-1d49-4724-ac19-d74fccad9a36":{"MeridianWebhookSignature":{"type":"apiKey","in":"header","name":"X-Meridian-Signature","description":"Meridian signs every webhook request it sends you.\n\nHeaders on every delivery:\n - X-Meridian-Api-Key\n - X-Meridian-Timestamp\n - X-Meridian-Signature\n\nX-Meridian-Signature is the hex-encoded HMAC-SHA256 of apiKey + timestamp + method + path + body, computed with your webhook secret. The webhook API key and secret are issued separately from your REST API credentials. Recompute it from the request you received and reject the delivery if it does not match. See [Security](/products/retail-va/webhooks-overview#security) in the webhooks overview.","scopes":[],"schemeName":"MeridianWebhookSignature"}}},"servers":{"45a62985-c3bc-4b30-bebd-d67fe7438d94":{"url":"https://sandbox.api.mnai.com","description":"Sandbox"},"be777e9f-518e-42f7-afd2-c847075201e8":{"url":"https://api.mnai.com","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"X-Meridian-Signature","description":"Meridian signs every webhook request it sends you.\n\nHeaders on every delivery:\n - X-Meridian-Api-Key\n - X-Meridian-Timestamp\n - X-Meridian-Signature\n\nX-Meridian-Signature is the hex-encoded HMAC-SHA256 of apiKey + timestamp + method + path + body, computed with your webhook secret. The webhook API key and secret are issued separately from your REST API credentials. Recompute it from the request you received and reject the delivery if it does not match. See [Security](/products/retail-va/webhooks-overview#security) in the webhooks overview.","scopes":[],"schemeName":"MeridianWebhookSignature"},"schema":{"title":"X-Meridian-Signature","type":"string","description":"Meridian signs every webhook request it sends you.\n\nHeaders on every delivery:\n - X-Meridian-Api-Key\n - X-Meridian-Timestamp\n - X-Meridian-Signature\n\nX-Meridian-Signature is the hex-encoded HMAC-SHA256 of apiKey + timestamp + method + path + body, computed with your webhook secret. The webhook API key and secret are issued separately from your REST API credentials. Recompute it from the request you received and reject the delivery if it does not match. See [Security](/products/retail-va/webhooks-overview#security) in the webhooks overview.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"MeridianWebhookSignature","name":"X-Meridian-Signature"}],"title":"MeridianWebhookSignature"}]},"originalFileLocation":"products/retail-va/api-reference/retail-rtd.json"},"subdomain":"meridian-18e67158","siteName":"Meridian","title":"Virtual Account Transaction - Meridian","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-12T13:01:13.724Z","originalFileLocation":"products/retail-va/api-reference/webhooks/webhooks-transaction.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=\"light\"}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=\"Learn when the virtual account transaction webhook is sent and what data it includes.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Meridian\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003cmeta data-mint-head name=\"robots\" content=\"noindex\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/meridian-18e67158/WzlFd2UpES2XpXP8/_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/meridian-18e67158/WzlFd2UpES2XpXP8/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/meridian-18e67158/WzlFd2UpES2XpXP8/_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/meridian-18e67158/WzlFd2UpES2XpXP8/_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/meridian-18e67158/WzlFd2UpES2XpXP8/_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/meridian-18e67158/WzlFd2UpES2XpXP8/_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/meridian-18e67158/WzlFd2UpES2XpXP8/_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/meridian-18e67158/WzlFd2UpES2XpXP8/_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/meridian-18e67158/WzlFd2UpES2XpXP8/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Virtual Account Transaction - Meridian\">\u003cmeta data-mint-head property=\"og:description\" content=\"Learn when the virtual account transaction webhook is sent and what data it includes.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Meridian\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.mnai.com/products/retail-va/api-reference/webhooks/webhooks-transaction\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://meridian-18e67158.mintlify.site/_mintlify/api/og/v2?division=Webhooks\u0026amp;title=Virtual+Account+Transaction\u0026amp;description=Learn+when+the+virtual+account+transaction+webhook+is+sent+and+what+data+it+includes.\u0026amp;theme=6576e5154a5879feed8f84c7\u0026amp;signature=b85196c6a0ce2b39dc3fa213598fec8e80d3a7f30f532d83f33b5580570adcac\">\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=\"Virtual Account Transaction - Meridian\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Learn when the virtual account transaction webhook is sent and what data it includes.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://meridian-18e67158.mintlify.site/_mintlify/api/og/v2?division=Webhooks\u0026amp;title=Virtual+Account+Transaction\u0026amp;description=Learn+when+the+virtual+account+transaction+webhook+is+sent+and+what+data+it+includes.\u0026amp;theme=6576e5154a5879feed8f84c7\u0026amp;signature=b85196c6a0ce2b39dc3fa213598fec8e80d3a7f30f532d83f33b5580570adcac\">\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/meridian-18e67158/WzlFd2UpES2XpXP8/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Meridian\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0A0A0A\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.mnai.com/products/retail-va/api-reference/webhooks/webhooks-transaction\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/products/retail-va/api-reference/webhooks/webhooks-transaction.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.mnai.com/#organization\",\"name\":\"Meridian\",\"url\":\"https://docs.mnai.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/meridian-18e67158/VgZYEMrM1D9FVN_L/logo/meridian-light.svg?fit=max\u0026auto=format\u0026n=VgZYEMrM1D9FVN_L\u0026q=85\u0026s=165e274c2a61a48b1bbeb002a86899a0\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.mnai.com#website\",\"name\":\"Meridian\",\"url\":\"https://docs.mnai.com\",\"publisher\":{\"@id\":\"https://docs.mnai.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.mnai.com/products/retail-va/api-reference/webhooks/webhooks-transaction#webpage\",\"url\":\"https://docs.mnai.com/products/retail-va/api-reference/webhooks/webhooks-transaction\",\"name\":\"Virtual Account Transaction\",\"description\":\"Learn when the virtual account transaction webhook is sent and what data it includes.\",\"dateModified\":\"2026-11-12T13:01:13.724Z\",\"isPartOf\":{\"@id\":\"https://docs.mnai.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.mnai.com/products/retail-va/api-reference/webhooks/webhooks-transaction#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.mnai.com/products/retail-va/api-reference/webhooks/webhooks-transaction#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API Reference\",\"item\":\"https://docs.mnai.com/products/retail-va/api-reference\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Virtual Account Transaction\",\"item\":\"https://docs.mnai.com/products/retail-va/api-reference/webhooks/webhooks-transaction\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.mnai.com/products/retail-va/api-reference/webhooks/webhooks-transaction#apireference\",\"headline\":\"Virtual Account Transaction\",\"name\":\"Virtual Account Transaction\",\"description\":\"Learn when the virtual account transaction webhook is sent and what data it includes.\",\"url\":\"https://docs.mnai.com/products/retail-va/api-reference/webhooks/webhooks-transaction\",\"mainEntityOfPage\":{\"@id\":\"https://docs.mnai.com/products/retail-va/api-reference/webhooks/webhooks-transaction#webpage\"},\"dateModified\":\"2026-11-12T13:01:13.724Z\",\"publisher\":{\"@id\":\"https://docs.mnai.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.mnai.com#website\"}}]}\u003c/script>","agentPointerHref":"/products/retail-va/api-reference/webhooks/webhooks-transaction.md","siteName":"Meridian","nav":{"global":{"anchors":[{"anchor":"Changelog","icon":"list","href":"/changelog"}]},"products":[{"product":"Retail U.S. Accounts","pages":[{"title":"Retail Virtual Accounts","sidebarTitle":"Overview","href":"/products/retail-va"},{"group":"Getting Started","pages":[{"title":"Request a Sandbox","href":"/products/retail-va/sandbox"},{"title":"Authentication","href":"/products/retail-va/authentication"},{"title":"Webhooks","href":"/products/retail-va/webhooks-overview"}]},{"group":"Integration Guide","pages":[{"title":"Session management","href":"/products/retail-va/session-management"},{"title":"WebView","href":"/products/retail-va/web-view"},{"title":"Customization","href":"/products/retail-va/customization"},{"title":"Information we collect","sidebarTitle":"Information we collect","href":"/products/retail-va/kyc-information"},{"title":"Simulate KYC outcomes","sidebarTitle":"Simulate KYC outcomes","href":"/products/retail-va/simulate-kyc"}]},{"group":"Money Movement","pages":[{"title":"Deposits","href":"/products/retail-va/deposits"},{"title":"Withdrawals","href":"/products/retail-va/withdrawals"},{"title":"Transaction failure reasons","sidebarTitle":"Failure reasons","href":"/products/retail-va/failure-reasons"}]},{"group":"API Reference","pages":[{"title":"Introduction","description":"API reference for creating authenticated Virtual Accounts sessions, including base URLs, credentials, and authentication requirements.","href":"/products/retail-va/api-reference/index"},{"group":"Webhooks","pages":[{"title":"Virtual Account Transaction","openapi":"products/retail-va/api-reference/retail-rtd.json webhook virtual_account_transaction","href":"/products/retail-va/api-reference/webhooks/webhooks-transaction"}]},{"group":"Sessions","pages":[{"title":"Create a Session","description":"Create a Virtual Account Session to launch the hosted Meridian onboarding experience.","openapi":"products/retail-va/api-reference/retail-rtd.json POST /v1/virtual-accounts/sessions","href":"/products/retail-va/api-reference/sessions/create-session"}]},{"group":"Sandbox","pages":[{"title":"Delete a virtual account application","openapi":"products/retail-va/api-reference/retail-rtd.json DELETE /v1/remittances/users/{userId}/virtual-account-applications/{virtualAccountApplicationId}","href":"/products/retail-va/api-reference/simulations/delete-virtual-account-application"}]}]}]},{"product":"Meridian Accounts for Business","hidden":false,"pages":[{"title":"Meridian Accounts for Business","href":"/products/meridian-accounts/guides/getting-started"}]},{"product":"Payout Origination","pages":[{"title":"Payout Origination","href":"/products/payout-origination/overview"}]},{"product":"Bank Transfers","pages":[{"title":"Bank Transfers","href":"/products/bank-transfers/overview"}]},{"product":"Realtime Collections","pages":[{"title":"Realtime Collections","href":"/products/realtime-collections"}]}]},"basePath":"","title":"Virtual Account Transaction - Meridian","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"]}