Email receipts

With payments using Elements and the Payment Intents API, you can manually or automatically send customized email receipts. Learn more about receipts for payments.

Automatically send receipts

To enable automated receipts, toggle Successful payments on in your Customer emails settings. Only a successful payment triggers a receipt. Failed or declined payments don’t send a receipt.

You can optionally specify a receipt_email when you create a PaymentIntent. If you do, Stripe sends a receipt to that address instead of the Customer’s email address.

The receipt_email and Customer email address are the only values used to send a receipt. We don’t send a receipt to an email address included in a payment’s PaymentMethod billing_details.

curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=1099 \
  -d currency=usd \
  -d "payment_method_types[]"=card \
  --data-urlencode description="Thanks for your purchase!" \
  --data-urlencode receipt_email="I.override.your.customer.email.settings@example.com"

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. You can’t add additional line items.

To trigger an automatic receipt after the payment is complete, update the PaymentIntent’s receipt_email.

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.

Automatically send paid invoices

The Payment Intents API can’t generate invoices. Use Stripe Billing to directly create the invoice.

Localization

When using the Payment Intents 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.