stripe-express doc logo
Launch Stripe Express

Setup emails

How to setup email notifications and customer invoice for your payment.


In most of cases, site owner always wants to receive a payment notification during payment processing, for example, once the payment success from customer, you want to know it immediately and then ship your product to your customer.

Therefore, we provide three type emails so far: payment success, payment failed, customer invoice. You can not only turn on/off them individually but also customize the content with your site style.

wp stripe express email notification

Prerequisites

  • A premium license
  • WP SMTP provider works

Email sender

By default, we will use current login user as sender including name and email, but you can correct them if the pre-fill values do not meet you.

wp stripe express email sender

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

Email basic style

You can customize the basic theme style for all emails.

wp stripe express email style setting wp stripe express email theme

Enable/Disable Email

As title, once you enable it, the specified email will be sent when:

  • customer invoice: once the payment success, including recuring payment or async payment way like SOFORT.
  • payment success: once the payment success, including recuring payment or async payment way like SOFORT.
  • payment failed: once the payment failed.
wp stripe express email list

Email Detail Setting

Click on the Manage button to enter email setting page. You can edit the email detail here.

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

Tips:

  • you can specify multi recipients with comma separated.
  • placeholders are available for Subject, Header Text and any places in the editor content.
wp stripe express email editor

Send Test Email

You may want to see what the email looks like which you are editing. Simply click the Send Test button, then this email will be sent to the recipient which is same as the sender email no matter the enable option is check 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 whole email parts. Follow below steps if you really need it:

  1. Check on 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) 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 to send custom invoice, why we still need another one?

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

With self-controller invoice, you can add any additional information to your customer and even an 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 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 that is a core function of WordPress.

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

  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 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.