Email receipts and paid invoices
Send payment or refund receipts automatically.
With payments using Elements or direct API calls, you can manually or automatically send customized email receipts.
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 receipts
To enable automated receipts, toggle Successful payments on in your Customer emails settings. Receipts are only sent when a successful payment has been made—no receipt is sent if the payment fails or is declined.
You don’t have to specify any receipt parameters when you create a PaymentIntent. However, if you specify a receipt_email and the payment succeeds, Stripe sends a receipt to that address regardless of your Customer emails settings.
The receipt displays the amount, your public business information, and any value in the description
parameter of the request. Receipts for one-time payments include only this information—additional line items can’t be added.
To trigger an automatic receipt after the payment is complete, update the PaymentIntent’s receipt_email.
Manually send receipts
To send receipts in the Dashboard, click Send receipt within the Receipt history section of a Payment details page. You can also hover over a payment within the Payments section of a customer’s page and click the Send receipt icon. To resend an email receipt, input a different email address, or specify a comma-separated list of addresses to send it to several recipients. A record of the last 10 receipts is visible on the payment’s page.
Customize receipts
Alter the appearance and functionality of your receipts with the following customization options:
- Branding: Modify the logo and colors in your Branding settings. The upper limit for a custom logo image file size is 512KB. Ideally, the logo should be a square image exceeding 128 x 128 pixels. JPG, PNG, and GIF file types are supported.
- Public information: Specify the public information you want to include, such as your contact 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.
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.
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.
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 automated refund receipts, toggle Refunds on in your Customer emails settings.
Invoice and subscription payment receipts
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.
Stripe Connect receipts
Receipt settings depend on the charge and account type:
Destination charges and separate charges and transfers: Receipts use the platform account’s Customer emails, Branding, and Public details settings.
Direct charges: Receipts use the connected account’s Customer emails, Branding, and Public details settings.
Platform accounts can send a receipt for a connected account by passing receipt_
when making a charge request.
For connected accounts that use the Stripe Dashboard (which includes Standard connected accounts), you can configure receipt settings under Branding. For connected accounts that don’t use the Dashboard (which includes Express and Custom connected accounts), the platform configures receipt settings through settings.branding.
Automatically send paid invoices
The PaymentIntent API can’t generate invoices. Use Stripe Billing to directly create the invoice.
Localization
When using the PaymentIntent API, the language of the receipt is determined by several factors:
- If a Customer is set, their preferred locale is used if available.
- If a Customer is set without any preferred locale, or if no Customer is set, the language setting from the Stripe Dashboard is applied.