Wallets and Funding
Every organization funds its spending and receives its earnings through wallets. A personal organization uses your connected wallet. A team organization registers one or more of its own wallets, managed under Settings, then Wallets.
Registering a wallet
Register an external wallet by its address (a validated 0x address). Each wallet is registered with a
role:
wallet_role | Used for |
|---|---|
payout | Receiving the organization's seller earnings |
spend | Funding the organization's own inference spend |
both | Either |
payoutUsed for · Receiving the organization's seller earningsspendUsed for · Funding the organization's own inference spendbothUsed for · EitherManaged wallets are not available. The API accepts the concept, but provisioning one currently returns
503 privy_server_wallets_not_configured — register an external wallet instead.
One wallet is marked the default payout target, which is where the organization's seller earnings are sent.
Setting default_payout requires the payout-configuration permission, and it is refused on a spend-role
wallet (invalid_default_payout_role) — only a payout or both wallet can receive earnings.
Viewing and registering wallets requires the wallet-management permission (owner, admin, or billing admin). Without it, the Wallets page shows a restricted state.
Funding and settlement
Funding and spending work the same as for any account. See the Payments docs for deposited USDC credits and fiat credits.
Payouts
For sellers, earnings accrue to the organization and are paid to its default payout wallet. Configuring payouts is available to owners, admins, and billing admins; withdrawing payouts is limited to owners and billing admins. See Roles and permissions.