Reading starts here
ChurnAtlas

Check portal rules on 4 billing tools before sharing

Short answer. See the session window, plan cap, and cancel rule for Stripe, Paddle, Recurly, and Zoho Billing before you share a self-serve portal link with a customer.

ChurnAtlas Editorial Team. Written by an AI model on local hardware. Nobody edits or reviews it by hand.

Published · Sources checked · 11 min read

  1. Inputs Your product plan, your permissions and the task you want to finish.
  2. Decision Whether the help page matches what you see on your screen.
  3. Next action Do the task on one test account, then record what you changed.

New portal sessions expire after a 5 minute period, according to Stripe.

Before sending a self-serve billing link, verify the session duration and activity limits that apply to the specific platform. For Stripe, the documentation states that new portal sessions expire after a 5 minute period, according to Stripe. If a customer uses it within that time period, the session expires within 1 hour of the most recent activity, according to Stripe. These rules define how long a customer has to complete their billing actions before the link becomes invalid.

Key Takeaways on portal links

  • Confirm the initial session window for your billing provider.
  • Note the activity-based expiration time for active sessions.
  • Identify whether the platform uses magic links or standard login.
  • Check if the portal allows immediate cancellation or period-end cancellation.
  • Verify the maximum number of products displayed in plan switches.

Understanding these parameters helps you set correct expectations with customers. A customer success manager should know whether a link is a one-time use method or a persistent access method. The 5 minute and 1 hour lines are specific to Stripe's session rules on that page. Other platforms may have different windows for session validity or activity timeouts. Always check the specific documentation for the tool you are using.

When you prepare to send a link, confirm the current state of the customer's account. Ensure the customer has the necessary permissions to view or modify their billing details. Some portals require additional authentication steps, such as a magic link, which changes the user experience. The session rules determine how long the customer has to act. If the session expires, the customer must request a new link. This can cause friction if not communicated clearly.

Filled reference table of portal rules, one row for each publisher

The table below lists the session, access, and cancellation rules documented for four billing platforms. Each row cites the specific documentation page where that rule appears.

Publisher Session or Access Rule Plan or Product Limit Cancel Switch or Window
Stripe New portal sessions expire after a 5 minute period, and if a customer uses it within that time period, the session expires within 1 hour of the most recent activity according to Stripe. When you allow customers to switch plans, you can specify a maximum of 10 products for them to choose from according to Stripe. Cancel subscriptions immediately or at the end of the current billing period according to Stripe.
Paddle No session rule is stated on the cancellation page. No product limit is stated on the cancellation page. You can't cancel or pause a subscription within 30 minutes of its next billing date according to Paddle.
Recurly Two settings control how customers access Hosted Account Management according to Recurly. No product limit is stated on the access page. No cancel window is stated on the access page.
Zoho No session rule is stated on the subscription management page. No product limit is stated on the subscription management page. You can choose to allow the customers to cancel the subscription either immediately or on the next renewal using the checkboxes provided according to Zoho.

The Stripe row includes both the initial 5-minute expiry and the 1-hour activity-based expiry because both appear on the same documentation page. The 10-product limit applies specifically to the plan-switching feature, not to every product in the catalog. The Paddle row isolates the 30-minute restriction because that is the only cancellation rule documented on the cited page. The Recurly row names both access settings: Account Login unlocks the full Hosted Account Management portal, and Guest View Only displays limited customer details without requiring account registration. The Zoho row describes the administrator's ability to toggle cancellation timing with checkboxes.

Verify your own dashboard settings against these documented baselines. If you use Stripe, new portal sessions expire after 5 minutes, and the only related setting is the plan-switch list, which can include at most 10 products. If you use Paddle, be aware of the 30-minute blackout period before billing. If you use Recurly, locate the two settings that control access to Hosted Account Management. If you use Zoho, decide whether to enable immediate cancellation or next-renewal cancellation with the provided checkboxes.

The table reports only what each named source says about its own product. It does not infer behavior beyond the written text. For instance, it does not state that Stripe sessions are the only ones that expire in 5 minutes, nor does it state that Paddle is the only platform with a 30-minute cancel window. It simply reports the specific constraints documented on the cited pages.

Before sharing a link, cross-reference these documented rules with your internal policies. If your policy requires customers to be able to cancel immediately, verify that your platform supports this and that it is enabled. If your policy requires a longer session for customers to complete actions, verify that the documented session limit aligns with your needs. The table provides the baseline facts to start this verification process.

Stripe's 5 minute session, 1 hour activity, and 10 product cap

Before sending a customer a self-serve billing link, verify the specific session and plan rules printed on the provider's documentation page. For the "Provide a customer portal to your customers" feature, the documentation states that new portal sessions expire after a 5 minute period according to Stripe. This initial window applies only if the customer does not interact with the portal during that time. If a customer uses the portal within that initial 5 minute window, the session expires within 1 hour of the most recent activity according to Stripe. This 1 hour activity timer resets with each new interaction, extending the session as long as the customer remains active.

When configuring the portal to allow customers to switch plans, you can specify a maximum of 10 products for them to choose from according to Stripe. This 10 product limit applies specifically to the plan switching feature within this portal configuration. It is not a general cap for every portal or every billing tool. Check your own portal settings to confirm whether you have enabled plan switching and how many products you have listed. If you list more than 10 products for plan switching, the documentation specifies a maximum of 10, so you must curate the list to fit this limit.

Write down the exact session expiration times for your specific portal configuration. An unused new portal session expires after 5 minutes; if the customer uses it in that window, the session expires within 1 hour of the most recent activity. Record the activity-based expiration time if your portal supports it. List the number of products you have enabled for plan switching. Compare these numbers against the 5 minute, 1 hour, and 10 product figures cited from the Stripe documentation. If your portal differs, note the difference in your internal checklist. This ensures you know exactly what the customer will experience when they open the link. Do not assume the 5 minute or 1 hour rules apply to other providers. Each provider prints its own session and plan rules on its documentation pages.

The customer portal is on by default in the Paddle Developer Docs, which instructs you to link to it from your app and optionally generate authenticated sessions so customers don't need to sign in again, according to Paddle. This setup means the portal is accessible without additional configuration steps on your part, provided you follow the documented linking practice. When a customer clicks the link, they authenticate with a magic link sent to their email, and there is no username/password to manage, according to Paddle. This login method removes the burden of credential management for both the customer and your support team, as no password reset workflows are required for portal access.

Before sending a customer a self-serve billing link, verify the timing constraints around subscription changes. You can't cancel or pause a subscription within 30 minutes of its next billing date, according to Paddle. This 30-minute window is a hard limit on when a customer can execute a cancel or pause action through the system. This rule applies specifically to the cancel and pause actions described on the subscription cancellation page, not to other portal features.

To prepare for sending a portal link, confirm that your application correctly generates the authenticated session or relies on the magic link flow as described in the developer documentation. Ensure your customer communication examples do not promise immediate cancellation capabilities without noting the 30-minute restriction near the billing date. Tell customers to cancel or pause before the 30 minutes prior to the next billing date. This preparation step helps set accurate expectations and reduces support tickets related to timing errors during the cancellation process.

Recurly access settings and Zoho portal cancel checkboxes

Two settings control how customers access Hosted Account Management, according to Recurly. The first option is Account Login, which unlocks the full Hosted Account Management portal, according to Recurly. The second option is Guest View Only, which displays limited customer details without requiring account registration, according to Recurly. When you prepare a link for a customer, check which of these two access modes is active in your Hosted Account Management configuration. If you use Account Login, the customer must have an account to see the full portal. If you use Guest View Only, the customer sees limited details without registering.

For Zoho Billing, the cancel behavior is controlled by checkboxes in the settings. You can choose to allow the customers to cancel the subscription either immediately or on the next renewal using the checkboxes provided, according to Zoho. To change this, navigate to Settings > Customer Portal > Subscription Management and enable the Cancel Subscription option using the checkboxes, according to Zoho. The specific path is Settings > Customer Portal > Subscription Management. The action is to enable the Cancel Subscription option. The mechanism is checkboxes. You can select immediate cancellation or cancellation on the next renewal.

Before sending a Zoho Billing portal link, verify which checkbox is enabled. If the immediate cancellation checkbox is on, the customer can stop the subscription right away. If the next renewal checkbox is on, the customer can only cancel effective at the end of the current period. This distinction matters for how you explain the cancel option to the customer before they open the link. If you want the customer to have the option to cancel immediately, ensure the immediate checkbox is selected in the Subscription Management settings. If you prefer to restrict cancellation to the renewal date, select the next renewal checkbox instead.

Blank worksheet: write which cancel switch is on

Before sending a link, verify which cancellation option your billing provider exposes to the customer. The specific rules vary by platform, so you must record the exact behavior for your setup. Stripe documentation states that customers can "Cancel subscriptions immediately or at the end of the current billing period" according to Stripe. Your portal may present two distinct choices rather than a single action. Paddle documentation notes that "For compliance, you must offer a way for customers to cancel their subscriptions, too" according to Paddle. Additionally, Paddle specifies that "When a customer cancels a subscription through the portal, Cancellation Flows automatically launches to attempt to retain them before the cancellation is confirmed" according to Paddle. This automatic flow changes the customer experience from a simple termination to a multi-step process.

Fill in the blanks based on your current configuration settings. This worksheet helps you confirm whether a customer can end their service instantly or if they must wait for the billing cycle to conclude. It also clarifies if a retention sequence triggers automatically when a cancellation is initiated.

Do not assume that every portal behaves the same way. The rules cited above apply specifically to the platforms named in their respective documentation. Your specific implementation may have additional constraints or customizations. For example, you might have disabled immediate cancellation for certain plan types. You might have configured the retention flow to trigger only for specific product categories. Check your own admin panel to see the actual state of these switches.

How long does a new Stripe portal session last?

New Stripe portal sessions expire after 5 minutes, and if the customer uses the portal in that period the session expires within 1 hour of the most recent activity.

How many products can a Stripe plan switch show?

When customers are allowed to switch plans, the maximum you can specify is 10 products.

How does a Paddle customer sign in?

Customers authenticate with a magic link sent to their email, and there is no username/password to manage according to Paddle. This method is used for the customer portal described in the developer docs.

What are Recurly's two access settings?

Account Login unlocks the full Hosted Account Management portal, and Guest View Only displays limited customer details without account registration.

Can a Zoho customer cancel from the portal if the checkbox is off?

If the relevant checkbox is not enabled, the customer cannot perform that specific cancellation action from the portal.

Sources

Limits of this post

This post is general operational information, not legal advice about notice periods or renewal clauses. It does not promise that any method keeps a customer. A review model checked the facts once, and that check can miss errors, so open the sources before you act.