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.
Embed the checkout widget in your app to collect payment and amount, then let Stigg create the grant automatically.
  1. Place the widget on your Billing / Credits page.
  2. Configure allowed credit types, default amounts, and show the plan’s min/max rules to guide purchases.
  3. On successful payment:
    • A paid grant is created with amount, cost basis, priority, and dates (per plan defaults).
    • The customer’s balance updates immediately; the ledger records a Grant entry.
Customer experience: Choose amount → Pay → Balance updates; recent changes appear in the Grants table.

​
Option 2: 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.