{
"success": false,
"error": {
"code": "PLAN_UPGRADE_REQUIRED",
"message": "This product is not included in the Découverte plan. Upgrade to a paid plan (Starter, Business or Premium) to use \"gift_cards\".",
"details": {
"plan": "decouverte",
"product": "gift_cards"
}
}
}
{
"success": false,
"error": {
"code": "ACCOUNT_SUSPENDED_NEGATIVE_BALANCE",
"message": "Your account is suspended because one of your ops balances is negative. Top up the negative balance to restore access. Read-only requests (GET) remain available.",
"details": {
"negative_balance_since": "2026-10-15T08:00:00+00:00"
}
}
}
{
"success": false,
"error": {
"code": "VALIDATION_ERROR",
"message": "The customer must have an approved KYC and an approved proof of address to open a virtual account.",
"details": {
"kyc_status": "approved",
"poa_status": "pending"
}
}
}
Virtual Accounts
Create a Virtual Account
Opens a virtual bank account in the name of one of your customers, in EUR, USD, BRL or MXN.
Every deposit received on the account is converted to USDC, the KemyCard fee is taken, and the net amount
is sent to the destination you choose: a USDC wallet on Solana of the same customer, or an external
USDC address on Solana.
Requirements
A paid plan (Starter, Business or Premium). On Découverte, the request returns 402 PLAN_UPGRADE_REQUIRED.
Individual customers only. The customer must be active, with an approved KYC (kyc_statusapproved)
and an approved proof of address (poa_statusapproved).
One open account per customer and per currency. An account that is failed or closed does not count.
destination.typewallet: the wallet_code of a USDC wallet on Solana (POST /wallets with
blockchainsolana) that belongs to the same customer.
destination.typeexternal_address: a valid Solana address. Only USDC on Solana is sent to it.
Creation fee
The creation fee of your plan (Starter 10,Business7.50, Premium $5) is debited from your others ops
balance when you send the request. It is refunded to the same balance if the account is refused (failed),
or if you close it before its bank details have been issued.
Opening is asynchronous
The account is returned with the status processing. Follow its status with the webhooks or with
GET /virtual-accounts/{code}:
Status
Meaning
processing
The request is being processed
awaiting_tos
Your customer must accept the terms of our banking partner. Send them to tos_url (also sent in the virtual_account.tos_required webhook). They must accept the terms themselves
awaiting_provider
The account is being reviewed and opened by our banking partner
active
The account is open: deposit_instructions holds the bank details to share with the payer (virtual_account.activated webhook)
failed
The account was refused. failure_reason explains why, and the creation fee is refunded (virtual_account.failed webhook)
closed
The account was closed and no longer accepts deposits (virtual_account.closed webhook)
If you send tos_redirect_url, your customer is sent back to this page after accepting the terms. This is only a
browser redirect, not a confirmation: wait for the virtual_account.activated webhook (or the status active)
before showing the bank details. tos_redirect_url is set at creation and cannot be changed afterwards.
{
"success": false,
"error": {
"code": "PLAN_UPGRADE_REQUIRED",
"message": "This product is not included in the Découverte plan. Upgrade to a paid plan (Starter, Business or Premium) to use \"gift_cards\".",
"details": {
"plan": "decouverte",
"product": "gift_cards"
}
}
}
{
"success": false,
"error": {
"code": "ACCOUNT_SUSPENDED_NEGATIVE_BALANCE",
"message": "Your account is suspended because one of your ops balances is negative. Top up the negative balance to restore access. Read-only requests (GET) remain available.",
"details": {
"negative_balance_since": "2026-10-15T08:00:00+00:00"
}
}
}
{
"success": false,
"error": {
"code": "VALIDATION_ERROR",
"message": "The customer must have an approved KYC and an approved proof of address to open a virtual account.",
"details": {
"kyc_status": "approved",
"poa_status": "pending"
}
}
}
Authorizations
Authorization
string
header
required
API key (sk_test_... or sk_live_...)
Body
application/json
customer_code
string<uuid>
required
Code of the customer who owns the account
currency
enum<string>
required
Available options:
EUR,
USD,
BRL,
MXN
Example:
"EUR"
destination
object
required
Where the net amount of each deposit is sent, always in USDC on Solana. Two options:
wallet: a KemyCard wallet of the customer, identified by its wallet_code. No on-chain transfer: the
net amount is credited to the balance of this wallet, as for a wallet deposit. You withdraw it with
POST /wallets/{code}/withdrawals.
external_address: an address outside KemyCard (for example your own custody wallet). The net amount
is sent on-chain to this address.
Show child attributes
tos_redirect_url
string<uri>
Optional. An https page of your application (500 characters max.) where your customer is sent
back after accepting the terms of our banking partner. It is added to tos_url as redirect_uri.
Only a browser redirect: the acceptance is confirmed by the virtual_account.activated webhook.
It cannot be changed after the account is created.
Maximum string length: 500
Example:
"https://app.example.com/accounts/terms-accepted"
Response
Virtual account requested. The opening continues asynchronously.
success
boolean
Example:
true
data
object
Show child attributes
meta
object
Show child attributes
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"KemyCard API","colors":{"primary":"#6366F1","light":"#818CF8","dark":"#4F46E5"},"logo":{"light":"https://s3.eu-west-1.wasabisys.com/kemycard/image/favicon-kemycard-dark.jpg","dark":"https://s3.eu-west-1.wasabisys.com/kemycard/image/favicon-kemycard-dark.jpg"},"favicon":"https://s3.eu-west-1.wasabisys.com/kemycard/image/favicon-kemycard-dark.jpg","api":{"playground":{"display":"interactive","proxy":false}},"navbar":{"links":[{"href":"mailto:hi@kemycard.com","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://kemycard.com/en/api"}},"footer":{"socials":{"x":"https://x.com/kemycard","linkedin":"https://linkedin.com/company/kemycard","github":"https://github.com/kemycard"}},"contextual":{"options":["copy","view","chatgpt","claude","cursor"],"display":"header"},"styling":{"latex":true},"navigation":{"global":{"anchors":[{"anchor":"API Reference","icon":"square-terminal","href":"/api-reference/overview"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"kemitegroupltd","hasAudioNarration":false,"actualSubdomain":"kemitegroupltd","customDomains":["docs.kemycard.com"],"gitSource":{"type":"github","owner":"kemite-group-llc","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6b0197961c93281422a08a35","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"API Reference","count":63},{"language":"default","tag":"Guides","count":16},{"language":"default","tag":"Wallets","count":12},{"language":"default","tag":"Integration Guides","count":11},{"language":"default","tag":"Cards","count":10},{"language":"default","tag":"Payouts","count":9},{"language":"default","tag":"Webhooks","count":8},{"language":"default","tag":"FAQ","count":7},{"language":"default","tag":"Frequently asked questions","count":7},{"language":"default","tag":"Customers","count":6}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"api-reference/virtual-accounts/create","slug":"/api-reference/virtual-accounts/create","pageMetadata":{"title":"Create a Virtual Account","openapi":"POST /virtual-accounts","description":"Opens a virtual bank account in the name of one of your customers, in `EUR`, `USD`, `BRL` or `MXN`.\nEvery deposit received on the account is converted to USDC, the KemyCard fee is taken, and the net amount\nis sent to the destination you choose: a USDC wallet on Solana of the same customer, or an external\nUSDC address on Solana.\n\n**Requirements**\n\n- A paid plan (Starter, Business or Premium). On Découverte, the request returns `402 PLAN_UPGRADE_REQUIRED`.\n- Individual customers only. The customer must be `active`, with an **approved KYC** (`kyc_status` `approved`)\n and an **approved proof of address** (`poa_status` `approved`).\n- One open account per customer and per currency. An account that is `failed` or `closed` does not count.\n- `destination.type` `wallet`: the `wallet_code` of a **USDC wallet on Solana** (`POST /wallets` with\n `blockchain` `solana`) that belongs to the same customer.\n- `destination.type` `external_address`: a valid **Solana** address. Only USDC on Solana is sent to it.\n\n**Creation fee**\n\nThe creation fee of your plan (Starter $10, Business $7.50, Premium $5) is debited from your `others` ops\nbalance when you send the request. It is refunded to the same balance if the account is refused (`failed`),\nor if you close it before its bank details have been issued.\n\n**Opening is asynchronous**\n\nThe account is returned with the status `processing`. Follow its status with the webhooks or with\n`GET /virtual-accounts/{code}`:\n\n| Status | Meaning |\n|--------|---------|\n| `processing` | The request is being processed |\n| `awaiting_tos` | Your customer must accept the terms of our banking partner. Send them to `tos_url` (also sent in the `virtual_account.tos_required` webhook). They must accept the terms themselves |\n| `awaiting_provider` | The account is being reviewed and opened by our banking partner |\n| `active` | The account is open: `deposit_instructions` holds the bank details to share with the payer (`virtual_account.activated` webhook) |\n| `failed` | The account was refused. `failure_reason` explains why, and the creation fee is refunded (`virtual_account.failed` webhook) |\n| `closed` | The account was closed and no longer accepts deposits (`virtual_account.closed` webhook) |\n\nIf you send `tos_redirect_url`, your customer is sent back to this page after accepting the terms. This is only a\nbrowser redirect, not a confirmation: wait for the `virtual_account.activated` webhook (or the status `active`)\nbefore showing the bank details. `tos_redirect_url` is set at creation and cannot be changed afterwards.\n","href":"/api-reference/virtual-accounts/create"},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n annotation: \"annotation\",\n code: \"code\",\n li: \"li\",\n math: \"math\",\n mi: \"mi\",\n mn: \"mn\",\n mo: \"mo\",\n mrow: \"mrow\",\n p: \"p\",\n semantics: \"semantics\",\n span: \"span\",\n strong: \"strong\",\n table: \"table\",\n tbody: \"tbody\",\n td: \"td\",\n th: \"th\",\n thead: \"thead\",\n tr: \"tr\",\n ul: \"ul\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsxs(_components.p, {\n children: [\"Opens a virtual bank account in the name of one of your customers, in \", _jsx(_components.code, {\n children: \"EUR\"\n }), \", \", _jsx(_components.code, {\n children: \"USD\"\n }), \", \", _jsx(_components.code, {\n children: \"BRL\"\n }), \" or \", _jsx(_components.code, {\n children: \"MXN\"\n }), \".\\nEvery deposit received on the account is converted to USDC, the KemyCard fee is taken, and the net amount\\nis sent to the destination you choose: a USDC wallet on Solana of the same customer, or an external\\nUSDC address on Solana.\"]\n }), \"\\n\", _jsx(_components.p, {\n children: _jsx(_components.strong, {\n children: \"Requirements\"\n })\n }), \"\\n\", _jsxs(_components.ul, {\n children: [\"\\n\", _jsxs(_components.li, {\n children: [\"A paid plan (Starter, Business or Premium). On Découverte, the request returns \", _jsx(_components.code, {\n children: \"402 PLAN_UPGRADE_REQUIRED\"\n }), \".\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [\"Individual customers only. The customer must be \", _jsx(_components.code, {\n children: \"active\"\n }), \", with an \", _jsx(_components.strong, {\n children: \"approved KYC\"\n }), \" (\", _jsx(_components.code, {\n children: \"kyc_status\"\n }), \" \", _jsx(_components.code, {\n children: \"approved\"\n }), \")\\nand an \", _jsx(_components.strong, {\n children: \"approved proof of address\"\n }), \" (\", _jsx(_components.code, {\n children: \"poa_status\"\n }), \" \", _jsx(_components.code, {\n children: \"approved\"\n }), \").\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [\"One open account per customer and per currency. An account that is \", _jsx(_components.code, {\n children: \"failed\"\n }), \" or \", _jsx(_components.code, {\n children: \"closed\"\n }), \" does not count.\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"destination.type\"\n }), \" \", _jsx(_components.code, {\n children: \"wallet\"\n }), \": the \", _jsx(_components.code, {\n children: \"wallet_code\"\n }), \" of a \", _jsx(_components.strong, {\n children: \"USDC wallet on Solana\"\n }), \" (\", _jsx(_components.code, {\n children: \"POST /wallets\"\n }), \" with\\n\", _jsx(_components.code, {\n children: \"blockchain\"\n }), \" \", _jsx(_components.code, {\n children: \"solana\"\n }), \") that belongs to the same customer.\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"destination.type\"\n }), \" \", _jsx(_components.code, {\n children: \"external_address\"\n }), \": a valid \", _jsx(_components.strong, {\n children: \"Solana\"\n }), \" address. Only USDC on Solana is sent to it.\"]\n }), \"\\n\"]\n }), \"\\n\", _jsx(_components.p, {\n children: _jsx(_components.strong, {\n children: \"Creation fee\"\n })\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"The creation fee of your plan (Starter \", _jsxs(_components.span, {\n className: \"katex\",\n children: [_jsx(_components.span, {\n className: \"katex-mathml\",\n children: _jsx(_components.math, {\n xmlns: \"http://www.w3.org/1998/Math/MathML\",\n children: _jsxs(_components.semantics, {\n children: [_jsxs(_components.mrow, {\n children: [_jsx(_components.mn, {\n children: \"10\"\n }), _jsx(_components.mo, {\n separator: \"true\",\n children: \",\"\n }), _jsx(_components.mi, {\n children: \"B\"\n }), _jsx(_components.mi, {\n children: \"u\"\n }), _jsx(_components.mi, {\n children: \"s\"\n }), _jsx(_components.mi, {\n children: \"i\"\n }), _jsx(_components.mi, {\n children: \"n\"\n }), _jsx(_components.mi, {\n children: \"e\"\n }), _jsx(_components.mi, {\n children: \"s\"\n }), _jsx(_components.mi, {\n children: \"s\"\n })]\n }), _jsx(_components.annotation, {\n encoding: \"application/x-tex\",\n children: \"10, Business \"\n })]\n })\n })\n }), _jsx(_components.span, {\n className: \"katex-html\",\n \"aria-hidden\": \"true\",\n children: _jsxs(_components.span, {\n className: \"base\",\n children: [_jsx(_components.span, {\n className: \"strut\",\n style: {\n height: \"0.8778em\",\n verticalAlign: \"-0.1944em\"\n }\n }), _jsx(_components.span, {\n className: \"mord\",\n children: \"10\"\n }), _jsx(_components.span, {\n className: \"mpunct\",\n children: \",\"\n }), _jsx(_components.span, {\n className: \"mspace\",\n style: {\n marginRight: \"0.1667em\"\n }\n }), _jsx(_components.span, {\n className: \"mord mathnormal\",\n style: {\n marginRight: \"0.0502em\"\n },\n children: \"B\"\n }), _jsx(_components.span, {\n className: \"mord mathnormal\",\n children: \"u\"\n }), _jsx(_components.span, {\n className: \"mord mathnormal\",\n children: \"s\"\n }), _jsx(_components.span, {\n className: \"mord mathnormal\",\n children: \"in\"\n }), _jsx(_components.span, {\n className: \"mord mathnormal\",\n children: \"ess\"\n })]\n })\n })]\n }), \"7.50, Premium $5) is debited from your \", _jsx(_components.code, {\n children: \"others\"\n }), \" ops\\nbalance when you send the request. It is refunded to the same balance if the account is refused (\", _jsx(_components.code, {\n children: \"failed\"\n }), \"),\\nor if you close it before its bank details have been issued.\"]\n }), \"\\n\", _jsx(_components.p, {\n children: _jsx(_components.strong, {\n children: \"Opening is asynchronous\"\n })\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"The account is returned with the status \", _jsx(_components.code, {\n children: \"processing\"\n }), \". Follow its status with the webhooks or with\\n\", _jsx(_components.code, {\n children: \"GET /virtual-accounts/{code}\"\n }), \":\"]\n }), \"\\n\", _jsxs(_components.table, {\n children: [_jsx(_components.thead, {\n children: _jsxs(_components.tr, {\n children: [_jsx(_components.th, {\n children: \"Status\"\n }), _jsx(_components.th, {\n children: \"Meaning\"\n })]\n })\n }), _jsxs(_components.tbody, {\n children: [_jsxs(_components.tr, {\n children: [_jsx(_components.td, {\n children: _jsx(_components.code, {\n children: \"processing\"\n })\n }), _jsx(_components.td, {\n children: \"The request is being processed\"\n })]\n }), _jsxs(_components.tr, {\n children: [_jsx(_components.td, {\n children: _jsx(_components.code, {\n children: \"awaiting_tos\"\n })\n }), _jsxs(_components.td, {\n children: [\"Your customer must accept the terms of our banking partner. Send them to \", _jsx(_components.code, {\n children: \"tos_url\"\n }), \" (also sent in the \", _jsx(_components.code, {\n children: \"virtual_account.tos_required\"\n }), \" webhook). They must accept the terms themselves\"]\n })]\n }), _jsxs(_components.tr, {\n children: [_jsx(_components.td, {\n children: _jsx(_components.code, {\n children: \"awaiting_provider\"\n })\n }), _jsx(_components.td, {\n children: \"The account is being reviewed and opened by our banking partner\"\n })]\n }), _jsxs(_components.tr, {\n children: [_jsx(_components.td, {\n children: _jsx(_components.code, {\n children: \"active\"\n })\n }), _jsxs(_components.td, {\n children: [\"The account is open: \", _jsx(_components.code, {\n children: \"deposit_instructions\"\n }), \" holds the bank details to share with the payer (\", _jsx(_components.code, {\n children: \"virtual_account.activated\"\n }), \" webhook)\"]\n })]\n }), _jsxs(_components.tr, {\n children: [_jsx(_components.td, {\n children: _jsx(_components.code, {\n children: \"failed\"\n })\n }), _jsxs(_components.td, {\n children: [\"The account was refused. \", _jsx(_components.code, {\n children: \"failure_reason\"\n }), \" explains why, and the creation fee is refunded (\", _jsx(_components.code, {\n children: \"virtual_account.failed\"\n }), \" webhook)\"]\n })]\n }), _jsxs(_components.tr, {\n children: [_jsx(_components.td, {\n children: _jsx(_components.code, {\n children: \"closed\"\n })\n }), _jsxs(_components.td, {\n children: [\"The account was closed and no longer accepts deposits (\", _jsx(_components.code, {\n children: \"virtual_account.closed\"\n }), \" webhook)\"]\n })]\n })]\n })]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"If you send \", _jsx(_components.code, {\n children: \"tos_redirect_url\"\n }), \", your customer is sent back to this page after accepting the terms. This is only a\\nbrowser redirect, not a confirmation: wait for the \", _jsx(_components.code, {\n children: \"virtual_account.activated\"\n }), \" webhook (or the status \", _jsx(_components.code, {\n children: \"active\"\n }), \")\\nbefore showing the bank details. \", _jsx(_components.code, {\n children: \"tos_redirect_url\"\n }), \" is set at creation and cannot be changed afterwards.\"]\n })]\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}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Create a Virtual Account","openapi":"POST /virtual-accounts","description":"Opens a virtual bank account in the name of one of your customers, in `EUR`, `USD`, `BRL` or `MXN`.\nEvery deposit received on the account is converted to USDC, the KemyCard fee is taken, and the net amount\nis sent to the destination you choose: a USDC wallet on Solana of the same customer, or an external\nUSDC address on Solana.\n\n**Requirements**\n\n- A paid plan (Starter, Business or Premium). On Découverte, the request returns `402 PLAN_UPGRADE_REQUIRED`.\n- Individual customers only. The customer must be `active`, with an **approved KYC** (`kyc_status` `approved`)\n and an **approved proof of address** (`poa_status` `approved`).\n- One open account per customer and per currency. An account that is `failed` or `closed` does not count.\n- `destination.type` `wallet`: the `wallet_code` of a **USDC wallet on Solana** (`POST /wallets` with\n `blockchain` `solana`) that belongs to the same customer.\n- `destination.type` `external_address`: a valid **Solana** address. Only USDC on Solana is sent to it.\n\n**Creation fee**\n\nThe creation fee of your plan (Starter $10, Business $7.50, Premium $5) is debited from your `others` ops\nbalance when you send the request. It is refunded to the same balance if the account is refused (`failed`),\nor if you close it before its bank details have been issued.\n\n**Opening is asynchronous**\n\nThe account is returned with the status `processing`. Follow its status with the webhooks or with\n`GET /virtual-accounts/{code}`:\n\n| Status | Meaning |\n|--------|---------|\n| `processing` | The request is being processed |\n| `awaiting_tos` | Your customer must accept the terms of our banking partner. Send them to `tos_url` (also sent in the `virtual_account.tos_required` webhook). They must accept the terms themselves |\n| `awaiting_provider` | The account is being reviewed and opened by our banking partner |\n| `active` | The account is open: `deposit_instructions` holds the bank details to share with the payer (`virtual_account.activated` webhook) |\n| `failed` | The account was refused. `failure_reason` explains why, and the creation fee is refunded (`virtual_account.failed` webhook) |\n| `closed` | The account was closed and no longer accepts deposits (`virtual_account.closed` webhook) |\n\nIf you send `tos_redirect_url`, your customer is sent back to this page after accepting the terms. This is only a\nbrowser redirect, not a confirmation: wait for the `virtual_account.activated` webhook (or the status `active`)\nbefore showing the bank details. `tos_redirect_url` is set at creation and cannot be changed afterwards.\n","href":"/api-reference/virtual-accounts/create"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"createVirtualAccount","tags":["Virtual Accounts"],"summary":"Create a virtual account","description":"Opens a virtual bank account in the name of one of your customers, in `EUR`, `USD`, `BRL` or `MXN`.\nEvery deposit received on the account is converted to USDC, the KemyCard fee is taken, and the net amount\nis sent to the destination you choose: a USDC wallet on Solana of the same customer, or an external\nUSDC address on Solana.\n\n**Requirements**\n\n- A paid plan (Starter, Business or Premium). On Découverte, the request returns `402 PLAN_UPGRADE_REQUIRED`.\n- Individual customers only. The customer must be `active`, with an **approved KYC** (`kyc_status` `approved`)\n and an **approved proof of address** (`poa_status` `approved`).\n- One open account per customer and per currency. An account that is `failed` or `closed` does not count.\n- `destination.type` `wallet`: the `wallet_code` of a **USDC wallet on Solana** (`POST /wallets` with\n `blockchain` `solana`) that belongs to the same customer.\n- `destination.type` `external_address`: a valid **Solana** address. Only USDC on Solana is sent to it.\n\n**Creation fee**\n\nThe creation fee of your plan (Starter $10, Business $7.50, Premium $5) is debited from your `others` ops\nbalance when you send the request. It is refunded to the same balance if the account is refused (`failed`),\nor if you close it before its bank details have been issued.\n\n**Opening is asynchronous**\n\nThe account is returned with the status `processing`. Follow its status with the webhooks or with\n`GET /virtual-accounts/{code}`:\n\n| Status | Meaning |\n|--------|---------|\n| `processing` | The request is being processed |\n| `awaiting_tos` | Your customer must accept the terms of our banking partner. Send them to `tos_url` (also sent in the `virtual_account.tos_required` webhook). They must accept the terms themselves |\n| `awaiting_provider` | The account is being reviewed and opened by our banking partner |\n| `active` | The account is open: `deposit_instructions` holds the bank details to share with the payer (`virtual_account.activated` webhook) |\n| `failed` | The account was refused. `failure_reason` explains why, and the creation fee is refunded (`virtual_account.failed` webhook) |\n| `closed` | The account was closed and no longer accepts deposits (`virtual_account.closed` webhook) |\n\nIf you send `tos_redirect_url`, your customer is sent back to this page after accepting the terms. This is only a\nbrowser redirect, not a confirmation: wait for the `virtual_account.activated` webhook (or the status `active`)\nbefore showing the bank details. `tos_redirect_url` is set at creation and cannot be changed afterwards.\n","requestBody":"5ba24236-767d-437f-9456-219f8a5b05d3","responses":{"201":"4c6bf7a4-a537-4400-a768-21aeccad34a6","400":"0b4eeadd-860a-4e8d-bf03-96f721e640ed","402":"909d3e6a-7d6e-4375-874a-e8fdaa91b73c","403":"71fd6790-a626-4736-a4ba-391267ac0a56","404":"b27b3a8d-ab9c-4fa3-940e-e2b3f96a6c9c","422":"e71e9286-dd1a-4175-a780-2dd0a67ca904"},"method":"post","type":"path","servers":["a458413f-17bf-4ec9-a47e-26f2c9cbf135","5dec1547-1f3c-4fbd-9d8d-7d84a20109ad"],"security":["a43f8918-423f-4568-99a8-ef4ad1d497bf"],"path":"/virtual-accounts","baseUrlOptions":["https://api.kemycard.com/v1","https://api.kemycard.com/v1"],"title":"Create a virtual account","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated","disableProxy":true},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["customer_code","currency","destination"],"properties":{"customer_code":{"type":"string","format":"uuid","description":"Code of the customer who owns the account","isRequired":true,"uniqueKey":"customer_code","typeLabel":"string\u003cuuid>"},"currency":{"type":"string","enum":["EUR","USD","BRL","MXN"],"example":"EUR","isRequired":true,"uniqueKey":"currency","typeLabel":"enum\u003cstring>"},"destination":{"type":"object","required":["type"],"description":"Where the net amount of each deposit is sent, always in USDC on Solana. Two options:\n\n- `wallet`: a **KemyCard wallet** of the customer, identified by its `wallet_code`. No on-chain transfer: the\n net amount is credited to the balance of this wallet, as for a wallet deposit. You withdraw it with\n [`POST /wallets/{code}/withdrawals`](/api-reference/wallets/withdraw).\n- `external_address`: an **address outside KemyCard** (for example your own custody wallet). The net amount\n is sent on-chain to this address.\n","properties":{"type":{"type":"string","enum":["wallet","external_address"],"description":"`wallet` (KemyCard wallet of the customer) or `external_address` (Solana address outside KemyCard)","example":"wallet","isRequired":true,"uniqueKey":"destination.type","typeLabel":"enum\u003cstring>"},"wallet_code":{"type":"string","format":"uuid","description":"Required with `type` `wallet`: the `code` of a KemyCard wallet of the same customer, created with\n[`POST /wallets`](/api-reference/wallets/create) on the `solana` blockchain in USDC.\n","example":"01a11628-4600-7e59-bd4a-01604c588373","uniqueKey":"destination.wallet_code","typeLabel":"string\u003cuuid>"},"address":{"type":"string","description":"Required with `type` `external_address`: a valid Solana address outside KemyCard, able to receive USDC on\nSolana. Double-check it: funds sent on-chain cannot be recovered.\n","example":"YOUR_SOLANA_USDC_ADDRESS","uniqueKey":"destination.address","typeLabel":"string"}},"isRequired":true,"uniqueKey":"destination","typeLabel":"object"},"tos_redirect_url":{"type":"string","format":"uri","maxLength":500,"description":"Optional. An `https` page of your application (500 characters max.) where your customer is sent\nback after accepting the terms of our banking partner. It is added to `tos_url` as `redirect_uri`.\nOnly a browser redirect: the acceptance is confirmed by the `virtual_account.activated` webhook.\nIt cannot be changed after the account is created.\n","example":"https://app.example.com/accounts/terms-accepted","uniqueKey":"tos_redirect_url","typeLabel":"string\u003curi>"}},"uniqueKey":"","typeLabel":"object"},"examples":{"wallet":{"title":"wallet","summary":"Deposits sent to a USDC wallet on Solana of the customer","value":{"customer_code":"bf75d143-e2ff-4872-8c93-cc6157f834aa","currency":"EUR","destination":{"type":"wallet","wallet_code":"01a11628-4600-7e59-bd4a-01604c588373"},"tos_redirect_url":"https://app.example.com/accounts/terms-accepted"}},"external_address":{"title":"external_address","summary":"Deposits sent to an external USDC address on Solana","value":{"customer_code":"bf75d143-e2ff-4872-8c93-cc6157f834aa","currency":"USD","destination":{"type":"external_address","address":"YOUR_SOLANA_USDC_ADDRESS"}}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"4c6bf7a4-a537-4400-a768-21aeccad34a6":{"description":"Virtual account requested. The opening continues asynchronously.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true,"uniqueKey":"success","typeLabel":"boolean"},"data":{"type":"object","properties":{"code":{"type":"string","format":"uuid","description":"Virtual account code","uniqueKey":"data.code","typeLabel":"string\u003cuuid>"},"customer_code":{"type":"string","format":"uuid","uniqueKey":"data.customer_code","typeLabel":"string\u003cuuid>"},"external_reference":{"type":"string","description":"Your reference of the customer","example":"user-001","uniqueKey":"data.external_reference","typeLabel":"string"},"currency":{"type":"string","enum":["EUR","USD","BRL","MXN"],"example":"EUR","uniqueKey":"data.currency","typeLabel":"enum\u003cstring>"},"status":{"type":"string","enum":["processing","awaiting_tos","awaiting_provider","active","failed","closed"],"example":"active","uniqueKey":"data.status","typeLabel":"enum\u003cstring>"},"destination":{"type":"object","properties":{"type":{"type":"string","enum":["wallet","external_address"],"example":"wallet","uniqueKey":"data.destination.type","typeLabel":"enum\u003cstring>"},"wallet_code":{"type":"string","format":"uuid","description":"Only with `type` `wallet`","example":"01a11628-4600-7e59-bd4a-01604c588373","uniqueKey":"data.destination.wallet_code","typeLabel":"string\u003cuuid>"},"blockchain":{"type":"string","enum":["solana"],"example":"solana","uniqueKey":"data.destination.blockchain","typeLabel":"enum\u003cstring>"},"currency":{"type":"string","enum":["USDC"],"example":"USDC","uniqueKey":"data.destination.currency","typeLabel":"enum\u003cstring>"},"address":{"type":"string","description":"Address of the wallet (`wallet`) or the external address (`external_address`)","example":"CUSTOMER_DEPOSIT_ADDRESS","uniqueKey":"data.destination.address","typeLabel":"string"}},"uniqueKey":"data.destination","typeLabel":"object"},"deposit_instructions":{"oneOf":[{"type":"object","description":"Bank details to share with the payer, once they have been issued (`null` before). The fields depend on\nthe currency: `iban` and `bic` for EUR (SEPA), `bank_routing_number` and `bank_account_number` for USD\n(ACH, FedNow, wire), `br_code` for BRL (PIX), `clabe` for MXN (SPEI). Every format includes `currency`\nand `payment_rails`.\n","additionalProperties":true,"example":{"currency":"eur","payment_rails":["sepa"],"iban":"LU00TEST0000000000000000","bic":"TESTLULL","account_holder_name":"Alice Martin","bank_name":"Test Bank S.A.","bank_address":"1 Test Street, L-0000 Luxembourg"},"uniqueKey":"data.deposit_instructions.oneOf.0","typeLabel":"object"},{"type":"null","description":"Bank details to share with the payer, once they have been issued (`null` before). The fields depend on\nthe currency: `iban` and `bic` for EUR (SEPA), `bank_routing_number` and `bank_account_number` for USD\n(ACH, FedNow, wire), `br_code` for BRL (PIX), `clabe` for MXN (SPEI). Every format includes `currency`\nand `payment_rails`.\n","additionalProperties":true,"example":{"currency":"eur","payment_rails":["sepa"],"iban":"LU00TEST0000000000000000","bic":"TESTLULL","account_holder_name":"Alice Martin","bank_name":"Test Bank S.A.","bank_address":"1 Test Street, L-0000 Luxembourg"},"uniqueKey":"data.deposit_instructions.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.deposit_instructions","typeLabel":"object | null"},"tos_url":{"oneOf":[{"type":"string","description":"Only with the status `awaiting_tos`: the page where your customer accepts the terms of our banking\npartner. Your customer must accept them themselves.\n","uniqueKey":"data.tos_url.oneOf.0","typeLabel":"string"},{"type":"null","description":"Only with the status `awaiting_tos`: the page where your customer accepts the terms of our banking\npartner. Your customer must accept them themselves.\n","uniqueKey":"data.tos_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.tos_url","typeLabel":"string | null"},"creation_fee":{"type":"number","description":"Creation fee debited from your `others` ops balance","example":10,"uniqueKey":"data.creation_fee","typeLabel":"number"},"failure_reason":{"oneOf":[{"type":"string","description":"Only with the status `failed`","example":"The customer was not approved by our banking partner.","uniqueKey":"data.failure_reason.oneOf.0","typeLabel":"string"},{"type":"null","description":"Only with the status `failed`","example":"The customer was not approved by our banking partner.","uniqueKey":"data.failure_reason.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.failure_reason","typeLabel":"string | null"},"created_at":{"type":"string","format":"date-time","uniqueKey":"data.created_at","typeLabel":"string\u003cdate-time>"},"activated_at":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"data.activated_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"data.activated_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.activated_at","typeLabel":"string\u003cdate-time> | null"},"closed_at":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"data.closed_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"data.closed_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.closed_at","typeLabel":"string\u003cdate-time> | null"}},"uniqueKey":"data","typeLabel":"object"},"meta":{"type":"object","properties":{"request_id":{"type":"string","example":"a4f8e2c1b3d97056","uniqueKey":"meta.request_id","typeLabel":"string"},"mode":{"type":"string","enum":["test","live"],"example":"test","uniqueKey":"meta.mode","typeLabel":"enum\u003cstring>"},"timestamp":{"type":"string","format":"date-time","uniqueKey":"meta.timestamp","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"meta","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":true,"data":{"code":"3c90c3cc-0d44-4b50-8888-8dd25736052a","customer_code":"3c90c3cc-0d44-4b50-8888-8dd25736052a","external_reference":"user-001","currency":"EUR","status":"active","destination":{"type":"wallet","wallet_code":"01a11628-4600-7e59-bd4a-01604c588373","blockchain":"solana","currency":"USDC","address":"CUSTOMER_DEPOSIT_ADDRESS"},"deposit_instructions":{"currency":"eur","payment_rails":["sepa"],"iban":"LU00TEST0000000000000000","bic":"TESTLULL","account_holder_name":"Alice Martin","bank_name":"Test Bank S.A.","bank_address":"1 Test Street, L-0000 Luxembourg"},"tos_url":"\u003cstring>","creation_fee":10,"failure_reason":"The customer was not approved by our banking partner.","created_at":"2023-11-07T05:31:56Z","activated_at":"2023-11-07T05:31:56Z","closed_at":"2023-11-07T05:31:56Z"},"meta":{"request_id":"a4f8e2c1b3d97056","mode":"test","timestamp":"2023-11-07T05:31:56Z"}}}},"exampleType":"generated"}},"exampleType":"generated"},"0b4eeadd-860a-4e8d-bf03-96f721e640ed":{"description":"Insufficient ops balance","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false,"uniqueKey":"success","typeLabel":"boolean"},"error":{"type":"object","properties":{"code":{"type":"string","description":"Error code, for example `AUTHENTICATION_REQUIRED`, `AUTHENTICATION_FAILED`, `ACCOUNT_RESTRICTED`,\n`IP_NOT_ALLOWED`, `PLAN_UPGRADE_REQUIRED`, `PLAN_LIMIT_REACHED`, `ACCOUNT_SUSPENDED_NEGATIVE_BALANCE`,\n`INSUFFICIENT_BALANCE`, `OPERATION_FAILED`, `FORBIDDEN`, `RESOURCE_NOT_FOUND`, `VALIDATION_ERROR`,\n`COUNTRY_NOT_SUPPORTED`, `RATE_LIMIT_EXCEEDED`, `INTERNAL_ERROR`, `wrong_api_host`. See [Error Handling](/guides/error-handling).\n","example":"VALIDATION_ERROR","uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","example":"Missing required fields.","uniqueKey":"error.message","typeLabel":"string"},"details":{"oneOf":[{"type":"object","uniqueKey":"error.details.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"error.details.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.details","typeLabel":"object | null"}},"uniqueKey":"error","typeLabel":"object"},"meta":{"type":"object","properties":{"request_id":{"type":"string","example":"a4f8e2c1b3d97056","uniqueKey":"meta.request_id","typeLabel":"string"},"mode":{"type":"string","enum":["test","live"],"example":"test","uniqueKey":"meta.mode","typeLabel":"enum\u003cstring>"},"timestamp":{"type":"string","format":"date-time","uniqueKey":"meta.timestamp","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"meta","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"success":false,"error":{"code":"INSUFFICIENT_BALANCE","message":"Insufficient ops balance.","details":{"required":50,"available":10,"balance_type":"cards_mastercard"}}},"examples":{"Example":{"title":"Example","value":{"success":false,"error":{"code":"INSUFFICIENT_BALANCE","message":"Insufficient ops balance.","details":{"required":50,"available":10,"balance_type":"cards_mastercard"}}}}},"exampleType":"examples"}},"exampleType":"examples"},"909d3e6a-7d6e-4375-874a-e8fdaa91b73c":{"description":"The product is not included in your plan","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false,"uniqueKey":"success","typeLabel":"boolean"},"error":{"type":"object","properties":{"code":{"type":"string","description":"Error code, for example `AUTHENTICATION_REQUIRED`, `AUTHENTICATION_FAILED`, `ACCOUNT_RESTRICTED`,\n`IP_NOT_ALLOWED`, `PLAN_UPGRADE_REQUIRED`, `PLAN_LIMIT_REACHED`, `ACCOUNT_SUSPENDED_NEGATIVE_BALANCE`,\n`INSUFFICIENT_BALANCE`, `OPERATION_FAILED`, `FORBIDDEN`, `RESOURCE_NOT_FOUND`, `VALIDATION_ERROR`,\n`COUNTRY_NOT_SUPPORTED`, `RATE_LIMIT_EXCEEDED`, `INTERNAL_ERROR`, `wrong_api_host`. See [Error Handling](/guides/error-handling).\n","example":"VALIDATION_ERROR","uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","example":"Missing required fields.","uniqueKey":"error.message","typeLabel":"string"},"details":{"oneOf":[{"type":"object","uniqueKey":"error.details.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"error.details.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.details","typeLabel":"object | null"}},"uniqueKey":"error","typeLabel":"object"},"meta":{"type":"object","properties":{"request_id":{"type":"string","example":"a4f8e2c1b3d97056","uniqueKey":"meta.request_id","typeLabel":"string"},"mode":{"type":"string","enum":["test","live"],"example":"test","uniqueKey":"meta.mode","typeLabel":"enum\u003cstring>"},"timestamp":{"type":"string","format":"date-time","uniqueKey":"meta.timestamp","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"meta","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"success":false,"error":{"code":"PLAN_UPGRADE_REQUIRED","message":"This product is not included in the Découverte plan. Upgrade to a paid plan (Starter, Business or Premium) to use \"gift_cards\".","details":{"plan":"decouverte","product":"gift_cards"}}},"examples":{"Example":{"title":"Example","value":{"success":false,"error":{"code":"PLAN_UPGRADE_REQUIRED","message":"This product is not included in the Découverte plan. Upgrade to a paid plan (Starter, Business or Premium) to use \"gift_cards\".","details":{"plan":"decouverte","product":"gift_cards"}}}}},"exampleType":"examples"}},"exampleType":"examples"},"71fd6790-a626-4736-a4ba-391267ac0a56":{"description":"One of your ops balances is negative; every request other than `GET` is refused until it is topped up","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false,"uniqueKey":"success","typeLabel":"boolean"},"error":{"type":"object","properties":{"code":{"type":"string","description":"Error code, for example `AUTHENTICATION_REQUIRED`, `AUTHENTICATION_FAILED`, `ACCOUNT_RESTRICTED`,\n`IP_NOT_ALLOWED`, `PLAN_UPGRADE_REQUIRED`, `PLAN_LIMIT_REACHED`, `ACCOUNT_SUSPENDED_NEGATIVE_BALANCE`,\n`INSUFFICIENT_BALANCE`, `OPERATION_FAILED`, `FORBIDDEN`, `RESOURCE_NOT_FOUND`, `VALIDATION_ERROR`,\n`COUNTRY_NOT_SUPPORTED`, `RATE_LIMIT_EXCEEDED`, `INTERNAL_ERROR`, `wrong_api_host`. See [Error Handling](/guides/error-handling).\n","example":"VALIDATION_ERROR","uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","example":"Missing required fields.","uniqueKey":"error.message","typeLabel":"string"},"details":{"oneOf":[{"type":"object","uniqueKey":"error.details.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"error.details.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.details","typeLabel":"object | null"}},"uniqueKey":"error","typeLabel":"object"},"meta":{"type":"object","properties":{"request_id":{"type":"string","example":"a4f8e2c1b3d97056","uniqueKey":"meta.request_id","typeLabel":"string"},"mode":{"type":"string","enum":["test","live"],"example":"test","uniqueKey":"meta.mode","typeLabel":"enum\u003cstring>"},"timestamp":{"type":"string","format":"date-time","uniqueKey":"meta.timestamp","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"meta","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"success":false,"error":{"code":"ACCOUNT_SUSPENDED_NEGATIVE_BALANCE","message":"Your account is suspended because one of your ops balances is negative. Top up the negative balance to restore access. Read-only requests (GET) remain available.","details":{"negative_balance_since":"2026-10-15T08:00:00+00:00"}}},"examples":{"Example":{"title":"Example","value":{"success":false,"error":{"code":"ACCOUNT_SUSPENDED_NEGATIVE_BALANCE","message":"Your account is suspended because one of your ops balances is negative. Top up the negative balance to restore access. Read-only requests (GET) remain available.","details":{"negative_balance_since":"2026-10-15T08:00:00+00:00"}}}}},"exampleType":"examples"}},"exampleType":"examples"},"b27b3a8d-ab9c-4fa3-940e-e2b3f96a6c9c":{"description":"Resource not found","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false,"uniqueKey":"success","typeLabel":"boolean"},"error":{"type":"object","properties":{"code":{"type":"string","description":"Error code, for example `AUTHENTICATION_REQUIRED`, `AUTHENTICATION_FAILED`, `ACCOUNT_RESTRICTED`,\n`IP_NOT_ALLOWED`, `PLAN_UPGRADE_REQUIRED`, `PLAN_LIMIT_REACHED`, `ACCOUNT_SUSPENDED_NEGATIVE_BALANCE`,\n`INSUFFICIENT_BALANCE`, `OPERATION_FAILED`, `FORBIDDEN`, `RESOURCE_NOT_FOUND`, `VALIDATION_ERROR`,\n`COUNTRY_NOT_SUPPORTED`, `RATE_LIMIT_EXCEEDED`, `INTERNAL_ERROR`, `wrong_api_host`. See [Error Handling](/guides/error-handling).\n","example":"VALIDATION_ERROR","uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","example":"Missing required fields.","uniqueKey":"error.message","typeLabel":"string"},"details":{"oneOf":[{"type":"object","uniqueKey":"error.details.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"error.details.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.details","typeLabel":"object | null"}},"uniqueKey":"error","typeLabel":"object"},"meta":{"type":"object","properties":{"request_id":{"type":"string","example":"a4f8e2c1b3d97056","uniqueKey":"meta.request_id","typeLabel":"string"},"mode":{"type":"string","enum":["test","live"],"example":"test","uniqueKey":"meta.mode","typeLabel":"enum\u003cstring>"},"timestamp":{"type":"string","format":"date-time","uniqueKey":"meta.timestamp","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"meta","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"success":false,"error":{"code":"RESOURCE_NOT_FOUND","message":"Resource not found.","details":null}},"examples":{"Example":{"title":"Example","value":{"success":false,"error":{"code":"RESOURCE_NOT_FOUND","message":"Resource not found.","details":null}}}},"exampleType":"examples"}},"exampleType":"examples"},"e71e9286-dd1a-4175-a780-2dd0a67ca904":{"description":"Validation error: missing field, unsupported currency, customer not active, KYC or proof of address not\napproved (`details.kyc_status`, `details.poa_status`), invalid destination, invalid `tos_redirect_url`, or\nthe customer already has an open account in this currency (`details.virtual_account_code`,\n`details.status`). `COUNTRY_NOT_SUPPORTED`: the country (or US state) of residence of the customer is\nnot supported for this currency (`details.country`, `details.currency`), see\n[Supported countries](/supported-countries/virtual-accounts). No fee is charged in these cases.\n","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false,"uniqueKey":"success","typeLabel":"boolean"},"error":{"type":"object","properties":{"code":{"type":"string","description":"Error code, for example `AUTHENTICATION_REQUIRED`, `AUTHENTICATION_FAILED`, `ACCOUNT_RESTRICTED`,\n`IP_NOT_ALLOWED`, `PLAN_UPGRADE_REQUIRED`, `PLAN_LIMIT_REACHED`, `ACCOUNT_SUSPENDED_NEGATIVE_BALANCE`,\n`INSUFFICIENT_BALANCE`, `OPERATION_FAILED`, `FORBIDDEN`, `RESOURCE_NOT_FOUND`, `VALIDATION_ERROR`,\n`COUNTRY_NOT_SUPPORTED`, `RATE_LIMIT_EXCEEDED`, `INTERNAL_ERROR`, `wrong_api_host`. See [Error Handling](/guides/error-handling).\n","example":"VALIDATION_ERROR","uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","example":"Missing required fields.","uniqueKey":"error.message","typeLabel":"string"},"details":{"oneOf":[{"type":"object","uniqueKey":"error.details.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"error.details.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.details","typeLabel":"object | null"}},"uniqueKey":"error","typeLabel":"object"},"meta":{"type":"object","properties":{"request_id":{"type":"string","example":"a4f8e2c1b3d97056","uniqueKey":"meta.request_id","typeLabel":"string"},"mode":{"type":"string","enum":["test","live"],"example":"test","uniqueKey":"meta.mode","typeLabel":"enum\u003cstring>"},"timestamp":{"type":"string","format":"date-time","uniqueKey":"meta.timestamp","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"meta","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"success":false,"error":{"code":"VALIDATION_ERROR","message":"The customer must have an approved KYC and an approved proof of address to open a virtual account.","details":{"kyc_status":"approved","poa_status":"pending"}}},"examples":{"Example":{"title":"Example","value":{"success":false,"error":{"code":"VALIDATION_ERROR","message":"The customer must have an approved KYC and an approved proof of address to open a virtual account.","details":{"kyc_status":"approved","poa_status":"pending"}}}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"a43f8918-423f-4568-99a8-ef4ad1d497bf":{"BearerAuth":{"type":"http","scheme":"bearer","description":"API key (sk_test_... or sk_live_...)","scopes":[],"schemeName":"BearerAuth"}}},"servers":{"a458413f-17bf-4ec9-a47e-26f2c9cbf135":{"url":"https://api.kemycard.com/v1","description":"Development (tests internes)"},"5dec1547-1f3c-4fbd-9d8d-7d84a20109ad":{"url":"https://api.kemycard.com/v1","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"API key (sk_test_... or sk_live_...)","scopes":[],"schemeName":"BearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"API key (sk_test_... or sk_live_...)","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"BearerAuth","name":"Authorization"}],"title":"BearerAuth"}]},"originalFileLocation":"openapi.yaml"},"subdomain":"kemitegroupltd","siteName":"KemyCard API","title":"Create a Virtual Account - KemyCard API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-22T02:22:04.200Z","originalFileLocation":"api-reference/virtual-accounts/create.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Opens a virtual bank account in the name of one of your customers, in EUR, USD, BRL or MXN. Every deposit received on the account is converted to USDC, the KemyCard fee is taken, and the net amount is sent to the destination you choose: a USDC wallet on Solana of the same customer, or an external USDC address on Solana. Requirements - A paid plan (Starter, Business or Premium). On Découverte, the request returns 402 PLAN_UPGRADE_REQUIRED. - Individual customers only. The customer must be active, with an approved KYC (kyc_status approved) and an approved proof of address (poa_status approved). - One open account per customer and per currency. An account that is failed or closed does not count. - destination.type wallet: the wallet_code of a USDC wallet on Solana (POST /wallets with blockchain solana) that belongs to the same customer. - destination.type external_address: a valid Solana address. Only USDC on Solana is sent to it. Creation fee The creation fee of your plan (Starter $10, Business $7.50, Premium $5) is debited from your others ops balance when you send the request. It is refunded to the same balance if the account is refused (failed), or if you close it before its bank details have been issued. Opening is asynchronous The account is returned with the status processing. Follow its status with the webhooks or with GET /virtual-accounts/{code}: | Status | Meaning | |--------|---------| | processing | The request is being processed | | awaiting_tos | Your customer must accept the terms of our banking partner. Send them to tos_url (also sent in the virtual_account.tos_required webhook). They must accept the terms themselves | | awaiting_provider | The account is being reviewed and opened by our banking partner | | active | The account is open: deposit_instructions holds the bank details to share with the payer (virtual_account.activated webhook) | | failed | The account was refused. failure_reason explains why, and the creation fee is refunded (virtual_account.failed webhook) | | closed | The account was closed and no longer accepts deposits (virtual_account.closed webhook) | If you send tos_redirect_url, your customer is sent back to this page after accepting the terms. This is only a browser redirect, not a confirmation: wait for the virtual_account.activated webhook (or the status active) before showing the bank details. tos_redirect_url is set at creation and cannot be changed afterwards.\">\u003cmeta data-mint-head name=\"application-name\" content=\"KemyCard API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/jpeg\" sizes=\"180x180\" href=\"https://s3.eu-west-1.wasabisys.com/kemycard/image/favicon-kemycard-dark.jpg\">\u003clink data-mint-head rel=\"icon\" type=\"image/jpeg\" sizes=\"32x32\" href=\"https://s3.eu-west-1.wasabisys.com/kemycard/image/favicon-kemycard-dark.jpg\">\u003clink data-mint-head rel=\"icon\" type=\"image/jpeg\" sizes=\"16x16\" href=\"https://s3.eu-west-1.wasabisys.com/kemycard/image/favicon-kemycard-dark.jpg\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/jpeg\" href=\"https://s3.eu-west-1.wasabisys.com/kemycard/image/favicon-kemycard-dark.jpg\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create a Virtual Account - KemyCard API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Opens a virtual bank account in the name of one of your customers, in EUR, USD, BRL or MXN. Every deposit received on the account is converted to USDC, the KemyCard fee is taken, and the net amount is sent to the destination you choose: a USDC wallet on Solana of the same customer, or an external USDC address on Solana. Requirements - A paid plan (Starter, Business or Premium). On Découverte, the request returns 402 PLAN_UPGRADE_REQUIRED. - Individual customers only. The customer must be active, with an approved KYC (kyc_status approved) and an approved proof of address (poa_status approved). - One open account per customer and per currency. An account that is failed or closed does not count. - destination.type wallet: the wallet_code of a USDC wallet on Solana (POST /wallets with blockchain solana) that belongs to the same customer. - destination.type external_address: a valid Solana address. Only USDC on Solana is sent to it. Creation fee The creation fee of your plan (Starter $10, Business $7.50, Premium $5) is debited from your others ops balance when you send the request. It is refunded to the same balance if the account is refused (failed), or if you close it before its bank details have been issued. Opening is asynchronous The account is returned with the status processing. Follow its status with the webhooks or with GET /virtual-accounts/{code}: | Status | Meaning | |--------|---------| | processing | The request is being processed | | awaiting_tos | Your customer must accept the terms of our banking partner. Send them to tos_url (also sent in the virtual_account.tos_required webhook). They must accept the terms themselves | | awaiting_provider | The account is being reviewed and opened by our banking partner | | active | The account is open: deposit_instructions holds the bank details to share with the payer (virtual_account.activated webhook) | | failed | The account was refused. failure_reason explains why, and the creation fee is refunded (virtual_account.failed webhook) | | closed | The account was closed and no longer accepts deposits (virtual_account.closed webhook) | If you send tos_redirect_url, your customer is sent back to this page after accepting the terms. This is only a browser redirect, not a confirmation: wait for the virtual_account.activated webhook (or the status active) before showing the bank details. tos_redirect_url is set at creation and cannot be changed afterwards.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"KemyCard API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.kemycard.com/api-reference/virtual-accounts/create\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://kemitegroupltd.mintlify.site/_mintlify/api/og/v2?division=Virtual+Accounts\u0026amp;title=Create+a+Virtual+Account\u0026amp;description=Opens+a+virtual+bank+account+in+the+name+of+one+of+your+customers%2C+in+%60EUR%60%2C+%60USD%60%2C+%60BRL%60+or+%60MXN%60.%0AEvery+deposit+received+on+the+account+is+converted+to+USDC%2C+\u0026amp;theme=118623e1dd030dd4d19018db\u0026amp;signature=490f0c1e4373f93e6df0037f8ba41ca85ebf7862259aa7cff16b9353a6e42562\">\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 Account - KemyCard API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Opens a virtual bank account in the name of one of your customers, in EUR, USD, BRL or MXN. Every deposit received on the account is converted to USDC, the KemyCard fee is taken, and the net amount is sent to the destination you choose: a USDC wallet on Solana of the same customer, or an external USDC address on Solana. Requirements - A paid plan (Starter, Business or Premium). On Découverte, the request returns 402 PLAN_UPGRADE_REQUIRED. - Individual customers only. The customer must be active, with an approved KYC (kyc_status approved) and an approved proof of address (poa_status approved). - One open account per customer and per currency. An account that is failed or closed does not count. - destination.type wallet: the wallet_code of a USDC wallet on Solana (POST /wallets with blockchain solana) that belongs to the same customer. - destination.type external_address: a valid Solana address. Only USDC on Solana is sent to it. Creation fee The creation fee of your plan (Starter $10, Business $7.50, Premium $5) is debited from your others ops balance when you send the request. It is refunded to the same balance if the account is refused (failed), or if you close it before its bank details have been issued. Opening is asynchronous The account is returned with the status processing. Follow its status with the webhooks or with GET /virtual-accounts/{code}: | Status | Meaning | |--------|---------| | processing | The request is being processed | | awaiting_tos | Your customer must accept the terms of our banking partner. Send them to tos_url (also sent in the virtual_account.tos_required webhook). They must accept the terms themselves | | awaiting_provider | The account is being reviewed and opened by our banking partner | | active | The account is open: deposit_instructions holds the bank details to share with the payer (virtual_account.activated webhook) | | failed | The account was refused. failure_reason explains why, and the creation fee is refunded (virtual_account.failed webhook) | | closed | The account was closed and no longer accepts deposits (virtual_account.closed webhook) | If you send tos_redirect_url, your customer is sent back to this page after accepting the terms. This is only a browser redirect, not a confirmation: wait for the virtual_account.activated webhook (or the status active) before showing the bank details. tos_redirect_url is set at creation and cannot be changed afterwards.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://kemitegroupltd.mintlify.site/_mintlify/api/og/v2?division=Virtual+Accounts\u0026amp;title=Create+a+Virtual+Account\u0026amp;description=Opens+a+virtual+bank+account+in+the+name+of+one+of+your+customers%2C+in+%60EUR%60%2C+%60USD%60%2C+%60BRL%60+or+%60MXN%60.%0AEvery+deposit+received+on+the+account+is+converted+to+USDC%2C+\u0026amp;theme=118623e1dd030dd4d19018db\u0026amp;signature=490f0c1e4373f93e6df0037f8ba41ca85ebf7862259aa7cff16b9353a6e42562\">\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=\"https://mintlify.s3.us-west-1.amazonaws.com/kemitegroupltd/_generated/favicon/browserconfig.xml?v=3\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"KemyCard API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#6366F1\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.kemycard.com/api-reference/virtual-accounts/create\">\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.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.kemycard.com/#organization\",\"name\":\"KemyCard API\",\"url\":\"https://docs.kemycard.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://s3.eu-west-1.wasabisys.com/kemycard/image/favicon-kemycard-dark.jpg\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.kemycard.com#website\",\"name\":\"KemyCard API\",\"url\":\"https://docs.kemycard.com\",\"publisher\":{\"@id\":\"https://docs.kemycard.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.kemycard.com/api-reference/virtual-accounts/create#webpage\",\"url\":\"https://docs.kemycard.com/api-reference/virtual-accounts/create\",\"name\":\"Create a Virtual Account\",\"description\":\"Opens a virtual bank account in the name of one of your customers, in EUR, USD, BRL or MXN. Every deposit received on the account is converted to USDC, the KemyCard fee is taken, and the net amount is sent to the destination you choose: a USDC wallet on Solana of the same customer, or an external USDC address on Solana. Requirements - A paid plan (Starter, Business or Premium). On Découverte, the request returns 402 PLAN_UPGRADE_REQUIRED. - Individual customers only. The customer must be active, with an approved KYC (kyc_status approved) and an approved proof of address (poa_status approved). - One open account per customer and per currency. An account that is failed or closed does not count. - destination.type wallet: the wallet_code of a USDC wallet on Solana (POST /wallets with blockchain solana) that belongs to the same customer. - destination.type external_address: a valid Solana address. Only USDC on Solana is sent to it. Creation fee The creation fee of your plan (Starter $10, Business $7.50, Premium $5) is debited from your others ops balance when you send the request. It is refunded to the same balance if the account is refused (failed), or if you close it before its bank details have been issued. Opening is asynchronous The account is returned with the status processing. Follow its status with the webhooks or with GET /virtual-accounts/{code}: | Status | Meaning | |--------|---------| | processing | The request is being processed | | awaiting_tos | Your customer must accept the terms of our banking partner. Send them to tos_url (also sent in the virtual_account.tos_required webhook). They must accept the terms themselves | | awaiting_provider | The account is being reviewed and opened by our banking partner | | active | The account is open: deposit_instructions holds the bank details to share with the payer (virtual_account.activated webhook) | | failed | The account was refused. failure_reason explains why, and the creation fee is refunded (virtual_account.failed webhook) | | closed | The account was closed and no longer accepts deposits (virtual_account.closed webhook) | If you send tos_redirect_url, your customer is sent back to this page after accepting the terms. This is only a browser redirect, not a confirmation: wait for the virtual_account.activated webhook (or the status active) before showing the bank details. tos_redirect_url is set at creation and cannot be changed afterwards.\",\"dateModified\":\"2026-10-22T02:22:04.200Z\",\"isPartOf\":{\"@id\":\"https://docs.kemycard.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.kemycard.com/api-reference/virtual-accounts/create#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.kemycard.com/api-reference/virtual-accounts/create#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"KemyCard API\",\"item\":\"https://docs.kemycard.com\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create a Virtual Account\",\"item\":\"https://docs.kemycard.com/api-reference/virtual-accounts/create\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.kemycard.com/api-reference/virtual-accounts/create#apireference\",\"headline\":\"Create a Virtual Account\",\"name\":\"Create a Virtual Account\",\"description\":\"Opens a virtual bank account in the name of one of your customers, in EUR, USD, BRL or MXN. Every deposit received on the account is converted to USDC, the KemyCard fee is taken, and the net amount is sent to the destination you choose: a USDC wallet on Solana of the same customer, or an external USDC address on Solana. Requirements - A paid plan (Starter, Business or Premium). On Découverte, the request returns 402 PLAN_UPGRADE_REQUIRED. - Individual customers only. The customer must be active, with an approved KYC (kyc_status approved) and an approved proof of address (poa_status approved). - One open account per customer and per currency. An account that is failed or closed does not count. - destination.type wallet: the wallet_code of a USDC wallet on Solana (POST /wallets with blockchain solana) that belongs to the same customer. - destination.type external_address: a valid Solana address. Only USDC on Solana is sent to it. Creation fee The creation fee of your plan (Starter $10, Business $7.50, Premium $5) is debited from your others ops balance when you send the request. It is refunded to the same balance if the account is refused (failed), or if you close it before its bank details have been issued. Opening is asynchronous The account is returned with the status processing. Follow its status with the webhooks or with GET /virtual-accounts/{code}: | Status | Meaning | |--------|---------| | processing | The request is being processed | | awaiting_tos | Your customer must accept the terms of our banking partner. Send them to tos_url (also sent in the virtual_account.tos_required webhook). They must accept the terms themselves | | awaiting_provider | The account is being reviewed and opened by our banking partner | | active | The account is open: deposit_instructions holds the bank details to share with the payer (virtual_account.activated webhook) | | failed | The account was refused. failure_reason explains why, and the creation fee is refunded (virtual_account.failed webhook) | | closed | The account was closed and no longer accepts deposits (virtual_account.closed webhook) | If you send tos_redirect_url, your customer is sent back to this page after accepting the terms. This is only a browser redirect, not a confirmation: wait for the virtual_account.activated webhook (or the status active) before showing the bank details. tos_redirect_url is set at creation and cannot be changed afterwards.\",\"url\":\"https://docs.kemycard.com/api-reference/virtual-accounts/create\",\"mainEntityOfPage\":{\"@id\":\"https://docs.kemycard.com/api-reference/virtual-accounts/create#webpage\"},\"dateModified\":\"2026-10-22T02:22:04.200Z\",\"publisher\":{\"@id\":\"https://docs.kemycard.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.kemycard.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"KemyCard API\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"KemyCard API\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/virtual-accounts/create.md","siteName":"KemyCard API","nav":{"global":{"anchors":[{"anchor":"API Reference","icon":"square-terminal","href":"/api-reference/overview"}]},"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":""}]},{"tab":"API Reference","groups":[{"group":"Overview","pages":[{"title":"API Reference","href":"/api-reference/overview"}]},{"group":"Customers","pages":[{"title":"Create a Customer","openapi":"POST /customers","href":"/api-reference/customers/create"},{"title":"List Customers","openapi":"GET /customers","href":"/api-reference/customers/list"},{"title":"Get a Customer","openapi":"GET /customers/{code}","href":"/api-reference/customers/get"},{"title":"Update a Customer","openapi":"PATCH /customers/{code}","href":"/api-reference/customers/update"},{"title":"Suspend a Customer","openapi":"POST /customers/{code}/suspend","href":"/api-reference/customers/suspend"},{"title":"Activate a Customer","openapi":"POST /customers/{code}/activate","href":"/api-reference/customers/activate"}]},{"group":"Card Products","pages":[{"title":"List Card Products","openapi":"GET /cards/products","href":"/api-reference/card-products/list"},{"title":"Get a Card Product","openapi":"GET /cards/products/{code}","href":"/api-reference/card-products/get"}]},{"group":"Cards","pages":[{"title":"Create a Card","openapi":"POST /cards","href":"/api-reference/cards/create"},{"title":"List Cards","openapi":"GET /cards","href":"/api-reference/cards/list"},{"title":"Get a Card","openapi":"GET /cards/{code}","href":"/api-reference/cards/get"},{"title":"Top Up a Card","openapi":"POST /cards/{code}/topup","href":"/api-reference/cards/topup"},{"title":"Freeze a Card","openapi":"POST /cards/{code}/freeze","href":"/api-reference/cards/freeze"},{"title":"Unfreeze a Card","openapi":"POST /cards/{code}/unfreeze","href":"/api-reference/cards/unfreeze"},{"title":"Withdraw from a Card","openapi":"POST /cards/{code}/withdraw","href":"/api-reference/cards/withdraw"},{"title":"Terminate a Card","openapi":"POST /cards/{code}/terminate","href":"/api-reference/cards/terminate"},{"title":"Get Card Sensitive Data","openapi":"GET /cards/{code}/sensitive","href":"/api-reference/cards/sensitive"},{"title":"List Card Transactions","openapi":"GET /cards/{code}/transactions","href":"/api-reference/cards/transactions"}]},{"group":"KYC","pages":[{"title":"Get KYC Link","openapi":"POST /kyc/{customerCode}/link","href":"/api-reference/kyc/link"},{"title":"Get KYC Status","openapi":"GET /kyc/{customerCode}/status","href":"/api-reference/kyc/status"},{"title":"Synchronize Identity","openapi":"POST /kyc/{customerCode}/synchronize","href":"/api-reference/kyc/synchronize"}]},{"group":"POA","pages":[{"title":"Submit Proof of Address","openapi":"POST /poa/{customerCode}/document","href":"/api-reference/poa/document"},{"title":"Get POA Status","openapi":"GET /poa/{customerCode}/status","href":"/api-reference/poa/status"}]},{"group":"Wallets","pages":[{"title":"Create a Wallet","openapi":"POST /wallets","href":"/api-reference/wallets/create"},{"title":"List Wallets","openapi":"GET /wallets","href":"/api-reference/wallets/list"},{"title":"Get a Wallet","openapi":"GET /wallets/{code}","href":"/api-reference/wallets/get"},{"title":"List Deposits","openapi":"GET /wallets/deposits","href":"/api-reference/wallets/deposits"},{"title":"Get Wallet Balances","openapi":"GET /wallets/balance","href":"/api-reference/wallets/balance"},{"title":"Withdraw from a Wallet","openapi":"POST /wallets/{code}/withdrawals","href":"/api-reference/wallets/withdraw"},{"title":"List Withdrawals","openapi":"GET /wallets/withdrawals","href":"/api-reference/wallets/withdrawals"},{"title":"Get a Withdrawal","openapi":"GET /wallets/withdrawals/{code}","href":"/api-reference/wallets/withdrawal"},{"title":"Change a Destination Address","openapi":"PATCH /wallets/{code}/destination","href":"/api-reference/wallets/update-destination"},{"title":"List Forwards","openapi":"GET /wallets/forwards","href":"/api-reference/wallets/forwards"},{"title":"List the Forwards of a Wallet","openapi":"GET /wallets/{code}/forwards","href":"/api-reference/wallets/wallet-forwards"},{"title":"Get a Forward","openapi":"GET /wallets/forwards/{code}","description":null,"href":"/api-reference/wallets/forward"}]},{"group":"Virtual Accounts","pages":[{"title":"Create a Virtual Account","openapi":"POST /virtual-accounts","href":"/api-reference/virtual-accounts/create"},{"title":"List Virtual Accounts","openapi":"GET /virtual-accounts","description":"Lists the virtual accounts of your customers, most recent first.","href":"/api-reference/virtual-accounts/list"},{"title":"Get a Virtual Account","openapi":"GET /virtual-accounts/{code}","href":"/api-reference/virtual-accounts/get"},{"title":"Change the Destination","openapi":"PATCH /virtual-accounts/{code}/destination","href":"/api-reference/virtual-accounts/update-destination"},{"title":"Close a Virtual Account","openapi":"POST /virtual-accounts/{code}/close","href":"/api-reference/virtual-accounts/close"},{"title":"List Deposits","openapi":"GET /virtual-accounts/{code}/deposits","href":"/api-reference/virtual-accounts/deposits"}]},{"group":"Gift Cards","pages":[{"title":"Browse Catalog","openapi":"GET /gift-cards/catalog","href":"/api-reference/gift-cards/catalog"},{"title":"Purchase a Gift Card","openapi":"POST /gift-cards/orders","href":"/api-reference/gift-cards/purchase"}]},{"group":"Payouts","pages":[{"title":"List Payout Countries","openapi":"GET /payouts/countries","href":"/api-reference/payouts/countries"},{"title":"Create a Beneficiary","openapi":"POST /payouts/beneficiaries","href":"/api-reference/payouts/create-beneficiary"},{"title":"List Beneficiaries","openapi":"GET /payouts/beneficiaries","href":"/api-reference/payouts/list-beneficiaries"},{"title":"Get a Beneficiary","openapi":"GET /payouts/beneficiaries/{code}","href":"/api-reference/payouts/get-beneficiary"},{"title":"Delete a Beneficiary","openapi":"DELETE /payouts/beneficiaries/{code}","href":"/api-reference/payouts/delete-beneficiary"},{"title":"Create a Quote","openapi":"POST /payouts/quotes","href":"/api-reference/payouts/create-quote"},{"title":"Send a Payout","openapi":"POST /payouts","href":"/api-reference/payouts/create"},{"title":"List Payouts","openapi":"GET /payouts","href":"/api-reference/payouts/list"},{"title":"Get a Payout","openapi":"GET /payouts/{code}","href":"/api-reference/payouts/get"}]},{"group":"Balance","pages":[{"title":"Get Balance Summary","openapi":"GET /balance","href":"/api-reference/balance/summary"},{"title":"List Transactions","openapi":"GET /balance/transactions","href":"/api-reference/balance/transactions"}]},{"group":"Webhooks","pages":[{"title":"Create Webhook Endpoint","openapi":"POST /webhooks","href":"/api-reference/webhooks/create"},{"title":"List Webhook Endpoints","openapi":"GET /webhooks","href":"/api-reference/webhooks/list"},{"title":"Get Webhook Endpoint","openapi":"GET /webhooks/{code}","href":"/api-reference/webhooks/get"},{"title":"Update Webhook Endpoint","openapi":"PATCH /webhooks/{code}","href":"/api-reference/webhooks/update"},{"title":"Rotate Webhook Secret","openapi":"POST /webhooks/{code}/rotate-secret","href":"/api-reference/webhooks/rotate-secret"},{"title":"Ping Webhook Endpoint","openapi":"POST /webhooks/{code}/ping","href":"/api-reference/webhooks/ping"},{"title":"List Deliveries","openapi":"GET /webhooks/{code}/deliveries","href":"/api-reference/webhooks/deliveries"},{"title":"List Available Events","openapi":"GET /webhooks/events","href":"/api-reference/webhooks/events"}]}]},{"tab":"FAQ","pages":[{"title":"FAQ","href":"/faq/eligibility"}]},{"tab":"Supported Countries","pages":[{"title":"Supported Countries","href":"/supported-countries/virtual-accounts"}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog"}]}]},"basePath":"","title":"Create a Virtual Account - KemyCard API","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CiUHMMOm.js","snippetPresets-BgfXU7Bw.js","utils-DWvOwgy_.js","style-to-object-BY3JEAdk.js","utils-BN7RXSMJ.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-CFw8bq89.js","conditional-requirements-CFM0id0Q.js","cloneDeep-CAwdfOU2.js","_Uint8Array-BJr8e-ZL.js","isObject-FP1Yky1u.js","ApiExamples-XX0UgMZK.js","usePlaygroundInputsStore-DXDFSa1V.js","shallow-CdX5aREi.js","isEqual-CoOaxexF.js","CodeSnippets-Cg2wpzWm.js","CodeSnippet-D_HwgQO_.js","getApiPlaygroundDisplay-CmCoerhe.js","Page-CVJ-f_k1.js","DynamicMarkdown-CQM9Bhbv.js","SectionHeading-DpbrP8nQ.js","icon-BPCgijHy.js","MethodPill-GQ8DuY0c.js","getPastedJson-Cb5mT31m.js","Check2Icon-a7bUI6e8.js","axios-CsQoIw0U.js","Markdown-CX2QY19L.js","AssistantPageLink-CY3bFglh.js","dist-Dl6_zDnT.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}