How do I resolve field mapping issues when syncing Chargebee with Salesforce?

Related Scenarios

• Products sync partially; some fields are missing or blank.
• New products or item prices do not appear in Salesforce.
• Sync fails silently (no logs).
• Sync error: ITEM_DOES_NOT_EXIST.

Problem Statement

Chargebee products may not sync or map correctly to Salesforce: some fields are missing or blank, new items do not appear, and item prices show ITEM_DOES_NOT_EXIST errors with no sync logs. This often occurs when the Salesforce user used for the integration has MFA enabled and Session Security Level Required at Login set to High Assurance.

Solution

Salesforce rejects Chargebee API calls when the integration user has MFA and Session Security Level Required at Login set to High Assurance. The error is:

Fix it by either using a different Salesforce user without this requirement or by changing the existing user's session settings (see Configuration Steps below).

Configuration Steps

Option 1: Use another Salesforce user

1. Assign the integration to a user who does not have MFA or High Assurance session level.
2. Ensure that user has the API and object-level permissions required for Chargebee Sync.

Option 2: Modify the existing user's settings

1. In Salesforce, go to Setup.
2. Open Profiles > [Integration User Profile].
3. Under Session Settings, set Session Security Level Required at Login to None.
4. Save.

Then in Chargebee:

1. Go to Advanced Actions.
2. Select Retrieve Items to re-sync products and item prices.
3. Confirm that products and fields are now populated correctly in Salesforce.