Chargebee
Seamlessly integrate Kiflo with Chargebee to collect end-users payments into Kiflo and generate rewards for your partners.
Overview
Turn on the integration when you want to convert leads or deals and generate rewards automatically on successful payments from Chargebee.
There are three actions that can be automated:
Convert lead to customer
It converts a lead to a new customer in Kiflo matching the customer's email from Chargebee.
Associate customer on deal
It associates an existing customer or create a new one to an existing deal in Kiflo using the customer's email from Chargebee.
Create transaction from succeeded payment
It creates a new transaction in Kiflo for each successful payment from Chargebee if the payment is made by a known customer. Kiflo uses the Chargebee Customer ID to find the customer, and add the new transaction to it.
The transaction is also associate with the customer's source partner allowing rewards to be given to the partner on successful payments.
Enable Chargebee integration
Go to:
- Manage
- Integrations
- Chargebee
Then click the Add to Kiflo button.
When turned on, the options on the Settings tab become selectable:

Step 1: Enable options
Choose the options to turn on based on your business requirements.
Convert lead to customer
Turn it on when you work with leads and expect them to convert in Chargebee. On successful payment, Kiflo uses the new customer's email in Chargebee to find an existing lead in Kiflo.
If a lead is found Kiflo converts it to a new customer, otherwise nothing happens.
Associate customer on deal
Turn it on when you work with deals and expect them to be associated with customers when you receive the first payment from Chargebee. Kiflo uses the contact's email on the deal to match the new customer's email from Chargebee.
If the customer already exists in Kiflo it is associate with all deals matching the same email address. If the customer does not exist yet a new one is created.
Create transaction from succeeded payment
Turn it on when you want to capture payments to generate rewards. It creates a new transaction in Kiflo, associates it with the right customer and source partner.
When enabling this option you must enable at least one of the previous two options, either Convert lead to customer or Associate customer on deal.
Step 2: Configure Chargebee
You must configure a new webhook in your Chargebee account to listen to successful payments.
Official documentation: Webhook Settings
Copy the Webhook URL from Kiflo:

In Chargebee, go to:
- Settings
- Configure Chargebee
- Webhooks
Then, click on Add Webhook and fill the form:
- Webhook Name: Give a meaningful name like "Kiflo Chargebee integration"
- Webhook URL: Paste the URL you copied from Kiflo
- Events to Send: Select Payment Succeeded and Subscription Canceled
Optionally check the "Exclude card information from webhook call" option and click Create:

Chargebee Properties
When the integration is turned on, new properties are automatically added to enrich customers and transactions.
| Object | Property | Description |
|---|---|---|
| Customer | ChargeBee Customer ID | Stores the identifier of the customer from Chargebee. |
| Transaction | Chargebee Transaction ID | Stores the identifier of the transaction from Chargebee. |
| Transaction | Chargebee Invoice ID | Stores the identifier of the invoice associated with the transaction from Chargebee. |
Advanced configuration
If the above options are not enough to handle your use cases, you can configure advanced options:
Click the Show advanced options link:

How to match Kiflo's leads and deals with Chargebee's customers?
| Option | Description | Examples |
|---|---|---|
| Full email address | When a new payment is received from Chargebee, Kiflo uses the email address on the Chargebee customer to find the corresponding lead or deal. Then it creates a Kiflo Customer and save a new Transaction. | Perfect for B2C. When the lead submitted in Kiflo is the same person who will pay in Chargebee. |
| Email domain only | When a new payment is received from Chargebee, Kiflo uses the domain from the Chargebee customer's email address to find the corresponding lead or deal. Then it creates a Kiflo Customer and saves a new Transaction. | Perfect for B2B. When you sell to companies, and the email address on the Lead in Kiflo (ex: john@foobar.com) is not the same as the email in Stripe (ex: billing@foobar.com). |
How transactions must be created?
| Option | Description | Examples |
|---|---|---|
| One transaction per invoice/charge | Create one transaction for the entire invoice or charge |
If an invoice contains 2 line items: - Kiflo PRM - Premier - Onboarding services Only one transaction will be created. The amount will be the sum of the 2 line items. |
| One transaction per line item | Create one transaction for each individual line item in the invoice |
If an invoice contains 2 line items: - Kiflo PRM - Premier - Onboarding services Two transactions are created. |