Salesforce is a CRM platform that allows you to keep track of the leads generated, deals closed, and new customers acquired.
Chargebee integrates with Salesforce to facilitate seamless sales and subscription data integration. Chargebee will sync all your customer data including plans, subscriptions, coupons, pricing etc., with Salesforce.
If two or more customers have the same email ID, it will be captured as a Sync Error and the sync will not go through. Removing the duplicate values will let you proceed further with the sync.
Field Accessibility: The user logging in, while setting up the integration, should have access to necessary objects (say, Pricebook) in Salesforce. Based on the user's credentials, Chargebee will get access to the fields/objects and the details will be synced to Salesforce accordingly.
Multicurrency: If Multicurrency is enabled in the Chargebee, it should be enabled in Salesforce as well.
The integration of Salesforce and Chargebee begins with the installation of the Chargebee plugin. The plugin authenticates, validates and syncs your customer information in Salesforce and Chargebee.
During the integration, the fields in Chargebee are mapped with the fields in Salesforce (with the help of standard and custom objects).
*These are created as Custom Objects in Salesforce. Read more about Custom Objects in Salesforce
Navigate to Settings > Third Party Integrations > Salesforce, you'll find the option Connect and clicking it will redirect you to the Salesforce page asking you for your Salesforce credentials. Enter the credentials and proceed.
After the credentials are validated, you'll now be redirected to the Chargebee app for initiating the one-time installation of the plugin.
During the installation, you will be asked to choose the Account/role the plugin needs to be linked/installed to. We recommend that you enable the plugin for Admins. You can change the plugin access for other users in Salesforce later as well.
You will be navigated back to Chargebee after the installation is completed.
In this step, Chargebee checks if certain prerequisites are met.
Here's the list of checks performed by Chargebee:
All the customers should have an email ID in both Chargebee & Salesforce. Without the email ID, the customer will not be synced.
When customers are synced from Chargebee to Salesforce, if the same email ID is present for any Contacts, the customer details will be mapped and new records will not be created. If the same email ID is present for any open Lead, Chargebee will convert the Lead in Salesforce (into an Account, Contact and Opportunity). The rest of the customer details will be mapped to the contact and new records will not be created.
If Multicurrency is enabled in Salesforce.
If the user credentials have access to the necessary objects and fields in Salesforce.
If you have custom mandatory fields set up in Salesforce, Chargebee can send default values to such fields. To set this up, contact email@example.com .
Based on the checks performed, Chargebee will list the errors, if encountered:
Here's how you could fix some of the common errors during the validation process:
Set a Date: You need to set a date for Chargebee to pick the records and sync with Salesforce. Based on your choice, Chargebee will sync all the records from the date specified by you.
Next, define how the changes in Chargebee should be updated in Salesforce.
|What happens in Chargebee||You can choose what should happen in Salesforce|
|When a Customer is created||Create a new Account
Create a new Contact under an Account
|When a Subscription is created||Create a Subscription and an Opportunity
Create a Subscription but don't create an Opportunity
|When a Subscription is upgraded||Update the existing Opportunity
Create a new Opportunity and update the probability of existing Opportunity (to 0%)
Don't update the Opportunity
|When a Trial is Created or changed (from Trial to Active state)||Create an Opportunity
Don't create an Opportunity
What happens in Salesforce when a new customer is created in Chargebee is defined here. The customer details will be retained as Contact details in Salesforce along with the company name.
There are two ways of handling new customers in Chargebee
Every Subscription in Chargebee creates a subscription (custom object) in Salesforce.
Following are the scenarios as far as a subscription is concerned:
i) Create Subscription: When a subscription is created in Chargebee, you can choose to create a subscription and an equivalent Opportunity in Salesforce, or just create a Subscription but not an Opportunity
ii) Upgrade Subscription: When a subscription is updated in Chargebee, there are 3 ways of updating an Opportunity in Salesforce:
Subscription downgrades will not be updated to Salesforce
iii) Trial Subscriptions: When a trial subscription is created or changed, you can either create a zero value Opportunity in Salesforce or don't create an Opportunity in Salesforce. When the trial subscription is moved to active state in Chargebee, an Opportunity will be created in Salesforce.
When Chargebee is configured to create an Opportunity in Salesforce, Chargebee will check if there are any open Opportunities for the same Contact and map the corresponding Subscription with the Opportunity instead of creating a new Opportunity.
If there are more than one open Opportunities, the Opportunity with a matching product will be considered. If there are no matching Opportunities (with product), the most recently created Opportunity will be mapped to the Subscription and be updated with the relevant information like Products and Opportunity value.
Once the sync preferences are set, Chargebee will do a ‘Test Sync' with the first 10 records which were created on or from the date set by you. You could check how the sync reflects in your Salesforce account
The initial sync could be bumpy and you're likely to run into errors. Chargebee will give you a description of the errors. You can either resolve them and retry the sync or skip and proceed. If you choose to skip a customer record, keep in mind that the related records such as invoices, transactions will not be synced. You can always initiate a sync manually after fixing the errors with the given record.
After the test sync, you'll also find the option on Sync All Records which will initiate a sync for all records between Chargebee and Salesforce.
Auto Sync: You can enable auto-sync and this option will initiate a sync, which will sync data every 30 minutes between Chargebee and Salesforce.
Sync Now: At any point in time, if there's a change in Chargebee that need to be reflected in Salesforce, Sync Now option will sync the changes made and update the same in Salesforce immediately.
Manage Preferences: This option allows you to update or change your sync preferences. However, the changes made after the initial setup will only take effect from the next sync onwards and will have no impact on the data that were synced previously.
Remove Integration: In case you want the integration to stop, this is the option to use. The link between Chargebee and Salesforce will be removed and will stop any further data from being synced until you set it up again. However, this will not affect the data which has been synced already.
Download: This option will download the error log (in a CSV format). This will help you sort the errors and prep the data again for sync.
Updates in your Salesforce account can be synced in your Chargebee site. Sync will take place in the background without you having to log in to your Chargebee account while working on your Salesforce Account, given Auto Sync is ON.
The following are the operations you can perform in Salesforce to sync in your Chargebee site :
|Update Payment Method||Prompts the customer to update their payment method. The customer will be redirected to Chargebee's Checkout page|
|Create Customer in Chargebee||A leads conversion to customer can be recorded in your Chargebee site|
|Create Subscription||Creates a subscription for the customer in your Chargebee site|
After setting up the integration of Chargebee with Salesforce, you will find Custom buttons of Chargebee in your Salesforce account. These buttons can be added to your existing Salesforce layout and can perform the operations ‘Update Payment Method', ‘Create Customer in Chargebee' and ‘Create Subscription'.
You can place the buttons in the following objects in Salesforce:
Only certain operations can be carried out in the given objects and here's how it works:
|Salesforce Object||Chargebee Operation|
|Contacts|| - Create Customer in Chargebee
- Update Payment Method
- Create Subscription
There are three buttons available in Salesforce for the three Chargebee operations: ‘Update Payment Method', ‘Create Customer in Chargebee' and ‘Create Subscription'. Buttons for all three operations will be made available in your Salesforce account once the integration setup is done. Now to configure these buttons in the Salesforce Objects, follow the steps as below:
Navigate to Accounts/Contacts/Opportunities in your Salesforce Account
Select an Account or a Contact or an Opportunity and find the option Edit Layout on the left-top corner of the screen
In the ‘Account/Contact/Opportunity Layout' Menu, select Buttons where you will find the list of buttons along with the ones from Chargebee
Select the operation and drag it to the Account/Contact/Opportunity Detail section, in to the Custom Buttons box.
Save the changes you made using the Save option on the left-top corner.
If you're using Salesforce Lightning UI, Chargebee's buttons will be available in Mobile and Lightning Actions section.
Update Payment Method:
Payment methods and subscription are saved against a customer. Using this option you can prompt the customer to update their associated payment method.
An email will be sent to the customer with the link to the checkout page where they can add the payment details.
The information will be collected in Chargebee's end. Once the payment information is filed, you can sign up for the subscription on your customer's behalf. However, if you want the customer to update their payment method as well as sign up for the subscription, send them the checkout link.
If there is no customer or subscription linked to the Account, you can send a form to the customer to enter their details, the subscription they're opting for and the payment method. This will in turn create a customer, link a subscription to their Account and create an invoice and collect payment based on the payment method they saved.
This option will create a subscription for the customer from the list of plans.
Clicking on create subscription will allow you to create a subscription for the customer from your end.
However, if you want your customer to create a subscription themselves, you could use the option ‘Send Checkout Link'. This will send an email to your customer.
The checkout link included in the email will redirect the customer to the page where the Subscription details and the Customer information are pre-populated. The payment details needs to be entered by the customer in this page.
When a Subscription is created from an Account, you will be prompted to choose a Customer and an Opportunity. Choosing a Customer is mandatory. However, if you haven't chosen an Opportunity, Chargebee will create one in Salesforce by default.
When customer is created from a Contact, you will be prompted to choose an Opportunity. However, if you haven't chosen one, Chargebee will create an Opportunity in Salesforce by default.
Create Customer in Chargebee:
If there ever comes a need to save the details of a lead or a Contact in your Salesforce account as a customer in Chargebee, this option will come in handy. A new customer will be created in Chargebee based on your Customer's email ID.
In case you use Salesforce for customer acquisition and Chargebee for subscription creation & management, this is the right option for you.
Which Salesforce edition is the integration supported?
Chargebee-Salesforce integration is supported only by Salesforce Enterprise Edition
Is the Lightning UI framework supported?
Yes, the integration is supported in the Salesforce Classic and Lightning UI frameworks.
How do I change the Sync Start Date later?
Contact firstname.lastname@example.org to change the Sync Start Date you had set up initially, as the option is not currently available in the Chargebee App.
Does Chargebee support Person Accounts?
Chargebee does not support Person Account currently. However, if the feature is enabled in Salesforce, Chargebee will create Accounts in Salesforce with record type as Business Accounts.
Does Chargebee-Salesforce Integration support price overriding?
Price overriding done in Chargebee will reflect in Saleforce during one-way sync. If you're creating a subscription in Salesforce, you can define custom pricing
Will the shipping address of the subscription in Chargebee be visible in Salesforce?
Yes, the shipping address added for the subscription in Chargebee will reflect in the address section in ‘CB Subscription' custom object.