Email Configuration

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 failed, and even do some automation tasks with email.

Prerequisites

Supported Emails

We currently offer notifications for three event types:

  • Payment Succeeded

  • Payment Failed

  • Customer Invoice

These can be enabled/disabled and customized individually to match your site's style. Let us know if any other email notifications would be helpful for your workflow and we'll consider adding them.

When specifying recipient(s), you can enter multiple emails separated by commas. For example:

{customer.email}, [email protected]

Supported merge fields:

The following merge tags can be used to dynamically insert data into the email content:

Note: Some fields may be empty depending on the payment type - for example, shipping details may be empty if no shipping required when collect payment information

Metadata merge field (Pro Only)

Metadata is a powerful feature that allows you to store all the submitted form data, which can be leveraged to populate email templates with field names. This information can also be found in the Stripe Dashboard.

The {metadata} is a formatted key-value string including the specified metadata (for checkout redirection) or form values (for payment form)

We can split them by giving an existing key. For example, if a form id key is called 'first_name', we can use it in email as {metadata.first_name}

Customize Default Template Colors (Pro Only)

We provide a default template for email notifications, but you can easily customize its theme to match your brand’s colors. The following color settings are available:

  • Base Color: #4a90e2

  • Background Color: #f7f7f7

  • Body Background Color: #ffffff

  • Body Text Color: #3c3c3c

The body content remains unchanged and can be configured in the email content editor (available for all three email types).

Once you unlock this feature, you’ll see the Customize Email Template section, where you can modify the supported colors.

To style button links as shown above, switch the editor to Code Mode and add the class button to your link:

Override the Default Template Layout (Pro Only)

If you want more control over your email template—beyond just colors—you can fully customize the layout, including headers, footers, and other structural elements.

To override the default template, place an HTML file named default.html in your theme folder at:

{themefolder}/elementor-pay-addons/emails/default.html

This custom template supports all email and payment merge fields.

A special merge field, {{__email_body__}} (wrapped in double braces), is reserved for dynamic content replacement. This ensures the email body you configure in the editor is automatically inserted into your custom template.

A full example file:

payaddons custom template
PreviousCheckout Redirect Form (Pro)NextDecimal Form Field (Pro)

Last updated