Usage and billing behavior
Billing cycles, proration, wallet, and how subscription changes become Stripe invoices.
Written By Zoro
Last updated 3 days ago
This page explains when and why charges appear. Amounts and tax are always on the invoice and in Stripe.
Billing cycle
New subscriptions are anchored to a monthly boundary (first day of the next calendar month, UTC, in the current server implementation). The Subscriptions view notes that recurring invoices align with monthly cycles. Your Invoices page lists actual issue and due dates.
Automatic collection
Subscriptions use Stripe charge automatically. The default payment method pays open invoices on success. If Stripe cannot charge, see Failed payments.
Plan and add-on changes
When you upgrade a plan or change add-on quantities, Stripe updates subscription items. The product often uses proration behaviours such as always_invoice so partial-period differences become immediate invoice lines or adjustments. The exact proration lines appear on the next relevant invoice.
Subscription schedules can stage future phases (for example next-cycle plan changes). When a schedule is active, upcoming items may display in the product before they bill.
Compute credits and line items
Compute credits reduce the cash portion of eligible Worker Node purchases. Implementation applies credits as invoice items that offset price data for the charge. See Compute credits.
Wallet balance
Wallet reflects Stripe customer balance (stored in cents internally, displayed as currency in the UI). Promotions, top-ups, or adjustments can change it. When an open invoice exists and the wallet balance covers amount due, the product may mark the invoice paid and decrement wallet as part of automated recovery (Failed payments).
Wallet is not the same ledger as compute credits, though both affect out-of-pocket cost.
Usage metadata
Stripe subscription metadata includes a type field for some products (for example distinguishing Worker Node style subscriptions). Behaviour for failed payments can depend on that type. Platform usage subscriptions follow the general retry and wallet rules in this section.
Upcoming invoice reminders
The platform can enqueue upcoming invoice reminder jobs so you receive notice before large renewals. Email and in-app messaging depend on configuration; keep contact info current under Profile → Account.