# Build for business

> Let your users pay, top up and get paid in USD₮ on USD.NET by API, final in under a second, without ever holding their keys.

USD.NET for business is for sites and apps that move dollars with their users: games, marketplaces, collectibles, creator tools, subscriptions. A user opens a self-custodial USD.NET wallet with a passkey in seconds, tops it up from any chain, and your server charges, refunds and pays them out in USD₮ on USD.NET by API. Every movement is final in under a second.

You never hold a user's keys or their money. Users sign a **mandate** that lets your server charge them up to limits they choose, and revoke it whenever they like.

:::cards
- [Quickstart](/business/quickstart) Build a pack-opening shop on testnet in 15 minutes
- [USD.NET Connect](/business/connect) connect.js: connect a wallet, approve a mandate, pay
- [Charges and payouts](/business/charges) Take payments and send refunds, buy-backs and winnings
- [Webhooks](/business/webhooks) Hear about every charge, payout and top-up
- [API reference](/business/api) Every business endpoint
- [Build with AI](/business/ai) Everything an AI agent needs in one file
:::

## The pieces

| Piece | What it is |
| --- | --- |
| **Business wallet** | A normal USD.NET wallet that you open with a passkey. It owns your partner record and is where you sweep revenue. |
| **Server wallet** | A key that lives on your server (`USDNET_SERVER_KEY`). It charges users within their mandates, sends payouts and pays the network fee. Made in your browser when you create the partner record and shown once. |
| **Partner record** | Your name, the sites allowed to open Connect, your server wallets and your webhook URL. Public except the webhook. `pt_…` |
| **USD.NET Connect** | A popup on usd.net, opened by `connect.js` on your site. The user unlocks their wallet there and approves; your page gets the address and the signed result. |
| **Mandate** | A user's signed permission for one server wallet to charge them: per charge, per day, optionally in total, until a date. It can also let you see their balance. |
| **Charge** | Your server takes an amount from a user, within their mandate. Idempotent by your `id`. |
| **Payout** | Your server pays a user: refunds, buy-backs, winnings, cash-outs. No nonce, so send thousands at once. Idempotent by your `id`. |
| **Webhooks** | Signed POSTs to your server when a charge, payout, payment, mandate or top-up happens. |

## How a purchase flows

:::steps
### The user taps **Connect with USD.NET**
Your page calls `USDNet.connect({ partner, mandate })`. The popup shows your name, your verified site and the limits. They approve with Face ID or Touch ID.

### Your server saves their address
The popup returns `{ address, mandate }`. You get a `mandate.created` webhook too.

### They top up
From any chain or exchange: their own deposit addresses on Solana, Ethereum, Tron, BNB Chain, Base and Arbitrum credit their USD.NET account. You get `user.credited`.

### They buy
Your server calls `charge({ user, amount: '4.99', id: 'order_1042' })`. Final in under a second; the pack opens.

### They sell back
Your server calls `payout({ user, amount: '12.50', id: 'buyback_88' })`. The USD₮ is in their wallet before the animation ends.
:::

## Costs

| | Who pays | Amount |
| --- | --- | --- |
| Charge | Your server wallet | 0.01 USD₮ network fee |
| Payout | Your server wallet | 0.01 USD₮ network fee |
| Mandate, revoke | Nobody | Free |
| Partner record, webhooks | Nobody | Free |

There is no platform fee, no monthly fee and no approval step to start on testnet.

## What users see

Their wallet lists every business they connected in **Settings → Connected apps**, with each mandate's limits, what it has charged and a **Revoke** button. Charges show in their Activity as **Paid · charged by an app**, payouts as **Received · from an app**. Their account stays [confidential](/wallet/confidential): the public sees only that a transaction happened.

> [!NOTE]
> You are responsible for your own product: the rules where your users live, consumer law, refunds and, where they apply, licences and age checks. USD.NET provides the wallet, the network and the API.
