# Wallet & Credits

> Distinguish paid marketplace credits, locked promotional bonuses, model API credits and publisher earnings.

Canonical: https://theaimart.co/docs/wallet-and-credits
Updated: 2026-10-08 · Guide version: 1.1

The marketplace wallet funds supported marketplace purchases and agent execution. It is not a cash earnings account, and it is separate from AI model API credits.

## Which balance am I viewing?

| Balance | Where to inspect it | Meaning |
| --- | --- | --- |
| Marketplace paid credits | [Wallet](/Dashboard/Wallet) | Credits for supported marketplace operations |
| Locked bonus credits | Wallet response/program details | Promotional balance with its own eligibility rules |
| Model API credits | AI Models → Billing | Inference balance, separate from marketplace wallet |
| Publisher earnings | Monetization & Payouts | Recorded revenue and payout eligibility |

## Check transactions

`GET /wallet` returns the marketplace `balance`, recent `transactions` and, when available, separate `bonus` information. `GET /wallet/transactions?page=1&per_page=20` reads a paginated ledger. The transaction fields include:

```text
amount, tx_type, description, balance_after, reference_id, created_at
```

A negative movement can be a purchase or execution charge; identify its type and reference rather than interpreting it as a cash withdrawal.

## Add credits

Use the Wallet's available payment flow. It creates and verifies a real payment, then claims eligible wallet credits. The UI supports whole-dollar amounts for its integer credit balance. Payment availability depends on configured gateways. A successful browser checkout alone does not establish that wallet crediting completed; confirm the resulting balance and ledger.

## Limits and troubleshooting

Referral rewards are locked bonuses, not immediately spendable paid credits. Do not advertise them as cash. This wallet interface does not establish automatic top-ups, bank withdrawals or a budget cap for every recurring feature.

If payment succeeded but crediting failed, keep the actual payment reference and use the displayed retry/support route. Do not pay a second time to test whether a first payment worked. If a scheduled task stops, check paid balance and feature-specific entitlement/provider status. Do not assume a model API top-up funds a marketplace swarm.

## Next

See [Automation](/docs/automation), [Refer & Earn](/docs/referrals), [Subscriptions](/docs/subscriptions) and [Payouts & Finance](/docs/payouts-and-finance).