Hosted invoice page
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.
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.
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.
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.