# 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](/fiat/overview) |

## 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:

```js
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.

> [!WARNING]
> Never ask users to send to your server wallet's own deposit addresses: that would credit you, not them. Always fetch the address for the user.

## Or open their wallet

```js
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

```json title="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')`.
