Prerequisites
- Server API key: with the
orders.createandorders.readscopes. 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, setexecutionParameters.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.
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
Order creation fails with 'The recipient wallet has no Helius Private Wallet. Private delivery needs one.'
Order creation fails with 'The recipient wallet has no Helius Private Wallet. Private delivery needs one.'
recipient.walletAddress has no registered Private Wallet. Have the user create one, then create the order again, or create the order without delivery: "private".Order creation fails with 'Private delivery is only available for USDC and EURC onramp orders.'
Order creation fails with 'Private delivery is only available for USDC and EURC onramp orders.'
Order creation fails with 'executionParameters.delivery 'private' is only available for onramp orders on Solana.'
Order creation fails with 'executionParameters.delivery 'private' is only available for onramp orders on Solana.'
tokenLocator on Solana, or create the order without delivery: "private".Order creation fails with 'Private delivery needs a wallet recipient.'
Order creation fails with 'Private delivery needs a wallet recipient.'
recipient.walletAddress.Payment fails with 'Private delivery is not available for US customers.'
Payment fails with 'Private delivery is not available for US customers.'
delivery: "private".Order creation fails with a 502 status
Order creation fails with a 502 status

