New in Chargebee: Explore Reveal and understand your payment performance end-to-end.Try Now
Docschargebeedocs
HomeBillingPaymentsRevRecGrowthReveal
Support

Product Updates


  • Release Notes

Getting Started


  • Overview
  • Chargebee Billing Data Centers
  • Object Relationship Model
  • Understanding Sites
  • Developer Resources
  • Chargebee Tech Glossary
  • Articles and FAQ

Implementing Chargebee


  • Implementation Guide
  • Go-live Checklist
  • Articles and FAQ

AI in Chargebee


  • Chargebee Agents
  • Chargebee Copilot
  • Chargebee MCP Server (Model context protocol)

Product Catalog


  • Product Catalog Overview
  • Coupons
  • Articles and FAQ

Subscriptions


  • Working with Subscriptions
  • Billing
  • Orders
  • Articles and FAQ

Customers


  • Managing Customers
  • Account Hierarchy
  • Email Notifications
  • Branding
  • Configure Multiple Languages
  • Articles and FAQ

Invoices, Credit Notes and Quotes


  • Invoices
  • Credit Notes
  • Quotes [Legacy]
  • Transactions
  • Articles and FAQ

Taxes


  • Overview
  • Configuring Taxes
  • Country-specific Taxes
  • Articles and FAQ

Hosted Capabilities


  • Overview
  • Hosted Checkout
  • Hosted Self-Serve Portal
  • Hosted Pages Features
  • Additional Hosted Pages
  • Payment Components
  • Managing payments with ChargebeeJS
  • Mobile-Optimized Hosted Pages
  • Articles and FAQ

Site Configuration


  • Users & Roles
  • Custom Fields & Metadata
  • Mandatory Fields
  • File Attachments & Comments
  • Advanced Filter Options
  • Multicurrency Pricing
  • Multi-decimal Support
  • Configuring Reason Codes
  • Events and Webhooks
  • API Keys
  • Time Zone
  • Time Machine
  • Transfer Configurations
  • Articles and FAQ

Reports and Analytics


  • RevenueStory
    • Reports Explorer
    • Custom Fields in RevenueStory
    • Report Builder
      • Working with Reports
      • Data Sources
        • Coupons
        • Credit Notes
        • Customers
        • Customer Balance
        • Invoices
        • Orders
        • Payments
        • Products
        • Refunds
        • Subscriptions
        • Multientity
        • Product Family
        • Subscription Contract Terms
        • Dunning Details
        • Invoice Transactions
        • Invoice Line Items
        • Invoice Addresses
        • Invoice Discounts
        • Credit Note Line Items
        • Monthly Subscription History
        • Yearly Subscription History
        • Applied Credits
        • Monthly Component History
        • Yearly Component History
        • Order Line items
        • Payment Sources
        • Subscription Discounts
        • Subscription Addons
        • Subscription Shipping Addresses
      • Sample Reports
    • Monthly Recurring Revenue (MRR)
    • Metric Description
  • Home Dashboard
  • Frequently Asked Questions
  • FAQs for Classic Reports Sunset
  • Articles and FAQ

Integrations


  • Sales
  • Customer Support and Success
  • Finance
  • Tax
  • Marketing
  • Stitch
  • Collaboration
  • Contract Management
  • Order Management
  • Mobile Subscriptions (Legacy)
  • Other Integrations
  • Articles and FAQ

Data Privacy & Security


  • Two Factor Authentication
  • SAML Single Sign-On
  • System for Cross-Domain Identity Management (SCIM)
  • EU-GDPR
  • Consent Management
  • Personal Data Management
  • Compliance Certificates
  • HIPAA Guidelines
  • PCI Recommendations and Integration Types
  • Articles and FAQ

Data Operations


  • Bulk Operations
  • Migration
  • Articles and FAQ
  1. Billing
  2. Customers
  3. Email Notifications
  1. Billing
  2. Customers
  3. Email Notifications

Email Notifications v1 (Deprecated)

Information

Users who signed up for Chargebee after September 25, 2017 will have Email Notifications enabled by default.

Chargebee can automatically send email notifications to your customers for various events, such as credit card expiration or payment failure. You can configure email notification settings under Settings > Configure Chargebee > Email Notifications in your Chargebee site.

Information

Gmail implemented its DMARC policy in June 2016. This means emails sent from any server other than Gmail's will be ignored, and your customers will not receive emails sent via non-Gmail servers. Learn more.

Settings

You can configure the sender's name, email address, subject prefix (if any), and BCC.

The sender's name and address can be configured globally under Settings > Configure Chargebee > Email Notifications > Settings or separately for specific email notifications.

If you have customized any email notifications, you must update the "From" details for those notifications individually by editing those templates.

Updating the configuration only under Settings > Configure Chargebee > Email Notifications > Settings will not update the sender's details for notifications that have been customized.

Notify new revenue to – Configuring an email address here will send the recipient the first invoice generated for each subscription. The subject line of this email will have the prefix "[First Invoice]." This receipt will be sent even if the Invoice Receipt email notification is turned off.

Enable Email Notifications

Configure the header and footer, and enable the events that should automatically notify your customers.

By default, all notification events are disabled. You can enable the ones you need and customize the templates.

Customer Portal Notifications

If you've enabled the customer portal, these email notifications are automatically sent to your customers. These notifications cannot be turned off because they are required, but you can customize the templates.

Email notifications are automatically sent to your customers when they:

  • Request for the sign up email
  • Use the Forgot Password option
  • Change their customer portal account password
  • Get locked out of their account due to numerous failed login attempts

An email with a verification link is also sent to your customer when you change their email address from your end.

Customizing Email Templates

You can easily customize email templates by adding your content and using the mail merge fields available at the bottom. Simply copy and paste the fields, and the data will be automatically populated when the email is sent.

Templates can be in plain text or HTML format. To enable HTML, click the HTML tab and then Enable. Images can be uploaded and saved to your account, and used in any email template you compose. You can disable HTML at any time.

 width=860px

Note

  • The HTML mode needs to be enabled for each email template individually. Enabling/Disabling an email template only affects the template that you currently have open.
  • Chargebee supports only inline CSS styles.

Update Template saves the current changes you've made to the template.

Reset Template undoes the changes you just made and reverts to the last saved version of the template.

Restore Default restores the default system template.

Preview shows you how your email will look.

Disable HTML disables HTML format for the template you are currently working on.

Chargebee's reminder emails (such as the Subscription Ending and Trial Ending reminders) include two additional Send Reminder fields:

  • Send Reminder (days): The first allows you to customize how many days prior to the renewal you would like to send the email.

  • Send Reminder (billing period): The second allows you to choose the billing period(s) (such as annual, quarterly, and so on) for which you want to send reminders. Once a billing period is set, only customers with subscriptions that fit into it will receive the email reminder. This setting provides flexibility for reminders; for example, a monthly billing period might not require a reminder email, while a yearly billing period might.

Mail Merge Fields

There are several fields you can use to customize your email template. Adding these fields will automatically fill in the corresponding data.

Example

If you want to automatically fill in the customer's first name (for example, Johnny) in the subject line of a template, simply copy the corresponding field from the list of mail merge fields and paste it in the subject line as follows:

Welcome, customer.first_name!

The subject line of the email sent to the customer would read:

"Welcome, Johnny!"

Note

Only fields relevant to the particular event will be displayed. If you copy a field from another event's template and use it for an event that does not include that field, it will not display any data.

See also

Mail Merge Usage for more information.

Notifying 3DS Payment Failures

If your business is based in Europe or has a significant customer base in the EEA, it is recommended that you authenticate payments via 3D Secure. This ensures you are SCA compliant and in line with the PSD2 regulation. To be compliant, complete Chargebee's setup.

Since 3DS failures are hard card declines and require customer intervention, it is necessary to inform customers of the failure so they can take action. You can configure the email templates under Settings > Configure Chargebee > Email Notifications > Dunning for Online Payments.

Make sure you embed the following mail merge fields to notify the customer of a 3DS failure, along with the "Pay Now" option.

customer.collect_unpaid_invoices_url - Pay Now for unpaid invoices

transaction.payment_failure_reason - Failure reason

SMTP Settings

Email notifications can be sent to your customers using either Chargebee's SMTP server or your own SMTP server.

To learn more, visit Chargebee's SMTP Configuration page.

Email Logs

When email notifications are sent to your customers, they are archived in Chargebee for future reference. You can view all emails sent to your customers by going to Logs > Email Logs.

You can search for emails using keywords and filters, and also view and resend these emails.

Was this article helpful?