Use this endpoint to create an Onramper Account for a customer. An Onramper Account gives your customer a dedicated virtual bank account number. Any fiat deposited to that account is automatically converted to the specified stablecoin and forwarded to the destination wallet address — no per-transfer API call is required. Always create one Onramper Account per customer, even if multiple customers share the same destination wallet, to ensure deposits can be attributed correctly.
Onramper Accounts are a separate product from the Transfer API. They use different endpoints and do not support bank account creation via the Transfer API.
Fee breakdown for the virtual account, including integrator and platform fees.
Show child attributes
Last modified on June 18, 2026
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"SpherePay","colors":{"primary":"#2563EB","light":"#60A5FA","dark":"#1D4ED8"},"logo":{"light":"https://mintcdn.com/spherepayco/uywNRH6jm1-R-nPL/logo/sphere-light.svg?fit=max\u0026auto=format\u0026n=uywNRH6jm1-R-nPL\u0026q=85\u0026s=783c82452519d50b023b9866c8a1ba48","dark":"https://mintcdn.com/spherepayco/uywNRH6jm1-R-nPL/logo/sphere-dark.svg?fit=max\u0026auto=format\u0026n=uywNRH6jm1-R-nPL\u0026q=85\u0026s=841362b62b2d8a0da3d2b69d22c62d88"},"favicon":"https://mintcdn.com/spherepayco/a4WF4v5_QYD1dXam/favicon.png?fit=max\u0026auto=format\u0026n=a4WF4v5_QYD1dXam\u0026q=85\u0026s=b3c29639701db7176e6ac8f2b03f68a7","api":{"playground":{"display":"none"}},"navbar":{"primary":{"type":"button","label":"Sphere Dashboard ↗","href":"https://spherepay.co/dashboard"}},"icons":{"library":"lucide"},"styling":{"codeblocks":"dark","latex":true},"metadata":{"timestamp":true},"navigation":{"languages":[{"language":"en","default":true,"href":"introduction"},{"language":"es","href":"es/introduction"},{"language":"pt-BR","href":"pt-BR/introduction"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"spherepayco","hasAudioNarration":false,"actualSubdomain":"spherepayco","customDomains":["docs.spherepay.co"],"gitSource":{"type":"github","owner":"sphere-laboratories","repo":"mintlify-docs","deployBranch":"main","isPrivate":true,"contentDirectory":"","mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae4e40af8344a2328cd117d","collectionId":"1a93b227-1f28-4c2a-bb42-9163f0a8c012","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae4e40af8344a2328cd117d"},"feedback":{"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae4e40af8344a2328cd117d","clientVersion":"0.0.4044","searchFilterCounts":[{"language":"en","tag":"API Reference","count":52},{"language":"es","tag":"Referencia de la API","count":52},{"language":"pt-BR","tag":"Referência da API","count":52},{"language":"en","tag":"Concepts","count":29},{"language":"es","tag":"Conceptos","count":29},{"language":"pt-BR","tag":"Conceitos","count":29},{"language":"en","tag":"Onboarding","count":27},{"language":"es","tag":"Incorporación","count":27},{"language":"pt-BR","tag":"Onboarding","count":27},{"language":"en","tag":"Money movement","count":24},{"language":"es","tag":"Movimiento de dinero","count":24},{"language":"pt-BR","tag":"Movimentação de dinheiro","count":24},{"language":"en","tag":"Webhooks","count":13},{"language":"es","tag":"Webhooks","count":13},{"language":"pt-BR","tag":"Webhooks","count":13},{"language":"en","tag":"Accounts","count":9},{"language":"en","tag":"Transfers","count":9},{"language":"en","tag":"Get Started","count":9},{"language":"es","tag":"Cuentas","count":9},{"language":"es","tag":"Transferencias","count":9},{"language":"es","tag":"Comenzar","count":9},{"language":"pt-BR","tag":"Contas","count":9},{"language":"pt-BR","tag":"Transferências","count":9},{"language":"pt-BR","tag":"Começar","count":9},{"language":"en","tag":"Virtual Accounts","count":7},{"language":"es","tag":"Cuentas Virtuales","count":7},{"language":"pt-BR","tag":"Contas Virtuais","count":7},{"language":"en","tag":"Documents \u0026 Verification","count":6},{"language":"es","tag":"Documentos y Verificación","count":6},{"language":"pt-BR","tag":"Documentos e Verificação","count":6}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":true,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true,"deflection":{"enabled":true,"email":"support@spherepay.co","showHelpButton":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":"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":"byok-sep-25","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":"billing-updated-9-15","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}],"starterQuestions":[{"_id":"6a02974593b34b4b8541d063","deploymentId":"69f39b63abf2e25489b5290d","questionText":"What currencies are supported?","status":"active","generatedBy":"manual","createdAt":"2026-05-12T02:58:13.452Z","updatedAt":"2026-05-12T02:58:13.452Z","__v":0},{"_id":"6a02973893b34b4b8541d023","deploymentId":"69f39b63abf2e25489b5290d","questionText":"How do I create a transfer?","status":"active","generatedBy":"manual","createdAt":"2026-05-12T02:58:00.452Z","updatedAt":"2026-05-12T02:58:00.452Z","__v":0},{"_id":"6a02972c93b34b4b8541cfef","deploymentId":"69f39b63abf2e25489b5290d","questionText":"How do I onboard a business?","status":"active","generatedBy":"manual","createdAt":"2026-05-12T02:57:48.946Z","updatedAt":"2026-05-12T02:57:48.946Z","__v":0}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"[data-component-part=update-tag]{padding:2px 8px;border:1px solid var(--gray-200, #e5e7eb);background:0 0;color:var(--gray-600, #4b5563);font-size:.6875rem;font-weight:600;letter-spacing:.04em;text-transform:uppercase;border-radius:4px;line-height:1.4}.dark [data-component-part=update-tag]{border-color:var(--gray-700, #374151);color:var(--gray-300, #d1d5db)}[data-component-part=update-tag-list]{margin-top:.5rem;gap:.375rem}nav[class*=navbar] ul li a.link{border-radius:0!important;background:0 0!important;border-bottom:2px solid transparent;transition:border-color 120ms ease,color 120ms ease}nav[class*=navbar] ul li a.link:hover{background:0 0!important;color:#18181b!important;border-bottom-color:rgba(37,99,235,.4)}.dark nav[class*=navbar] ul li a.link:hover{color:#60a5fa!important;border-bottom-color:rgba(96,165,250,.4)}nav[class*=navbar] ul li a.link[aria-current=page]{background:0 0!important;border-bottom-color:var(--mintlify-primary, #2563EB);color:#18181b!important}.dark nav[class*=navbar] ul li a.link[aria-current=page]{color:#fafafa!important;border-bottom-color:#60a5fa}nav[class*=navbar][class*=justify-center]{justify-content:flex-start!important}button:has(>div>svg.lucide-search){width:auto!important;min-width:220px;padding-left:14px!important;padding-right:12px!important;justify-content:space-between!important}button:has(>div>svg.lucide-search) .truncate.min-w-0{display:block!important}a[href=\"https://spherepay.co/dashboard\"] span[class*=bg-primary-dark]{border-radius:6px!important;background-color:#2970ff!important;transition:background-color 120ms ease}a[href=\"https://spherepay.co/dashboard\"]:hover span[class*=bg-primary-dark]{background-color:#155eef!important;opacity:1!important}a[href=\"https://spherepay.co/dashboard\"] svg{display:none!important}[data-component-part=card-icon]{width:44px!important;height:44px!important;display:flex!important;align-items:center;justify-content:center;background:rgba(209,224,255,.5);border-radius:10px;margin-bottom:1rem}.dark [data-component-part=card-icon]{background:rgba(96,165,250,.15)}ul.space-y-px:has(>li>a[href*=\"/api-reference/\"]):not(:has(ul)){margin-left:24px;padding-left:4px;border-left:1.5px solid #e5e7eb}ul.space-y-px:has(>li>a[href*=\"/api-reference/\"]):not(:has(ul)) a[href*=\"/api-reference/\"]{padding-left:16px!important}.dark ul.space-y-px:has(>li>a[href*=\"/api-reference/\"]):not(:has(ul)){border-left-color:rgba(255,255,255,.12)}#sidebar button[aria-expanded]>div:has(>svg[viewBox=\"0 -9 3 24\"]){margin-left:auto}#sidebar:has(a[href*=\"/api-reference/\"]){border-right:1px solid #e5e7eb}.dark #sidebar:has(a[href*=\"/api-reference/\"]){border-right-color:rgba(255,255,255,.1)}.sidebar-group-icon{display:none!important}#navbar-transition{border-bottom-color:#e5e7eb!important}@media (min-width:1024px){#navbar-transition::after{content:\"\";position:absolute;left:0;right:0;top:64px;height:1px;background:#e5e7eb;pointer-events:none}}#navbar .flex-1{border-bottom-color:transparent!important}.dark #navbar-transition{border-bottom-color:rgba(255,255,255,.1)!important}.dark #navbar-transition::after{background:rgba(255,255,255,.1)}"}],"page":{"pagePath":"api-reference/virtual-account/post","slug":"/api-reference/virtual-account/post","pageMetadata":{"title":"Create a Virtual Bank Account for Fiat On-Ramp","sidebarTitle":"Create Virtual Account","openapi":"openapi/spherepay.yaml POST /v2/virtual-account","description":"Create a new virtual account that converts incoming fiat deposits to crypto.","href":"/api-reference/virtual-account/post"},"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: \"Create a new virtual account that converts incoming fiat deposits to crypto.\"\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={p:`p`,..._provideComponents(),...props.components},{Info}=_components;if(!Info)_missingMdxReference(`Info`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Use this endpoint to create an Onramper Account for a customer. An Onramper Account gives your customer a dedicated virtual bank account number. Any fiat deposited to that account is automatically converted to the specified stablecoin and forwarded to the destination wallet address — no per-transfer API call is required. Always create one Onramper Account per customer, even if multiple customers share the same destination wallet, to ensure deposits can be attributed correctly.`}),`\n`,_jsx(Info,{children:_jsx(_components.p,{children:`Onramper Accounts are a separate product from the Transfer API. They use different endpoints and do not support bank account creation via the Transfer API.`})})]})}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":{"codeStyling":"dark","config":{},"pageMetadata":{"title":"Create a Virtual Bank Account for Fiat On-Ramp","sidebarTitle":"Create Virtual Account","openapi":"openapi/spherepay.yaml POST /v2/virtual-account","description":"Create a new virtual account that converts incoming fiat deposits to crypto.","href":"/api-reference/virtual-account/post"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/spherepayco/27b80abc67bf6551/snippets/demoAppUrl.js"],"openApiReferenceData":{"operation":{"description":"Create a new virtual account that converts incoming fiat deposits to crypto.","operationId":"postV2VirtualAccount","parameters":[],"requestBody":"1e65f3c9-ca97-47cf-add5-8c140beb2453","responses":{"201":"e88ab86e-5efd-4a69-bd97-ded027492323","400":"afcc8817-086f-4c9a-a8fa-c278cc24c9f4","404":"75f7d7af-4f75-4042-8d05-f8295b4400c7","422":"7328b9f4-d3f9-47aa-94d8-b82fa5b65731"},"summary":"Create a Virtual Account","method":"post","type":"path","servers":["b5036787-7020-43a8-8dee-cb8b0d270e6a"],"security":["d8f4bc21-1820-4e73-bc5e-ea3b587aeee8"],"path":"/v2/virtual-account","baseUrlOptions":["https://api.spherepay.co"],"title":"Create a Virtual Account","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"content":{"application/json":{"schema":{"properties":{"customerId":{"description":"The customer who will own the virtual account.","example":"customer_b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7","type":"string","isRequired":true,"uniqueKey":"customerId","typeLabel":"string"},"destinationCurrency":{"description":"The crypto currency deposited funds are converted into. See [Supported Rails \u0026 Currencies](/concepts/transfers/supported-rails).","enum":["usdc","usdt","eurc"],"example":"usdc","type":"string","isRequired":true,"uniqueKey":"destinationCurrency","typeLabel":"enum\u003cstring>"},"network":{"description":"The blockchain network the destination wallet is on. See [Supported Rails \u0026 Currencies](/concepts/transfers/supported-rails).","enum":["arbitrum","avalanche","base","ethereum","polygon","sol","tron"],"example":"ethereum","type":"string","isRequired":true,"uniqueKey":"network","typeLabel":"enum\u003cstring>"},"sourceCurrency":{"description":"The fiat currency the virtual account accepts for deposits.","enum":["usd","eur"],"example":"usd","type":"string","isRequired":true,"uniqueKey":"sourceCurrency","typeLabel":"enum\u003cstring>"},"walletAddress":{"description":"The on-chain wallet address where converted crypto is sent. Must be valid for the selected network.","example":"0x4838B106FCe9647Bdf1E7877BF73cE8B0BAD5f97","type":"string","isRequired":true,"uniqueKey":"walletAddress","typeLabel":"string"},"integratorFeeBps":{"description":"Integrator fee in basis points (1 bps = 0.01%). Defaults to 0 if not provided.","example":"100","type":"string","uniqueKey":"integratorFeeBps","typeLabel":"string"}},"required":["destinationCurrency","network","walletAddress","customerId","sourceCurrency"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"customerId":"customer_b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7","destinationCurrency":"usdc","network":"ethereum","sourceCurrency":"usd","walletAddress":"0x4838B106FCe9647Bdf1E7877BF73cE8B0BAD5f97","integratorFeeBps":"100"}}},"exampleType":"generated"}},"required":true,"exampleType":"generated"},"responses":{"e88ab86e-5efd-4a69-bd97-ded027492323":{"content":{"application/json":{"schema":{"properties":{"active":{"description":"Whether the virtual account is currently active and accepting deposits.","example":true,"type":"boolean","isRequired":true,"uniqueKey":"active","typeLabel":"boolean"},"created":{"description":"Timestamp when the virtual account was created (ISO 8601).","example":"2025-01-15T10:30:00.000Z","type":"string","isRequired":true,"uniqueKey":"created","typeLabel":"string"},"depositInstructions":{"description":"Bank account details that depositors should use to send fiat funds into the virtual account.","properties":{"bankAccountNumber":{"oneOf":[{"description":"Bank account number for deposits (USD accounts). Null for EUR accounts.","example":"9876543210","type":"string","isRequired":true,"uniqueKey":"depositInstructions.bankAccountNumber.oneOf.0","typeLabel":"string"},{"description":"Bank account number for deposits (USD accounts). Null for EUR accounts.","example":"9876543210","type":"null","isRequired":true,"uniqueKey":"depositInstructions.bankAccountNumber.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"depositInstructions.bankAccountNumber","typeLabel":"string | null"},"bankAddress":{"description":"Address of the bank holding the virtual account.","example":"1801 Main St, Kansas City, MO 64108","type":"string","isRequired":true,"uniqueKey":"depositInstructions.bankAddress","typeLabel":"string"},"bankBeneficiaryAddress":{"description":"Address of the beneficiary on the account.","example":"123 Finance St, San Francisco, CA 94105","type":"string","isRequired":true,"uniqueKey":"depositInstructions.bankBeneficiaryAddress","typeLabel":"string"},"bankBeneficiaryName":{"description":"Name of the beneficiary on the account.","example":"Bridge Financial Inc.","type":"string","isRequired":true,"uniqueKey":"depositInstructions.bankBeneficiaryName","typeLabel":"string"},"bankName":{"description":"Name of the bank holding the virtual account.","example":"Lead Bank","type":"string","isRequired":true,"uniqueKey":"depositInstructions.bankName","typeLabel":"string"},"bankRoutingNumber":{"oneOf":[{"description":"Bank routing number for deposits (USD accounts). Null for EUR accounts.","example":"021000089","type":"string","isRequired":true,"uniqueKey":"depositInstructions.bankRoutingNumber.oneOf.0","typeLabel":"string"},{"description":"Bank routing number for deposits (USD accounts). Null for EUR accounts.","example":"021000089","type":"null","isRequired":true,"uniqueKey":"depositInstructions.bankRoutingNumber.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"depositInstructions.bankRoutingNumber","typeLabel":"string | null"},"bic":{"oneOf":[{"description":"BIC/SWIFT code for deposits (EUR accounts). Null for USD accounts.","example":"COBADEFFXXX","type":"string","isRequired":true,"uniqueKey":"depositInstructions.bic.oneOf.0","typeLabel":"string"},{"description":"BIC/SWIFT code for deposits (EUR accounts). Null for USD accounts.","example":"COBADEFFXXX","type":"null","isRequired":true,"uniqueKey":"depositInstructions.bic.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"depositInstructions.bic","typeLabel":"string | null"},"currency":{"description":"The fiat currency accepted for deposits into the virtual account.","enum":["usd","eur"],"example":"usd","type":"string","isRequired":true,"uniqueKey":"depositInstructions.currency","typeLabel":"enum\u003cstring>"},"iban":{"oneOf":[{"description":"IBAN for deposits (EUR accounts). Null for USD accounts.","example":"DE89370400440532013000","type":"string","isRequired":true,"uniqueKey":"depositInstructions.iban.oneOf.0","typeLabel":"string"},{"description":"IBAN for deposits (EUR accounts). Null for USD accounts.","example":"DE89370400440532013000","type":"null","isRequired":true,"uniqueKey":"depositInstructions.iban.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"depositInstructions.iban","typeLabel":"string | null"}},"required":["currency","bankName","bankAddress","bankAccountNumber","bankRoutingNumber","bankBeneficiaryName","bankBeneficiaryAddress","iban","bic"],"type":"object","isRequired":true,"uniqueKey":"depositInstructions","typeLabel":"object"},"destination":{"description":"The crypto destination where converted funds are sent after deposit.","properties":{"currency":{"description":"The crypto currency deposited funds are converted into.","enum":["usdc","usdt","eurc"],"example":"usdc","type":"string","isRequired":true,"uniqueKey":"destination.currency","typeLabel":"enum\u003cstring>"},"network":{"description":"The blockchain network the destination wallet is on.","enum":["arbitrum","avalanche","base","ethereum","polygon","sol","tron"],"example":"ethereum","type":"string","isRequired":true,"uniqueKey":"destination.network","typeLabel":"enum\u003cstring>"},"walletAddress":{"description":"The on-chain wallet address where converted crypto is sent.","example":"0x4838B106FCe9647Bdf1E7877BF73cE8B0BAD5f97","type":"string","isRequired":true,"uniqueKey":"destination.walletAddress","typeLabel":"string"}},"required":["currency","walletAddress","network"],"type":"object","isRequired":true,"uniqueKey":"destination","typeLabel":"object"},"id":{"description":"Unique identifier for the virtual account.","example":"virtualAccount_a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6","type":"string","isRequired":true,"uniqueKey":"id","typeLabel":"string"},"updated":{"description":"Timestamp when the virtual account was last updated (ISO 8601).","example":"2025-01-15T12:00:00.000Z","type":"string","isRequired":true,"uniqueKey":"updated","typeLabel":"string"},"customer":{"description":"The customer ID who owns the virtual account.","example":"customer_b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7","type":"string","uniqueKey":"customer","typeLabel":"string"},"fee":{"description":"Fee breakdown for the virtual account, including integrator and platform fees.","properties":{"integratorFee":{"description":"Fee charged by the integrator.","properties":{"bpsRate":{"description":"Integrator fee rate in basis points (1 bps = 0.01%).","example":"100","type":"string","isRequired":true,"uniqueKey":"fee.integratorFee.bpsRate","typeLabel":"string"}},"required":["bpsRate"],"type":"object","isRequired":true,"uniqueKey":"fee.integratorFee","typeLabel":"object"},"platformFee":{"description":"Fee charged by the platform.","properties":{"bpsRate":{"description":"Platform fee rate in basis points (1 bps = 0.01%).","example":"30","type":"string","isRequired":true,"uniqueKey":"fee.platformFee.bpsRate","typeLabel":"string"}},"required":["bpsRate"],"type":"object","isRequired":true,"uniqueKey":"fee.platformFee","typeLabel":"object"},"totalBpsRate":{"description":"Total fee rate in basis points (integrator + platform). 1 bps = 0.01%.","example":"130","type":"string","isRequired":true,"uniqueKey":"fee.totalBpsRate","typeLabel":"string"}},"required":["totalBpsRate","integratorFee","platformFee"],"type":"object","uniqueKey":"fee","typeLabel":"object"}},"required":["id","active","depositInstructions","destination","created","updated"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"active":true,"created":"2025-01-15T10:30:00.000Z","depositInstructions":{"bankAccountNumber":"9876543210","bankAddress":"1801 Main St, Kansas City, MO 64108","bankBeneficiaryAddress":"123 Finance St, San Francisco, CA 94105","bankBeneficiaryName":"Bridge Financial Inc.","bankName":"Lead Bank","bankRoutingNumber":"021000089","bic":"COBADEFFXXX","currency":"usd","iban":"DE89370400440532013000"},"destination":{"currency":"usdc","network":"ethereum","walletAddress":"0x4838B106FCe9647Bdf1E7877BF73cE8B0BAD5f97"},"id":"virtualAccount_a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6","updated":"2025-01-15T12:00:00.000Z","customer":"customer_b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7","fee":{"integratorFee":{"bpsRate":"100"},"platformFee":{"bpsRate":"30"},"totalBpsRate":"130"}}}},"exampleType":"generated"}},"description":"","exampleType":"generated"},"afcc8817-086f-4c9a-a8fa-c278cc24c9f4":{"content":{"application/json":{"examples":{"Bad Request":{"title":"Bad Request","value":{"code":"address/invalid","correlationId":"28c61e885c6e5eaa78c1a2183a9b883c","detail":"Invalid request parameters","status":400}}},"schema":{"properties":{"detail":{"type":"string","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"status":{"type":"integer","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"code":{"type":"string","uniqueKey":"code","typeLabel":"string"},"correlationId":{"type":"string","uniqueKey":"correlationId","typeLabel":"string"},"errors":{"items":{"properties":{"detail":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].detail","typeLabel":"string"},"header":{"type":"string","uniqueKey":"errors.items.[INDEX].header","typeLabel":"string"},"parameter":{"type":"string","uniqueKey":"errors.items.[INDEX].parameter","typeLabel":"string"},"pointer":{"type":"string","uniqueKey":"errors.items.[INDEX].pointer","typeLabel":"string"}},"required":["detail"],"type":"object","uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"errors","typeLabel":"object[]"},"title":{"type":"string","uniqueKey":"title","typeLabel":"string"}},"required":["status","detail"],"type":"object","uniqueKey":"","typeLabel":"object"},"exampleType":"examples"}},"description":"Bad Request","exampleType":"examples"},"75f7d7af-4f75-4042-8d05-f8295b4400c7":{"content":{"application/json":{"examples":{"Not Found":{"title":"Not Found","value":{"code":"resource/not-found","correlationId":"28c61e885c6e5eaa78c1a2183a9b883c","detail":"Resource not found","status":404}}},"schema":{"properties":{"detail":{"type":"string","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"status":{"type":"integer","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"code":{"type":"string","uniqueKey":"code","typeLabel":"string"},"correlationId":{"type":"string","uniqueKey":"correlationId","typeLabel":"string"},"errors":{"items":{"properties":{"detail":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].detail","typeLabel":"string"},"header":{"type":"string","uniqueKey":"errors.items.[INDEX].header","typeLabel":"string"},"parameter":{"type":"string","uniqueKey":"errors.items.[INDEX].parameter","typeLabel":"string"},"pointer":{"type":"string","uniqueKey":"errors.items.[INDEX].pointer","typeLabel":"string"}},"required":["detail"],"type":"object","uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"errors","typeLabel":"object[]"},"title":{"type":"string","uniqueKey":"title","typeLabel":"string"}},"required":["status","detail"],"type":"object","uniqueKey":"","typeLabel":"object"},"exampleType":"examples"}},"description":"Not Found","exampleType":"examples"},"7328b9f4-d3f9-47aa-94d8-b82fa5b65731":{"content":{"application/json":{"examples":{"Validation Error":{"title":"Validation Error","value":{"code":"validation/failed","correlationId":"28c61e885c6e5eaa78c1a2183a9b883c","detail":"Validation failed","errors":[{"detail":"Invalid email format","pointer":"/email"},{"detail":"Name is required","pointer":"/name"}],"status":422}}},"schema":{"properties":{"detail":{"type":"string","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"status":{"type":"integer","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"code":{"type":"string","uniqueKey":"code","typeLabel":"string"},"correlationId":{"type":"string","uniqueKey":"correlationId","typeLabel":"string"},"errors":{"items":{"properties":{"detail":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].detail","typeLabel":"string"},"header":{"type":"string","uniqueKey":"errors.items.[INDEX].header","typeLabel":"string"},"parameter":{"type":"string","uniqueKey":"errors.items.[INDEX].parameter","typeLabel":"string"},"pointer":{"type":"string","uniqueKey":"errors.items.[INDEX].pointer","typeLabel":"string"}},"required":["detail"],"type":"object","uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"errors","typeLabel":"object[]"},"title":{"type":"string","uniqueKey":"title","typeLabel":"string"}},"required":["status","detail"],"type":"object","uniqueKey":"","typeLabel":"object"},"exampleType":"examples"}},"description":"Unprocessable Entity - Validation Error","exampleType":"examples"}},"security":{"d8f4bc21-1820-4e73-bc5e-ea3b587aeee8":{"bearer":{"bearerFormat":"JWT","scheme":"bearer","type":"http","scopes":[],"schemeName":"bearer"}}},"servers":{"b5036787-7020-43a8-8dee-cb8b0d270e6a":{"description":"Production","url":"https://api.spherepay.co"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"bearerFormat":"JWT","scheme":"bearer","type":"http","scopes":[],"schemeName":"bearer"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearer","name":"Authorization"}],"title":"bearer"}]},"originalFileLocation":"openapi/spherepay.yaml"},"subdomain":"spherepayco","siteName":"SpherePay","title":"Create a Virtual Bank Account for Fiat On-Ramp - SpherePay","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/api-reference/virtual-account/post","matchLevel":0},"es":{"href":"/es/api-reference/virtual-account/post","matchLevel":1},"pt-BR":{"href":"/pt-BR/api-reference/virtual-account/post","matchLevel":1}}},"lastModified":"2026-06-18T02:06:48.306Z","gitLastModified":"2026-06-18T02:06:27.000Z","originalFileLocation":"api-reference/virtual-account/post.mdx","locale":"en"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Create a new virtual account that converts incoming fiat deposits to crypto.\">\u003cmeta data-mint-head name=\"application-name\" content=\"SpherePay\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/spherepayco/MOEcmEf1ysLzlDTM/_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/spherepayco/MOEcmEf1ysLzlDTM/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/spherepayco/MOEcmEf1ysLzlDTM/_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/spherepayco/MOEcmEf1ysLzlDTM/_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/spherepayco/MOEcmEf1ysLzlDTM/_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/spherepayco/MOEcmEf1ysLzlDTM/_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/spherepayco/MOEcmEf1ysLzlDTM/_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/spherepayco/MOEcmEf1ysLzlDTM/_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/spherepayco/MOEcmEf1ysLzlDTM/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create a Virtual Bank Account for Fiat On-Ramp - SpherePay\">\u003cmeta data-mint-head property=\"og:description\" content=\"Create a new virtual account that converts incoming fiat deposits to crypto.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"SpherePay\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.spherepay.co/api-reference/virtual-account/post\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://spherepayco.mintlify.app/_mintlify/api/og/v2?division=Virtual+Accounts\u0026amp;title=Create+a+Virtual+Bank+Account+for+Fiat+On-Ramp\u0026amp;description=Create+a+new+virtual+account+that+converts+incoming+fiat+deposits+to+crypto.\u0026amp;theme=b4fcde6ac9937acf506a9b2d\u0026amp;signature=8f7beab0395bb65ef26fd7f2127f2f6de462b290e5f90322ec3210a911eed201\">\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 a Virtual Bank Account for Fiat On-Ramp - SpherePay\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Create a new virtual account that converts incoming fiat deposits to crypto.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://spherepayco.mintlify.app/_mintlify/api/og/v2?division=Virtual+Accounts\u0026amp;title=Create+a+Virtual+Bank+Account+for+Fiat+On-Ramp\u0026amp;description=Create+a+new+virtual+account+that+converts+incoming+fiat+deposits+to+crypto.\u0026amp;theme=b4fcde6ac9937acf506a9b2d\u0026amp;signature=8f7beab0395bb65ef26fd7f2127f2f6de462b290e5f90322ec3210a911eed201\">\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/spherepayco/MOEcmEf1ysLzlDTM/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"SpherePay\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#2563EB\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.spherepay.co/api-reference/virtual-account/post\">\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-account/post.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.spherepay.co/api-reference/virtual-account/post\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"es\" href=\"https://docs.spherepay.co/es/api-reference/virtual-account/post\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"pt-BR\" href=\"https://docs.spherepay.co/pt-BR/api-reference/virtual-account/post\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.spherepay.co/api-reference/virtual-account/post\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.spherepay.co/#organization\",\"name\":\"SpherePay\",\"url\":\"https://docs.spherepay.co\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/spherepayco/uywNRH6jm1-R-nPL/logo/sphere-light.svg?fit=max\u0026auto=format\u0026n=uywNRH6jm1-R-nPL\u0026q=85\u0026s=783c82452519d50b023b9866c8a1ba48\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.spherepay.co#website\",\"name\":\"SpherePay\",\"url\":\"https://docs.spherepay.co\",\"publisher\":{\"@id\":\"https://docs.spherepay.co/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.spherepay.co/api-reference/virtual-account/post#webpage\",\"url\":\"https://docs.spherepay.co/api-reference/virtual-account/post\",\"name\":\"Create a Virtual Bank Account for Fiat On-Ramp\",\"description\":\"Create a new virtual account that converts incoming fiat deposits to crypto.\",\"dateModified\":\"2026-06-18T02:06:27.000Z\",\"isPartOf\":{\"@id\":\"https://docs.spherepay.co#website\"},\"breadcrumb\":{\"@id\":\"https://docs.spherepay.co/api-reference/virtual-account/post#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.spherepay.co/api-reference/virtual-account/post#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Money movement\",\"item\":\"https://docs.spherepay.co/api-reference/transfer/post\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create a Virtual Bank Account for Fiat On-Ramp\",\"item\":\"https://docs.spherepay.co/api-reference/virtual-account/post\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.spherepay.co/api-reference/virtual-account/post#apireference\",\"headline\":\"Create a Virtual Bank Account for Fiat On-Ramp\",\"name\":\"Create a Virtual Bank Account for Fiat On-Ramp\",\"description\":\"Create a new virtual account that converts incoming fiat deposits to crypto.\",\"url\":\"https://docs.spherepay.co/api-reference/virtual-account/post\",\"mainEntityOfPage\":{\"@id\":\"https://docs.spherepay.co/api-reference/virtual-account/post#webpage\"},\"dateModified\":\"2026-06-18T02:06:27.000Z\",\"publisher\":{\"@id\":\"https://docs.spherepay.co/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.spherepay.co#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"SpherePay\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"SpherePay","nav":{"global":null,"languages":[{"language":"en","default":true,"tabs":[{"tab":"Get Started","pages":[{"title":"Get Started","href":"/introduction"}]},{"tab":"Concepts","pages":[{"title":"Concepts","href":"/concepts/overview"}]},{"tab":"Guides","pages":[{"title":"Guides","href":"/implementation-guides/overview"}]},{"tab":"Solutions","pages":[{"title":"Solutions","href":"/solutions/overview"}]},{"tab":"API Reference","groups":[{"group":"Onboarding","pages":[{"group":"Customers","icon":"user","pages":[{"title":"Create an Individual or Business Customer","sidebarTitle":"Create Customer","openapi":"openapi/spherepay.yaml POST /v2/customer","href":"/api-reference/customer/post"},{"title":"List Customers with Filters and Pagination","sidebarTitle":"List Customers","openapi":"openapi/spherepay.yaml GET /v2/customer","href":"/api-reference/customer/get"},{"title":"Retrieve a Customer with Verification Status","sidebarTitle":"Get Customer","openapi":"openapi/spherepay.yaml GET /v2/customer/{id}","href":"/api-reference/customer/get-id"},{"title":"Update Customer Address, Phone, or Email","sidebarTitle":"Update Customer","openapi":"openapi/spherepay.yaml PATCH /v2/customer/{id}","href":"/api-reference/customer/patch-id"}]},{"group":"Onboarding Links","icon":"link","pages":[{"title":"Create Customer via Link","sidebarTitle":"Create Customer via Link","openapi":"openapi/spherepay.yaml POST /v2/customer/kyc-link","href":"/api-reference/customer/kyc-link"},{"title":"Regenerate a Customer's KYC Link","sidebarTitle":"Regenerate KYC Link","openapi":"openapi/spherepay.yaml POST /v2/customer/{id}/kyc-link","href":"/api-reference/customer/kyc"}]},{"group":"Documents \u0026 Verification","icon":"file-check","pages":[{"title":"Upload KYC and KYB Identity Documents","sidebarTitle":"Upload Document","openapi":"openapi/spherepay.yaml POST /v2/document","href":"/api-reference/document/post"},{"title":"Generate a Customer Face Verification Link","sidebarTitle":"Face Verification Link","openapi":"openapi/spherepay.yaml POST /v2/customer/{id}/face-verification-link","href":"/api-reference/enhanced-due-diligence/face-verification-link"},{"title":"Generate a UBO Face Verification Link for KYB","sidebarTitle":"UBO Face Verification Link","openapi":"openapi/spherepay.yaml POST /v2/business-representative/{id}/face-verification-link","href":"/api-reference/enhanced-due-diligence/ubo-face-verification-link"},{"title":"Send an OTP Code for Customer Verification","sidebarTitle":"Send Verification Code","openapi":"openapi/spherepay.yaml POST /v2/customer/{id}/otp-send","href":"/api-reference/enhanced-due-diligence/send-verification-code"},{"title":"Verify a Customer OTP Code for Email or Phone","sidebarTitle":"Verify OTP Code","openapi":"openapi/spherepay.yaml POST /v2/customer/{id}/otp-verify","href":"/api-reference/enhanced-due-diligence/verify-verification-code"},{"title":"Record Customer Terms of Service Acceptance","sidebarTitle":"Accept Terms of Service","openapi":"openapi/spherepay.yaml POST /v2/customer/{id}/tos-link","href":"/api-reference/enhanced-due-diligence/tos"}]},{"group":"Business Representatives","icon":"users","pages":[{"title":"Register a Business UBO for KYB Verification","sidebarTitle":"Register Representative","openapi":"openapi/spherepay.yaml POST /v2/business-representative","href":"/api-reference/business-representative/post"},{"title":"List All Business Representatives and UBOs","sidebarTitle":"List Representatives","openapi":"openapi/spherepay.yaml GET /v2/business-representative","href":"/api-reference/business-representative/get"},{"title":"Retrieve a Business Representative by ID","sidebarTitle":"Get Representative","openapi":"openapi/spherepay.yaml GET /v2/business-representative/{id}","href":"/api-reference/business-representative/get-id"},{"title":"Update a Business Representative Before KYB","sidebarTitle":"Update Representative","openapi":"openapi/spherepay.yaml PATCH /v2/business-representative/{id}","href":"/api-reference/business-representative/patch-id"},{"title":"Remove a Business Representative or UBO","sidebarTitle":"Delete Representative","openapi":"openapi/spherepay.yaml DELETE /v2/business-representative/{id}","href":"/api-reference/business-representative/delete-id"}]}]},{"group":"Accounts","pages":[{"group":"Bank Accounts","icon":"landmark","pages":[{"title":"Register a Customer Bank Account for Transfers","sidebarTitle":"Register Bank Account","openapi":"openapi/spherepay.yaml POST /v2/bank-account","href":"/api-reference/bank-account/post"},{"title":"List All Registered Customer Bank Accounts","sidebarTitle":"List Bank Accounts","openapi":"openapi/spherepay.yaml GET /v2/bank-account","href":"/api-reference/bank-account/get"},{"title":"Retrieve a Bank Account by ID","sidebarTitle":"Get Bank Account","openapi":"openapi/spherepay.yaml GET /v2/bank-account/{id}","href":"/api-reference/bank-account/get-id"},{"title":"Update Bank Account Payment Rail Settings","sidebarTitle":"Update Bank Account","openapi":"openapi/spherepay.yaml PATCH /v2/bank-account/{id}","href":"/api-reference/bank-account/patch-id"},{"title":"Delete a Registered Customer Bank Account","sidebarTitle":"Delete Bank Account","openapi":"openapi/spherepay.yaml DELETE /v2/bank-account/{id}","href":"/api-reference/bank-account/delete-id"}]},{"group":"Wallets","icon":"wallet","pages":[{"title":"Register a Customer Crypto Wallet for Transfers","sidebarTitle":"Register Wallet","openapi":"openapi/spherepay.yaml POST /v2/wallet","href":"/api-reference/wallet/post"},{"title":"List All Registered Customer Crypto Wallets","sidebarTitle":"List Wallets","openapi":"openapi/spherepay.yaml GET /v2/wallet","href":"/api-reference/wallet/get"},{"title":"Retrieve a Customer Crypto Wallet by ID","sidebarTitle":"Get Wallet","openapi":"openapi/spherepay.yaml GET /v2/wallet/{id}","href":"/api-reference/wallet/get-id"},{"title":"Remove a Registered Customer Crypto Wallet","sidebarTitle":"Delete Wallet","openapi":"openapi/spherepay.yaml DELETE /v2/wallet/{id}","href":"/api-reference/wallet/delete-id"}]}]},{"group":"Money movement","pages":[{"group":"Transfers","icon":"arrow-right-left","pages":[{"title":"Create an On-Ramp or Off-Ramp Transfer","sidebarTitle":"Create Transfer","openapi":"openapi/spherepay.yaml POST /v2/transfer","href":"/api-reference/transfer/post"},{"title":"List On-Ramp and Off-Ramp Transfers","sidebarTitle":"List Transfers","openapi":"openapi/spherepay.yaml GET /v2/transfer","href":"/api-reference/transfer/get"},{"title":"Retrieve a Transfer with Deposit Instructions","sidebarTitle":"Get Transfer","openapi":"openapi/spherepay.yaml GET /v2/transfer/{id}","href":"/api-reference/transfer/get-id"},{"title":"Cancel an Unfunded Pending Transfer","sidebarTitle":"Cancel Transfer","openapi":"openapi/spherepay.yaml DELETE /v2/transfer/{id}","href":"/api-reference/transfer/delete-id"}]},{"group":"Quotes","icon":"calculator","pages":[{"title":"Create a Rate-Locked Quote","sidebarTitle":"Create Quote","openapi":"openapi/spherepay.yaml POST /v2/quote","href":"/api-reference/quote/post"},{"title":"List All Rate-Locked Quotes for Your Account","sidebarTitle":"List Quotes","openapi":"openapi/spherepay.yaml GET /v2/quote","href":"/api-reference/quote/get"},{"title":"Retrieve a Quote by ID","sidebarTitle":"Get Quote","openapi":"openapi/spherepay.yaml GET /v2/quote/{id}","href":"/api-reference/quote/get-id"},{"title":"Update Quote Status","sidebarTitle":"Update Quote","openapi":"openapi/spherepay.yaml PUT /v2/quote/{id}","description":"Mark an active quote as used or expired. Only active quotes can be updated.","href":"/api-reference/quote/put-id"}]},{"group":"Virtual Accounts","icon":"credit-card","pages":[{"title":"Create a Virtual Bank Account for Fiat On-Ramp","sidebarTitle":"Create Virtual Account","openapi":"openapi/spherepay.yaml POST /v2/virtual-account","href":"/api-reference/virtual-account/post"},{"title":"List All Onramper Virtual Bank Accounts","sidebarTitle":"List Virtual Accounts","openapi":"openapi/spherepay.yaml GET /v2/virtual-account","description":"List all active virtual accounts for the authenticated application.","href":"/api-reference/virtual-account/get"},{"title":"Retrieve an Onramper Account by ID","sidebarTitle":"Get Virtual Account","openapi":"openapi/spherepay.yaml GET /v2/virtual-account/{virtualAccountId}","href":"/api-reference/virtual-account/get-id"},{"title":"Update an Onramper Account Destination Wallet","sidebarTitle":"Update Virtual Account","openapi":"openapi/spherepay.yaml PATCH /v2/virtual-account/{virtualAccountId}","href":"/api-reference/virtual-account/patch"},{"title":"List Transfers for an Onramper Account","sidebarTitle":"List Account Transfers","openapi":"openapi/spherepay.yaml GET /v2/virtual-account/{virtualAccountId}/transfer","href":"/api-reference/virtual-account/list-transfers"},{"title":"Deactivate an Onramper Virtual Bank Account","sidebarTitle":"Deactivate Account","openapi":"openapi/spherepay.yaml PATCH /v2/virtual-account/{virtualAccountId}/deactivate","href":"/api-reference/virtual-account/deactivate"},{"title":"Reactivate a Deactivated Onramper Account","sidebarTitle":"Reactivate Account","openapi":"openapi/spherepay.yaml PATCH /v2/virtual-account/{virtualAccountId}/reactivate","href":"/api-reference/virtual-account/reactivate"}]},{"group":"Offloader Wallets","icon":"arrow-up-from-line","pages":[{"title":"Create an Offloader Wallet for Crypto Payouts","sidebarTitle":"Create Offloader Wallet","openapi":"openapi/spherepay.yaml POST /v2/offloader-wallet","href":"/api-reference/offloader-wallet/post"},{"title":"List All Offloader Wallets for Your Account","sidebarTitle":"List Offloader Wallets","openapi":"openapi/spherepay.yaml GET /v2/offloader-wallet","href":"/api-reference/offloader-wallet/get"},{"title":"Retrieve an Offloader Wallet by ID","sidebarTitle":"Get Offloader Wallet","openapi":"openapi/spherepay.yaml GET /v2/offloader-wallet/{id}","href":"/api-reference/offloader-wallet/get-id"},{"title":"Update an Offloader Wallet Bank Destination","sidebarTitle":"Update Offloader Wallet","openapi":"openapi/spherepay.yaml PATCH /v2/offloader-wallet/{id}","href":"/api-reference/offloader-wallet/patch-id"}]}]},{"group":"Webhooks","pages":[{"group":"Webhook Endpoints","icon":"plug","pages":[{"title":"Register a Webhook Endpoint for Event Delivery","sidebarTitle":"Create Webhook Endpoint","openapi":"openapi/spherepay.yaml POST /v2/webhook-endpoints","href":"/api-reference/webhook-endpoints/post"},{"title":"List All Registered Webhook Endpoints","sidebarTitle":"List Webhook Endpoints","openapi":"openapi/spherepay.yaml GET /v2/webhook-endpoints","href":"/api-reference/webhook-endpoints/get"},{"title":"Retrieve a Webhook Endpoint by ID","sidebarTitle":"Get Webhook Endpoint","openapi":"openapi/spherepay.yaml GET /v2/webhook-endpoints/{id}","href":"/api-reference/webhook-endpoints/get-id"},{"title":"Delete a Webhook Endpoint","sidebarTitle":"Delete Webhook Endpoint","openapi":"openapi/spherepay.yaml DELETE /v2/webhook-endpoints/{id}","href":"/api-reference/webhook-endpoints/delete-id"}]},{"group":"Events","icon":"bell","pages":[{"title":"List Events and Their Delivery Status","sidebarTitle":"List Events","openapi":"openapi/spherepay.yaml GET /v2/events","href":"/api-reference/events/get"},{"title":"Retrieve an Event with Full Delivery History","sidebarTitle":"Get Event","openapi":"openapi/spherepay.yaml GET /v2/events/{id}","href":"/api-reference/events/get-id"},{"title":"Replay a Failed Event Delivery","sidebarTitle":"Replay Delivery","openapi":"openapi/spherepay.yaml POST /v2/events/replay/{eventDeliveryId}","href":"/api-reference/events/replay"}]}]}]},{"tab":"Releases","pages":[{"title":"Releases","href":"/changelog"}]},{"tab":"FAQ","href":"https://spherepay-knowledge-base.help.usepylon.com/"}]},{"language":"es","pages":[{"title":"es","href":"/es/api-reference/virtual-account/post"}]},{"language":"pt-BR","pages":[{"title":"pt-BR","href":"/pt-BR/api-reference/virtual-account/post"}]}]},"basePath":"","title":"Create a Virtual Bank Account for Fiat On-Ramp - SpherePay","buildId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","deploymentId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CS552b7R.js","utils-DDTCYAF2.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-De8ttokP.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DrwRDvAh.js","snippetPresets-DtAN0nWx.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-D5rWArI6.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-O2i12wsz.js","shallow-DV8xABTt.js","getApiPlaygroundDisplay-DBZ0B5Jx.js","CodeSnippet-BVi0tPUX.js","CodeSnippets-CqASbIwY.js","Page-m07pfKpT.js","getPastedJson-DG9vsMS8.js","icon-CXzRSCr8.js","MethodPill-BdKVtEuX.js","DuplicateIcon-CZlmBrJI.js","createIcon-biFEUKPL.js","DynamicMarkdown-B54_zNBF.js","SectionHeading-DwwHK3Pt.js","axios-vUo_bRtp.js","Markdown-DfhCTwyA.js","clsx-xpJZXxdP.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-BTZUMDnx.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-DqdKa2R4.js"]}