Payment, Limits, and Top-Ups
Three controls on Settings → Billing belong to you: the payment method on file, a monthly spending limit, and automatic top-up. Everything else about the account — the billing model, the debt limit, and suspension — is set by Suger under an approval trail.
Add a payment method
You do not need one to use Insulin. The $100 monthly free credit is spendable without a card, and most accounts never add one. Add one when you want automatic top-up, or when you are moving to monthly billing.
- Open Settings → Billing.
- Under Payment method, select Add payment method (or Add another if one is already saved).
- You are taken to Stripe’s hosted checkout page to enter the details, then returned to the same billing page.
Cards and US bank accounts are both accepted. Saved methods are listed by brand and last four digits — Visa ending 4242, Bank account ending 6789.
If the payment provider is briefly unavailable the panel says so and states plainly that your credit balance and AI usage are unaffected — it is a problem on Suger’s side, not something to fix in your own settings.
Set a monthly spending limit
A ceiling on what the organization may spend in a calendar month, whichever billing model it is on.
- Under Monthly spending limit, enter an amount in US dollars.
- Select Save limit.
To remove it, select Remove, or clear the field and save. An empty field means no limit.
| Rule | Detail |
|---|---|
| Range | 0 to $100,000 per month |
| When it applies | Compared against the month’s spend so far, on both billing models |
| What it does | Pauses AI requests for the rest of the month |
| What it also does | Stops automatic top-up — you asked not to spend more |
| Resets | At the start of the next month |
Reaching your limit is not the same as running out of credit, and the fix is different: your balance is untouched, so adding credit will not resume service. Raise or remove the limit instead. See When AI pauses.
A limit set below what you have already spent this month applies straight away, though it can take up to a minute for in-flight requests to start being refused.
Turn on automatic top-up
Automatic top-up charges your saved payment method once the balance is at or below a trigger you choose, so a long-running job is not interrupted by a balance nobody was watching.
- Save a payment method first — the switch is disabled without one, because there would be nothing to charge.
- Turn on Automatic top-up.
- Set When the balance is below (the trigger) and Top up by (the amount).
- Select Save top-up settings.
| Rule | Detail |
|---|---|
| Requires | A saved payment method |
| Trigger range | 0 to $100,000 |
| Top-up range | Greater than 0, up to $100,000 |
| Hard rule | The top-up must be larger than the trigger |
| Checked | Every five minutes |
| Overridden by | Your monthly spending limit |
Why the top-up must exceed the trigger. A top-up that lands back on its own trigger fires again immediately, and again after that. It is the only setting on this page that can charge real money repeatedly rather than once, so the console refuses to save it.
Credit added this way is Purchased credit and stays valid for three years — it is not lost at the end of the month.
How the limit and the top-up interact
Your monthly spending limit wins. Once the month’s spend reaches it, no top-up is charged for the rest of the month, whatever the balance does — charging you for credit you asked not to spend would defeat the point of setting a limit. The panel states this above the Save button whenever a limit is set.
What you cannot change here
| Setting | Who sets it |
|---|---|
| Billing model (pay as you go / monthly) | Suger, effective the following month |
| Debt limit — how far below zero the account may go | Suger |
| Suspension | Suger |
| The monthly free credit amount | Suger |
These sit behind an approval trail on Suger’s side, recorded with who changed them, when, and why. Contact support@suger.io to request a change.
If a payment fails
Stripe retries a failed payment on its own schedule, up to four attempts, before the cycle is treated as exhausted. Nothing happens to your account during the retries — the most common cause is a temporary hold or a card that gets replaced within a few days.
Once the retries are exhausted:
| Billing model | What happens |
|---|---|
| Pay as you go | The organization is suspended and notified. Update the payment method, then contact Suger to lift the suspension — it is not cleared automatically when a payment succeeds. |
| Monthly billing | Nobody is cut off automatically. You are notified, and Suger’s team follows up about the outstanding balance. |
Stored files and running sandboxes are unaffected either way.
Spotted something wrong or out of date on this page? Tell us and we'll correct it.