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
  • 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. Articles and FAQ
  4. SMTP settings
  1. Billing
  2. Customers
  3. Articles and FAQ
  4. SMTP settings

Emails fail due to SPF and DKIM settings

This article also covers

SPF and DKIM are failing DMARC test

DMARC failure

What to do and what not to do during SMTP setup?

Summary

When setting up your SMTP you need to ensure the DMARCs Return-Path matches the domain in your From address. If not, the SPF and DKIM configuration would fail the DMARC alignment test.

In this case, You can set up a DKIM record and check with this source about setting up the custom Return-Path.

Note: Chargebee does not support signing mails with other domains while sending. To use DMARC, you can verify your domain (DKIM) in the postmarkapp and use its SMTP credentials in Chargebee to avoid this issue.

Kindly make sure you adhere to the following settings when you set up the SMTP configuration.

  • Create a custom app credential, if your account has Multiple factor authentication (MFA) enabled.

  • Check for overrides in Mail clients' SMTP account 'From Address' & the 'From address' you set in Chargebee

    • For some email clients, such as Office 365, the username of the 'SMTP Settings' and the 'From Address' given in Chargebee should be the same, for you to use the credentials in Chargebee.
  • If you have configured your own SMTP, we would not have access to the logs to check the delivery of the emails.

  • Make sure the email address that you bcc to is a "catch-all" email address that forwards the email to your individual accounts.

  • If you have enabled DMARC for your domain then you will need to use your own SMTP server where you have verified DKIM and SPF records for your domain with respect to the SMTP provider, making the SMTP provider an authenticated sender on your behalf.

    • Once you have created your own SMTP server, you can configure that SMTP credentials in Chargebee so that your emails don't get dropped due to DMARC checks.

    • DMARC is built upon two authentication protocols- DKIM and SPF and you need to mention both on your domains before proceeding with DMARC.

You can refer to this document for more information.

Related Articles

How do I find out if emails have been delivered to the customer?
Office365- "Please check whether your email address is authorized/verified/blocked by your SMTP server" error
When would I use my own SMTP Server instead of Chargebee's?
Error while configuring SMTP server settings
How to configure my own SMTP server?
Authentication Failure. Please check your SMTP credentials.
'"Unhandled Error has occurred when trying to communicate with the mail server" while configuring the SMTP of AWS'
What happens when the SMTP server is down?

Show more

Was this article helpful?