Skip to main content
POST

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.
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
meta
object