Chargebee Salesforce (v1.41+) 


If you want to upgrade your Chargebee site from Product Catalog 1.0 to 2.0, you must upgrade the Salesforce package version to v1.48 or above first and then migrate the Chargebee Salesforce integration. Contact support  for assistance with the installation.

  • Supported Salesforce versions : Salesforce Enterprise Edition and above.
  • Both Salesforce Classic and Lightning user interface are supported.

The Chargebee package for Salesforce  is not updated automatically, you must contact support  to do so. To view if you have the latest version, in Salesforce, select Setup > Installed Packages and then search for the Version Number for Chargebee for Salesforce.

What's new in Salesforce integration

Package Version 1.54

  • Issue Refund
    This feature allows you to easily issue refunds within Salesforce directly from the Chargebee invoice object. Using Issue Refund, you can now initiate refunds from the invoice object, similar to how a refund is issued in Chargebee Billing.
    To initiate a refund, simply select the "issue refund" action from the invoice object, set the refund amount, add a reason code, and include an optional invoice note. Learn more 

  • Generate Invoice PDF
    Now, you can download Chargebee invoices as PDFs directly into Salesforce. By using Generate Invoice, you are able to view the actual invoice from Chargebee within Salesforce.
    To download an invoice PDF, select the "Download Invoice PDF" action within the Chargebee Invoice object in Salesforce. It generates the PDF and attaches it to the files-related list within the invoice. Learn more 

  • Modify Subscription Start Date
    With this feature, you can modify a subscription's start date in Chargebee, even after the subscription has been created. It is possible to adjust the start date of a subscription as long as the subscription has not started.
    To modify the start date of a subscription, select the "Change Start Date" action from the Subscription object in Salesforce. If the subscription has not yet started, you will be able to update the start date to a new date. However, if the subscription has already started, this action will result in an error and will not allow any changes to the subscription. Learn more 

Package Version 1.53

How-to Video

Package Version 1.52

  • You can now schedule the integration to auto-sync Chargebee customers, subscriptions, invoices, and more records every 10 minutes.
  • The integration now allows sales users to modify an existing quote.
  • While creating subscriptions out of opportunities, customers can now pay via their bank account while using the checkout link to complete their purchases.
  • While configuring sync rules for plans and addons, you can now use custom fields on the Salesforce product for matching Chargebee items.
  • Utilizing the Generate Checkout URL button while creating subscriptions, you can now seamlessly retrieve checkout links and use them in your sales workflows.
  • You can grant access to users who are part of a Salesforce public group like system administrators or sales managers to view and modify fields while they create subscriptions.
  • You can configure e-invoices for customers who are authorized to receive them when creating or updating Chargebee customers in Salesforce.

View all releases

Chargebee provides a highly customizable integration with Salesforce . By maintaining a one-to-one relationship between Chargebee customer records and Salesforce accounts, the integration keeps both the systems up-to-date. Chargebee subscriptions can be directly created and managed from Salesforce.

Based on the configuration, the integration creates or updates records within the following standard objects in Salesforce:

  • Account
  • Contact
  • Lead
  • Opportunity
  • Opportunity Product
  • Product
  • Price Book
  • Price Book Entry

Additionally, custom objects are also created and updated with Chargebee data.

Key Features 

The below illustration displays the Chargebee integration for Salesforce.

Listed below are the key features of the Chargebee - Salesforce integration.

  • Important Chargebee operations that support a sales-driven workflow can be performed without leaving Salesforce.
  • Customer and subscription data is synced into Salesforce, aiding a direct-purchase model.
  • Flexible integration, configured entirely within Salesforce, with a host of customizations available to suit your business workflow.
  • Multiple Chargebee sites can be connected to a single Salesforce instance.
  • Chargebee's Metered Billing and Multi-decimal Pricing and Quantities are supported.
  • The sync health dashboard provides information about the sync status at a glance.
  • The ‘sync logs' feature provides record-level detail on the last run sync jobs, thereby creating a complete audit trail in Salesforce. The timely availability of this information coupled with root causes for failures, equips you to understand and resolve sync errors yourself.
  • Advanced field-mapping configuration between Salesforce and Chargebee.
  • Specifies record types for account/opportunities.

Sync Overview 

This section gives you an overview of what happens when the data is synced during the integration.

  • Chargebee items  are synced to products.
  • Chargebee item prices  are synced to price book entry records and some custom object records.
  • A price book record is created for each of your connected Chargebee sites.
  • Pricing information for item prices with tiered pricing models is stored in the CB Pricing Tier custom object.
  • Customer records are mapped in a 1-to-1 manner to account records (person accounts are also supported).
  • Leads can be converted if matching accounts are not found.
  • Coupons are synced to a custom object.
  • Chargebee quotes can be created from within Salesforce and emailed to customers.
  • All invoices, credit notes, and quotes are synced to Salesforce as custom objects.
  • Opportunities can be created upon lead conversion.
  • Subscriptions are synced to Salesforce as a custom object.
  • Opportunities can be mapped and maintained against subscriptions.

Object Mapping 

On a high level, the objects in Chargebee are mapped to those in Salesforce as follows:

See also

Object and field mapping between Salesforce and Chargebee.

Setting up the Integration 

The Chargebee for Salesforce integration must be setup to match your business workflows:

  • The first step is to connect to Salesforce from your Chargebee site and to install the Chargebee for Salesforce package. ​​For more information, read the installation guide.
  • The next step is to ensure that the integration behavior is configured to match your Salesforce workflows. The integration guide helps you in this.

Subscription Management 

Once the integration is set up successfully, Chargebee customers and subscriptions can be managed directly from Salesforce user interface. The available options are listed under Chargebee Actions in Salesforce.

Was this article helpful?