- 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
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, andorders.readscopes. 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 Save the
201 with the bank details in depositInstructions:Response
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 The call answers
simulate-deposit call makes a deposit arrive in the account. Send it with the completed outcome: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

