Email receipts
Stripe automatically sends email receipts after a successful payment or refund when you provide an email address in the Customer object of your API request. You can also generate an email receipt after checkout by updating the PaymentIntent with the customer’s email address. Each payment in the Dashboard has a Receipt history where you can view and 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. Accessing an expired receipt link resends the receipt to the original recipient.
Automatically send receipts when payments are successful
Receipts with Billing
Stripe creates receipts 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.
To automatically send receipts, set the customer’s email
and enable email customers for successful payments in your email receipt settings.
After payment, the Hosted Invoice Page includes a link to a receipt that a customer can download for their own records.
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.
Refund receipts
When a payment is refunded, Stripe automatically sends 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.
As with payment receipts, you must enable Email customers for refunds in your email receipt settings to make sure refund receipts are automatically sent to your customer.
Customize receipts
You can customize the look and behavior of your receipts in several ways:
- Specify which language to use for receipts in your email receipt settings
- Upload a custom logo in the branding settings.
- Maximum file size permitted 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 account details
- Opt-out of including your support phone number on receipts (and other customer facing documents like the invoice email, invoice PDF, and hosted invoice page) in your account details
Stripe uses your logo’s colors to automatically set the header color for your receipts, but you can provide an alternate a hexadecimal (hex) number to override Stripe’s selection.
Stripe receipts help you comply by filling in all the fields that we know. Use the description parameter to display other custom text on your receipts, for example:
- Description of goods or service provided
- Authorization code
- Whether this is the recurring charge or if it qualifies as buying additional credits that are separate or above and beyond the recurring subscription
- Cancellation policies
Caution
Receipts pull data from the Charge object that’s auto-generated upon PaymentIntent confirmation. To update receipt data such as the description
value after the Charge is generated, you must update the Charge. Updates to the PaymentIntent alone at this point won’t be reflected on the receipt.
Preview your changes in real-time within the Dashboard. To see how a receipt looks when it’s sent, click Send test email… to send yourself a test receipt.
Receipts for Stripe Connect
Stripe sends a receipt to the email address that’s specified for receipt_email in the PaymentIntent
object depending on your account email settings.
For destination charges and separate charges and transfers, the platform account’s email settings, branding, and public business information control the receipts.
For direct charges, the connected account’s email settings, branding, and public business information control the receipts.
Platform accounts that create charges on Standard accounts can still send a receipt for the connected account by passing receipt_email
when making a charge request.
You can configure email settings for both your platform and Standard accounts in the Dashboard. For Express and Custom accounts, the platform configures the settings for the connected account through the connected account’s branding settings.
If your platform and connected accounts use customers (for example, a platform for subscription services), you can’t change customer email settings on Standard accounts—you manage the email settings for each connected account individually.