Skip to main content
In this quickstart, you will open an EUR virtual account in the Staging environment and receive a test deposit in the user’s wallet. You will:
  • Open a virtual account for a user
  • Simulate a bank transfer into the account
  • Read the order and see the EURC delivered to the wallet
No real bank transfer is sent. The simulated deposit follows the same path as a real one.
Virtual Accounts are gated in both staging and production. Contact Crossmint to get access.

Prerequisites

  • Verified user: a staging user who has passed onramp KYC. See User Onboarding and KYC.
  • Registered wallet: the user’s wallet on Solana, linked to the user with ownership verified through the Link Wallet API. The user’s own Crossmint wallet needs no linking.
  • API Key: a staging server API key with the virtual-accounts.create, virtual-accounts.read, and orders.read scopes. In staging, all scopes are included by default.

Integration Steps

1

Open the Account

Send the user, the currency, and the wallet and token that deposits go to.
The account returns 201 with the bank details in depositInstructions:
Response
Save the virtualAccountId. When the call answers 403 payments:virtual-account.not-eligible, the user still has to pass KYC. See When the User Is Not Eligible. When status is pending, see Wait for the Bank Details.
2

Simulate a Deposit

In production, the user sends a bank transfer to the IBAN. In staging, the simulate-deposit call makes a deposit arrive in the account. Send it with the completed outcome:
The call answers 202 with the orderId of the deposit:
Response
3

Read the Order

Every deposit is an order. Read it with the Get Order API:
When phase is completed, the stablecoins are in the wallet:
Response (excerpt)
lineItems[].delivery.txId is the onchain transaction, and tokens holds the amount delivered. The amounts, rate, and fees are illustrative.

Learn More

How Virtual Accounts Work

The flow of an account and of each deposit

Open a Virtual Account

Eligibility, terms of service, pending accounts, and errors