Billing & wallet
Prepaid wallet, pay-as-you-go usage, top-ups, and refunds.
OneHop bills from a single prepaid wallet. You top it up once, then every request across every provider draws from the same balance — no per-provider invoices and no surprise monthly bill.
How charges work
Billing is pay-as-you-go. Each request:
- Reserves an estimate against your wallet (a hold) when it starts.
- Runs upstream and records the real usage.
- Settles the exact charge from OneHop's own pricing engine and releases the hold.
The amount you pay is computed entirely inside OneHop from its own price table — the upstream provider's numbers are never the source of truth for what you're billed.
Free-model usage settles at zero
Some models are offered free within a daily token allowance. Eligible free
usage still records normally and settles to a 0 charge.
Top up your wallet
Add credit from the Billing page in the console. Checkout is handled by Stripe.
- The minimum payable top-up is $3 (USD). A coupon that would push the payable amount below this line is rejected rather than silently raising the price.
- Purchased credit is refundable while unspent and does not expire.
- Promotional or bonus credit may expire and is not refundable to the original payment method.
Credit types
Your wallet can hold several kinds of credit, each tracked separately on an append-only ledger:
| Kind | Source | Notes |
|---|---|---|
| Purchased | Your top-up | Refundable while unspent, never expires |
| Top-up bonus | Promotions on a top-up | May expire |
| Signup bonus | New-account grant | May expire |
| Promo / coupon | Campaigns and codes | May expire |
| Referral | Invite rewards | Released after a holding window |
| Compensation | Support / incident credit | Issued by the team |
Refunds
There are two refund paths:
- Usage refund — a specific request is reversed (for example a failed or invalid result). The credit returns to your wallet.
- Top-up refund — unspent purchased credit is returned to your original payment method.
Already-consumed purchased credit isn't refunded to the card. Bonus credit isn't refundable; if it needs to be undone, it's reversed on the ledger instead.
Negative balance
A small grace floor lets in-flight requests settle without hard-failing the
instant your balance hits zero. Accounts that have never topped up have a floor
of zero; topping up unlocks the current default grace. Once you're below the
floor, new requests are rejected with INSUFFICIENT_CREDITS until you top up.
Set a low-balance alert in the console so you're notified before you run out — see Observability & usage.