Email receipts

Send payment or refund receipts automatically.

Payment Links

Checkout

Direct API or Elements

With Checkout, 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, Checkout 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.

Note

Invoice creation for one-time payments in Checkout is not an Invoicing feature, and is priced separately. Review this support article to learn more.

To generate invoices, first, in your Customer emails settings, under Email customers about, select Successful payments. Then, when creating a Checkout session, set invoice_creation[enabled] to true.

Note

Enabling invoice_creation isn’t supported if you set payment_intent_data[capture_method] to manual.

Command Line

curl https://api.stripe.com/v1/checkout/sessions \
  -u "sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d mode=payment \
  -d "invoice_creation[enabled]"=true \
  -d "line_items[0][price]"={{ONE_TIME_PRICE_ID}} \
  -d "line_items[0][quantity]"=1 \
  --data-urlencode success_url="https://example.com" \
  --data-urlencode cancel_url="https://example.com"

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.

Screenshot of the invoice PDF that customers can download from the invoice summary email

Customers can download the invoice PDF.

Screenshot of the invoice receipt that customers can download from the invoice summary email

Customers can download the invoice receipt.

Screenshot of the invoice summary email Stripe sends

The email sent to customers includes links to download the invoice PDF or receipt.

You can also view the invoice in the Dashboard or access it programmatically by listening to the invoice.paid webhook event.

You can use the invoice_data hash inside invoice_creation to further customize the invoice generated by the Checkout Session.

Command Line

curl https://api.stripe.com/v1/checkout/sessions \
  -u "sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d mode=payment \
  -d "invoice_creation[enabled]"=true \
  -d "invoice_creation[invoice_data][description]"="Invoice for Product X" \
  -d "invoice_creation[invoice_data][metadata][order]"=order-xyz \
  -d "invoice_creation[invoice_data][account_tax_ids][0]"=DE123456789 \
  -d "invoice_creation[invoice_data][custom_fields][0][name]"="Purchase Order" \
  -d "invoice_creation[invoice_data][custom_fields][0][value]"=PO-XYZ \
  -d "invoice_creation[invoice_data][rendering_options][amount_tax_display]"=include_inclusive_tax \
  -d "invoice_creation[invoice_data][footer]"="B2B Inc." \
  -d "line_items[0][price]"={{ONE_TIME_PRICE_ID}} \
  -d "line_items[0][quantity]"=1 \
  --data-urlencode success_url="https://example.com" \
  --data-urlencode cancel_url="https://example.com"

Review invoice best practices for your region to make sure you’re collecting the right information from your customers. Information like the customer’s billing and shipping addresses, phone number and tax ID appear on the resulting invoice.

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.