Skip to main content
The Customer Portal is a hosted, self-service page where your customers can manage everything related to their relationship with your business — without having to email your support team.

​
What customers can do

From the Customer Portal, your customers can:
  • View their active subscriptions and past purchase history
  • Download and edit invoices (e.g. add a company name, VAT number, or billing address)
  • Access benefits they’re entitled to — license keys, file downloads, Discord access, etc.
  • Cancel active subscriptions on their own
  • Update their default payment method — the primary way for customers to recover from failed payments
  • Optionally, change their email address, switch subscription plans, manage seats, and view metered usage (see Settings)

​
Why it matters

The Customer Portal isn’t just a convenience feature — it’s a critical piece of your billing stack:
  • Failed payment recovery. When a subscription renewal fails, the portal is where customers update their card so they don’t lose access. Because Polar is PCI-compliant, you never have to handle card details yourself.
  • Self-service cancellations. Some jurisdictions (notably California under the Automatic Renewal Law) legally require customers to be able to cancel a subscription the same way they signed up. The Customer Portal satisfies that requirement out of the box.
  • Invoice access. Customers can always retrieve and edit their invoices for bookkeeping and tax purposes, without pulling you into a support thread.

​
Next steps

Navigate customers to the portal

Use the default portal URL, generate authenticated links, or rely on the emails Polar already sends.

Customer portal settings

Configure what your customers can do from the portal under Settings → Billing → Customer portal.

Customer Portal API

Build your own portal experience on top of the Customer Portal API.

​
FAQ

No. The Customer Portal is always available for your customers, and it can’t be turned off.This is a deliberate design decision. The portal is how we guarantee that your customers can always:
  • Access their invoices, which they often need for tax and bookkeeping reasons.
  • Cancel their subscriptions on their own, which is legally required in some jurisdictions (for example California’s Automatic Renewal Law, which requires that customers be able to cancel the same way they signed up).
  • Update their payment method in a PCI-compliant way, so they can recover from failed renewals without you having to handle card details.
You can, however, fine-tune what customers can do from the portal — for example, disabling subscription plan changes or email edits.
Not the hosted portal at polar.sh/<your-org-slug>/portal — it’s intentionally consistent across all Polar organizations.If you need a branded experience, you can build your own portal on top of the Customer Portal API, which covers the day-to-day actions: viewing subscriptions and orders, downloading invoices, managing benefits and seats, and reading meter usage.
Not every action is exposed through the Customer Portal API. Most notably, updating a default payment method is only available from the hosted Customer Portal — this is what keeps you PCI-compliant, since card details never touch your servers. Customers you send into a custom portal will still need the hosted one to recover from failed payments.
By default, customers authenticate with the email address they used to purchase or subscribe — Polar emails them a one-time code to confirm.You can also skip the email step entirely by generating a pre-authenticated link from your own application. See Navigate customers to the portal for details.
The customer receives an email from Polar letting them know, with a link to the Customer Portal where they can update their default payment method. Once they do, Polar automatically retries the charge.This self-service flow is the primary way customers recover from failed renewals — keep it in mind when you’re thinking about churn.