Mapping Apple and Google Products

Chargebee allows you to fetch products from the Apple App Store and Google Play Store and map them to your Chargebee plans. This enables you to view store-specific plans in Chargebee, link entitlements, and grant privileges for app purchases made in these stores.

To link Apple and Google products to Chargebee, follow these steps:

1. Login to your Chargebee Billing site.
2. Navigate to Product Catalog > Plans.
3. Select the desired plan to view the Plan Details page.
4. Under the Pricing section, the following options appear.
   • Web
   • Apple App Store
   • Google Play Store
   
5. Select the Apple App Store / Google Play Store tab to link the respective products.
   1. Mapping Apple subscription products to Chargebee plans
   2. Mapping Google subscription products to Chargebee plans

Mapping Apple subscription products to Chargebee plans

1. Click Link Product Pricing to begin the process.
   
2. Select an app from the list of your connected Apple apps present in Chargebee.
   
3. A list appears with subscription groups available for the selected app. Select any one of the subscription groups from the list.
   
4. After selecting a subscription group, all the associated subscription products will be listed. Select one or more subscription products to link with the Chargebee plan.
   
5. Click Link Products to complete the mapping. A success message appears, and the linked plans appear in the same tab.
   
6. Click View Pricing to view the Apple App Store pricing page of the subscription product.
7. Click Link More Products to link more products to the Chargebee's plan. To prevent duplicates, subscription products that are already linked will appear disabled.
   

Mapping Google subscription products to Chargebee plans

1. Click Link Product Pricing to begin the process.
   
2. Select an app from the list of your connected Google apps present in Chargebee.
   
3. A list of subscription products available for the selected app appears. Select any one of the subscription products from the list.
   
4. After selecting a subscription product, all the associated base plans will be listed. Select one or more base plans to link with the Chargebee plan.
   
5. Click Link Products to complete the mapping. A success message appears, and the linked plans will be listed in the same tab.
   
6. Click View Pricing to view the pricing of the base plan in Google Play Console.
7. Click Link More Products to link more base plans to the Chargebee's plan. To prevent duplicates, subscription products that are already linked will appear disabled.
   

Unlink Google Play Store or Apple App Store Products

If you linked wrong products by mistake, click Unlink unlink all the linked products from Chargebee's plan.

Retrieving Entitlements for a Linked Product in Chargebee

After linking Apple or Google products to Chargebee plans, you can fetch all associated entitlements using the List Item Entitlements for an Item API.

Follow these steps to implement this functionality:

1. Monitor omnichannel events such as create, upgrade, or downgrade that are relevant to entitlement management. Alternatively, you can call the Retrieve an Omnichannel Subscription API using the omnichannel_subscriptions_id to get the details of the omnichannel_subscription_item.

2. Get the linked_item.id value from the omnichannel_subscription_item object. This maps the Apple or Google Store plan (via item_id_at_source) to the Chargebee plan ID (linked_item.id).

3. Pass linked_item.id as the {item_id} path parameter in the List Item Entitlements for an Item API to retrieve the entitlements linked to that item.

Learn more about implementing entitlements.