View as Markdown

Subscriber Experience

Checkout

Visitors choose a price, sign in or enter their email, and pay through Stripe. Apple Pay and Google Pay appear where supported. With expedited checkout, email and payment are collected on one screen.

Access begins after payment is confirmed, or when a free trial starts. Reveal content only when hasAccess(...) or hasPurchased(...) returns decision: "allowed". Check on page load and after access:change.

Guests can optionally create an account after checkout to sign in faster next time. See Guest Checkout. To test the flow before launch, see Testing with Test Mode.

Checkout Inside the Page

mountCheckout displays checkout inside your page. Visitors who already have access see an eligible upgrade or You already have access.

Confirmation stays on the page after a purchase or upgrade. Pass successUrl to provide a Continue link; checkout does not navigate automatically. See Mount Checkout in Your Page.

Upgrades

Offer upgrades through showPaywall({ product }), openCheckout({ price }), or mountCheckout({ target, price }). Eligible subscribers change their existing subscription instead of buying a second one. They can choose a higher price on the same product, such as monthly to annual, or move to another product.

Checkout shows the new plan, unused-time credit, amount due today, and next renewal date. Stripe calculates the new plan's full first billing period minus unused-time credit, adjusted for any account balance. The renewal date resets when the upgrade takes effect; the next renewal is one full billing period later.

Paying for an Upgrade

Subscribers can use their saved card or choose Change to enter a new card or use Apple Pay or Google Pay where supported. Authorizing a wallet payment confirms the upgrade. Apple Pay requires fresh authorization for a charge.

A payment method added during an upgrade becomes that subscription's renewal method, even if the upgrade does not complete.

After Payment

Access switches to the new product only when the upgrade completes. If payment fails or verification is abandoned, the current plan or trial continues on its original schedule.

Account credit reduces the amount collected. Any remaining credit applies to future payments. Amounts below Stripe's minimum charge may also carry forward to a future invoice.

Upgrading during a free trial ends the trial when the upgrade completes. The subscriber pays the new plan's full price, less account credit, with no credit for unused trial time. The new plan does not grant another trial.

Subscribers receive an upgrade confirmation email. For local-currency payments, checkout shows an approximate local amount; Stripe sets the final conversion when charging.

When Upgrades Are Offered

  • The new price must use the subscription's currency.
  • For the same or a longer billing period, the new price's billing-period amount must be higher.
  • A shorter billing period is allowed only on a different product with a higher monthly rate. For example, $9.99/year to another product's $4.97/month qualifies; annual to monthly on the same product does not.
  • Upgrades are unavailable with a pending cancellation, outstanding renewal payment, applied discount, or a trial started with a promo code. A price already held on another subscription is also excluded.

showPaywall can offer an upgrade even when the subscriber already has access. To avoid showing offers on every page load, use an upgrade button. Subscribers can dismiss the offer without losing access.

Upgrading to another product moves access to that product. If Premium should include Basic content, allow access when either hasAccess("basic") or hasAccess("premium") returns decision: "allowed".

Free Trials

A price with a free trial requires a payment method and grants access immediately. Billing starts when the trial ends unless the subscriber cancels first.

Returning Subscribers

Add a login link using ezsubscriptions.login() or data-ezoic-login. Signing in restores access on your site. Subscribers can also request a single-use email access link, valid for 15 minutes. See Add a Log In Link.

Subscriber Portal

At subscriber.ezoic.com, subscribers can view subscriptions, purchases, invoices, and receipts; cancel or reactivate subscriptions; and manage payment methods across publisher sites.

Add a Manage subscription link with ezsubscriptions.openAccountPortal(). Upgrades are offered through publisher checkout.

Cancellations

Cancellation takes effect at the end of the current billing period. Subscribers keep access until then and can reactivate before it ends. Canceling during a trial prevents its first charge.

Payment Methods

Subscribers can update payment methods in the portal. Before removing a card used by an active subscription, they must select another payment method or cancel that subscription.

What Publishers Should Tell Subscribers

Direct billing questions to the subscriber portal. To restore content access on a new device, subscribers must sign in on your site; signing in to the portal alone does not unlock content.