Create account
Sign in
Home
Payments
Business operations
Financial services
Developer tools
Security
All products
Home
Payments
Business operations
Home
Payments
Business operations
Financial services
Developer tools
Support
Overview
Overview
Customers
Products and Prices
Tax Rates
Customer portal
Quotes
Start with a use case
Subscriptions with Checkout
Fixed-price subscriptions with Elements
Metered billing with Elements
Per-seat billing with Elements
Manage subscriptions
How subscriptions work
Subscription webhooks
Change subscriptions
Strong Customer Authentication (SCA)
Improved tax support
Invoices API updates
Migrating to Prices
Additional features
Testing
Add payment methods
Bacs Direct Debit in the UK
BECS Direct Debit in Australia
SEPA Direct Debit in the EU
Invoice customers
How invoices work
Create an invoice
Customize invoices
Hosted invoice page
Additional features
Revenue recognition
Overview
Reports
Methodology
Examples
Overrides
Testing
billing
·
HomePaymentsSubscriptions

Hosted invoice page

Use the hosted invoice page to securely collect payment from your customers with zero setup.

Customer portal

In addition to using the hosted invoice page, you can also implement the customer portal to provide a Stripe-hosted dashboard where customers can view their invoice history, manage subscriptions, and update billing details.

The hosted invoice page provides a secure, private URL at which your customers can:

  • View the details, amounts, and status of the invoice
  • Pay the invoice using any of the enabled payment methods
  • Download PDF copies of the invoice and receipt

A sample hosted invoice page

All finalized invoices within Stripe Billing are assigned a secret unique URL which you can choose to be shared with your customer. These invoices are hosted by Stripe, making it an easy and secure way to quickly collect payment from your customers without any extra implementation code.

If the URL for your hosted invoice page is compromised, Stripe might issue a new URL. This can happen when the URL is leaked, or when a customer inadvertently shares the URL. If Stripe issues a new URL, the old URL is invalidated and you need to retrieve the invoice and check the invoice.hosted_invoice_url attribute to use the new one.

The URL includes a secure long and random identifier, resembling https://pay.stripe.com/invoice/invst_abcdefghijklmnop0123456789.

The hosted invoice page’s secret URL is only shared with your customers when enabled in your invoice email configuration, or if you share the URL directly with them.

Sharing the URL in the invoice email

You can configure Billing’s invoice email to include a link to the hosted invoice page. When enabled, the hosted invoice page URL appears in:

  • The Invoice API response as hosted_invoice_url
  • Invoice emails as a payment link
  • The footer of invoice PDFs

To enable the hosted invoice page by default for all newly created invoices, select the checkbox for Include a Stripe-hosted link to an invoice payment page in the invoice email within the Invoice template settings page in the Dashboard.

Enabling hosted invoice page by default on the Billing settings page

To enable the hosted invoice page on a per-invoice or per-subscription basis select the Include a Stripe-hosted linked to an invoice payment page in the invoice email checkbox on the subscription or invoice edit pages.

The email sent to the customer will contain a link to the hosted invoice page.

Enabling hosted invoice page when creating an invoice

Customizing the hosted invoice page branding

The hosted invoice page is customizable with your:

  • Brand color
  • Logo
  • Icon

You can customize these brand settings on the Business settings > Branding page in the Dashboard.

Setting allowed payment methods

You can configure invoices to allow payment with one or more of the Hosted Invoice Page’s supported payment methods. You can set defaults to be applied to all newly created invoices from the Dashboard’s Invoice template page, on a per-invoice basis from the Dashboard’s new invoice page, and a per-subscription basis from the Dashboard’s new subscription page.

When enabled, the hosted invoice page displays the list of allowed payment methods to the customer, allowing them to choose the payment method that works best for them, with the benefit of having Stripe handle complex payment and authentication flows (without any extra implementation effort from you).

In Europe, for example, Strong Customer Authentication (SCA) regulation requires customers to confirm their payment with 3D Secure (3DS). In this case, the hosted invoice page displays the payment confirmation modal to your customer.

Supported payment methods

  • Cards
  • ACH bank transfer
  • Bancontact
  • giropay
  • iDEAL
  • Checks
  • BECS Direct Debit in Australia
  • Sofort
  • FPX
  • EPS
  • Przelewy24
  • ID bank transfer (beta)
  • JP bank transfer (beta)

Payment method persistence

Cards and BECS Direct Debit details entered on the hosted invoice page are stored on the customer for use in subsequent payments. Single-use payment methods like iDEAL, Bancontact, Sofort, and giropay are not stored for re-use.

Public support information

The hosted invoice page includes any public information that you’ve specified in your account details, such as your phone number or website address. Here you’ll also be able to opt-out of including your support phone number on the hosted invoice page. This setting also determines whether or not your support phone number appears on other customer facing documents like the invoice email, invoice PDF, payment receipt. and refund receipt.

Was this page helpful?
Questions? Contact us.
Developer tutorials on YouTube.
You can unsubscribe at any time. Read our privacy policy.
On this page
Sharing the URL in the invoice email
Customizing the hosted invoice page branding
Setting allowed payment methods
Supported payment methods
Payment method persistence
Public support information