Skip to main content

Customer Portal

In JetShip's Next.js implementation, when users access the Customer Portal, they are redirected to the payment provider's customer portal (either Stripe or Lemon Squeezy) based on their initial payment provider choice. This portal enables users to manage their subscriptions and billing details directly through the payment provider's interface.

🎯 Key Points​

Subscription Plan Management​

  • Users can upgrade, downgrade, or change their subscription plans directly within the payment provider’s customer portal. This gives them full control over their subscription, including modifying payment methods, updating billing information, and reviewing invoices.

For example, a user can easily upgrade from a Basic subscription to a Pro subscription directly through Stripe or Lemon Squeezy's portal.

One-Off Purchases​

⚠️ Important Note: In the case of one-off purchases, upgrading or changing plans is not supported by payment providers like Stripe or LemonSqueezy. This is due to the nature of one-time purchases, which cannot be modified after payment is completed. Once a one-time purchase is made, users cannot switch or upgrade to another plan.

📋 Plan Management Guidelines​

Subscription Plans​

✅ Available Actions:

  • Switch between subscription tiers
  • Change billing frequency (monthly/yearly)
  • Cancel subscription
  • Update payment details
  • Access billing history

One-Time Purchases​

❌ Limitations:

  • Cannot upgrade or modify purchase
  • No plan switching available
  • Changes require new purchases

💡 Pro Tip: When designing your pricing strategy, consider offering subscription-based plans if you want to provide users with flexible upgrade paths.

🛠️ How the Customer Portal Works​

User Flow​

  1. User Redirection

When users access the Billing section from the User Dashboard, they are redirected to the appropriate customer portal for their chosen payment provider. In this portal, they can:

  • Review their active subscriptions
  • Upgrade or downgrade their subscription plans
  • Update payment methods and billing information
  • View billing history and invoices
  1. Automated Updates

Any changes users make in the payment provider's portal, such as upgrading to a higher plan or changing their billing details, are automatically reflected in your JetShip application.

Billing Page Example​

Here's an example of the Billing section works in the User Dashboard:

Customer Portal

From here, users can access the Customer Portal for further management.

In the portal, users can manage their subscriptions, view their payment history, and update personal and billing details.

📝 Conclusion​

  • Subscription Management: Users can easily manage subscriptions (upgrades, downgrades, cancellations) via the payment provider's customer portal.
  • One-Time Purchases: Users cannot upgrade or modify one-time purchases after payment is made.

By integrating Stripe or LemonSqueezy’s customer portals, JetShip offers users a seamless way to manage their payments while adhering to the limitations of each payment provider.