Skip to main content
This guide covers how to deliver the stablecoins a user buys through Onramp into their private balance on Solana. By default, the tokens arrive in the recipient’s public token account. With private delivery, they are deposited into the recipient’s Helius Private Wallet, part of Solana Privacy Rings. The resulting balance is encrypted onchain, and only the recipient can read it. The deposit itself is a public Solana transaction, so the recipient address, the token, and the amount stay visible onchain. Only the balance it creates, and what the recipient does with that balance afterwards, is private.

Prerequisites

  • Server API key: with the orders.create and orders.read scopes. In staging, all scopes are included by default.
  • A recipient with a Private Wallet: the Solana wallet address the tokens go to must have a registered Helius Private Wallet. You can integrate one into your wallet or use the Embedded Private Wallet.

Supported Orders

Private delivery is available only for orders that meet all of the following:

Create the Order With Private Delivery

From your server, set executionParameters.delivery to "private" on the line item. The rest of the order is the same as any onramp order. Leave the field out, or set it to "public", for a regular transfer.
Create Order checks the chain, token, order type, and recipient, and looks up the recipient’s Private Wallet in the onchain registry. The country restriction is checked later, when the buyer’s country of residence is known after KYC. A successful Create Order response therefore does not confirm that the buyer is eligible. The rest of the flow, including KYC, payment, and the embedded checkout, is the same as for any onramp order.
Private delivery never falls back to a public transfer. If the recipient’s Private Wallet is missing when the tokens are delivered, the order is not delivered and the user is refunded.

Verify the Delivery

Fetch the order with Get Order. lineItems[].executionParams.delivery is "private" for an order created with private delivery. Once the order completes, the delivery transaction in lineItems[].delivery is the deposit into the recipient’s private balance, not a transfer to their token account. The tokens do not appear in the recipient’s public token balance. The recipient reads them from their private balance with their Private Wallet. See Read a private balance in the Helius docs.

Troubleshooting

The wallet in recipient.walletAddress has no registered Private Wallet. Have the user create one, then create the order again, or create the order without delivery: "private".
The line item buys a token other than USDC or EURC on Solana. Private delivery supports only those two onramp tokens.
The line item is not an onramp token on Solana. For example, it buys a token on another chain, or a memecoin or an NFT on Solana. Use a USDC or EURC tokenLocator on Solana, or create the order without delivery: "private".
The order has no wallet recipient. Pass the user’s Solana wallet address in recipient.walletAddress.
The user lives in the United States, where private delivery is not available. Create the order without delivery: "private".
The Private Wallet registry could not be read to check the recipient. The error is temporary: create the order again.

Next Steps

Onramp to Non-Crossmint Wallets

Link and verify wallets not created through Crossmint

Get an Onramp Quote

Estimate the stablecoin amount before placing an order

Create Order

Full reference for the onramp order payload