Clerk Billing now supports account credits
- Category
- Billing
- Published
Adjust customer credit balances from the Clerk Dashboard and APIs
Starting today, you can add or remove account credits from Users and Organizations directly from the Clerk Dashboard and APIs.
Sometimes you want to adjust what a customer owes without changing their subscription. Maybe you're offering a one-time discount, issuing a service credit, or resolving a billing issue. Account credits make these kinds of adjustments simple while keeping subscription pricing unchanged.
Credits are stored on a customer's account and automatically applied toward future charges. If the available credit exceeds the amount of the current invoice, the remaining balance stays on the account and is automatically used for future recurring charges.
Flexible account adjustments
Account credits give you a straightforward way to make account-level billing adjustments without creating custom pricing or modifying Plans.
For example, you might:
- Offer a one-time courtesy credit after a service interruption.
- Grant promotional credits to early customers.
- Apply a manual discount for a specific customer. (Note: customers can use their credits however they would like to).
- Resolve billing issues by crediting part or all of an upcoming invoice.
Whenever a customer is billed, Clerk automatically applies any available credit balance before charging their payment method. Any unused credit remains on the account until it's fully consumed.
Built directly into Clerk Billing
Account credits can be managed from the Clerk Dashboard or through the Backend API, giving you the flexibility to automate credit adjustments or handle them manually.
Each User or Organization displays its current credit balance, and every adjustment immediately updates the amount available for future billing.
Every credit adjustment is recorded in a ledger, giving you a complete history of credits that were added or removed from an account. Whether you're issuing promotional credits automatically through your application or making manual adjustments from the Dashboard, you always have an audit trail of how a customer's balance changed over time.
Get started with Account credits
- Open a User or Organization in the Clerk Dashboard.
- Open the Actions menu.
- Select Adjust credit balance.
- Enter the amount of credit to add or remove.
- Save your changes.
The updated balance will automatically be applied to the customer's next eligible charge, with any remaining credit carrying forward to future recurring invoices.