Buy Credit (prepaid gateway AI credit top-ups via Stripe checkout)
Buy Credit lets a signed-in Omniscio user top up their prepaid gateway AI credit with a credit card. You pick an amount, Omniscio opens Stripe's hosted Checkout page in your browser, you pay, and the credit lands on your balance a moment later. It's the self-serve way to keep gateway credit on hand so your AI work never stalls for lack of funds.
On this page
What it is
Buy Credit lets a signed-in Omniscio user top up their prepaid gateway AI credit with a credit card. You pick an amount, Omniscio opens Stripe's hosted Checkout page in your browser, you pay, and the credit lands on your balance a moment later. It's the self-serve way to keep gateway credit on hand so your AI work never stalls for lack of funds.
Buying is 1:1 face value: pay $25 and you get $25 of usable credit. The card processing fee is absorbed — it is not added on top and it does not eat into the credit you receive.
Spending it is not 1:1. Each request billed against the balance is charged at the real
upstream cost plus a flat 10% surcharge (DEFAULT_MARKUP_PCT = 10 in
credits.ts, baked into the deployed service
as GATEWAY_MARKUP_PCT=10), so $25 of credit buys about $22.73 of AI at provider list prices.
The 1:1 promise is about the purchase, never the burn rate — do not describe the balance as
un-marked-up. Using an own API key skips the credit balance and the surcharge entirely.
The Buy Credit card lives in Settings → Accounts & AI → Plan & Usage, directly under the "Credits remaining" balance, so buying more sits right where you see what's left — alongside your plan and monthly allowance. The same balance also shows under Settings → API Keys (where creating a pooled key needs it), with a link back to Plan & Usage to add credit. (Moved here 2026-08-18 in the money-surface consolidation; it was previously under Settings → API Keys.)
You can also buy credit from the Credits widget in the header, which shows your balance and opens a panel with the same preset amounts and a custom amount. After you pay, Omniscio waits for the balance to change in the background (up to 45 seconds) and shows one Credit added to your balance. message, whichever of the header panel or the Plan & Usage screen is open.
Where to find it
Settings → Accounts & AI → Plan & Usage, in the Buy Credit card under the Credits remaining balance. (The balance is also visible under Settings → API Keys.)
How it behaves
How to use it
- Open Settings → Accounts & AI → Plan & Usage and find the Buy Credit card under your Credits remaining balance.
- Pick an amount. There are four one-tap presets — $10 / $25 / $50 / $100 — or enter a custom amount (minimum $5, maximum $1,000).
- Omniscio opens Stripe Checkout in your browser. Stripe is the payment processor; your card details are entered on Stripe's own hosted page, never inside Omniscio.
- Complete the payment on Stripe. When you're done you're returned to Omniscio.
- Your balance updates shortly after payment — a verified Stripe webhook adds the credit. If you don't see it immediately, refresh the balance; crediting is near-instant but not synchronous with closing the Checkout tab.
You are told what happened either way (T-27). Finishing the payment is not the only way the secure window closes, and the other two used to end the purchase in silence:
- Cancelled — "Checkout cancelled. Nothing was charged."
- Closed without paying — "Checkout closed. If you finished paying, your credit will appear in a moment." This one never claims nothing was charged, because a payment can still be settling.
While the page waits for the webhook it watches the balance itself. If the balance couldn't be read when you clicked Buy, it confirms on the first readable positive balance and says "Credit added to your balance." — so a purchase made while the balance was unreadable still confirms instead of sitting on "Confirming…" until it times out.
Money-safety facts
- 1:1 face value on the PURCHASE, fee absorbed. $25 paid → $25 of credit. The processing fee is covered for you, so what you pay is what you get.
- Cost + 10% on the SPEND. Each request billed against the balance is charged at real upstream cost plus a flat 10% surcharge, so $25 of credit buys ≈ $22.73 of AI. This is the only markup; an own API key bills the provider directly and skips it.
- Presets + custom range. $10 / $25 / $50 / $100 presets, or any custom amount from $5 to $1,000.
- Credit is applied by a verified webhook, not by the browser returning. Omniscio only adds credit when Stripe's signed webhook confirms the payment succeeded, so a closed tab or a flaky network can't leave you paid-but-not-credited — the balance catches up on the next refresh.
- Refunds and chargebacks auto-debit the credit back out. If a payment is later refunded or charged back, the corresponding credit is automatically removed from your balance, so the balance always reflects money actually settled.
- Sales tax is added on top and is not credit. Where Stripe Tax collects sales tax, it is added to what you pay, and your credit is the amount you chose. A refund removes exactly the credit that purchase added.
Auto top-up
Auto top-up refills your balance by itself, so agents never stop for lack of credit.
- Where: the Credits widget in the header. Turn on Auto top-up, then choose three amounts: when my balance drops below ($5–$500, default $10), add this much each time ($10–$1,000, default $25, at least the first amount) and never add more than this per month ($25–$2,000, default $100).
- Saving a card: the first time you turn it on, Omniscio opens a Stripe page once to save a card for automatic charges (with your billing address, which sales tax needs). Card details never enter Omniscio. Change card opens the same page again.
- When it charges: when an AI request finds your balance below the amount you chose, Omniscio charges your saved card once, adds the amount you chose, and the request carries on. Turning auto top-up back on while your balance is already low charges straight away. Each charge is a Stripe invoice, so you get a receipt and sales tax is handled the same way as a manual purchase.
- Never more than your limit: automatic charges in a calendar month (UTC) stop at your monthly limit; the count starts fresh each month. The panel shows how much was used this month.
- If your card is declined: auto top-up turns itself off, the Credits widget goes red with Paused, and the panel says why, with a Fix card button. It never retries the card on its own.
- Turning it off: switch it off in the panel at any time; nothing else is charged. Deleting your account removes the saved card.
- Only from your own desktop: changing auto top-up and saving a card work only in the desktop app, never from the phone view or an agent.
Codes: vouchers and discounts
The Credits widget and Plan & Usage both have a Have a code? link.
- Vouchers start with
OMNI. Redeem one and its free credit is added to your balance at once. Each voucher works once per account, and only for a signed-in account with a verified email. - Discount codes are anything else. Omniscio holds the code and applies it to your next credit purchase on the Stripe page; you get the full amount of credit you chose and pay the discounted price. A code that would bring a purchase under Stripe's $0.50 minimum is refused.
- Wrong codes: five unknown codes in an hour lock redeeming for 24 hours. A typo in a voucher is caught straight away and does not count.
- Money boxes show
$: every dollar amount box in Credits and Plan & Usage shows a$inside it.
For code makers: Vouchers & coupons
Vouchers & coupons in Plan & Usage appears for two kinds of account — the app's admin role is not what decides it:
a code giver: makes codes up to a dollar limit per calendar month, sees "You can give $X more this month", and sees and changes only the codes they made. A code that would go over the limit is refused with the amount left. A discount code Stripe refuses, and the unredeemed part of a voucher they retire, give that month's room back;
a full code admin: no personal limit, sees every code (with who made it), and manages the Code givers list — add someone by email with a monthly limit, change the limit, or remove them.
Create a voucher (value per use, number of uses, an optional total budget, days until it expires, a label) or a discount code (percent or amount off, uses, expiry, what it applies to). The new code is shown once, with a copy button.
Confirm it's you: making, pausing or retiring a code never asks you to sign in again. Only adding, changing or removing a code giver does; that sign-in is good for nine minutes.
Limits: one voucher can give away at most $500 in total, and all new codes together at most $2,000 in any 24 hours.
Pause, resume or retire any voucher from the list; Show older loads earlier ones. Retiring is final; credit already given stays.
Alerts: the owner gets an email for every new code (naming who made it) and for every code giver added, changed or removed, and an hourly check emails if a voucher was changed outside the app.
Related
- plan-billing.md — the Plan & Usage screen where the Buy Credit card now lives
- api-keys.md — the Settings → API Keys panel, which still shows the balance for key creation
- cost-control.md — watching spend and managing budget caps on your AI usage
Last verified 2026-11-04