Use billing creditsPublic preview

Implement a prepaid billing solution with billing credits.

This guide explains how to set up usage-based billing by using the Meters API and billing credits.

Note

Billing credits only apply to subscription invoice line items that link to a billing meter price and not to the legacy usage records API. Learn more about credit application eligibility.

Before you begin

Set up usage-based billing:

Create a billing meter.
Create a pricing model and add the meter to it.
Subscribe a customer to the usage-based price.

OptionalFund the credit grant

Grant billing credits to your customer

Go the customer page and click on a customer.
Go to the Credit Grants section and click the plus (+) symbol.
Name your credit grant and add the amount.
(Optional) Specify the effective start and expiry date.
Select Create Grant.

Apply billing credits to invoices

After the invoice finalises, Stripe automatically applies all applicable billing credits. At this time, the credit grant’s available balance reflects the new credit balance transaction which represents the billing credits applied to the invoice.

To find the amount of billing credits applied on an invoice:

Go to the customer page and select the relevant customer.
Select the invoice from the Invoices section.
Find the line Credit grant applied under Subtotal.

Get the available billing credit balance

To see what the available billing credit balance is for a customer:

Go to the customer page and select the relevant customer.
Find the list of credit grants under the Credit grants section.

The amount in the Available column is the credit grant’s available balance.

List transactions for a credit grant

To see the credit balance transactions for a specific credit grant:

Go to the customer page and select the relevant customer.
Select the specific credit grant in the Credit grants section.