Email receipts
With Payment Links, you can configure Stripe to automatically send email receipts or paid invoices.
Automatically send receipts
To enable automated receipts, in your Customer emails settings, under Email customers about, select Successful payments. You can also customize receipts. Receipts are only sent when a successful payment has been made—no receipt is sent if the payment fails or is declined.
Receipt features
Each receipt contains a link to view it in a browser, and a unique receipt number that’s useful when looking up payment information.
You can also access the link to view the receipt in a browser through the API in the PaymentIntent’s related Charge object. When you visit the link, the receipt always shows the latest status of that Charge–if it has been refunded, the receipt accurately reflects it.
As a security measure, receipt links expire within 30 days. Expired receipt links require the customer to provide the original email address to resend the receipt to that address.
Automatically send paid invoices
In addition to ordinary receipts, Payment Links can generate paid invoices as proof of payment. Invoices have more information than receipts. For subscriptions, Stripe generates invoices automatically, but for one-time payments, you need to enable them.
To generate invoices, first, in your Customer emails settings, under Email customers about, select Successful payments. Then, when creating a Payment Link, on the After payment tab, select Create an invoice PDF. You can also configure your invoice template in the Dashboard.
After the payment completes, Stripe sends an invoice summary with links to download the invoice PDF and invoice receipt to the email address your customer provides during checkout.
Caution
Invoices for delayed notification payment methods such as Bacs Direct Debit, Bank transfers, Boleto, Canadian pre-authorized debits, Konbini, OXXO, SEPA Direct Debit, SOFORT, or ACH Direct Debit might take longer to send because we send the invoice after successful payment, not upon checkout session completion.
You can also view the invoice in the Dashboard or access it programmatically by listening to the invoice.paid webhook event.
Manually send receipts from the Dashboard
You can send receipts in the Dashboard using the receipt history section of a payment’s page, or the payments section of a customer’s page. You can provide a different email address to resend an email receipt, or a comma-separated list of addresses to send it to multiple recipients. The payment’s page displays a history of the last 10 receipts.
Customize receipts
You can customize the look and behavior of your receipts in several ways:
- Specify which language to use in your Customer emails settings
- Customize the logo and colors in your Branding settings.
- The maximum file size for a custom logo image is 512KB
- The optimum logo is a square image larger than 128 x 128 pixels
- JPG, PNG, and GIF file types are supported
- Specify public information to include, such as your phone number or website address, in your Public details settings
To display custom text, use the description attribute on the PaymentIntent. Some examples include:
- Description of goods or services provided
- Authorization code
- Subscription information
- Cancellation policies
Caution
Receipts pull data from the Charge object generated when the PaymentIntent is confirmed. To update receipt data such as the description after the Charge is generated, you must update the Charge. Changes to a confirmed PaymentIntent don’t appear on receipts.
You can see a real-time preview of your email receipt on your Dashboard Branding settings page. To send a test receipt, hover over the preview image and click Send test receipt, then enter your email address.
Refund receipts
When a payment is refunded, Stripe can automatically send a receipt to the same email address provided in the original charge. You can also use the Dashboard to manually send a copy of the refund receipt.
To enable automatic refund receipts, in your Customer emails settings, under Email customers about, select Refunds.
Receipts with Billing
Stripe creates a receipt when a customer pays an invoice or makes any subscription payment. Receipts for subscription and invoice payments are itemized to include line items, discounts, and taxes.
After payment, the Hosted Invoice Page includes a link to a receipt that the customer can download for their own records.
Receipts for Stripe Connect
Receipt settings depend on the charge and account type.
For destination charges and separate charges and transfers, receipts use the platform account’s Customer emails, Branding, and Public details settings.
For direct charges, receipts use the connected account’s Customer emails, Branding, and Public details settings.
Platform accounts that create charges on Standard accounts can send a receipt for a connected account by passing receipt_email when making a charge request.
Configure receipt settings for a platform or Standard account in the account’s Dashboard. For Express and Custom accounts, the platform configures receipt settings for the connected account through the connected account’s Branding settings.