Skip to main content
Self-serve top-ups let customers add credits on their own, without contacting support or sales. After payment, Stigg creates a paid grant with the correct cost basis, updates the pool instantly, and logs the change in the ledger.

​
Prerequisites

  • A credit type defined in Product Catalog → Credits.
  • A prepaid plan with:
    • Currency set to your credit type.
    • Top-up model (e.g., Flat rate) and currency value configured.
    • Min/Max rules for purchase amounts, if desired.
    • Credit consumption mappings for your metered features.

​
API-driven top-ups

If you collect payment through your own flow or another PSP, create the grant from your server after a successful charge.
  1. Charge the customer.
  2. Call the credits API to create a paid grant with currency/type, amount, cost basis, priority, and optional effective/expiry.
  3. Confirm the new grant in Customers → [Customer] → Credits → Grants; verify the Ledger increment.

​
Automatic top-ups (low-balance protection)

Prevent interruptions by configuring an automatic rule:
  1. In Customers → [Customer] → Credits, click Automatic top-up.
  2. Set Top up when balance below (threshold) and the Top-up amount.
  3. Define Per unit cost basis, Spend limit period, and Spend limit amount.
  4. (Optional) Set an Expiry date and Auto top-up expiry.
  5. Save. The rule will trigger a purchase and grant when the threshold is crossed within the spend cap.

​
Monitoring and receipts

  • Credits utilization shows the live balance and recent changes.
  • Grants lists each top-up with remaining/original amounts and dates.
  • Ledger records the corresponding Grant entries with deltas and end balances.

​
Troubleshooting

  • Top-up didn’t appear: Check payment status, then look for a new Grant in Grants and a Grant entry in Ledger.
  • Rule didn’t fire: Verify threshold, top-up amount, and spend limit; confirm the time window and review the Activity log.