Skip to content
Switch from Chargebee in an afternoon →
Glossary

What is a customer portal?

Definition

A customer portal is a self-service page where subscribers manage their own billing: they view invoices, update payment details, and change, pause or cancel their subscription without contacting support.

How a customer portal works

The customer signs in, usually without a password: they enter their email and receive a one-time code or a magic link. The portal shows what they subscribe to, their invoices and receipts, and the payment methods on file.

From there they act on their own account. Typical actions are downloading an invoice, replacing an expiring card, changing plan or quantity with a preview of the prorated cost, applying a coupon, pausing and canceling. You decide which actions are on offer.

Many products embed the portal in their own app, so customers manage billing without leaving it while the billing system does the work behind the scenes.

Worked example

A customer on a $20 monthly plan moves to the $50 plan halfway through the month. The portal shows the cost before they confirm.

Credit for the unused half of the $20 plan
−$10.00
Charge for the remaining half on the $50 plan
$25.00
Due today after confirming
$15.00

If the same customer later starts to cancel, the portal asks why and can offer a pause first.

Why a customer portal matters

Every billing request a customer can handle alone is an email your team never has to answer: a copy of an invoice, a new card, a seat change. Customers get what they need in seconds instead of waiting for a reply.

The portal is also where you keep customers. A card updated before it expires prevents a failed payment, and a cancel flow that asks why and offers a pause is a last chance to keep someone who only needed a break.

Common mistakes

  • Hiding the cancel button Making canceling hard leads to chargebacks and complaints, and consumer rules in some places require it to be as easy as signing up. Make it easy, and ask why.
  • Plan changes without a price A customer who cannot see what an upgrade costs will not click it, or will dispute it later.
  • A portal that does not look like you Customers hesitate to enter card details on a page that does not carry your name and logo.
Questions

Customer portal, answered

What should a subscription customer portal include?

At least invoices and receipts, payment method updates, plan and quantity changes with a price preview, and cancellation. Pausing, coupons and usage views are common additions.

Do customers need a password for the portal?

Not usually. Most portals, yRecurring's included, sign customers in with a one-time code or a magic link sent to their email.

Can I embed the customer portal in my own app?

With yRecurring, yes, from the Grow plan: your app creates a portal session through the API and shows the portal on an allow-listed page of your own.

Start free. Pick a plan when it is working.