Automatically send receipts
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.
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.
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
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.
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
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 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.