Wallet System¶
Traylinx wallets hold the credits and tokens that pay for platform usage — LLM calls, marketplace installs, Tytus pod usage beyond the bundled plan, and creator payouts. Wallets are organized by entity, so one user can have many wallets at the same time.
1. Open the wallets page¶
- Sidebar → Admin → Wallets (or
/admin/wallets).
You see every wallet you can access, grouped by entity type.
2. Wallet entities¶
| Entity | Purpose |
|---|---|
| Personal | Tied to your user account. Used for personal usage and quick top-ups. |
| Organization | The default funding source for an org's projects, Tytus subscriptions, and marketplace installs. Owners and admins manage it. |
| Project | (Optional) per-project wallet that overrides the org wallet for that project's spend. |
| Agent / Service | Auto-created per Famous Agent or installed marketplace tool that meters usage independently. |
One organization can have a dozen wallets across its projects and agents. They are listed independently — there's no single "portfolio" view.
3. What's in a wallet card¶
Each wallet card shows:
- Name and entity type.
- Balance in the wallet's currency (CREDITS, TOKENS, or USD).
- Recent transactions — last 5 entries with timestamp, amount, and source.
- Funding button — opens the payment dialog to top up.
- Auto-recharge status — on / off, with threshold and recharge amount if configured.
4. Filter and search¶
The wallets list supports: - Filter by entity type — Personal, Organization, Project, Agent. - Filter by currency — CREDITS / TOKENS / USD. - Search by name.
Use filters to find a specific project's wallet quickly in a large org.
5. Fund a wallet¶
- Click Fund on the wallet card.
- Pick an amount (preset chips or custom).
- Confirm. The payment goes through Stripe using the payment method on the wallet's owning organization.
- The balance updates within a few seconds; a new transaction appears in the recent list.
If no payment method is configured, the dialog redirects you to Organization settings → Billing to add one.
6. Wallet currencies¶
- CREDITS — the universal currency for platform features and most marketplace items.
- TOKENS — used for some agent-metered items and Tytus AIL bundles.
- USD — used for direct fiat-priced items and external payouts.
Currencies don't auto-convert. If a charge requires tokens and a wallet only has credits, the charge fails and you'll see a "wallet currency mismatch" message.
7. Transaction history¶
Click View all transactions on any wallet to open the full history with date filtering, transaction-type filtering (top-up, charge, refund, payout), and CSV export.
8. Auto-recharge¶
Avoid running out mid-task by configuring auto-recharge — when the balance drops below a threshold, Stripe automatically tops the wallet up. See Auto-recharge.
9. Wallet for marketplace earnings¶
When other users install your paid marketplace items, the creator share lands in your organization wallet. The amount per install depends on your subscription plan — see Earnings and revenue.
10. Withdraw funds¶
USD wallets at the organization level support payouts. From the wallet card, click Withdraw to push funds to the bank account configured under Organization settings → Billing → Payouts. Minimum payout amounts and processing times depend on your region.
For subscription billing (Explorer / Creator / Operator), see Subscription tiers. For organization-level billing setup and payment methods, see Organization settings.
Mirrored from traylinx-web:docs/user-manuals/billing/wallet_system.md. Edit the source in the traylinx-web repo — changes here are overwritten by the sync script.