Billing
Credits & top-ups
How the wallet works, what each grant covers, and what the top-up packs actually cost.
Credits & top-ups
Token Harbor has one balance in USD. Web chat, the OpenAI-compat API, the Anthropic-compat API — they all draw from the same wallet.
Free credit
| Grant | Amount | How you get it |
|---|---|---|
| Welcome grant | $5 trial balance | Manually claim from the gift box on the dashboard after sign-up. Expires 7 days after it's granted if unspent. |
The welcome trial credit can be spent on anything but not withdrawn. Paid balance (top-ups, plus any referral and cashback rewards) is withdrawable.
Top-up packages
| Package | You pay | You get | Bonus |
|---|---|---|---|
| Starter | $10 | $10 | — |
| Community | $50 | $50 | — |
| Harbor | $100 | $100 | — |
Charged via PayPal. Credits never expire.
No-bonus / no-markup is the current pricing stance — the value to users sits in the per-token billing being passthrough cost, plus the platform caches and API cashback loop.
How spend is calculated
Token Harbor bills per token, against the upstream vendor's published prices, plus an optional per-model markup we set in admin (default 0% today). Full formula in Models → How we bill.
Three cache layers reduce what you pay:
- Identical requests within 5 minutes — $0.
- Semantically similar questions — $0.
- Long repeated prefixes (≥1024 tokens) — up to 90% off via the vendor's prompt cache.
Refunds
Unused wallet balance is refundable within 30 days of the original top-up — email billing@tokenharbor.ai and we return it to the original payment method whenever possible.
| Refundable? | |
|---|---|
| Unused top-up balance | Yes — in full |
| Already-consumed balance | No |
| Promotional credits | No |
| Reward credits | No |
Promotional credits include the first top-up match, which lands locked and unlocks $1-for-$1 as you spend. A refund returns your unused top-up balance and reclaims any still-locked match first.
Seeing your balance
Top-bar pill updates live via Supabase realtime. For per-call detail, /dashboard/usage shows your last 100 requests with tokens, cache layer, and exact cost. Export the full history as CSV from the same page.
Top-up audit trail & reconciliation
Need a record that proves every payment was credited to your account — for accounting, expense reports, or peace of mind? Export your full transaction ledger as CSV:
- Sign in and go to Dashboard → Billing.
- Click the Top-ups filter to show only recharges (or leave it on All for the complete ledger).
- Click Export CSV. A file named
tokenharbor-ledger-<date>.csvdownloads — open it in Excel, Google Sheets, or Numbers.
Each row is one ledger entry. For a top-up it carries everything you need to reconcile against PayPal:
| Column | Meaning |
|---|---|
| Date (ISO UTC) | When the entry posted |
| Type | e.g. Recharge for a top-up |
| Source pool | Which balance it credited (Paid pool for top-ups) |
| Amount USD | Exact amount credited to your account |
| Running balance USD | Account balance right after that entry |
| Status | e.g. completed |
| Order ID | Your PayPal order ID |
| PayPal capture ID | Your PayPal capture (transaction) ID |
To reconcile a payment, match the PayPal capture ID (and Order ID) in the CSV against your PayPal receipt — the Amount USD confirms the credit landed in your account, and the ledger is append-only. For a statement covering a specific date range, email billing@tokenharbor.ai.