Documentation Index¶

Fetch the complete documentation index at: https://makakoo-traylinx-35.mintlify.app/llms.txt Use this file to discover all available pages before exploring further.

Wallet System¶

Manage credits, tokens, and funds using TrayLinx's multi-entity wallet system.

The TrayLinx wallet system gives every entity on the platform — users, organizations, projects, and AI agents — its own financial account. Each wallet holds one or more asset types and provides a full transaction history. You can deposit funds, transfer between wallets, and convert between asset types from a single interface.

Wallet entity types¶

Each wallet is owned by a specific entity. The entity type determines what the wallet is used for and who can access it.

Linked to your individual user account. Your personal wallet is your primary account for managing your own credits and assets, independent of any organization.

Automatically created when you create an organization. Used for operating funds, subscription billing, and receiving creator revenue payouts.

Optional wallet scoped to a specific project. Useful for isolating project-level spending and resource allocation.

Wallets assigned to AI agents, robots, services, or API clients. Allows autonomous agents to hold and spend credits independently of the owning user or organization.

When creating a wallet, you assign it an entity type (user, organization, project, ai_agent, robot, service, or api_client), an entity ID, and a purpose (general, api_usage, operating, or savings).

Supported asset types¶

Each wallet can hold multiple asset types simultaneously. The following asset types are supported:

Asset	Code	Description
Credits	`CREDITS`	Platform credits used to pay for AI service usage. 1 USD = 100 Credits.
Tokens	`TOKENS`	Platform tokens for additional features and services.
USDC	`USDC`	USD Coin stablecoin. 1 USD = 1 USDC.
Plan Tokens	`PLAN_TOKENS`	Tokens tied to your active subscription plan. Tracks subscription and billing state.

Auto-recharge is supported for Credits, Tokens, and USDC. See Auto-Recharge to configure automatic top-ups.

Viewing your wallet balance¶

Select Wallets from the sidebar to open the wallets page.
The page header shows your total portfolio value in USD and the total number of wallets you manage.
Each wallet is displayed as a card. Click a wallet card to open its detail page.

On the wallet detail page, asset cards show:

USD value — the total USD equivalent of each asset
Balance — the raw asset balance (for example, 5,000 CREDITS)
Available — the portion of the balance available for spending (excludes reserved amounts)
Reserved — any balance held for pending operations

Click any asset card to open the Asset Detail Modal with a full breakdown, transaction history, and conversion options.

Depositing funds¶

TrayLinx uses Stripe for card payments and supports USDC purchases. To add funds to a wallet:

Navigate to Wallets, then click Add Money (available on the wallet detail page or from the primary wallet display in the header).

Choose whether you want to purchase Credits, USDC, or another supported asset.

Enter the USD amount you want to spend. The dialog shows a preview of how many units you will receive based on the current conversion rate.

Click Pay to open the Stripe checkout flow. Enter your card details and confirm the payment.

After a successful payment, your wallet balance updates automatically. The system polls for the balance update and displays a confirmation once the credit appears.

Credit purchases apply at a rate of \$1 USD = 100 Credits. USDC purchases apply at a 1:1 rate with USD.

You can also purchase USDC through Coinbase Commerce, which supports crypto payment methods including BTC, ETH, LTC, BCH, and USDC directly.

Transferring between wallets¶

You can transfer assets from one wallet to another within your accessible wallets. The transfer system supports two modes:

Same-asset transfer — move a balance of one asset type from wallet A to wallet B
Transfer with conversion — move a balance while simultaneously converting to a different asset type (for example, transfer 100 CREDITS from your personal wallet and receive USDC in an organization wallet)

Transfers require a verification code for security. The sender initiates the transfer, receives a verification code, and must confirm before the funds move.

Navigate to Wallets and click the wallet you want to send from.

Click the Send button on the wallet detail page to open the Send Assets dialog.

Choose the destination wallet from the list of your accessible wallets.

Enter the amount and select the asset type. If converting between assets, select the target asset type.

Enter the verification code sent to your account to authorize the transfer, then confirm.

You can check the status of pending transfers under the Transfers tab on the wallet detail page. Transfers can be accepted or rejected by the recipient.

Transaction history¶

Every credit, debit, and transfer is recorded as a transaction. To view the transaction history for a wallet:

Navigate to Wallets and click a wallet.
Select the Transactions tab on the wallet detail page.
Use the filter and pagination controls to browse transactions by date or type.

Each transaction record includes:

Type — credit, debit, or transfer
Amount and asset — the quantity and asset type involved
Description — a human-readable description of the transaction
Reference ID — links the transaction to an originating payment or operation
Timestamp — when the transaction was created

Click a transaction row to open the Transaction Details dialog for the full record including metadata.

Multi-currency support¶

Wallets are multi-asset by default. Each wallet can simultaneously hold Credits, USDC, Tokens, and Plan Tokens. The wallet detail page displays a card for each asset type present in the wallet.

The Portfolio Asset Breakdown panel on the wallets overview page shows aggregated totals across all your wallets per asset type, alongside their USD equivalent values.

You can convert between asset types within the same wallet using the Convert button on any asset card. The conversion dialog shows the current exchange rate and a preview of the converted amount before you confirm.

Conversion rates are applied at the time of the transaction. The rate for Credits is fixed at 100 Credits per 1 USD. USDC maintains a 1:1 rate with USD. Rates for other assets may vary.

Built with Mintlify.