Skip to main content
Prepaid credits let customers pay upfront for a defined amount of usage. Each credit represents a unit of value in a chosen currency, which can then be spent on metered features. Prepaid balances are deducted in real time as usage happens, and customers can top up their balance at any time within configured rules (e.g., minimum or maximum purchase).

​
Setting up a prepaid plan

  1. Go to Product Catalog > Plans.
  2. Click +New plan.
  1. Set Plan type to Paid.
  2. Under Billing model, select Prepaid.

​
Prepaid configuration

In the Prepaid configuration section, define how customers purchase and top up credits:
  • Currency: choose the credit type (e.g., AI Tokens (AIT)).
  • Top-up model: select the required top-up model, such as Flat rate.
  • Currency value: define the rate for one credit (e.g., 1 AI Token = $1.00).
  • Min, Max Rules (optional): enable and set Minimum and Maximum purchase amounts (e.g., 250 to 8,000 credits).

​
Credit consumption

In the Credit consumption section, map how usage consumes credits:
  • Select the metered feature (e.g., AI Agent Email).
  • Define the conversion (e.g., 1 email = 1 AI Token).
  • Click Add to include additional feature mappings if needed.
Only event-based meters are currently supported for credit consumption mapping.
  1. Click Save changes.

​
Creating a subscription to a prepaid plan

  1. Go to Customers → select the customer → click Create subscription.
  1. In Configuration:
    • Select the product from the Product dropdown
    • Select the plan that was created when configuring prepaid credits.
    • Select the currency context from the Price localization dropdown.
  2. If required, edit the credit currency value by clicking the edit icon in the Credits section and set the rate (e.g., 1 AI Token = $0.04).
  3. If the subscription includes credits:
    • Toggle Enable in Included credits
    • Choose Purchase credits or Promo grants from the Initial grant amount
    • Enter the credit amount (e.g., 100 AI Tokens).
    • Select the expiration rule (e.g., Never).
  4. In the Credit consumption section, map the feature, rates and credit consumption.
  5. In the Schedule section, choose when the subscription begins (e.g., Immediately).
  6. In the Billing section:
    • Billing provider: select the provider (e.g., Customers EMEA).
    • Billing address: confirm the address (e.g., 123 Main St, NY, US).
    • Payment method: choose how to charge (e.g., Automatically using payment method on file, **** 4242 Expires 12/2034).
  7. Review the Subscription preview and click Create Subscription.

​
Credit management

  • Customer self-service: Customers can top up their prepaid balance through the Credit top-up flow.
  • Admin adjustments: Admins can manually add or deduct credits from a subscription through the Credit adjustment process.
⌘I