stripe-express doc logo
Launch Stripe Express

Setup emails

How to set up email notifications and customer invoices for your payment.


In most cases, site owners want to receive notifications during payment processing, such as when a payment is successful or when a customer disputes a charge.

To support this, we offer three types of email notifications: payment success, payment failure, and customer invoices. These notifications can be turned on or off individually and their content can be customized to match the style of your site.

wp stripe express email notification

Prerequisites

  • A premium license
  • WP SMTP provider works

Email sender

By default, we will use the current login user as the sender, including their name and email. However, you can change these values if they do not meet your needs.

wp stripe express email sender

(NOTE) our Send Test function will use this sender email as the recipient to receive the email.

Email basic style

You can customize the basic theme style for all emails in the setting tab.

wp stripe express email style setting wp stripe express email theme

Enable/Disable Email

As the title suggests, once you enable an email, it will be sent when certain events occur:

  • customer invoice: sent once the payment is successful, including recurring payments or asynchronous payment methods like SOFORT.
  • payment success: sent once the payment is successful, including recurring payments or asynchronous payment methods like SOFORT.
  • payment failed: sent once the payment fails.
wp stripe express email list

Email Detail Setting

Click on the Manage button to enter the email setting page. Here, you can edit the email details.

Available placeholders (let us know if you need more): {siteurl}, {sitetitle}, {siteaddress}, {amount}, {amountsymbol}, {currency}, {description}, {receipturl}, {customeremail}, {customername}, {customerphone}, {error_message}

Tips:

  • You can specify multiple recipients by separating them with commas.
  • Placeholders can be used in the Subject, Header Text, and anywhere in the editor content.
wp stripe express email editor

Send Test Email

You may want to see what the email looks like that you are editing. Simply click the Send Test button, then this email will be sent to the recipient which is the same as the sender email regardless of whether the Enable option is checked or not.

NOTE: Please save the email before clicking the button.

Advanced Customize Email

If the built-in email template doesn't meet your requirement, we provide a way to customize the entire email. Follow the below steps if you need them:

  1. Check the Enable override (advanced) option.
  2. Copy any or whole files from stripe-express/templates/emails/ to your theme folder: {themefolder}/stripe-express/emails/ (create the folder if not exists)
wse_email_default_theme.html  // header, footer
wse_email_default_theme_styles.html // style 
wse_email_invoice.html
wse_email_pay_fail.html
wse_email_pay_success.html

Once the Enable override (advanced) is checked, during sending email, our plugin will look up the customized templates folder under your current theme folder: {themefolder}/stripe-express/emails/.

For example, you want to customize the email footer, then you just need to copy the wse_email_default_theme.html file to the folder, then open the file and find the footer and modify it:

<!-- Footer -->
......
<p style="margin: 0 0 16px;">
    this is a footer {site_title} — <a href="{site_address}">{site_address}</a>
</p>
......
<!-- End Footer -->
wp stripe express email footer

Tips: Once you can uncheck the option, then all the emails will not use these customized templates.

FAQ on Email

Q. Stripe supports sending a custom invoice, why do we still need another one?

Stripe built-in invoices will send from their domains to the customer, so it's not controlled by the site owner and may result in customer confusion.

With a self-controller invoice, you can add any additional information to your customer and even a stripe invoice link/pdf in your content.

Q. Suggested Dedicated SMTP Providers?

For SMTP provider setup, it is out of this plugin box, but here are some suggestions:
There are dedicated SMTP providers that work for most websites. All have their own plugin on WordPress.org, can be installed from your WordPress dashboard, and have support available to help you get started.

  • Mailjet (Plugin) – Send 6,000 emails free per month.
  • Sendinblue (Plugin) – Send 9,000 emails free per day.
  • Postmark (Plugin) – Priced plans start at 10,000 emails a month.
  • Amazon SES (Plugin) – Send 62,000 emails to free per month if your website is hosted on AWS or pricing starts at $0.10 for every 1,000 emails.

Q. How does email work with WordPress?

As most plugins sending email, send mail by using the wp_mail() function which is a core function of WordPress.

Q. I am getting payment from stripe, but no emails are sent!

  1. First of all, make sure your email service works fine, you can send the email from other places or plugin, if they can send it correctly.
  2. Check the email setting correctly, there could be an issue in the email delivery to a recipient. This could be a spam blocker that classified your emails are spam and stopped them. Installing a mail logging plugin can help.