Reset Passes

Halfbill Code plans include a weekly fair-use allowance for premium models. A Reset Pass restores that full allowance the moment you redeem it — no waiting for the rolling 7-day window — and a fresh window starts with your next premium request. The pass card lives on the Halfbill Code dashboard directly under the premium allowance meter, styled as a stamped visa extension: each pass you hold appears as a stamp.

Included and purchased passes

Two kinds of stamps appear on the card:

• Included passes come with Code Pro and Code Max. They refresh every billing cycle, don't roll over, and are always consumed before purchased passes.
• Purchased passes are one-time purchases at the tier's price, bound to the tier they were bought for — a pass purchased on Code Pro is redeemable while you're on Code Pro. They never expire, so an unused pass applies again whenever you're back on that tier, even after a cancelled plan.

Redeeming a pass

Click Use a pass on the card. Your premium usage for the week is zeroed immediately and the 7-day window restarts with your next premium request. Redemption is deliberately explicit — a pass is never consumed automatically, and it is rejected while your allowance is untouched. Once you've used more than 90% of your monthly credit allowance, the dashboard also asks you to confirm: a reset restores the weekly cap, but only the remaining monthly allowance is available to spend. Once the monthly allowance is fully used, Reset Passes cannot be redeemed.

Standard models are unaffected either way: they never count against the weekly cap.

Renewal and the weekly window

Nothing about the weekly allowance carries over between billing cycles — every monthly renewal starts you completely fresh, all at once:

• The weekly premium allowance resets in full. Renewal zeroes your premium usage and starts a new 7-day window at the renewal moment, alongside the monthly credit reset. You never begin a cycle mid-window or with a partially used allowance.
• Included passes replenish. Code Pro's 1 and Code Max's 2 included passes are restored every cycle; unused ones don't roll over. Purchased passes are unaffected — they persist until redeemed.

An immediate tier upgrade restarts your billing cycle and performs the same full reset.

Between renewals the window is rolling, not on a fixed schedule. When a 7-day window ends, the next one starts with your next premium request — and a redeemed pass clears the window entirely, so your next premium request starts a fresh 7 days. There is no weekly reset schedule that redeeming late (or early) can shift into the next cycle.

In practice, a 30-day cycle of steady premium usage fits about five weekly windows (starting around days 0, 7, 14, 21, and 28) before any passes. On Code Max, whose weekly cap is 18% of the monthly allowance, those five windows plus a single included pass already unlock more than the entire monthly credit pool — so even spending exclusively on premium models needs no front-loaded pass redemptions or timing strategy. Redeem when you actually hit the cap.

If you hit the cap from a coding agent, the API's 402 response points here:

{
	"error": {
		"message": "You've used your weekly allowance for premium-tier models on the pro plan. Redeem a Reset Pass from your dashboard for an instant reset, upgrade for a higher allowance, or use any standard model now. Resets in 6 days.",
		"type": "invalid_request_error",
		"code": "billing_error"
	}
}

Buying and billing

Buy a pass shows a confirmation dialog, then charges the payment method saved on your Halfbill Code subscription — no checkout redirect, no subscription change, no proration. Each purchase emails a PDF invoice and appears in the Halfbill Code billing history alongside plan charges. Purchases are paused once you've used more than 95% of your monthly credit allowance — a pass would give you almost nothing to use at that point — and open up again when your credits renew.

An unused pass can be returned: for 7 days after purchase, a purchased pass that hasn't been redeemed can be self-refunded from the billing history. The refund goes back to your payment method, the pass is removed from your passport, and your Halfbill Code plan itself is unaffected.