Credits
Your organization's credits pay for everything it runs. This page covers buying credits, when purchased credits expire, the low-balance alert and auto-refill. How plan credits arrive each month is on Plans and sign-up.
Only the organization's owner and its admins can buy credits or change these settings. Other members do not see the Credits & Auto-refill tab and cannot buy credits.
Where to find it
Open Usage & History from your profile menu (the Billing & Usage page) and choose the Credits & Auto-refill tab. It shows:
- Purchased credits: each purchase that still holds credit, with Purchased, Amount, Used, Remaining and Expires, and the Buy credits button.
- Low-balance alert and Auto-refill, saved together with Save credit settings.
- Refill history: every auto-refill, failed ones too.
Billing & Credits shows your purchased credits too, and its Buy more button opens the same purchase dialog.
Buying credits
Choose Buy credits (or Buy more), enter how many credits to buy (the dialog shows what they cost), and choose how to pay:
- Saved card (charged now): choose Buy now, then Confirm: pay $…. The card is charged at once and the credits are added straight away; the dialog shows the date they expire. If your bank asks you to confirm the payment, nothing is charged and you are taken to Stripe Checkout to pay there instead. Without a saved card, pay with Checkout.
- Stripe Checkout: choose Continue to checkout and pay on Stripe's page. The credits are added once the payment goes through.
You can buy any number of credits from 1,000. $1 buys 100 credits, so 1,000 credits cost $10.00. If your organization owes credit (its balance went below zero), the purchase pays that off first.
When purchased credits expire
Purchased credits expire 12 months after their purchase, each purchase on its own. A purchase made on 10 March 2026 expires on 10 March 2027, whatever happened to your other purchases. An auto-refill is a purchase too, and expires 12 months after it. Credit still left at expiry is removed and shows in your history as Purchased credits expired.
Credits Strongly adds to your organization never expire. They are forfeited with the rest of your credits when your subscription ends.
Credits are used in this order:
- Plan and grant credit first, the soonest-expiring first.
- Purchased credits only after it runs out, the soonest-expiring purchase first.
When your subscription ends, every credit you still have (plan, grant and purchased) is forfeited. No money is refunded, not for unused credits either. See Canceling.
Low-balance alert
The low-balance alert is off until you turn it on. Turn on Alert me when the balance is low and set When the balance falls to as a percent of your plan's monthly credits; the page shows how many credits that is. 20% of a 5,000-credit plan month is 1,000 credits.
- Each time the balance falls to that amount, the owner and admins are notified once: always in the app (the notification bell), and by email to each of them whose Profile > Preferences > Email me about governance is on.
- The alert is ready again once the balance is back above the amount, so the next fall notifies again.
- With the alert on, the owner and admins are also told 14 days before a purchase's credit expires, if any of it is left.
Auto-refill
Auto-refill is off until you turn it on. Turn on Charge my saved card when the balance is low and set:
| Setting | What it is |
|---|---|
| When the balance falls below | A percent of your plan's monthly credits; the page shows how many credits that is |
| Buy | How many credits each refill buys: any number from 1,000 ($10.00; $1 buys 100 credits) |
| At most, a day | The most refills in one day, from 1 to 10; the page shows how many ran today |
When the balance falls below the amount, your saved card is charged for the Buy credits and they are added as purchased credits, which expire 12 months after the refill.
If the card is declined, or the bank asks for a confirmation that cannot be given while you are away, nothing is credited and auto-refill turns itself off. The owner and admins are notified, the failed refill shows in Refill history, and the tab says auto-refill turned itself off. Update your card, then turn auto-refill on again. A failed payment never marks your subscription past due: it adds no credits, and your work keeps running until the balance runs out, as it would anyway.
REST API, STAN and the Python SDK
The same settings and purchases are available to the owner and admins outside the page:
- REST:
GETandPATCH /api/v1/organizations/:id/credit-settings,GET /api/v1/organizations/:id/credit-purchases, andPOST /api/v1/organizations/:id/credit-purchaseswithpaymentMethodcheckout(the default) orsaved-card. Send anIdempotency-Keyheader with a saved-card purchase so a retry charges once. Thresholds are whole percents (thresholdPercent); amounts are in credits (amountCredits,thresholdCredits), and a purchase sendscreditsand answersamountCreditsandchargeCents, the charge in US cents. See Organizations. - STAN has tools for each:
get_organization_credit_settings,update_organization_credit_settings,list_organization_credit_purchasesandcreate_credit_purchase. STAN asks you to confirm before it buys credits or turns auto-refill on. - Python SDK:
organizations.get_credit_settings,organizations.update_credit_settings,organizations.list_credit_purchasesandorganizations.purchase_credits(credits=..., payment_method="saved-card", idempotency_key=...).