{
"errors": [
{
"customer_id": "c1f4a8e2-3b57-4d09-9a61-7e2b5c8d4f30",
"source": {
"currency": "USD",
"rail": "FEDWIRE"
}
},
{
"virtual_account_id": "9d2b7f41-6c8a-45e3-b071-2fa93c5e8d16"
}
],
"message": "Virtual account already exists for the given parameters."
}
Create Virtual Account
Create Virtual Account V3
Create a virtual bank account for a specific customer to convert fiat deposits to crypto. The customer_id path parameter identifies the customer for whom the virtual account is being created. V3 adds source.bank so you can choose the banking partner that issues the account, and returns the destination and banking partner on the create response.
{
"errors": [
{
"customer_id": "c1f4a8e2-3b57-4d09-9a61-7e2b5c8d4f30",
"source": {
"currency": "USD",
"rail": "FEDWIRE"
}
},
{
"virtual_account_id": "9d2b7f41-6c8a-45e3-b071-2fa93c5e8d16"
}
],
"message": "Virtual account already exists for the given parameters."
}
Any fiat transactions submitted between 9:30 AM and 5:30 PM ET on a weekday are processed the same day. Transactions submitted outside these hours or on weekends will be settled the next business day.
Check all the supported fiat and crypto rails and currencies, along with the valid combinations, in Supported rails and currencies.
The available rails and currencies depend on the configuration set up for you. Contact support to know more.
The minimum deposit amount for USD virtual accounts is 50 USD.
A customer can hold only one virtual account per source currency and rail. Requesting one that already exists returns 422 with the colliding customer_id and source in errors, along with the virtual_account_id of the existing account. Use that account instead of retrying the create call.
{"docsConfig":{"theme":"willow","$schema":"https://mintlify.com/docs.json","name":"EngageXPay","description":"EngageXPay Orchestration API documentation. Guides and API reference for onboarding customers (KYB/KYC), managing beneficiaries, sending payouts, virtual accounts, balances, FX rates, and webhooks.","colors":{"primary":"#151515","light":"#ffffff","dark":"#151515"},"logo":{"light":"https://mintcdn.com/enagage-x-pay/FEj0pOmeiBFLeLWn/logo/engagexpay-light.svg?fit=max\u0026auto=format\u0026n=FEj0pOmeiBFLeLWn\u0026q=85\u0026s=4150a6758362fde0c5ab216d6382c1bd","dark":"https://mintcdn.com/enagage-x-pay/FEj0pOmeiBFLeLWn/logo/engagexpay-dark.svg?fit=max\u0026auto=format\u0026n=FEj0pOmeiBFLeLWn\u0026q=85\u0026s=fedf4d29a1a18785512adcf311045eb7"},"favicon":"https://mintcdn.com/enagage-x-pay/FEj0pOmeiBFLeLWn/favicon.svg?fit=max\u0026auto=format\u0026n=FEj0pOmeiBFLeLWn\u0026q=85\u0026s=68cef930bf5c9bcdb64b27f090c6c2b6","api":{"playground":{"display":"interactive","proxy":false},"examples":{"languages":["curl","node","java","python","go"]}},"appearance":{"default":"dark","strict":false},"background":{"color":{"dark":"#151515"}},"navbar":{"links":[],"primary":{"type":"button","label":"EngageXPay App","href":"https://app.engagexpay.com"}},"footer":{"socials":{}},"fonts":{"family":"Inter","weight":400},"icons":{"library":"lucide"},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"thumbnails":{"appearance":"dark","background":"https://mintcdn.com/enagage-x-pay/jTINrWuRVZAADmLE/images/Thumbnail.png?fit=max\u0026auto=format\u0026n=jTINrWuRVZAADmLE\u0026q=85\u0026s=2ccd3da4235818679634f6957f5f91b6"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"enagage-x-pay","hasAudioNarration":false,"actualSubdomain":"enagage-x-pay","customDomains":["doc.engagexpay.com"],"gitSource":{"type":"github","owner":"engagexpay","repo":"doc","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":"","_id":"6aea0d3f0fba27ac624555d0"},"chroma":{"latestBuiltDeploymentHistoryId":"6aeb2ac6d4e7ed0286063fab","collectionId":"c7801af1-ad9e-4164-9c06-424d4b732335","liveDeploymentHistoryId":"6aeb2ac6d4e7ed0286063fab","schemaVersion":"v3"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6aeb2b01119a07d709eaf68f","clientVersion":"0.0.4054","searchFilterCounts":[{"language":"default","tag":"API Reference","count":66},{"language":"default","tag":"Guides","count":28},{"language":"default","tag":"Transactions","count":22},{"language":"default","tag":"Beneficiaries","count":15},{"language":"default","tag":"Customers","count":14},{"language":"default","tag":"Webhooks","count":12},{"language":"default","tag":"Customers and compliance","count":11},{"language":"default","tag":"Catalogue","count":7},{"language":"default","tag":"All Catalogues","count":7},{"language":"default","tag":"Create now, settle later","count":7}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/virtual-accounts/create-virtual-account-v3","slug":"/api-reference/virtual-accounts/create-virtual-account-v3","pageMetadata":{"openapi":"POST /v3/customers/{customer_id}/virtual-accounts","title":"Create Virtual Account V3","description":"Create a virtual bank account for a specific customer to convert fiat deposits to crypto. The `customer_id` path parameter identifies the customer for whom the virtual account is being created. V3 adds `source.bank` so you can choose the banking partner that issues the account, and returns the destination and banking partner on the create response.","href":"/api-reference/virtual-accounts/create-virtual-account-v3"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Create a virtual bank account for a specific customer to convert fiat deposits to crypto. The \", _jsx(_components.code, {\n children: \"customer_id\"\n }), \" path parameter identifies the customer for whom the virtual account is being created. V3 adds \", _jsx(_components.code, {\n children: \"source.bank\"\n }), \" so you can choose the banking partner that issues the account, and returns the destination and banking partner on the create response.\"]\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`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Heading,Note,Table}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsx(Note,{children:_jsx(_components.p,{children:`Any fiat transactions submitted between 9:30 AM and 5:30 PM ET on a weekday are processed the same day. Transactions submitted outside these hours or on weekends will be settled the next business day.`})}),`\n`,_jsx(Note,{children:_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Check all the supported fiat and crypto rails and currencies, along with the valid combinations, in `,_jsx(_components.a,{href:`https://docs.engagexpay.com/guides/coverage/supported-rails-and-currencies`,children:`Supported rails and currencies`}),`.`]}),`\n`,_jsx(_components.li,{children:`The available rails and currencies depend on the configuration set up for you. Contact support to know more.`}),`\n`,_jsx(_components.li,{children:`The minimum deposit amount for USD virtual accounts is 50 USD.`}),`\n`]})}),`\n`,_jsx(Heading,{level:`2`,id:`what-changed-from-v2`,children:`What changed from V2`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{style:{textAlign:`left`},children:`Change`}),_jsx(_components.th,{style:{textAlign:`left`},children:`Detail`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsxs(_components.td,{style:{textAlign:`left`},children:[_jsx(_components.code,{children:`source.bank`}),` added`]}),_jsx(_components.td,{style:{textAlign:`left`},children:`Required. Selects the banking partner that issues the account.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:`Response body`}),_jsxs(_components.td,{style:{textAlign:`left`},children:[`Now returns `,_jsx(_components.code,{children:`deposit_instructions`}),`, `,_jsx(_components.code,{children:`destination`}),`, and `,_jsx(_components.code,{children:`bank`}),`. `,_jsx(_components.code,{children:`customer_id`}),` and `,_jsx(_components.code,{children:`created_at`}),` are no longer returned on create.`]})]})]})]}),`\n`,_jsxs(_components.p,{children:[`V2 remains available at `,_jsx(_components.a,{href:`/api-reference/virtual-accounts/create-virtual-account-v2`,children:`Create Virtual Account V2`}),` for existing integrations. Use V3 for new integrations.`]}),`\n`,_jsx(Heading,{level:`2`,id:`choosing-a-banking-partner`,children:`Choosing a banking partner`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`source.bank`}),` selects the banking partner that issues the virtual account and receives the customer’s fiat deposit. The only accepted value is `,_jsx(_components.code,{children:`PORTAGE`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`duplicate-accounts`,children:`Duplicate accounts`}),`\n`,_jsxs(_components.p,{children:[`A customer can hold only one virtual account per source currency and rail. Requesting one that already exists returns `,_jsx(_components.code,{children:`422`}),` with the colliding `,_jsx(_components.code,{children:`customer_id`}),` and `,_jsx(_components.code,{children:`source`}),` in `,_jsx(_components.code,{children:`errors`}),`, along with the `,_jsx(_components.code,{children:`virtual_account_id`}),` of the existing account. Use that account instead of retrying the create call.`]})]})}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":{"openapi":"POST /v3/customers/{customer_id}/virtual-accounts","title":"Create Virtual Account V3","description":"Create a virtual bank account for a specific customer to convert fiat deposits to crypto. The `customer_id` path parameter identifies the customer for whom the virtual account is being created. V3 adds `source.bank` so you can choose the banking partner that issues the account, and returns the destination and banking partner on the create response.","href":"/api-reference/virtual-accounts/create-virtual-account-v3"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"What changed from V2","slug":"what-changed-from-v2","depth":2,"children":[]},{"title":"Choosing a banking partner","slug":"choosing-a-banking-partner","depth":2,"children":[]},{"title":"Duplicate accounts","slug":"duplicate-accounts","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"createVirtualAccountV3","summary":"Create Virtual Account V3","description":"Create a virtual bank account for a specific customer to convert fiat deposits to crypto. The `customer_id` path parameter identifies the customer for whom the virtual account is being created. V3 adds `source.bank` so you can choose the banking partner that issues the account, and returns the destination and banking partner on the create response.","tags":["Virtual Accounts"],"security":["a041b604-d7ad-42f2-9d4e-681fe263ef11"],"parameters":["1ecf5ff5-39bf-40f1-a8f9-e955c78ab354"],"requestBody":"71f7ee4c-79cc-48c5-904d-a1d36199e7f6","responses":{"200":"dd249b21-be3e-454a-afba-e1bff5eb62ff","401":"5bca3f14-4287-4d43-9e3a-e7ecd1b9b137","422":"d0ce4ca3-0621-4600-ba62-dda0f0c10bc4"},"method":"post","type":"path","servers":["cbeade3a-6620-4ea8-a8b3-35acd1819633","dafcce7c-d9d9-422e-9aae-ab48e7d0edc1"],"path":"/v3/customers/{customer_id}/virtual-accounts","baseUrlOptions":["https://sandbox.api.engagexpay.com","https://api.engagexpay.com"],"title":"Create Virtual Account V3","codeSamples":[],"requestExampleLanguages":["bash","node","java","python","go"],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated","disableProxy":true},"dependencies":{"parameters":{"1ecf5ff5-39bf-40f1-a8f9-e955c78ab354":{"name":"customer_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","isRequired":true,"description":"Unique identifier of the customer to create the virtual account for.","uniqueKey":"","typeLabel":"string\u003cuuid>"},"description":"Unique identifier of the customer to create the virtual account for.","example":"ed54db74-7dbe-47d2-8ea0-c2bf2a9dda06"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["destination","source","developer_fee"],"properties":{"destination":{"type":"object","required":["wallet","currency","rail"],"properties":{"wallet":{"type":"string","description":"Destination wallet address. The address format depends on the rail. Ethereum, Base, and Polygon use hexadecimal (0x...), and Solana uses base58.","example":"0x7A3f5C21b9E04d8a6C15fB3e920D74Ac815b6E39","isRequired":true,"uniqueKey":"destination.wallet","typeLabel":"string"},"currency":{"type":"string","enum":["USDC"],"description":"Token delivered to the destination wallet. Availability depends on both the rail and the source rail. See [Supported rails and currencies](https://docs.engagexpay.com/guides/coverage/supported-rails-and-currencies) for valid combinations.","example":"USDC","isRequired":true,"uniqueKey":"destination.currency","typeLabel":"enum\u003cstring>"},"rail":{"type":"string","enum":["POLYGON","ETHEREUM","SOLANA","BASE"],"description":"Blockchain network for the destination wallet. Not every token is issued on every network. See [Supported rails and currencies](https://docs.engagexpay.com/guides/coverage/supported-rails-and-currencies) for valid combinations.","example":"ETHEREUM","isRequired":true,"uniqueKey":"destination.rail","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"destination","typeLabel":"object"},"source":{"type":"object","required":["currency","rail","bank"],"properties":{"currency":{"type":"string","enum":["USD","MXN"],"description":"Fiat currency of the incoming deposit. Each source rail settles in a single currency.","example":"USD","isRequired":true,"uniqueKey":"source.currency","typeLabel":"enum\u003cstring>"},"rail":{"type":"string","enum":["ACH","SWIFT","FEDWIRE","SPEI"],"description":"Fiat payment rail used to fund the virtual account. ACH and Fedwire settle USD domestically, SWIFT settles USD internationally, and SPEI settles MXN.","example":"FEDWIRE","isRequired":true,"uniqueKey":"source.rail","typeLabel":"enum\u003cstring>"},"bank":{"type":"string","enum":["PORTAGE"],"description":"Banking partner that issues the virtual account and receives the fiat deposit. The banks available to you depend on your configuration, and not every bank supports every source rail. Contact support to find out which banks are enabled for your account.","example":"PORTAGE","isRequired":true,"uniqueKey":"source.bank","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"source","typeLabel":"object"},"developer_fee":{"type":"object","required":["percentage","fixed"],"properties":{"fixed":{"type":"number","example":0,"isRequired":true,"uniqueKey":"developer_fee.fixed","typeLabel":"number"},"percentage":{"type":"number","example":0,"isRequired":true,"uniqueKey":"developer_fee.percentage","typeLabel":"number"}},"isRequired":true,"uniqueKey":"developer_fee","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"destination":{"wallet":"0x7A3f5C21b9E04d8a6C15fB3e920D74Ac815b6E39","currency":"USDC","rail":"ETHEREUM"},"source":{"currency":"USD","rail":"FEDWIRE","bank":"PORTAGE"},"developer_fee":{"fixed":0,"percentage":0}},"examples":{"Example":{"title":"Example","value":{"destination":{"wallet":"0x7A3f5C21b9E04d8a6C15fB3e920D74Ac815b6E39","currency":"USDC","rail":"ETHEREUM"},"source":{"currency":"USD","rail":"FEDWIRE","bank":"PORTAGE"},"developer_fee":{"fixed":0,"percentage":0}}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"dd249b21-be3e-454a-afba-e1bff5eb62ff":{"description":"Virtual account created successfully","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier of the virtual account.","example":"9d2b7f41-6c8a-45e3-b071-2fa93c5e8d16","uniqueKey":"data.id","typeLabel":"string\u003cuuid>"},"status":{"type":"string","enum":["PROCESSING","IN_COMPLIANCE","REQUEST_FOR_INFORMATION","ACTIVE","INACTIVE","DECLINED"],"description":"Current state of the virtual account. A newly created account is always returned as `PROCESSING`, and `deposit_instructions` stays null, until the banking partner issues the account. Once the bank issues it, the status moves to `ACTIVE` and the deposit instructions are populated. Poll [List Virtual Accounts](https://docs.engagexpay.com/api-reference/virtual-accounts/list-virtual-accounts-v3) or listen for the virtual account webhooks to pick up the change.","example":"PROCESSING","uniqueKey":"data.status","typeLabel":"enum\u003cstring>"},"deposit_instructions":{"oneOf":[{"type":"object","description":"Bank details the customer deposits into. Null until the account becomes `ACTIVE`, so it is always null on the create response.","properties":{"currency":{"type":"string","example":"USD","uniqueKey":"data.deposit_instructions.oneOf.0.currency","typeLabel":"string"},"bank_name":{"type":"string","example":"Bank of Nowhere","uniqueKey":"data.deposit_instructions.oneOf.0.bank_name","typeLabel":"string"},"bank_address":{"type":"string","example":"1800 North Pole St., Orlando, FL 32801","uniqueKey":"data.deposit_instructions.oneOf.0.bank_address","typeLabel":"string"},"bank_routing_number":{"type":"string","example":"101019644","uniqueKey":"data.deposit_instructions.oneOf.0.bank_routing_number","typeLabel":"string"},"bank_account_number":{"type":"string","example":"2611508020","uniqueKey":"data.deposit_instructions.oneOf.0.bank_account_number","typeLabel":"string"},"payment_rails":{"type":"array","items":{"type":"string","uniqueKey":"data.deposit_instructions.oneOf.0.payment_rails.items.[INDEX]","typeLabel":"string"},"example":["ACH","FEDWIRE"],"uniqueKey":"data.deposit_instructions.oneOf.0.payment_rails","typeLabel":"string[]"},"bank_country":{"oneOf":[{"type":"string","example":null,"uniqueKey":"data.deposit_instructions.oneOf.0.bank_country.oneOf.0","typeLabel":"string"},{"type":"null","example":null,"uniqueKey":"data.deposit_instructions.oneOf.0.bank_country.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.deposit_instructions.oneOf.0.bank_country","typeLabel":"string | null"},"account_type":{"oneOf":[{"type":"string","example":null,"uniqueKey":"data.deposit_instructions.oneOf.0.account_type.oneOf.0","typeLabel":"string"},{"type":"null","example":null,"uniqueKey":"data.deposit_instructions.oneOf.0.account_type.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.deposit_instructions.oneOf.0.account_type","typeLabel":"string | null"},"bank_code":{"oneOf":[{"type":"string","example":null,"uniqueKey":"data.deposit_instructions.oneOf.0.bank_code.oneOf.0","typeLabel":"string"},{"type":"null","example":null,"uniqueKey":"data.deposit_instructions.oneOf.0.bank_code.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.deposit_instructions.oneOf.0.bank_code","typeLabel":"string | null"}},"uniqueKey":"data.deposit_instructions.oneOf.0","typeLabel":"object"},{"type":"null","description":"Bank details the customer deposits into. Null until the account becomes `ACTIVE`, so it is always null on the create response.","properties":{"currency":{"type":"string","example":"USD"},"bank_name":{"type":"string","example":"Bank of Nowhere"},"bank_address":{"type":"string","example":"1800 North Pole St., Orlando, FL 32801"},"bank_routing_number":{"type":"string","example":"101019644"},"bank_account_number":{"type":"string","example":"2611508020"},"payment_rails":{"type":"array","items":{"type":"string"},"example":["ACH","FEDWIRE"]},"bank_country":{"oneOf":[{"type":"string","example":null},{"type":"null","example":null}]},"account_type":{"oneOf":[{"type":"string","example":null},{"type":"null","example":null}]},"bank_code":{"oneOf":[{"type":"string","example":null},{"type":"null","example":null}]}},"uniqueKey":"data.deposit_instructions.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.deposit_instructions","typeLabel":"object | null"},"destination":{"type":"object","description":"Crypto destination the deposits settle to, echoed back from the request.","properties":{"currency":{"type":"string","enum":["USDC"],"example":"USDC","uniqueKey":"data.destination.currency","typeLabel":"enum\u003cstring>"},"destination_chain":{"type":"string","enum":["POLYGON","ETHEREUM","SOLANA","BASE"],"example":"ETHEREUM","uniqueKey":"data.destination.destination_chain","typeLabel":"enum\u003cstring>"},"address":{"type":"string","example":"0x4E91c07aB35d2F6810b94Ce7d13A5f826c0D4b7E","uniqueKey":"data.destination.address","typeLabel":"string"}},"uniqueKey":"data.destination","typeLabel":"object"},"bank":{"type":"string","enum":["PORTAGE"],"description":"Banking partner that issues the virtual account, echoed back from the request.","example":"PORTAGE","uniqueKey":"data.bank","typeLabel":"enum\u003cstring>"},"rfi":{"oneOf":[{"type":"object","description":"Populated only when the status is `REQUEST_FOR_INFORMATION`.","example":null,"uniqueKey":"data.rfi.oneOf.0","typeLabel":"object"},{"type":"null","description":"Populated only when the status is `REQUEST_FOR_INFORMATION`.","example":null,"uniqueKey":"data.rfi.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.rfi","typeLabel":"object | null"}},"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"OK":{"title":"OK","value":{"data":{"id":"9d2b7f41-6c8a-45e3-b071-2fa93c5e8d16","status":"PROCESSING","deposit_instructions":null,"destination":{"currency":"USDC","destination_chain":"ETHEREUM","address":"0x4E91c07aB35d2F6810b94Ce7d13A5f826c0D4b7E"},"bank":"PORTAGE","rfi":null}}}},"exampleType":"examples"}},"exampleType":"examples"},"5bca3f14-4287-4d43-9e3a-e7ecd1b9b137":{"description":"Authentication failed due to invalid credentials","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Authentication failed","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"Authentication failed"}}},"exampleType":"generated"}},"exampleType":"generated"},"d0ce4ca3-0621-4600-ba62-dda0f0c10bc4":{"description":"The request failed validation. This includes the case where a virtual account already exists for the same customer and source combination.","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string","description":"Summary of why the request failed.","example":"Virtual account already exists for the given parameters.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"errors":{"type":"array","description":"Context for the failure. When a virtual account already exists, this holds the customer and source that collided, followed by the identifier of the account that already covers them.","items":{"type":"object","properties":{"customer_id":{"type":"string","format":"uuid","description":"Customer the request was made for.","example":"c1f4a8e2-3b57-4d09-9a61-7e2b5c8d4f30","uniqueKey":"errors.items.[INDEX].customer_id","typeLabel":"string\u003cuuid>"},"source":{"type":"object","description":"Source currency and rail that already has a virtual account.","properties":{"currency":{"type":"string","example":"USD","uniqueKey":"errors.items.[INDEX].source.currency","typeLabel":"string"},"rail":{"type":"string","example":"FEDWIRE","uniqueKey":"errors.items.[INDEX].source.rail","typeLabel":"string"}},"uniqueKey":"errors.items.[INDEX].source","typeLabel":"object"},"virtual_account_id":{"type":"string","format":"uuid","description":"Identifier of the virtual account that already exists. Use this account rather than creating another one.","example":"9d2b7f41-6c8a-45e3-b071-2fa93c5e8d16","uniqueKey":"errors.items.[INDEX].virtual_account_id","typeLabel":"string\u003cuuid>"}},"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"uniqueKey":"errors","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"DuplicateVirtualAccount":{"title":"DuplicateVirtualAccount","value":{"errors":[{"customer_id":"c1f4a8e2-3b57-4d09-9a61-7e2b5c8d4f30","source":{"currency":"USD","rail":"FEDWIRE"}},{"virtual_account_id":"9d2b7f41-6c8a-45e3-b071-2fa93c5e8d16"}],"message":"Virtual account already exists for the given parameters."}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"a041b604-d7ad-42f2-9d4e-681fe263ef11":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Bearer token authentication. Obtain token from [Issue a Token](https://docs.engagexpay.com/api-reference/authentication/issue-a-token) endpoint","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"cbeade3a-6620-4ea8-a8b3-35acd1819633":{"url":"https://sandbox.api.engagexpay.com","description":"Sandbox server"},"dafcce7c-d9d9-422e-9aae-ab48e7d0edc1":{"url":"https://api.engagexpay.com","description":"Production server"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Bearer token authentication. Obtain token from [Issue a Token](https://docs.engagexpay.com/api-reference/authentication/issue-a-token) endpoint","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer token authentication. Obtain token from [Issue a Token](https://docs.engagexpay.com/api-reference/authentication/issue-a-token) endpoint","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"api-reference/openapi.yaml"},"subdomain":"enagage-x-pay","siteName":"EngageXPay","title":"Create Virtual Account V3 - EngageXPay","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-04T12:53:44.388Z","originalFileLocation":"api-reference/virtual-accounts/create-virtual-account-v3.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=\"dark\"}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=\"Create a virtual bank account for a specific customer to convert fiat deposits to crypto. The customer_id path parameter identifies the customer for whom the virtual account is being created. V3 adds source.bank so you can choose the banking partner that issues the account, and returns the destination and banking partner on the create response.\">\u003cmeta data-mint-head name=\"application-name\" content=\"EngageXPay\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/enagage-x-pay/rcU3n-36H6C4X8E2/_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/enagage-x-pay/rcU3n-36H6C4X8E2/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/enagage-x-pay/rcU3n-36H6C4X8E2/_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/enagage-x-pay/rcU3n-36H6C4X8E2/_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/enagage-x-pay/rcU3n-36H6C4X8E2/_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/enagage-x-pay/rcU3n-36H6C4X8E2/_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/enagage-x-pay/rcU3n-36H6C4X8E2/_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/enagage-x-pay/rcU3n-36H6C4X8E2/_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/enagage-x-pay/rcU3n-36H6C4X8E2/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create Virtual Account V3 - EngageXPay\">\u003cmeta data-mint-head property=\"og:description\" content=\"Create a virtual bank account for a specific customer to convert fiat deposits to crypto. The customer_id path parameter identifies the customer for whom the virtual account is being created. V3 adds source.bank so you can choose the banking partner that issues the account, and returns the destination and banking partner on the create response.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"EngageXPay\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://doc.engagexpay.com/api-reference/virtual-accounts/create-virtual-account-v3\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://enagage-x-pay.mintlify.app/_mintlify/api/og/v2?division=Create+Virtual+Account\u0026amp;title=Create+Virtual+Account+V3\u0026amp;description=Create+a+virtual+bank+account+for+a+specific+customer+to+convert+fiat+deposits+to+crypto.+The+%60customer_id%60+path+parameter+identifies+the+customer+for+whom+the+\u0026amp;theme=2356807b39eb913fdb8aabf5\u0026amp;signature=e36d1577be06b038d193591f631f1487947ecff127c49a899812db1cd6b1cfdf\">\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=\"Create Virtual Account V3 - EngageXPay\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Create a virtual bank account for a specific customer to convert fiat deposits to crypto. The customer_id path parameter identifies the customer for whom the virtual account is being created. V3 adds source.bank so you can choose the banking partner that issues the account, and returns the destination and banking partner on the create response.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://enagage-x-pay.mintlify.app/_mintlify/api/og/v2?division=Create+Virtual+Account\u0026amp;title=Create+Virtual+Account+V3\u0026amp;description=Create+a+virtual+bank+account+for+a+specific+customer+to+convert+fiat+deposits+to+crypto.+The+%60customer_id%60+path+parameter+identifies+the+customer+for+whom+the+\u0026amp;theme=2356807b39eb913fdb8aabf5\u0026amp;signature=e36d1577be06b038d193591f631f1487947ecff127c49a899812db1cd6b1cfdf\">\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/enagage-x-pay/rcU3n-36H6C4X8E2/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"EngageXPay\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#151515\">\u003clink data-mint-head rel=\"canonical\" href=\"https://doc.engagexpay.com/api-reference/virtual-accounts/create-virtual-account-v3\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/virtual-accounts/create-virtual-account-v3.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://doc.engagexpay.com/#organization\",\"name\":\"EngageXPay\",\"url\":\"https://doc.engagexpay.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/enagage-x-pay/FEj0pOmeiBFLeLWn/logo/engagexpay-light.svg?fit=max\u0026auto=format\u0026n=FEj0pOmeiBFLeLWn\u0026q=85\u0026s=4150a6758362fde0c5ab216d6382c1bd\"}},{\"@type\":\"WebSite\",\"@id\":\"https://doc.engagexpay.com#website\",\"name\":\"EngageXPay\",\"url\":\"https://doc.engagexpay.com\",\"publisher\":{\"@id\":\"https://doc.engagexpay.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://doc.engagexpay.com/api-reference/virtual-accounts/create-virtual-account-v3#webpage\",\"url\":\"https://doc.engagexpay.com/api-reference/virtual-accounts/create-virtual-account-v3\",\"name\":\"Create Virtual Account V3\",\"description\":\"Create a virtual bank account for a specific customer to convert fiat deposits to crypto. The customer_id path parameter identifies the customer for whom the virtual account is being created. V3 adds source.bank so you can choose the banking partner that issues the account, and returns the destination and banking partner on the create response.\",\"dateModified\":\"2026-11-04T12:53:44.388Z\",\"isPartOf\":{\"@id\":\"https://doc.engagexpay.com#website\"},\"breadcrumb\":{\"@id\":\"https://doc.engagexpay.com/api-reference/virtual-accounts/create-virtual-account-v3#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://doc.engagexpay.com/api-reference/virtual-accounts/create-virtual-account-v3#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"EngageXPay\",\"item\":\"https://doc.engagexpay.com\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create Virtual Account V3\",\"item\":\"https://doc.engagexpay.com/api-reference/virtual-accounts/create-virtual-account-v3\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://doc.engagexpay.com/api-reference/virtual-accounts/create-virtual-account-v3#apireference\",\"headline\":\"Create Virtual Account V3\",\"name\":\"Create Virtual Account V3\",\"description\":\"Create a virtual bank account for a specific customer to convert fiat deposits to crypto. The customer_id path parameter identifies the customer for whom the virtual account is being created. V3 adds source.bank so you can choose the banking partner that issues the account, and returns the destination and banking partner on the create response.\",\"url\":\"https://doc.engagexpay.com/api-reference/virtual-accounts/create-virtual-account-v3\",\"mainEntityOfPage\":{\"@id\":\"https://doc.engagexpay.com/api-reference/virtual-accounts/create-virtual-account-v3#webpage\"},\"dateModified\":\"2026-11-04T12:53:44.388Z\",\"publisher\":{\"@id\":\"https://doc.engagexpay.com/#organization\"},\"isPartOf\":{\"@id\":\"https://doc.engagexpay.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"EngageXPay\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"EngageXPay","nav":{"global":null,"tabs":[{"tab":"Main Site","href":"https://engagexpay.com"},{"tab":"Guides","pages":[{"title":"Guides","href":""}]},{"tab":"API Reference","pages":[{"group":"Authentication","pages":[{"openapi":"POST /v1/oauth/token","title":"Issue a Token","href":"/api-reference/authentication/issue-a-token"},{"openapi":"POST /v1/oauth/refresh-token","title":"Refresh a Token","href":"/api-reference/authentication/refresh-a-token"}]},{"group":"Customers","pages":[{"group":"Create Individual Customer","expanded":false,"pages":[{"openapi":"POST /v2/customers/individual","title":"Create Individual Customer","href":"/api-reference/customers/create-individual-customer-v2"},{"openapi":"POST /v2/customers/{customer_id}/individual/attach","title":"Attach Documents to Individual Customer","href":"/api-reference/customers/attach-documents-to-individual-customer-v2"}]},{"group":"Create Business Customer","expanded":false,"pages":[{"openapi":"POST /v2/customers/business","title":"Create Business Customer","href":"/api-reference/customers/create-business-customer-v2"},{"openapi":"POST /v2/customers/{customer_id}/business/attach","title":"Attach Documents to Business Customer","href":"/api-reference/customers/attach-documents-to-business-customer-v2"},{"openapi":"POST /v2/customers/{customer_id}/associated-parties/individual/attach","title":"Attach Documents to Associated Party","href":"/api-reference/customers/attach-documents-to-associated-party-v2"}]},{"openapi":"GET /v2/customers/{customer_id}","title":"Get Customer Details","href":"/api-reference/customers/get-customer-details-v2"},{"openapi":"GET /v2/customers","title":"List Customers","href":"/api-reference/customers/list-customers-v2"},{"openapi":"GET /v2/customers/{customer_id}/capabilities","title":"Get Customer Capabilities","href":"/api-reference/customers/get-customer-capabilities"},{"title":"Get Required Documents","openapi":"GET /v2/customers/required-documents","href":"/api-reference/customers/get-required-documents"},{"openapi":"POST /v1/customers/upload","title":"Upload Document","href":"/api-reference/customers/upload-document"},{"openapi":"PATCH /v1/customers/{customer_id}","title":"Patch Customer RFI","href":"/api-reference/customers/patch-customer-rfi"}]},{"group":"Beneficiaries","pages":[{"group":"Create Beneficiary","expanded":false,"pages":[{"openapi":"POST /v3/beneficiaries","title":"Create Beneficiary V3","href":"/api-reference/beneficiaries/create-beneficiary-v3"},{"openapi":"POST /v2/beneficiaries","title":"Create Beneficiary V2","href":"/api-reference/beneficiaries/create-beneficiary-v2"},{"openapi":"GET /v1/beneficiaries/countries","title":"List Available Countries","href":"/api-reference/beneficiaries/list-available-countries"},{"openapi":"GET /v1/beneficiaries/methods","title":"List Bank Identifiers","href":"/api-reference/beneficiaries/list-bank-identifiers"},{"openapi":"GET /v1/beneficiaries/methods/{method_id}/branches","title":"List Bank Branch Identifiers","href":"/api-reference/beneficiaries/list-bank-branch-identifiers"}]},{"openapi":"GET /v2/beneficiaries/details","title":"Fetch Beneficiary Details","href":"/api-reference/beneficiaries/fetch-beneficiary-details-v2"},{"openapi":"GET /v1/customers/{customer_id}/beneficiaries","title":"List Beneficiaries For a Customer","href":"/api-reference/beneficiaries/list-beneficiaries-for-a-customer"},{"openapi":"PATCH /v1/beneficiaries","title":"Update Beneficiary Active Status","href":"/api-reference/beneficiaries/update-beneficiary-active-status"},{"openapi":"POST /v1/beneficiaries/{beneficiary_id}/documents","title":"Upload Beneficiary Documents","description":"Upload one or more documents for a specific beneficiary using multipart/form-data","href":"/api-reference/beneficiaries/upload-beneficiary-documents"}]},{"group":"Virtual Accounts","pages":[{"group":"Create Virtual Account","expanded":false,"pages":[{"openapi":"POST /v3/customers/{customer_id}/virtual-accounts","title":"Create Virtual Account V3","href":"/api-reference/virtual-accounts/create-virtual-account-v3"},{"openapi":"POST /v2/customers/{customer_id}/virtual-accounts","title":"Create Virtual Account V2","description":"Create a virtual bank account for a specific customer to convert fiat deposits to crypto. The `customer_id` path parameter identifies the customer for whom the virtual account is being created.","href":"/api-reference/virtual-accounts/create-virtual-account-v2"}]},{"openapi":"GET /v3/customers/{customer_id}/virtual-accounts","title":"List Virtual Accounts","href":"/api-reference/virtual-accounts/list-virtual-accounts-v3"},{"openapi":"GET /v3/customers/{customer_id}/virtual-accounts/{va_id}","title":"Get Virtual Account Details","href":"/api-reference/virtual-accounts/get-virtual-account-details"},{"openapi":"GET /v1/virtual-account/{virtual_account_id}/transactions","title":"Fetch Virtual Account Transactions","href":"/api-reference/virtual-accounts/fetch-virtual-account-transactions"}]},{"group":"Transactions","pages":[{"group":"Create now, settle later","expanded":false,"pages":[{"openapi":"POST /v3/transactions/transfer-payout","title":"Create a Transfer V3","href":"/api-reference/transactions/create-a-transfer-v3"},{"openapi":"POST /v1/transactions/transfer-payout","title":"Create a Transfer","href":"/api-reference/transactions/create-a-transfer"},{"openapi":"POST /v2/transactions/transfer-payout","title":"Create a Transfer V2","href":"/api-reference/transactions/create-a-transfer-v2"},{"openapi":"POST /v3/transactions/transfer-payout/settle","title":"Settle a Transfer V3","href":"/api-reference/transactions/settle-a-transfer-v3"},{"openapi":"POST /v1/transactions/transfer-payout/settle","title":"Settle a Transfer","href":"/api-reference/transactions/settle-a-transfer"},{"openapi":"POST /v2/transactions/transfer-payout/settle","title":"Settle a Transfer V2","href":"/api-reference/transactions/settle-a-transfer-v2"},{"openapi":"POST /v1/beneficiaries/{beneficiary_id}/documents","title":"Upload Beneficiary Documents","href":"/api-reference/transactions/upload-beneficiary-documents"}]},{"group":"Batch Transfer","expanded":false,"pages":[{"openapi":"POST /v3/batch/transactions/commit","title":"Execute Batch Transfer V3","href":"/api-reference/transactions/execute-batch-transfer-v3"},{"openapi":"POST /v1/batch/transactions/commit","title":"Execute Batch Transfer","href":"/api-reference/transactions/execute-batch-transfer"},{"openapi":"GET /v1/batch/transactions/commit/{batch_id}","title":"Fetch Batch Details","href":"/api-reference/transactions/fetch-batch-details"}]},{"group":"Crypto Transfer","expanded":false,"pages":[{"openapi":"POST /v3/transactions/quote","title":"Create Quote V3","href":"/api-reference/transactions/create-quote-v3"},{"openapi":"POST /v2/transactions/quote","title":"Create Quote","href":"/api-reference/transactions/create-quote"},{"openapi":"POST /v3/transactions","title":"Execute Quote V3","href":"/api-reference/transactions/execute-quote-v3"},{"openapi":"POST /v2/transactions","title":"Execute Quote","href":"/api-reference/transactions/execute-quote"}]},{"group":"Transactions List","expanded":false,"pages":[{"openapi":"GET /v3/transactions","title":"List Customer Transactions V3","href":"/api-reference/transactions/list-customer-transactions-v3"},{"openapi":"GET /v2/transactions","title":"List Customer Transactions","href":"/api-reference/transactions/list-customer-transactions"},{"openapi":"GET /v1/beneficiaries/{beneficiary_id}/transactions","title":"List Beneficiary Transactions","href":"/api-reference/transactions/list-beneficiary-transactions"}]},{"group":"Transaction Details","expanded":false,"pages":[{"openapi":"GET /v3/transactions/{transaction_id}","title":"Fetch Transaction Details V3","href":"/api-reference/transactions/fetch-transaction-details-v3"},{"openapi":"GET /v2/transactions/{transaction_id}","title":"Fetch Transaction Details","href":"/api-reference/transactions/fetch-transaction-details-v2"}]}]},{"group":"Balances","pages":[{"openapi":"GET /v1/wallet/balances","title":"Fetch Prefunded Balance","href":"/api-reference/balances/fetch-prefunded-balance"}]},{"group":"Fees \u0026 FX Rates","pages":[{"openapi":"GET /v1/fx-rate","title":"Fetch Exchange Rates","href":"/api-reference/fees-and-fx-rates/fetch-exchange-rates"},{"openapi":"POST /v1/fee-calculation","title":"Calculate Exchange Rates","href":"/api-reference/fees-and-fx-rates/calculate-exchange-rates"}]},{"group":"Catalogue","pages":[{"group":"All Catalogues","expanded":false,"pages":[{"openapi":"GET /v1/occupations","title":"List Occupations","href":"/api-reference/catalogue/list-occupations"},{"openapi":"GET /v1/source-of-funds","title":"List Source of Funds","href":"/api-reference/catalogue/list-source-of-funds"},{"openapi":"GET /v1/source-of-wealth","title":"List Source of Wealth","href":"/api-reference/catalogue/list-source-of-wealth"},{"openapi":"GET /v1/purposes","title":"List Account Purposes","href":"/api-reference/catalogue/list-account-purposes"},{"title":"List Generic Country Codes","openapi":"GET /v1/countries","href":"/api-reference/catalogue/list-countries"},{"openapi":"GET /v1/countries/{country_code}/subdivisions","title":"List Subdivision Codes: ISO 3166-1 alpha-2","href":"/api-reference/catalogue/list-subdivisions"},{"openapi":"GET /v1/transaction-purposes","title":"List Transaction Purposes","href":"/api-reference/catalogue/list-transaction-purposes"}]}]},{"group":"Webhooks","pages":[{"group":"Customers","expanded":false,"pages":[{"openapi":"WEBHOOK customer.created","title":"Customer Created","href":"/api-reference/webhooks/customer-created"},{"openapi":"WEBHOOK customer.status","title":"Customer Status","href":"/api-reference/webhooks/customer-status"},{"openapi":"WEBHOOK customer.rfi","title":"Customer RFI","href":"/api-reference/webhooks/customer-rfi"}]},{"group":"Beneficiaries","expanded":false,"pages":[{"openapi":"WEBHOOK beneficiary.created","title":"Beneficiary Created","href":"/api-reference/webhooks/beneficiary-created"},{"openapi":"WEBHOOK beneficiary.status","title":"Beneficiary Status","href":"/api-reference/webhooks/beneficiary-status"}]},{"group":"Virtual Accounts","expanded":false,"pages":[{"openapi":"WEBHOOK virtual_account.created.v2","title":"Virtual Account Created V2","href":"/api-reference/webhooks/virtual-account-created-v2"},{"openapi":"WEBHOOK virtual_account.status.v2","title":"Virtual Account Status V2","href":"/api-reference/webhooks/virtual-account-status-v2"}]},{"group":"Transactions","expanded":false,"pages":[{"openapi":"WEBHOOK transaction.status","title":"Transaction Status","href":"/api-reference/webhooks/transaction-status"},{"openapi":"WEBHOOK beneficiary.liquidation.deposit","title":"Beneficiary Liquidation Deposit","href":"/api-reference/webhooks/beneficiary-liquidation-deposit"},{"openapi":"WEBHOOK batch.transaction.item.status","title":"Batch Transaction Item Status","href":"/api-reference/webhooks/batch-transaction-item-status"}]}]}]},{"tab":"Changelogs","pages":[{"title":"Changelogs","href":"/changelogs/2026-10-27"}]},{"tab":"FAQs","pages":[{"title":"FAQs","href":"/faqs"}]}]},"basePath":"","title":"Create Virtual Account V3 - EngageXPay","buildId":"dpl_345ReqzYaAjzS9QpeJemsKdb7KDj","deploymentId":"dpl_345ReqzYaAjzS9QpeJemsKdb7KDj","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-C8RPHPxo.js","utils-0BK-9q6z.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DfjzsUJT.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-B4v9psJ4.js","snippetPresets-CpTQv-Ez.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-BNP-Fvr0.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BSgu6h1D.js","shallow-Biv1i9Gs.js","getApiPlaygroundDisplay-BoGOXhtF.js","CodeSnippet-DvQoT18_.js","CodeSnippets-Dnpa15xT.js","Page-Buji1S4J.js","getPastedJson-xAIyhUFE.js","icon-S6FBih11.js","MethodPill-SaYeUZyk.js","DuplicateIcon-Cs-p3v2Q.js","createIcon-DjCFEoHq.js","DynamicMarkdown-BcnBltEQ.js","SectionHeading-BUBl0eEF.js","axios-vUo_bRtp.js","Markdown-h4cOoD8d.js","clsx-B2v50t8t.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-DJnKvr0g.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BHrrjR1K.js"]}