Monthly refills
When credits refill and when they expire. There is no job to schedule: UsageGate refills on its own.
Free plans
- Credits refill every month on the day the user joined. Joined on 12 March? They refill on 12 April, 12 May, and so on.
- The refill happens on the user's first request after that date.
- Unused credits don't carry over: each month starts at the plan's amount. A user who was away for three months gets one month's credits, not three.
Paid plans
- They follow the billing period of the subscription in Stripe (or the
periodEndyou send from another provider). - Each payment sets the plan's full amount until the end of that period.
- At the end of the period, unused credits expire. The next payment refills them. If that payment is late, the user is at zero until it arrives.
Cancellations
The user goes back to your Default free plan and keeps at most what they had left; cancelling never hands credits back. From then on the free plan refills monthly as above.
Balances you set by hand
grant sets one balance directly, for a support top-up or a one-off trial. It doesn't refill. You can give it an expiry date; after that the balance is zero.