Skip to main content

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:

  1. Plan and grant credit first, the soonest-expiring first.
  2. 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:

SettingWhat it is
When the balance falls belowA percent of your plan's monthly credits; the page shows how many credits that is
BuyHow many credits each refill buys: any number from 1,000 ($10.00; $1 buys 100 credits)
At most, a dayThe 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: GET and PATCH /api/v1/organizations/:id/credit-settings, GET /api/v1/organizations/:id/credit-purchases, and POST /api/v1/organizations/:id/credit-purchases with paymentMethod checkout (the default) or saved-card. Send an Idempotency-Key header with a saved-card purchase so a retry charges once. Thresholds are whole percents (thresholdPercent); amounts are in credits (amountCredits, thresholdCredits), and a purchase sends credits and answers amountCredits and chargeCents, the charge in US cents. See Organizations.
  • STAN has tools for each: get_organization_credit_settings, update_organization_credit_settings, list_organization_credit_purchases and create_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_purchases and organizations.purchase_credits(credits=..., payment_method="saved-card", idempotency_key=...).