Overview

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

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.

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.

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.

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.

Payment method persistence

Cards added 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.