How it works
You choose in the Stripe Dashboard which actions customers may take. Then, when a customer wants to manage billing, your server creates a portal session and redirects them to its url. Stripe’s documentation says a portal session gives a unique, temporary link to the portal, so the link is generated per visit rather than shared.
As of November 2026, the Dashboard settings include:
| Setting | Default |
|---|---|
| Invoice history visible | On |
| Cancel subscription | On, and customers can still renew until the billing period ends |
| Switch plan | Off |
| Update quantities | Off |
| Prorate subscription updates | An option you choose when plan or quantity changes are allowed |
Plan switching is off until you turn it on, so check the settings once before sending customers there.
Example: a card expires
A subscriber’s card expires in March. Stripe’s retries fail and the subscription goes past_due. The subscriber opens your “Manage billing” button, lands in the portal, enters a new card and the next retry succeeds. You wrote no billing screen and received no email. For what the license does in the meantime, see dunning.
Customer portal versus Clavem’s device page
They solve different problems and live in different places.
| Stripe customer portal | Clavem device page | |
|---|---|---|
| Address | Created per visit by your server | /licenses/manage |
| Who signs in | A Stripe customer, through your session | Nobody: the buyer enters a license key |
| Manages | Card, invoices, plan, cancellation | Devices that use the license |
The order page is a third thing: a private page with the license key, the downloads and your activation instructions.
How Clavem handles it
Clavem does not replace the portal and does not provide billing screens. A cancellation in the portal reaches Clavem as a Stripe event. The customer keeps the license until the end of the period they paid for. Stripe then sends customer.subscription.deleted and Clavem expires the license, which comes back if a payment succeeds later through invoice.paid. A new subscription after a cancellation is a new purchase and issues a new license. Plan changes are a Stripe matter; the Clavem docs describe renewals and cancellations, not a plan change moving a license to another product, so test that case in Stripe test mode before you offer plan switching.
Clavem’s own billing runs through the Stripe Billing Portal. Setup details are in Connecting Stripe, and the seller side is covered in Stripe customer portal for software. See also subscription licenses.
Questions
Does the Stripe customer portal manage license keys or devices?
No. It manages billing only. In Clavem, device activations are managed on a separate device page where the buyer enters a license key to see and remove devices.
What happens to a license when a customer cancels in the portal?
With Clavem, the customer keeps the license until the end of the period they paid for. Stripe sends customer.subscription.deleted then, and the license expires.