Skip to main content

​
Overview

Credits are a flexible, prepaid resource that customers can purchase and consume for metered features. This system is ideal for products with variable usage, such as AI tokens, API calls, or compute time, allowing you to offer predictable spending with the flexibility of usage-based pricing. A credit system in Metrifox allows you to:
  • Debit a prepaid balance instantly as customers consume features.
  • Set up recurring subscriptions that include a monthly credit allowance.
  • Enable manual top-ups so customers can purchase more credits at any time.
  • Allow overages, debiting usage now and invoicing for it at the end of the billing period.
  • Grant free promotional credits for trials or marketing campaigns.

​
Creating a credit system

  1. Navigate to Product Catalog → Credit Systems.
  2. Click Create New Credit System.
  3. Configure the settings:
    • Name: A unique identifier for the credit system (e.g., AI Tokens).
    • Description (Optional): displayed to customers during manual top-ups.
    • External Key (Optional): Your own unique ID. Leave blank to have one auto-generated.
    • Unit Labels: Define the singular and plural form of the unit (e.g., Token / Tokens).
  4. Click Create Credit System.

​
Set a Default Price

Define a standard price per credit to reuse across multiple plans. Updating this default price will automatically update all plans that use it.
  • How to Set: Edit your credit system and define the price in the Default Price section.
  • How to Use: When attaching the credit system to a plan, simply toggle “Use Default Price.”

​
Attach a Credit System to a Plan

To enable a plan or add-on to use credits, you must attach the credit system and define its rules.
  1. Navigate to your Plan.
  2. Find the Credit Systems section and click Attach Credit System.
  3. Select the credit system you want to attach.
Configure the entitlement rules:
  • Quota: The maximum number of credits a customer can consume per reset interval (e.g., 1000 per month). Use the infinity symbol (∞) for unlimited.
  • Reset Interval: How often the quota resets (e.g., monthly, annually).
  • Expiration (Optional): Set a duration after which unused purchased credits expire.
  • Included Allowance: Grant a recurring amount of free credits (e.g., 5 free credits every week).
    • Carryover: Allow unused included credits to roll over to the next period.
  • Enable Top-ups: Allow plans to support rechargeability through manual top-ups or automated credit subscriptions. This configuration ensures customers can replenish usage limits or entitlements without modifying their base plan.

​
Price Your Credits

If you’ve enabled top-ups, define how much customers pay for additional credits. You can use the default price or override it for this specific plan.
  1. In your plan’s Credit Systems section, click Add Price.
  2. Select Credit-based price.
  3. Choose to Use Default Price or toggle it off to set a custom price.
  4. Define Pricing that aligns with your product’s value delivery.
    1. Select a pricing model: Flat Fee, Per Unit, or Package Pricing based on standard pricing, graduated pricing or volume discounts.
  5. Save your configuration.

​
Configure Features to Consume Credits

Direct specific feature usage to deduct from the prepaid credit balance instead of generating standard meter usage.
  1. In your plan, navigate to the Prices section for a specific feature.
  2. Click Edit or Add Price.
  3. Select Dynamic Price.
  4. Find the desired metered feature and toggle on Enable Prepaid Usage.
  5. Select the Credit System and define the Credit Cost (e.g., 1 credit per 1 AI image generated).
  6. Click Save.

​
Monitor Customer Balances

Track all credit activity and balances for any customer.
  1. Navigate to the Customer’s Account page.
  2. Select the Prepaid Balance tab.
  3. Use the dropdown to select a specific credit wallet.
  4. View the Total Available Balance, which is the sum of:
    • Included Credits (from their plan allowance)
    • Purchased Credits (from top-ups)
    • Promotional Credits (manually granted)
  5. View Transactions: Click on any balance type to see a full history of purchases, grants, and consumption.
Note: Metrifox automatically consumes credits starting with those nearest to their expiration date (FIFO).