Top-ups
How users add USD₮ to their USD.NET account - deposit addresses on six chains, swaps, transfers - and how you hear about it.
A user's USD.NET account can be topped up four ways. All of them land as USD₮ on USD.NET in the user's own account, and, if their mandate has read: true, you get a user.credited webhook.
| Way | What the user does | Arrives |
|---|---|---|
| Deposit address | Sends USDC or USD₮ to their own address on Solana, Ethereum, Tron, BNB Chain, Base or Arbitrum, from any wallet or exchange | About a minute on Solana; after confirmations elsewhere |
| Swap | In their wallet, swaps any coin on any of those chains (or Bitcoin) into USD₮ on USD.NET | Depends on the route; the wallet shows it |
| Transfer | Another USD.NET user, or you, sends them USD₮ | Under a second |
| Fiat | Through a banking partner, where available | See Banking partners |
Show deposit addresses in your own UI
With a read: true mandate your server can fetch the user's deposit address on any open chain:
const d = await usd.depositAddress(user, 'solana');
// { chain: 'solana', address: '7xK…', assets: ['USDC', 'USDT'], min: '1', arrives: 'about a minute' }GET /bridge/address/:chain/:user. Chains on mainnet: solana, ethereum, tron, bnb, base, arbitrum; on testnet solana-devnet and base-sepolia. The address belongs to that user only; anything sent to it is credited to their account. Show the minimum: smaller deposits wait until the total reaches it.
Or open their wallet
USDNet.open('topup'); // their wallet's Swap, set to USD₮ on USD.NET
USDNet.open('receive'); // their deposit addresses and QR codesHear about it
{
"type": "user.credited",
"data": { "user": "0x7c1e…40ab", "type": "bridge_in", "amount": "50", "balance": "95.01", "hash": "0x…", "source": { "chain": "solana", "tx": "5Kf…" }, "time": 1762268400000, "block": 18231 }
}balance is their balance right after the credit. Use it to unlock a "Buy" button the moment money arrives. Payouts you send yourself don't trigger user.credited (you get payout.succeeded).
Cashing out
Users withdraw with their own wallet (Send → another chain), at any time. You can link them there with USDNet.open('send').