Customer self-service with a customer portal

Allow your customers to manage their own accounts and subscriptions.

Give your customers self-service options by setting up a customer portal. Configure it entirely in the Dashboard, or use the API to implement advanced features, such as multiple configurations for different customers or for connected accounts.

Automate many of your customer interactions by combining a customer portal with customer communications controlled by Stripe Billing automations.

Create a customer portal

Create a customer portal to enable your customers to self-serve functions such as updating their billing information, payment methods, and subscription status.

View demo

Get started

Set up the customer portal

Use the Dashboard to activate the self-serve customer portal and optionally customize branding and prefill customer email addresses.

Configure the customer portal

Configure settings for the self-serve customer portal in the Dashboard.

Integrate the customer portal

Customize and integrate a customer portal into your application using the Stripe API.

Create deep links to the customer portal

Set up custom links to specific self-service actions by coding customer portal flows.

Add a cancellation page

Allow your customers to cancel their subscriptions in the customer portal. You can optionally collect cancellation reasons and offer coupons to discourage cancellation.

Features

A customer portal allows your customers to self-manage their payment details, invoices, and subscriptions in one place.

Feature	Description
Customer management	Offer your customers a self-serve method to: Update billing information, including their tax IDs Update payment methods Update subscriptions Cancel subscriptions immediately or at the end of the current billing period Pay, download, and view current and past invoices
Cancellation deflection	Reduce churn by offering your customers a coupon when they try to cancel their subscription. Customers who cancel anyway can share why. You can collect those reasons through webhooks or Stripe Sigma.
Interoperability	Use the portal with other Stripe products: Checkout and the embeddable pricing table Payment Links Connect Invoices Billing Stripe Tax
Localization support	Automatically localize the portal based on your customers’ preferred language. To view a localized version of the portal, set your browser’s default language to the language you want to preview. See the full list of supported languages.
Customized branding	Configure the portal to match your branding, including your icon, logo, colors, and business information.
Payment methods	Manage payment methods to make it convenient for your customers to pay you. See the full list of supported payment methods. Read the payment methods guide to learn more.
Invoice-only support	You can use the customer portal for standalone invoices. See Preview invoicing management for details.
Stripe Connect compatibility	The customer portal works with Stripe Connect. If you’re using the customer portal with Stripe Connect, configure the customer portal for the platform instead of a connected account. TODO: find link
Ephemeral sessions	Portal sessions are temporary. New portal sessions expire after a 5 minute period. If a customer uses it within that time period, the session expires within 1 hour of the most recent activity.

Limitations

The customer portal has the following limitations:

Limitations to modifying subscriptions

If a subscription uses any of the following, the customer can cancel it in the portal, but can’t update it:
- Multiple products.
- Usage-based billing.
- Sending invoices for collection. Read more about the collection_method parameter. If you use the Dashboard to create the subscription, you make this selection in the Payment method section.
- Unsupported payment methods.
Customers can’t update or cancel subscriptions that currently have an update scheduled with a subscription schedule.
Customers can only modify subscriptions if the new price has the same tax behavior as the initial price. Additionally, no modifications are allowed if the tax behavior is unspecified, even if the tax behavior of the new price is unspecified. Learn more about the tax_behavior parameter and how it relates to subscriptions.
Customer modifications to a trialing subscription end the free trial and create an invoice for immediate payment.
When you allow customers to switch plans, you can specify a maximum of 10 products for them to choose from.

Technical limitations

If the session allows for payment method management, the portal displays the payment method section, even if the portal doesn’t support the customer’s default payment method. See the list of supported payment methods.
You can’t define multiple Prices with the same product and recurring.interval values. For example, to offer a magazine for a regular price of 4.00 USD per month and a student price of 3.00 USD per month, create a separate student magazine Product version.
You can’t display the customer portal inside an iframe.

Supported payment methods

Payment method	Description	Currencies	Business location	Limitations
ACH Direct Debit (`us_bank_account`)	Stripe users can receive bank transfers directly from customers.	USD	US	None
Amazon Pay (`amazon_pay`)	Amazon Pay is a wallet payment method that lets your customers check out the same way as on Amazon.com.	USD	US	None
AU BECS Debit (`au_becs_debit`)	Bulk Electronic Clearing System (BECS) Direct Debit payments from customers with an Australian bank account.	AUD	AU	None
Boleto (`boleto`)	Boleto is a popular payment method in Brazil where customers pay by using a Boleto voucher with a generated number.	BRL	BR	You must have a Brazilian Stripe account to accept Boleto from your customers.
Cards (`card`)	Cards, including Apple Pay and Google Pay, are one of the most popular ways to pay online, with broad global reach. There are different types of cards and several steps in the process.	Most currencies	Most locations	None
Cash App Pay (`cashapp`)	Cash App is a popular consumer app in the US that allows customers to bank, invest, send, and receive money using their digital wallet.	USD	US	None
Custom (`custom`)	Custom payment methods allow you to extend your payment and billing integrations with payment methods processed outside of Stripe.	Most currencies	Most locations	None
Link (`link`)	Link saves and autofills payment and shipping information for your customers so they don’t need to enter payment details manually.	Most currencies	Most locations	None
NZ BECS Debit (`nz_bank_account`)	Bulk Electronic Clearing System (BECS) Direct Debit payments from customers with a New Zealand bank account.	NZD	NZ	None
PayPal (`paypal`)	PayPal is a payment method that enables customers in any country to pay using their PayPal account.	Most currencies	Europe	Requires approval
Pre-authorized debits (`acss_debit`)	PADs are a low-cost, high volume batch processing network for financial transactions in Canada.	CAD, USD	CA, US	None
SEPA direct debit (`sepa_debit`)	The Single Euro Payments Area (SEPA) is an initiative of the European Union to simplify payments within and across member countries.	EUR	AU, CA, Europe, HK, JP, MX, NZ, SG, US	None
UK BACS Debit (`uk_bacs_debit`)	Bacs Direct Debit is a reusable, delayed notification payment method available to bank account holders from the United Kingdom.	GBP	UK	You must have a UK Stripe account and a UK bank account to accept UK BACS Debit from your customers.

Language support

The customer portal supports the following languages:

Bulgarian (bg)
Chinese Simplified (zh)
Chinese Traditional—Hong Kong (zh-Hant-HK)
Chinese Traditional—Taiwan (zh-Hant-TW)
Croatian (hr)
Czech (cs)
Danish (da)
Dutch (nl)
English, US (en)
English, UK (en-GB)
Estonian (et)
Filipino (fil)
Finnish (fi)
French, France (fr)
French, Canada (fr-CA)
German (de)
Greek (el)
Hungarian (hu)
Indonesian (id)
Italian (it)
Japanese (ja)
Korean (ko)
Latvian (lv)
Lithuanian (lt)
Malay (ms)
Maltese (mt)
Norwegian Bokmål (nb-NO)
Polish (pl)
Portuguese, Portugal (pt)
Portuguese, Brazil (pt-BR)
Romanian (ro)
Russian (ru)
Slovak (sk)
Slovenian (sl)
Spanish, Spain (es)
Spanish, Latin America (es-419)
Swedish (sv)
Thai (th)
Turkish (tr)
Vietnamese (vi)