Credit adjustments let you add, update, 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, extend expirations, or remove remaining balances. Every change updates the customer’s credit pool and is written to the ledger for audit.

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.

Update a grant (dates, priority, reason)

Use this to extend a grace period, align expirations with contracts, or change drawdown order.
  1. In Customers → [Customer] → Credits → Grants, open the menu for the target grant and choose Edit.
  2. Update Effective date, Expiry date, Priority, and/or Reason.
  3. Save.
Result: The grant is re-indexed for consumption order; the Ledger records the update for audit.
Changing expiry updates eligibility for consumption immediately and is tracked in the ledger.

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 update grants via API

You can perform the same actions programmatically (create paid or promotional grants, update dates/priority/reason, 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.
  • Update expiry/priority for contract changes.
  • Revoke after refunds.
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.