Skip to main content

Billing & paywall — Regression Test

Prerequisites​

  • To reach trial-ended / paywall states quickly, use the QA short-trial links (1-min / 5-min trials) described in Test the trial-ended experience. To reach a usage-quota paywall fast in a non-prod build, open Settings → QA: under Entitlements (QA) set Plan to Basic and click Apply, then under Seed usage near limit pick the feature you want to test (meetings captured, voice memos, note AI suggestions, etc.) and click Set count to limit - 2 — this puts you two actions below the cap. (Limits only enforce when Entitlements (QA) shows enforcement=true — it is gated per environment, so a local dev backend may have it off.)
  • Use Stripe test cards for the checkout steps.

Steps​

Changed in 5.0.0. A new signup starts on Free — there is no automatic trial any more. The free month is claimed with a card, and paywalls close only via the X (the "Not now" link is gone). Steps 1–4 are new; run them on a brand-new account.

  1. Sign up as a brand-new account and let the workspace paint. You do not need a new Google address — reset the one you have with the four steps in First run to first payment, and use a private window if you are testing the web app.
    • The sidebar card reads Basic Plan — no trial label and no countdown
    • A full-screen welcome offer appears a beat after home paints, offering a free month
    • Dismissing it with the X leaves the app usable, and relaunching does not ask again on this machine
  2. Re-open the offer with the Start your trial for $0 button on the Basic Plan card.
    • The offer is still available — dismissing never withdraws it
    • The badge, the call to action and the timeline all say the same number of free days (30 by default — the count is now a server-configured value and a trial-duration experiment can change it, so check that all three agree with each other rather than assuming 30), and the timeline names the date the plan begins
  3. Take the claim and complete it with a Stripe test card.
    • The payment pane says $0 today and names the first charge date, matching the timeline
    • After payment approval, Starting your trial appears while Premium is being prepared; wait for completion rather than submitting payment again (PR #1476)
    • A success/celebration state lands and the Basic Plan card disappears — a trialing subscription is premium-granting, so the pill hides rather than relabelling. Confirm Premium in Settings → Plans and Billing
    • Stripe dashboard: one subscription in trialing, an initial invoice of 0, and the first paid invoice due after the number of free days the offer showed in step 2
    • Relaunching shows no further offer — no welcome ask, no popup, no CTA pill
  4. On a separate Free account, open Settings → Usage.
    • Rows read Meetings, Dictation, Voice memos, Mono, History
    • Counts match what you have used, and renewal dates are your local calendar day
  5. On an account with an active trial (claimed above, or a QA short-trial link), look at the sidebar card.
    • It shows the plan name with a "· Trial" label and days-remaining
    • An Upgrade action is present
  6. Trigger a quota limit on Basic (e.g. exceed the monthly meeting limit, or hit the voice-memo / AI-suggestion limit — seed it via Settings → QA → Seed usage near limit as above, then perform a couple more actions to cross the cap).
    • A paywall modal appears with a feature-specific title and value prop
    • It closes only via the X — there is no "Not now" link, and the action stays blocked
  7. From the paywall (or Settings → Plans and Billing), click View plans / Upgrade.
    • The Basic (Free) and Premium ($14/month) plan cards are shown (Member is a gifted tier, not a purchasable card), with an Upgrade to Premium action
  8. Start the upgrade and complete Stripe checkout with a test card.
    • The "Secure checkout" flow processes, then a "You're Premium now" success dialog shows
    • After closing, the sidebar no longer offers an upgrade, and the premium-success banner appears
  9. (Premium) Open Settings → Plans and Billing and click Manage subscription.
    • The Stripe billing portal opens in the browser
    • The renewal date / next charge is shown

Variations​

  1. Let a 1-minute QA trial expire, then try a Premium-gated action.
  • The trial badge clears and the paywall blocks the gated feature
  1. (Free tier) Open a meeting note older than 30 days. (Seed one in a non-prod build via Settings → QA → Seed backdated note; see the Notes management regression test for the full QA setup, including the enforcement=true requirement.)
  • The note is locked with an "Unlock all notes" prompt
  1. On desktop, complete a Stripe checkout but interrupt connectivity right after paying, before the app confirms it (e.g. disconnect the network for a few seconds during the return from checkout).

    • A failure toast with a Retry button appears, instead of the account being silently left unconfirmed
    • Retry completes the confirmation once connectivity returns, and the account lands on Premium
  2. Repeat step 12 (interrupt connectivity right after paying, before confirmation lands), but instead of retrying, switch the free-month claim offer's plan-interval toggle (yearly ↔ monthly) and try to claim again before the first attempt confirms.

    • An error banner reads "You already have a checkout open for your free days…" before the app asks for card details again — the app recognizes the still-open checkout instead of starting a second one
  3. On the mobile app, look at the status chip in the top strip that is visible on every main tab (not just Settings).

    • On a Free account it reads a trial/upgrade state matching the sidebar card's desktop equivalent (e.g. days-remaining while trialing, an upgrade prompt once the trial ends)
    • On a Premium account it shows a Premium/crown state instead
    • Tapping it opens the offer sheet (Free) or Plans and Billing (Premium) — not a dead tap
    • It is present and correct on every main tab, not only the tab you started on
  4. On staging web with PR #1220, enable the browser's page translation before opening the free-month offer. Complete the claim with a Stripe test card.

    • The translated purchase button remains usable; the app does not crash
    • The claim completes and Premium is shown in Settings → Plans and Billing

Trial billing interval (PR #1300)​

Use two fresh test accounts and staging Stripe test cards. Run on the Nova entitlement path; record the environment/mode. This is a web/desktop claim check, not a native store purchase.

  1. Choose the yearly offer and complete the free-month claim, then open Settings → Plans and Billing.
    • The plan shows Premium and Yearly during the trial
  2. Restart and open a second signed-in client.
    • Premium and the yearly interval persist
  3. Repeat on the other fresh account with the monthly offer.
    • The plan shows Premium and Monthly; it does not inherit Yearly

Browser-translated mobile plan indicator (PR #1594)​

  1. In phone Safari, open the signed-in web app on a Basic test account. Use the browser's page translation, then tap the plan indicator.
    • The offer opens without crashing the app
  2. Dismiss the offer, navigate away and back, then tap the translated indicator again.
    • The indicator still opens the offer; restoring the original page language also works