Users and money

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.

WayWhat the user doesArrives
Deposit addressSends USDC or USD₮ to their own address on Solana, Ethereum, Tron, BNB Chain, Base or Arbitrum, from any wallet or exchangeAbout a minute on Solana; after confirmations elsewhere
SwapIn their wallet, swaps any coin on any of those chains (or Bitcoin) into USD₮ on USD.NETDepends on the route; the wallet shows it
TransferAnother USD.NET user, or you, sends them USD₮Under a second
FiatThrough a banking partner, where availableSee 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:

JavaScript
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

JavaScript
USDNet.open('topup');    // their wallet's Swap, set to USD₮ on USD.NET
USDNet.open('receive');  // their deposit addresses and QR codes

Hear about it

user.credited
{
  "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').