Credits are a versatile tool that you can utilize to give your customers pre-agreed, and in some cases, pre-paid allowances to use your product. Credits have balances that are drawn from over time.

Credit Overview

In Sequence, you can grant two types of credits:

  • Cash, or CURRENCY, which can act as a generic pre-payment for a customer
  • Unit, or METRIC, which provides entitlement to use a specified number of units for a given metric (e.g. 10,000 API Calls)

You can give credits to customers by creating a credit grant. Each credit grant includes a type, an amount, and optional effective and expiry date. By default, credit grants are effective from the day they are issued, unless an alternative effective day is specified. Similarly, grants are eligible for withdrawal indefinitely, unless an expiry date is specified.

Once the expiry date is passed and the balance is not zero, that grant cannot be used again.

There are a number of use cases where credits offer an elegant solution, including:

  • Guaranteed prepayment
  • Incentives to try or subscribe to a new product

Getting started with credits

To begin using credit grants in Sequence, transfer your customers’ existing credit balances. Create a credit grant for each customer’s current balance. Sequence will make draft invoices for new credit grants, but since it’s a balance transfer, you can void the invoice.


Helios is a company that offers OCR tech to turn PDFs into structured data. They charge customers based on API calls. Some customers, like Acme Corp, bought prepaid API credits. Helios bills customers at the end of each month and starts using Sequence for usage-based billing in March 2023.

  1. Acme bought 5000 API credits in January 2023.
  2. By the end of February, Acme has 1732 API credits left.
  3. To move the credit balance to Sequence, Helios’ billing operator creates a credit grant for Acme for 1732 credits and voids the related invoice.
  4. At the end of March, Sequence will automatically use this balance.