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)
- Go to Customers → [Customer] → Credits, then click Adjust credits balance.
- In Adjustment type, select Grant credits.
- Choose Resource (credit currency/type).
- Set Credit amount.
- 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.
- (Optional) Open Schedule to set Effective date and/or Expiry date.
- Set Priority (remember: lower is higher priority;
0
is highest). - (Optional) Add Reason (max 200 characters).
- Review the Summary (credits, total, previous/new balance) and click Grant Credits.
Update a grant (dates, priority, reason)
Use this to extend a grace period, align expirations with contracts, or change drawdown order.- In Customers → [Customer] → Credits → Grants, open the ⋯ menu for the target grant and choose Edit.
- Update Effective date, Expiry date, Priority, and/or Reason.
- Save.
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.- In Customers → [Customer] → Credits → Grants, open ⋯ and choose Revoke.
- Confirm the revocation and provide a Reason.
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.
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.