Credits & cost preflight

Every test run goes through a credit and subscription check before any step executes. Its outcome can stop the run from starting.

What the check does

If everything is fine, the run continues normally. Otherwise the run is marked as a hard failure before any step executes, and Mavster surfaces an alert that links you to the right place to fix it.

The blocking outcomes:

Insufficient credits

Your account is out of credits. The test doesn't run; an alert appears with a link to top up in the web app.

Subscription required

Your subscription is inactive. The test doesn't run; an alert appears with a link to reactivate or pick a plan.

Credits require an active subscription to spend — even if your balance is positive. If you cancel, your remaining credits stay visible in the app and the web billing page, but Mavster will block test runs with this same "subscription required" alert until you resubscribe. Your balance is preserved (not zeroed out) and becomes spendable again the moment your subscription is active.

During and after the run

Billing is enforced as the test runs, not just at the start. If you exhaust your credits mid-run, you'll see an alert at that point too — same message as the pre-run check, same path to top up.

What costs credits

Credit usage tracks the work Mavster does on your behalf:

• Resolving Tap, Visual Assert, and similar interactions.
• Screen segmentation (suppressed by None and reduced by cache hits on Auto).
• Memory hits — much cheaper than from-scratch resolution, but not zero.
• Self-healing recovery rounds.

Cost is per-test and per-project — review it in the web app analytics. The most direct levers are documented in the Cost-saving playbook.

Topping up

Top-ups happen in the web app's billing page. The macOS app links there from the alert presented by the check.

Monthly credit cap

To keep balances bounded, your monthly subscription credits pause when your balance reaches 1.5× your plan's monthly allotment.

• If your balance is already at the cap, the next monthly grant is skipped (or partially granted, just enough to bring you to the cap).
• The cap follows your plan: Basic 4,500 (3,000 × 1.5), Pro 30,000 (20,000 × 1.5), Ultra 90,000 (60,000 × 1.5).
• Top-up credits don't expire and aren't separately capped — but because they share the same balance, a large top-up can pause your next monthly grant until you've used down to the cap.

Granting resumes automatically on the next renewal once your balance is back below the cap.