> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stigg.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Enable self-serve top-ups

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**.