REM Credits
The one credits ledger for REM apps - how credits are granted from purchases, spent on AI actions, clawed back on refunds, and where you see them.
REM Credits are the credits REM apps use for AI actions. REM Payments keeps the only ledger of them. Credits are kept per app and per payer: credits bought in REM Vibe Coder are spent in REM Vibe Coder, never in another app. People see their own balance and history inside each app; Credits in REM Payments is where you, the merchant, see them all.
Where credits come from
Credits are granted only from a fact REM Payments recorded, never from a request:
Source | When |
|---|---|
Plan | Each paid period of a subscription (the plan's credits per cycle), ending with the period |
Rollover | At renewal, unused plan credits up to the plan's rollover cap carry into the next period |
Top-up | A one-time credit pack, valid for its set number of days or for ever |
Trial | When a trial starts, ending with the trial |
Free | An optional free allowance when a person is first set up in the app |
Credits are spent in this order: free, trial, plan, rollover, top-up, and inside each kind the one ending soonest first.
Spending
Before an AI action the app reserves credits (a hold), runs the action, then settles what it really used or releases the hold if the action failed. Prices per feature are set on the app's Credits tab: how much a hold reserves, and credits per million input and output units.
Refunds take credits back
When you refund a purchase, the refunded share of its credits is taken back: refund half the money and half the credits go. Unspent credits are taken first. For credits already spent the app's refund policy decides: written off (the default) or owed, in which case the balance goes negative and the next grant pays it back.
The Credits page
The Credits page (Money section) has:
Overview: accounts, credits outstanding, granted, used, clawed back and expired in the period, open holds, and the same per app.
Ledger: every movement with its kind (granted, reserved, used, expired, clawed back, adjusted), source, payer, feature, model and a Why sentence.
Credit Accounts: one row per payer per app with Available, Reserved, owed and frozen. Open one to see its Lots (each grant with its source, amount left and expiry) and its ledger.
A report of credits used or granted, grouped by app, organization, payer, model, feature or day.
A person with the Finance role can freeze an account (no new holds) and unfreeze it; both are audited.
Set up credits for an app
Open the app's Credits tab:
Set Up Credits with the app's code.
Set charging on or off, payers exempt from charging, the low-balance line, the top-up page address, the refund policy, the free allowance, and how long holds may stay open.
Add a price for each feature the app meters. Changing a price makes a new version; holds already open keep their price.
Apps on the REM Payments SDK get their credits identity automatically when they link; older apps use Make Secret (the secret is shown once).
How apps call the ledger: REM Credits API.
Last updated 18 Nov 2026