Managing Account and Credits
This page explains exactly what credits mean, when they are consumed, and why plan changes can show new plan features before monthly credit totals change.
What A Credit Represents
A credit is consumed when Kvasyr records a new subscription match for your workspace.
- Credits are not charged per scanned block.
- Credits are not charged for unmatched logs.
- Duplicate matches are deduplicated and do not consume additional credits.
This is why a very large backfill range can spend few credits if only a few events actually match your subscription filters.
Backfills And Credits
Backfills scan historical ranges, but charging still follows the same rule:
- 1 matched subscription event = 1 credit consumed
- 0 matches = 0 credits consumed
For example, scanning ~35M blocks and spending 27 credits means Kvasyr found 27 new matching subscription events in that range.
See Backfills for queueing and status behavior.
Why Plan Says Business But Cycle Still Shows 1k
This is expected when a paid plan change happens mid-cycle via billing.
Kvasyr applies plan features and plan identity when Stripe confirms payment
(invoice.paid), but monthly credits reset only on billing-cycle style invoices
(subscription_create, subscription_cycle, or subscription_threshold).
For subscription_update (typical mid-cycle plan switch), Kvasyr keeps your
current cycle credit pool until the next cycle reset.
In practice:
- Plan can show
Businessimmediately. - Credits can still show your old cycle pool (for example
973 / 1000) until the next reset point.
Reset Timing Summary
- Free/non-Stripe users: time-based reset at
credits_reset_at. - Stripe-managed paid users: reset on qualifying Stripe invoice events.
- Mid-cycle Stripe plan updates: usually no immediate credit reset.
How To Verify Your Current State
In Dashboard:
- Open Billing.
- Check Credits reset timestamp.
- Review recent billing events (especially
invoice_paiddetails).
If the latest invoice_paid event has credits_reset_applied: false, the
plan changed without resetting cycle credits yet.
If You Need Immediate Credit Adjustment
- Cloud: contact support for account-level adjustment.
- Self-hosted/admin-managed: use Admin -> Users to grant/debit credits or change plan with a cycle reset.