Usage & Billing
Understand plan entitlements, credit order, operation history and Stripe changes.
Usage & Billing displays the active plan, monthly free-call allowance, included and prepaid credit balances, overage state and the latest 50 ledger entries.
/api/clawdbase/usageCharge order
The backend reserves and settles usage atomically. Free calls, gifted credits, included plan credits and prepaid credits are consumed according to billing policy; eligible paid accounts can continue into metered overage.
Subscription changes
Builder and Pro checkout uses Stripe. Upgrades and downgrades target the chosen plan incrementally: Pro to Builder must become Builder, not Free; paid to Free must be an explicit Free action.
After Checkout or Portal return, the Console verifies the payment and refreshes plan, cycle and balance together. A success message appears only after the updated entitlement is confirmed.
See plans, credits and overage.
Balance order
Successful operations consume the first eligible source enforced by the service: monthly Free calls, gifted credits, included plan credits, purchased credits, then metered overage for an eligible active paid subscription. The browser displays the returned balance; it does not reproduce this accounting logic.
Checkout return
Detect the session
The Console shows a processing state after Stripe returns. It does not announce the new plan yet.
Verify ownership and payment
Clawdbase verifies the completed Checkout belongs to the signed-in billing account.
Fulfill idempotently
The plan or prepaid pack is applied once, even when Stripe confirmation is delivered more than once.
Update the interface
Plan, cycle, balance and renewal date update together before the Console shows success.
Plan changes
Free-to-paid uses Checkout. Builder-to-Pro and Pro-to-Builder use the paid plan-change route and update the base subscription item while preserving overage. Paid-to-Free is a separate end-of-period cancellation; it never routes through Builder by accident and a Pro-to-Builder change never calls the Free cancellation route.
Ledger table
Each operation row names the operation, channel, subject, charge source, credits charged, status and time. Pending rows remain visible for support. Failed rows show zero settled credits after reversal. Filters and pagination must run on the server for large histories.
Error recovery
If Clawdbase cannot confirm fulfillment, it leaves the prior confirmed state visible and shows a retry/support message. Do not purchase again until the original Checkout has been checked.