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

# Adjust credit balance

Credit adjustments let you add or revoke credit grants for a customer outside of the normal purchase flow. Use them to load paid credit packs, issue promotional trial credits, correct mistakes, or remove remaining balances. Every change updates the customer’s credit pool and is written to the ledger for audit.

<Note>
  Credits can be granted to and consumed by customers regardless of whether they have an active subscription. This makes it easy to seed new accounts with promotional credits before a plan is selected, issue credits to customers whose subscriptions have lapsed or haven't started yet, or run credits as a standalone system decoupled from Stigg subscription management entirely — see [Subtract credits directly](#subtract-credits-directly-no-subscription-required).
</Note>

### Key concepts

* **Grant**: a credit block with **Amount**, **Priority**, **Cost basis**, **Effective date**, **Expiry date**, **Category** (Paid / Promo), and **Reason**.
* **Priority**: controls consumption order; **lower value = higher priority** (e.g., `0` is the highest).
* **Cost basis**: price per credit for paid grants (used for finance).
* **Reason**: optional, up to **200 characters**, for internal context.

## Create a grant (Stigg app)

1. Go to **Customers → \[Customer] → Credits**, then click **Adjust credits balance**.
2. In **Adjustment type**, select **Grant credits**.
3. Choose **Resource** (credit currency/type).
4. Set **Credit amount**.
5. In **Grant method**, choose one:
   * **Purchase credits**: set **Per unit cost basis** and select a **Payment method**.
   * **Promo/Free granted**: leave cost basis implicit at zero.
6. (Optional) Open **Schedule** to set **Effective date** and/or **Expiry date**.
7. Set **Priority** (remember: lower is higher priority; `0` is highest).
8. (Optional) Add **Reason** (max 200 characters).
9. Review the **Summary** (credits, total, previous/new balance) and click **Grant Credits**.

**Result:** A new grant appears in **Grants**; the **Ledger** records a **Grant** entry and the pool balance is updated.

## Subtract credits directly (no subscription required)

Direct credit consumption lets you deduct from a customer's credit pool without going through Stigg subscription management — useful when you manage subscriptions yourself and only want Stigg for credit balances, entitlement enforcement, and governance, or when you already have your own credit system and just want to report consumption to Stigg. The customer doesn't need an active subscription or an assigned plan; credits can be granted and subtracted against their pool directly.

1. Go to **Customers → \[Customer] → Credits**, then click **Adjust credits balance**.
2. In **Adjustment type**, select **Subtract credits**.
3. Choose **Resource** (credit currency/type).
4. Under **Subtract details**, set **Credit amount** to deduct.
5. Review the **Summary** (previous balance, credit amount, new balance) and click **Subtract credits**.

**Result:** A confirmation toast ("Credits subtracted successfully") appears. Credits are deducted from the customer's active grant(s) following the standard [burn order](./credits-core-concepts#credit-grant-types) — highest priority, soonest-expiring, promotional before paid. The **Ledger** records a **Usage** entry per grant touched, tagged with source **Direct consumption**, and the pool balance updates immediately, whether or not the customer has a subscription.

For consuming credits from your backend, see [Consume credits](/api-and-sdks/integration/backend/usage-and-billing#consume-credits-directly) in the SDK reference — the SDK methods are named `consumeCredits` / `consumeCreditsAsync`.

## Update a grant (dates, priority, reason)

<Note>
  Updating an existing grant is not currently supported via the Stigg app or the API. To change a grant's effective date, expiry, priority, or reason, revoke the existing grant and create a new one with the desired settings.
</Note>

## Revoke a grant

Void a grant (or its remainder) to remove credits due to refunds, fraud, or policy changes.

1. In **Customers → \[Customer] → Credits → Grants**, open **⋯** and choose **Revoke**.
2. Confirm the revocation and provide a **Reason**.

**Result:** The grant becomes unavailable; the **Ledger** records a **Revocation** entry and the pool balance is adjusted accordingly.

## Create or revoke grants via API

You can perform the same actions programmatically (create paid or promotional grants, or revoke). Use your server-side integration to:

* Issue **paid** grants after a successful charge or when an invoice is issued.
* Issue **promo** grants during onboarding.
* **Revoke** after refunds.

<Note>
  Updating an existing grant via the API is not currently supported. To modify a grant, revoke it and create a new one with the updated values.
</Note>

Refer to the API reference for request fields that mirror the UI: **currency/type**, **amount**, **cost basis**, **effectiveAt**, **expireAt**, **priority**, **reason**.

## Audit and troubleshoot

* **Ledger** shows each change with **Type**, **Delta**, **End balance**, **Actor**, **Reason**.
* **Grants** lists lifecycle and remaining vs. original amounts.
* If a change isn’t visible, refresh the customer’s **Credits** tab and verify you edited the correct **credit type**.