API reference for creating authenticated Virtual Accounts sessions, including base URLs, credentials, and authentication requirements.
All API calls must be made from your backend. Client applications must never call Meridian APIs directly.
Base URLs
Environment
URL
Purpose
Sandbox
https://sandbox.api.mnai.com
Testing and certification
Production
https://api.mnai.com
Live traffic
Meridian provides your credentials and endpoint access for the Sandbox environment during onboarding. Always validate your integration against Sandbox before requesting production access.
Example credentials
Credential
Sandbox
Production
API Key
akey_test_q5zemhdwub8ztw2mlpykvhu0
akey_live_q5zemhdwub8ztw2mlpykvhu0
API Secret
asec_test_t44ne6ipaneugxurs13ly55t
asec_live_t44ne6ipaneugxurs13ly55t
Webhook API Key
wkey_test_z212127xb84fntpw4whvhd9x
wkey_live_z212127xb84fntpw4whvhd9x
Webhook API Secret
wsec_test_tolihur9tjlbah7558uuojf3
wsec_live_tolihur9tjlbah7558uuojf3
{"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":"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}],"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","slug":"/products/retail-va/api-reference","pageMetadata":{"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"},"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: \"API reference for creating authenticated Virtual Accounts sessions, including base URLs, credentials, and authentication requirements.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,p:`p`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{Heading,Table,Tip}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsx(Tip,{children:_jsx(_components.p,{children:`All API calls must be made from your backend. Client applications must never call Meridian APIs directly.`})}),`\n`,_jsx(Heading,{level:`2`,id:`base-urls`,children:`Base URLs`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{style:{textAlign:`left`},children:`Environment`}),_jsx(_components.th,{style:{textAlign:`left`},children:`URL`}),_jsx(_components.th,{style:{textAlign:`left`},children:`Purpose`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:`Sandbox`}),_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`https://sandbox.api.mnai.com`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`Testing and certification`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:`Production`}),_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`https://api.mnai.com`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`Live traffic`})]})]})]}),`\n`,_jsx(_components.p,{children:`Meridian provides your credentials and endpoint access for the Sandbox environment during onboarding. Always validate your integration against Sandbox before requesting production access.`}),`\n`,_jsx(Heading,{level:`2`,id:`example-credentials`,children:`Example credentials`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Credential`}),_jsx(_components.th,{children:`Sandbox`}),_jsx(_components.th,{children:`Production`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`API Key`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`akey_test_q5zemhdwub8ztw2mlpykvhu0`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`akey_live_q5zemhdwub8ztw2mlpykvhu0`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`API Secret`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`asec_test_t44ne6ipaneugxurs13ly55t`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`asec_live_t44ne6ipaneugxurs13ly55t`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Webhook API Key`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`wkey_test_z212127xb84fntpw4whvhd9x`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`wkey_live_z212127xb84fntpw4whvhd9x`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Webhook API Secret`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`wsec_test_tolihur9tjlbah7558uuojf3`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`wsec_live_tolihur9tjlbah7558uuojf3`})})]})]})]})]})}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":"Introduction","description":"API reference for creating authenticated Virtual Accounts sessions, including base URLs, credentials, and authentication requirements.","href":"/products/retail-va/api-reference/index"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Base URLs","slug":"base-urls","depth":2,"children":[]},{"title":"Example credentials","slug":"example-credentials","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"],"subdomain":"meridian-18e67158","siteName":"Meridian","title":"Introduction - Meridian","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-12T13:01:13.722Z","originalFileLocation":"products/retail-va/api-reference/index.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=\"API reference for creating authenticated Virtual Accounts sessions, including base URLs, credentials, and authentication requirements.\">\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=\"Introduction - Meridian\">\u003cmeta data-mint-head property=\"og:description\" content=\"API reference for creating authenticated Virtual Accounts sessions, including base URLs, credentials, and authentication requirements.\">\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\">\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=API+Reference\u0026amp;title=Introduction\u0026amp;description=API+reference+for+creating+authenticated+Virtual+Accounts+sessions%2C+including+base+URLs%2C+credentials%2C+and+authentication+requirements.\u0026amp;theme=6576e5154a5879feed8f84c7\u0026amp;signature=22ce87a8592fdeaba00f58b705546dfb18622f4006b188cc5ca05a9bae10974b\">\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=\"Introduction - Meridian\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"API reference for creating authenticated Virtual Accounts sessions, including base URLs, credentials, and authentication requirements.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://meridian-18e67158.mintlify.site/_mintlify/api/og/v2?division=API+Reference\u0026amp;title=Introduction\u0026amp;description=API+reference+for+creating+authenticated+Virtual+Accounts+sessions%2C+including+base+URLs%2C+credentials%2C+and+authentication+requirements.\u0026amp;theme=6576e5154a5879feed8f84c7\u0026amp;signature=22ce87a8592fdeaba00f58b705546dfb18622f4006b188cc5ca05a9bae10974b\">\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\">\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.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#webpage\",\"url\":\"https://docs.mnai.com/products/retail-va/api-reference\",\"name\":\"Introduction\",\"description\":\"API reference for creating authenticated Virtual Accounts sessions, including base URLs, credentials, and authentication requirements.\",\"dateModified\":\"2026-11-12T13:01:13.722Z\",\"isPartOf\":{\"@id\":\"https://docs.mnai.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.mnai.com/products/retail-va/api-reference#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.mnai.com/products/retail-va/api-reference#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Meridian\",\"item\":\"https://docs.mnai.com\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Introduction\",\"item\":\"https://docs.mnai.com/products/retail-va/api-reference\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.mnai.com/products/retail-va/api-reference#article\",\"headline\":\"Introduction\",\"name\":\"Introduction\",\"description\":\"API reference for creating authenticated Virtual Accounts sessions, including base URLs, credentials, and authentication requirements.\",\"url\":\"https://docs.mnai.com/products/retail-va/api-reference\",\"mainEntityOfPage\":{\"@id\":\"https://docs.mnai.com/products/retail-va/api-reference#webpage\"},\"dateModified\":\"2026-11-12T13:01:13.722Z\",\"publisher\":{\"@id\":\"https://docs.mnai.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.mnai.com#website\"}}]}\u003c/script>","agentPointerHref":"/products/retail-va/api-reference.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","description":"What each virtual account transaction failure code means and what to do.","href":"/products/retail-va/failure-reasons"}]},{"group":"API Reference","pages":[{"title":"Introduction","href":"/products/retail-va/api-reference/index"},{"group":"Webhooks","pages":[{"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"}]},{"group":"Sessions","pages":[{"title":"Create a Session","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":"Introduction - Meridian","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":[],"chunks":[]}