Credit Grants

Give customers prepaid credit balances that are consumed before metered charges are billed.

What are Credits?

Credits are prepaid balances assigned to a customer that offset their usage charges. Common use cases:

  • Free tier — give new customers $50 in credits to get started
  • Promotional offers — reward customers with bonus credits
  • Enterprise contracts — pre-pay a committed amount
  • Refunds as credit — issue credit instead of cash refunds

Creating a Credit Grant

To issue credits to a customer:

  1. Navigate to Usage-Based Billing → Credit Grants.
  2. Click Create Credit Grant.
  3. Select the customer.
  4. Enter the credit amount (in dollars).
  5. Optionally set an expiration date.
  6. Click Create.
Credit Grants

How Credits are Applied

When an invoice is generated at the end of a billing period:

  1. Total usage charges are calculated.
  2. Available credits are deducted from the total.
  3. Only the remaining balance (if any) is charged to the customer's payment method.

Credits are consumed on a first-expiring-first-out (FEFO) basis. Credits with the earliest expiration date are used first.