Hosted Invoice Page
The Hosted Invoice Page provides a secure, private URL where 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.
Stripe assigns all finalized invoices a secret unique URL that you can share with your customer. We host these invoices, which means you can securely 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 secret URL for the Hosted Invoice Page is only shared with your customers if you enable it in your invoice email configuration. The URL includes a secure, long, and random identifier, resembling the following example:
https://invoice.stripe.com/i/acct_abcdefghijklmno/invst_abcdefghijklmnop0123456789
Share the URL in the invoice email
You can configure the invoice email to include a link to the Hosted Invoice Page. When enabled, the Hosted Invoice Page URL appears in:
- Invoice emails as a payment link.
- The footer of invoice PDFs.
- The Invoice API response as hosted_invoice_url.
To enable the Hosted Invoice Page for all newly created invoices, select the checkbox for Include a Stripe-hosted link to an invoice payment page in the invoice email in the Invoice template.
To enable the Hosted Invoice Page on any individual invoice, select the Email invoice to customer with link to payment page checkbox in the Payment section when you’re editing an invoice.
You can also generate a link to the Hosted Invoice Page by clicking Settings and selecting Send invoice or link manually. After you complete the invoice, Stripe provides you with a payment link that you can manually send to a customer (We don’t send an email when you select this option).
Customize the Hosted Invoice Page
The Hosted Invoice Page is customizable with your:
- Brand color
- Logo
- Icon
You can customize these brand settings on the Branding page in the Dashboard.
Set allowed payment methods
From the Hosted Invoice Page, you can configure invoices to allow payment with one or more of the supported payment methods. You can set defaults to apply to all of the newly created invoices from the Invoice template. You can also select the payment method on a per-invoice basis when you’re creating an invoice through the Dashboard.
With the Hosted Invoice Page, you can display the allowed payment method list to the customer. This gives them the option to choose a payment method that suits them best. Additionally, enabling the Hosted Invoice Page gives the customer the benefit of having Stripe handle complex payment and authentication flows (without any extra implementation effort from you).
For example, the Strong Customer Authentication (SCA) regulation in Europe 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 and BECS Direct Debit details that you enter on the Hosted Invoice Page are stored on the customer for use in subsequent payments. We don’t store single-use payment methods like iDEAL, Bancontact, Sofort, and giropay for reuse.
Public support information
The Hosted Invoice Page includes any public information that you specified in your account details, such as your phone number or website address. You can choose to exclude your support phone number on the Hosted Invoice Page. You can also decide whether or not your support phone number appears on other customer-facing documents like the invoice email, invoice PDF, payment receipt, and refund receipt.