Docs

Enrichment with Chargebee Billing 

Chargebee Retention's Enrichment integration with Chargebee Billing allows you to pull in fields from your Chargebee Billing and map them to fields in Retention for use in both personalization, targeting, and data segmentation. Once you have connected your Chargebee API keys, you will have fields auto-mapped into Retention. Chargebee Retention will match sessions to subscription_id's in Chargebee Billing and pull back the relevant fields from the subscription and customer records.

Once you have successfully connected the Chargebee Integration, you will be able to select fields by field type from Chargebee under field mapping.

Go ahead and map as many fields as you would like. Mapped fields can be used to personalize the cancel page, target the cancel experience/offers, and in reporting via the customer's page.

Standard Fields Mapped from Chargebee 

When you connect the Chargebee Integration to Retention, we will automatically enable Enrichment and map a set of Fields from Billing into Retention. These fields can be viewed under Settings > Setup > Field Mapping.


The fields we pull from Chargebee are as follows:

Field Map
Chargebee Retention Chargebee Billing
Organization Name Customer Company Name
Owner First Name Customer First Name
Owner Last Name Customer Last Name
Owner Email Customer Email
State Customer State
Country Customer Country
Billing ID Customer ID
Plan ID Plan ID
Plan Interval Billing Period Unit
Interval Length Billing Period
Quantity Plan Quantity
Subscription Create Date Subscription Create Date
Subscription Current Period Start Subscription Current Term Start
Subscription Current Period End Subscription Current Term End
Subscription Start Date Subscription Start Date
Subscription Trial Start Date Subscription Trial Start Date
Subscription Trial End Date Subscription Trial End Date
Subscription Unit Amount Plan Unit Price
Subscription MRR Subscription MRR
Coupon IDs Applied Coupon IDs
Coupon Codes Applied Coupon Codes
Customer Create Date Customer Create Date
Customer Type Customer Type
Plan Amount Plan Amount
Subscription Amount Subscription Amount

Example Chargebee payload 

"subscription.started_at" : "1970-01-01T00:00:00Z", 
"subscription.customer.company_name" : "Chargebee", 
"subscription.id" : "premium_snack_pack", 
"subscription.activated_at" : "1970-01-01T00:00:00Z", 
"subscription.created_at" : "1970-01-01T00:00:00Z", 
"subscription.customer.last_name" : "Chargebee", 
"subscription.plan_quantity" : 1, 
"subscription.plan_unit_price" : 99, 
"subscription.mrr" : 99, 
"subscription.billing_period_unit" : "MONTH", 
"subscription.billing_period" : 1, 
"subscription.customer.created_at" : "1970-01-01T00:00:00Z", 
"subscription.plan_id" : "cbdemo_prem_s_p", 
"subscription.customer.email" : "jane@chargebee.com", 
"subscription.plan_amount" : 99000, 
"subscription.customer.first_name" : "Jane", "subscription.customer.id" : "cb_janebb"

Missing a field? Please contact retention-support@chargebee.com and we'll look into adding it.

Was this article helpful?
Loading…