Clavem

Grace period

A grace period is extra time a license keeps working after something that would normally end it, such as a missed subscription payment or a renewal date that has just passed.

How it works

Cards fail for ordinary reasons: an expired card, a bank block, a limit. A renewal that settles two days late should not lock out a customer who intends to pay. A grace period is the buffer. It trades a little free use for fewer angry emails and fewer wrongly locked screens.

The three windows in a Clavem license

People use “grace period” for three separate mechanisms. They do not stack in a simple way, so keep them apart.

Window Length What it covers
Renewal grace 3 days after the paid period ends Late settlement of a subscription renewal
Stripe retry window Set in your Stripe account The time Stripe keeps retrying a failed payment while the subscription is past_due
Offline window 14 days from the token’s iat, as refresh_by How long a device without a connection trusts its last token

Renewal grace

For a subscription, expires_at is the end of the paid period plus three days. The token carries the same date as exp. An example: a monthly subscription is paid through 1 December. The license is valid until 4 December. If invoice.paid arrives on 2 December, the expiry moves to the end of the next paid period plus three days and the customer never saw an expired state.

Stripe’s retries

Clavem treats active, trialing and past_due subscriptions as valid and keeps the license usable while Stripe retries. As of November 2026, Stripe’s documentation says new accounts have Smart Retries enabled by default, set for up to 8 attempts within 2 weeks, and that you can choose a retry window from 1 week to 2 months or define your own schedule. When Stripe gives up and the status becomes unpaid, canceled, incomplete_expired or paused, the license expires. A payment that succeeds later revives it through the next invoice.paid.

The offline window

This one is about connectivity, not money. A device that validated on 1 December holds a token with refresh_by on 15 December. See offline verification.

Grace period versus expiry

License expiry is the date itself. A grace period moves the date later or defers the lock. In Clavem the three days are already inside expires_at, so a validate call does not return “in grace”. It returns active until the shifted date passes and expired after.

How Clavem handles it

  • The three-day renewal grace and the 14-day window are fixed. The docs describe no seller-facing setting for either.
  • Retry behaviour belongs to Stripe. Adjust it in your Stripe billing settings, and see dunning for how failed-payment recovery works.
  • Perpetual licenses have no payment grace because they have no expiry.
  • Manual licenses and imported ones have no subscription behind them, so Stripe events never change them.

Each event is in connecting Stripe. For policy advice, read grace periods for expired licenses.

Questions

Can I change the three-day grace in Clavem?

The documentation describes no setting for it. It is fixed at three days after the paid period ends.

Is the 14-day offline window a grace period?

Not for payment. It is how long an offline device trusts the last signed answer before it must check again. It exists to protect customers without a connection.

Sources

  1. Stripe documentation, automate payment retries (Smart Retries), checked November 2026