Two models, four differences
| Time-limited trial | Freemium | |
|---|---|---|
| What users get | The full app for N days | A limited app, with no end date |
| What ends it | The calendar | The user, when they hit a limit and pay |
| Needs a license key | Usually yes, so the server owns the end date | No. The app checks for a paid key and gates features without one |
| Where the state lives | On a server: a license expiry or a Stripe subscription | In the app: which features are switched on |
The rest of the article is about what that means in practice. The conversion rates below are assumptions for arithmetic, not statistics. Nobody can tell you your rates until you have measured them.
Four ways to build a trial
| Method | State lives | Resettable by reinstalling | Cost to you |
|---|---|---|---|
| In-app timer from install date | The user’s machine | Yes | Nothing |
| Trial license with a server-owned expiry | License server | No | One active license until it expires |
| Stripe subscription with a trial period | Stripe | No | A Checkout and a subscription per trial |
| Paid purchase with a refund window | Stripe | Not applicable | Refund handling |
An in-app timer
The app writes the install date to a file or the registry and counts days. It is simple and it is the easiest to defeat: delete the file, reinstall, or set the clock back. It is a fair choice when trial abuse costs you little and you do not want an account system.
A trial license with a server-owned expiry
Create a license with a short expiry when someone asks for a trial. The server evaluates expiry whenever the license is read, so changing the clock on the machine does not extend it. With Clavem, the management API creates a license with an expires_at and a device limit, and the response includes the key to send by email.
curl https://clavem.io/v1/admin/licenses \
-H "Authorization: Bearer sk_clavem_…" \
-H "Content-Type: application/json" \
-d '{"product_id": 1, "email": "ada@example.com", "name": "Ada",
"activation_limit": 1, "expires_at": "2026-12-03T00:00:00Z"}'
This request is documented in the API reference; it is shown here as written and was not sent to production. The license starts as inactive and moves to active on the first activation. The expiry is a fixed date, so the trial runs from the day you set it, not from first launch. Create the license at the moment you send the key. After expires_at, validation answers HTTP 200 with valid: false and a token whose own valid is also false. That is a signed statement your app can verify offline.
Extending a trial is one change to expires_at through PATCH /v1/admin/licenses/:id. Moving it into the future revives an expired license. Because an expired license does not count toward the plan, a thousand lapsed trials cost nothing. Trials that are still running do count while they are not expired. Manual creation also pauses if you pass the plan limit, so a trial form built on this should handle the 402 plan_limit response.
A Stripe subscription with a trial period
Stripe has two paths, and the docs now point new builds to one of them.
- Trial offers are the newer Trial Offer API, which needs API version 2026-09-30.endive or later and flexible billing mode. Stripe’s docs list limits: not Payment Links, not pricing tables, and Checkout only for invited accounts in a private preview.
- Free trial periods are the legacy path:
trial_period_daysortrial_endon a subscription, andsubscription_data.trial_period_dayson a Checkout Session. A trial can last up to 730 days.
By default a Checkout Session collects a payment method before the trial. To skip it, pass payment_method_collection=if_required, and choose what happens at the end with trial_settings.end_behavior.missing_payment_method: cancel, pause or create_invoice. Stripe sends customer.subscription.trial_will_end a few days before the trial ends, which is your cue to ask for a card. When the trial ends, Stripe creates an invoice and tries to charge it about an hour later.
For a license, the event flow matters. Clavem issues a license when a Checkout Session is paid or needed no payment, so a card-less trial still gets a key. A subscription in trialing keeps the license valid, as active and past_due do. If a card-less trial ends without a payment method and the subscription is cancelled, customer.subscription.deleted expires the license. Before shipping, run one test-mode trial and read the expires_at the license receives, because the docs describe expiry in terms of paid periods.
Where trials get reset
| Trick | What it defeats | What helps |
|---|---|---|
| Reinstall or delete app data | In-app timer | A server-owned expiry |
| Move the system clock back | In-app timer | Online validation at launch; store the highest iat seen |
| New email address | One trial per email | Nothing technical. Add a card requirement if abuse hurts |
| Share one trial key | Several people on one trial | A device limit of 1 |
| Same device, new key | One trial per device | Your own record of fingerprints |
Clavem’s fingerprint field returns the same seat when the same device activates the same license again. It does not link different licenses. If you want one trial per device, keep a table of hashed fingerprints on your side, and decide what to do with hardware that changes. Machine fingerprinting pitfalls covers those cases.
Decide how much abuse you will tolerate. Every extra check adds friction for honest users, and a trial that is hard to start converts fewer people. Stopping piracy without annoying customers takes the same view.
Freemium: no key, and the plan arithmetic
Freemium users never need to touch the License API. The app runs with the free feature set until a paid key is entered, so free users create no license, no activation and no cost on the license side.
The alternative is to give every free user a key so you can track them. On Clavem, a license that is not revoked or expired counts toward the plan. The Free plan covers 50 active licenses, Indie 1,000, Studio 10,000 and Scale 50,000.
| Free users with keys | Plan needed | Monthly price |
|---|---|---|
| 40 | Free | $0 |
| 500 | Indie | $29 |
| 5,000 | Studio | $79 |
| 25,000 | Scale | $199 |
Collect free users’ emails with your own newsletter tool instead. Keep keys for people who pay or who are in a time-limited trial.
Conversion math, with made-up rates
Assume 1,000 new downloads a month and a $49 price. Assume a card-less trial converts 3% of those downloads, and a freemium tier converts 1%. Both rates are placeholders.
| Model | Buyers | Gross | After Stripe fees (2.9% + 30 cents) |
|---|---|---|---|
| Trial, 3% | 30 | $1,470 | $1,418 |
| Freemium, 1% | 10 | $490 | $473 |
| Freemium, 0.5% | 5 | $245 | $236 |
The comparison is a ratio. At these rates the free tier needs three times the downloads, or three times the conversion rate, to match the trial. Freemium can win if the free tier spreads the app by word of mouth and brings in users a trial would not. You can only know that by measuring downloads and upgrades on your own product.
Which model fits which product
| Product | Leans toward | Reason |
|---|---|---|
| Utility used once in a while | Freemium, with a clear limit | Value shows in one session, and a 14-day clock runs out unused |
| Tool with a learning curve | Trial of 14 to 30 days | Buyers need time with the whole feature set |
| App with a server cost per user | Trial with a card | A permanent free tier costs you money |
| Developer plugin or library | Freemium, or paid for commercial use | Users compare tools in a project before buying |
| Business software sold to teams | Trial, extended on request | Approval takes longer than 14 days |
Doing this with Clavem
Clavem supports trials three ways: a license with a short expires_at from the management API or dashboard, a Stripe subscription trial that its webhook follows, or a Free plan of 50 licenses to test your flow. It does not run a hosted checkout and cannot start a trial for you; your site or Stripe Payment Link does that. Extending a trial is a single change to expiry, which the MCP server, now being added, is meant to offer to assistants that manage licenses. For more on what a valid answer looks like when a trial ends, read offline license checks explained.
Questions
Should free users get a license key?
Usually not. A key is only needed to prove a purchase or a trial. If you issue keys to free users, each one that is not revoked or expired counts toward your plan's active license limit, so a large free audience pushes you into a bigger plan.
How do I stop people resetting a trial?
Do not keep the start date only on the machine. Give the trial an expiry that the server owns, require a verified email, and cap the trial license at one device. You cannot stop every determined user, and a strict rule costs honest users friction.
Does a Stripe subscription trial issue a license?
With Clavem, yes. A Checkout Session that needs no payment still issues the license, and a subscription in trialing status keeps it valid. When the subscription is cancelled or unpaid, the license expires.