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

Product Updates


  • Release Notes

Getting Started


  • Overview
  • Chargebee Billing Data Centers
  • Object Relationship Model
  • Understanding Sites
  • 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)

Developer Resources


  • Developer Resources Overview
  • Articles and FAQ

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

Entitlements


  • Entitlements Overview
  • Features Overview
  • Feature Management
  • Managing Product Entitlements
  • Subscription Entitlements
  • Customer Entitlements
  • Grandfathering Entitlements
  • Articles and FAQ

Usage Based Billing


  • Understanding Usages
  • Setting up Usage Based Billing
  • Usage Alerts
  • Metered Billing
  • Articles and FAQ

Chargebee CPQ


  • Chargebee CPQ
  • Chargebee CPQ for Salesforce
  • Chargebee CPQ for HubSpot

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
  • Pricing Table
  • Managing Payments with Chargebee.js
  • Mobile-Optimized Hosted Pages
  • Articles and FAQ

Site Configuration


  • Users & Roles
  • Custom Fields & Metadata
  • Approvals
  • 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

Multi Business Entity


  • Multi Business Entity Overview
  • Customer Transfer Overview
  • Articles and FAQ

Mobile Subscriptions


  • Overview
  • Omnichannel Subscriptions
  • Omnichannel One-Time Orders
  • Mobile Subscriptions (Legacy)

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
  • Ecommerce Management
  • 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. Integrations
  3. Zoho Crm
  1. Billing
  2. Integrations
  3. Zoho Crm

Zoho CRM

Zoho CRM empowers a global network to convert more leads, engage with customers, and grow their revenue. Transform your business with the world's favorite customer relationship management software.

Zoho CRM Contacts

Chargebee provides a highly customizable integration with ZOHO CRM. It is a one-way integration that syncs Chargebee Customer records to ZOHO CRM Contacts.

AccountTypes

You can configure the Chargebee - ZOHO CRM integration both in Chargebee's Test site as well as the Live site. We recommend that you test the synchronization of data from Chargebee's test site to a test account in ZOHO CRM.

Prerequisites

Ideally, there are no mandatory fields when creating a Customer in Chargebee (other than an ID, which can be auto-generated), so in theory, all the fields we're interested in (First Name, Last Name, Company, Email, Phone) could be missing. When creating a Contact in Zoho, the only mandatory field is the Last Name.

Object Mapping

Chargebee Customers are mapped to Contacts in Zoho CRM. The table below shows the relationship between objects in either system in terms of data flow.

Field Mapping

Customers in Chargebee are mapped to Contacts in ZOHO CRM. Given below is the default field mapping.

image

Configuration

Follow these steps to configure the Chargebee - Zoho CRM integration in your Chargebee site.

  1. Log into your Chargebee site and click Settings > Apps > Zoho CRM.
  2. Click the Connect button.
  3. Authorization: The Zoho CRM API uses the OAuth2.0 protocol for authentication. It is an industry-standard protocol specification that enables third-party applications to gain delegated access to protected resources in Zoho through an API.
image
image
  1. You need to go through the Sync Rules settings to complete the process.

Sync Rules for Contacts

You can manage how the data syncs with Zoho CRM using the Configure Sync Rules option.

image

The Sync Rules for contacts displays the following use cases:

  • Matching contact is absent in Zoho CRM
  • Matching contact is present in Zoho CRM
  • Allowing Chargebee to create Accounts in Zoho CRM
    image

Matching contact is absent in Zoho CRM

If a customer does not have a matching Contact in Zoho CRM select the options displayed in the dropdown.

  • Create contact - Create a new contact.
  • Do nothing - Do not create a contact.
    image

Matching contact is present in Zoho CRM

You can select the required action when a matching contact is present in Zoho from the available options:

  • Just map - You can map the fields of the Customer in Chargebee with the matching Contact in Zoho CRM.
  • Override the fields - Override the existing fields in Zoho CRM. By default, the integration doesn't overwrite Zoho data with Chargebee data, that is you can only sync a field that is empty in Zoho. This sync rule allows the user to change this setting.

Note that the setting is global, i.e. users are not allowed to specify this on a field-by-field level.

image

Create Accounts in Zoho CRM

You can choose to Create account or Leave the account field empty when the Company Name in Chargebee does not match any Account in Zoho CRM.

image

Click Apply changes to implement the changes.

Sync Preferences

The integration only syncs information from Chargebee to Zoho CRM. It is a one-way sync, where the Customer information from Chargebee can be mapped directly to create Contacts in Zoho CRM.

image

How Often Do you Sync

When the Autosync is enabled the sync runs every one hour to sync the Customers in Chargebee, to Contacts in Zoho CRM.

image

Users can run the sync manually using the Sync Now button.

image

Note that the manual sync is not possible while the auto-sync is running.

Unlink Integration

You can use this option to disconnect your Zoho CRM account from Chargebee for both test and live sites.

image

Zoho CRM Subscriptions

Chargebee provides a highly customizable integration with Zoho CRM. It is a one-way integration that syncs Chargebee Subscriptions to deals in ZOHO CRM.

ChargebeeZoho CRM
SubscriptionsDeals

Object Mapping

Chargebee Subscriptions are mapped to Deals in Zoho CRM. The table below shows the relationship between objects in both systems in terms of data flow.

All the basic information of subscriptions in Chargebee gets synced to Zoho CRM.

Field Mapping

Chargebee SubscriptionZoho Deal
Chargebee User who configured the integrationDeal Owner
Subscription IDDeal Name
CompanyAccount
Monthly Recurring Revenue (MRR)Amount
CustomerContact Name
Chargebee User who configured the integrationDeal Owner
Subscription Created DateDate

Prerequisites

  • You need to map the Company in Chargebee Subscription to an existing Account in Zoho Deal or create a new account as this is a mandatory field for Zoho.
  • The multi-currency setting needs to be activated to map MRR to Amount in Zoho.

Sync Rules For Subscriptions

There is only one sync rule i.e. Choose the pipeline and the stages related to the pipeline in Zoho for Active/Non-Renewing subscriptions displayed in the dropdown in ZohoCRM.

  • Update the Sync Status and Errors to deal with Subscriptions.
  • Sync subscriptions that are in the "Active/Non-Renewing" state (That is you cannot sync future subscriptions, trials,and so on.)
  • A subscription is synced only once.

Note

  • A subscription is never updated in ZohoCRM even if it is updated in Chargebee. eg. change the status is not done for a deal in Zoho.
  • The setting for ‘overriding Zoho data' only applies to contacts.

Release Notes

This page contains the latest updates of the Chargebee - Zoho CRM integration.

  • Version 1 - With this release, all Customers from Chargebee are synced to the Contacts in Zoho CRM.
  • Version 2 - With this release, all Subscriptions from Chargebee are synced to Zoho CRM.

FAQ

1. Can the user control the duration of the Autosync?

The auto-sync runs every 60 minutes. The user has no control over its frequency.

Note

The user cannot edit the auto sync feature.

2. What will happen if a customer updates blank fields before the next sync?

When a Customer updates some blank fields after the sync, the updated details will reflect in Zoho CRM at the next available sync.

3. What happens if several e-mail IDs are assigned to a Contact in Zoho CRM?

If the contact's e-mail is not unique in Zoho CRM, the sync fails with an error message displayed in the Sync errors tab.

Was this article helpful?