Docs
When you are selling physical goods on a recurring basis, handling subscriptions, orders, and billing together is critical yet challenging. Chargebee integrates with BigCommerce to help you manage subscriptions for your physical goods, fulfillment, and billing with ease.
When new subscribers sign up for your products through Chargebee, recurring orders can be automatically created and passed to BigCommerce for fulfillment and inventory management.
Here's a workflow of how Chargebee and BigCommerce integration works:
This is two-way data synchronization between Chargebee and BigCommerce. The data flow for various objects is explained below:
Customer records that have orders in Chargebee get synced to BigCommerce as follows:
While setting up your checkout using this integration, make note of the following points:
Orders are synced as follows between Chargebee and BigCommerce:
Ensure that the following prerequisites are met in Chargebee and BigCommerce, before configuring the integration.
Though not a prerequisite, it is recommended to have shipping and billing information for all orders in Chargebee to prevent processing errors by third-party fulfillment platforms linked to BigCommerce.
To install the Chargebee app in your BigCommerce store, follow these steps:
Log in to your BigCommerce store and click Apps > Marketplace > Chargebee > Install.
Click Confirm and allow Chargebee to access customers, products, and orders in your BigCommerce store.
In the next screen, enter the Chargebee site name that you want to integrate with the BigCommerce store and select the region in which your Chargebee site is hosted. Click Connect.
After being redirected to Chargebee, enter your login credentials to connect your BigCommerce store with Chargebee.
After logging in to your Chargebee site on the BigCommerce store, you can configure the following settings based on how you want to sync orders from Chargebee to BigCommerce:
How many days before the shipping date would you like to sync orders: Enter the number of days before the shipping date you want the orders to be synced from Chargebee to BigCommerce.
Choose the orders you'd like to sync from Chargebee to BigCommerce: You can select from the following options:
Use billing address as shipping address: When this setting is enabled, in the absence of a shipping address for order in Chargebee, the billing address will be used as the shipping address.
Use shipping address as billing address: When this setting is enabled, in the absence of a billing address for order in Chargebee, the shipping address will be used as the billing address.
Click Proceed. In the next step, configure how you want to sync new customer records from Chargebee to BigCommerce:
Once you have configured the sync preferences, you click Run Initial Sync to test the integration. This initiates the sync of orders from Chargebee to BigCommerce.
When the sync is complete, the order details that are synced and those which are not synced are displayed.
You can retry the initial sync, or click Proceed to sync all the orders from Chargebee to BigCommerce, which completes the setup. You can verify the data that is added to your BigCommerce store.
Chargebee syncs orders regularly based on your configuration. You can view the details of the orders that were successfully synced and edit preferences if required.
To view or edit the integration sync preferences in your BigCommerce store, click Apps > My Apps > Chargebee. You can configure the following settings:
While syncing order and customer records from Chargebee to BigCommerce, sync errors may occur for multiple reasons. When there are sync errors present after sync operation, Chargebee displays the last few error details for your reference. You can even generate a CSV file with all previous sync errors along with a reason for their respective failure to sync. The Generate Error CSV option is available only when there are sync errors present in the previous sync operation. If you do not see this option, it implies that all records were successfully synced to BigCommerce.
Click Generate Error CSV within the BigCommerce integration page, and Chargebee triggers the operation to prepare the CSV file with error details.
You may navigate to other screens in the Chargebee user interface while the file is being processed. Once the file is ready, you can click Download CSV to save the file from the integration page. The CSV file consists of all existing sync errors that are open from the prior sync operation. Any errors from the past sync operations that are fixed will not be listed.
You can integrate Chargebee In-app Checkout with your BigCommerce store to maintain all your customer and subscription information acquired through the BigCommerce store, in Chargebee. This step is crucial and is required after completing the BigCommerce integration.
All the details entered by your customers in the In-app Checkout window during checkout are saved in the respective customer record in Chargebee. To know more, refer to our docs on working with subscriptions and managing customers in Chargebee.
Ensure that you are PCI level 1 compliant before collecting and sending card details through API.
Chargebee supports the following three ways of integrating checkout:
1. How do I sell products (one-time, not subscriptions) via Chargebee?
Yes, you can create Non-recurring addons (shippable) in Chargebee. On purchase, an order will be created and synced to BigCommerce.
2. How to map Product ID in BigCommerce to plans/addons in Chargebee?
Follow these steps to retrieve the Product ID in BigCommerce and map them to respective plans and addons in Chargebee:
3. How does Self-serve portal work for Guest users in BigCommerce?
Your guest users cannot use the Self-serve Portal to manage subscriptions, as they cannot log in to BigCommerce.
4. Will Chargebee update the Product pages in BigCommerce?
No, Chargebee will not update the product pages in BigCommerce. You will have to add the necessary details on the product page/ product details page in BigCommerce on your own, such as adding the ‘Subscribe' button, ‘Billing frequency', and so on. On clicking the Subscribe button, Chargebee's Checkout will be loaded.
5. Can I re-install the app after uninstallation?
Yes, you can repeat the installation steps to install the Chargebee app in your BigCommerce store. When you uninstall and reinstall the Chargebee app on your BigCommerce store, please note that Chargebee does not store any settings or data basis what was previously synced to BigCommerce. Remember to use "sync from specific date" to avoid creating duplicate orders in BigCommerce if you have previously synced orders from Chargebee to BigCommerce.
Articles & FAQ