Docs
Customer Sharing is currently in Early Adopter Phase and not enabled on your site. You can request for access () to join the Early Adopter Program to learn more about this feature.
When a business operates with multiple legal entities like subsidiaries, regional offices, or product-specific business units, the same customer might interact with more than one of these entities. The Customer Sharing feature in Chargebee allows you to manage that customer as one unified profile, even if their purchases span across different entities in your setup.
Without customer sharing, businesses would need to create duplicate customer records for each entity the customer transacts with. This leads to:
With Customer Sharing enabled, you can:
Unified Customer profile: A customer is created once and shared across multiple entities in your organization.
Subscription Flexibility: A customer can have subscriptions managed by different business units (entities), giving your organization greater operational flexibility.
Central Access: Although a customer belongs to one primary entity, they are accessible across other entities for tasks like retrieving information or creating subscriptions.
Streamlined Operations: Reduces duplication of customer data and avoids friction between systems.
Improved Customer Experience: Enables smoother cross-sell scenarios by providing unified service across entities.
Here’s an example: AcmeFarms, a farm-tech company headquartered in Texas, USA, operates through independent entities in India, Singapore, and Australia using Chargebee's Multi-Business Entity setup. Each entity caters to its local market and complies with regional legal and tax regulations.
Now, consider that AcmeFarms has a customer, GrowMate Corp, a multinational agricultural retailer, with teams based in all three regions.
GrowMate Corp:
Without customer sharing, this would mean:
Three separate customer records across the three entities Fragmented subscription history and duplicated customer details Siloed communication and invoicing processes
With Customer Sharing enabled,
Chargebee allows AcmeFarms to create a unified and centralized customer profile for GrowMate Corp under an entity that AcmeFarms chooses, AcmeFarms India in this scenario.
From there:
Subscriptions from Singapore and Australia are linked to the same GrowMate customer profile, with AcmeFarms India serving as Growmate’s primary entity (first point of contact).
All entities can work together to serve the same customer using a single shared customer record, eliminating the need for duplication. Each entity retains its own subscription, billing, and tax logic, ensuring localized control. Billing is linked to a central customer profile, while shipping details are managed at the subscription (entity) level.
To enable and use this feature:
The setting for centralized customer profiles must be enabled. Request for accessContact eap@chargebee.com
When a new customer signs up:
While Customer Sharing allows you to maintain a unified customer profile across entities, payment methods are not shared between entities.
Each entity independently collects and stores its own payment methods. This ensures that payment processing, gateway configurations, compliance requirements, and financial operations remain separate for each legal entity.
This means that if a shared customer subscribes to products from multiple entities, they may need to provide payment details separately for each entity.
Payment methods are vaulted based on your Smart Routing configuration. However, regardless of routing setup, payment methods remain entity-specific.
If an entity overrides the site-level Smart Routing configuration:
If Smart Routing is configured only at the site level:
| Setting | Recommendation |
|---|---|
| Primary Entity | Assign during customer creation. Serves as the billing and communication anchor. |
| Product Catalog | Can be shared across entities or unique per entity. Decide based on your org’s structure. |
| Invoice Branding | Configure logos, from-addresses, and email templates for each entity. |
| Tax Rules | Set up per entity, especially if using manual tax configuration. |
This table outlines how customer-related actions work across different entities when Customer Sharing is enabled**.
| Action | What You Can Expect |
|---|---|
| Creating a Customer | Customers are created under a selected “primary” entity. Other entities can access the shared profile. |
| Viewing Subscriptions | Site View: All subscriptions across entities are listed. |
| Creating a Subscription | Subscriptions can be created under any entity. They are correctly mapped and billed by that specific entity. |
| Invoicing | Invoices are created per entity. |
| Credits & Payments | Credits and payments are entity-specific. A payment made under one entity won’t be used automatically for another. |
| Quick Charges & One-Time Charges | Can be processed per entity. Payments/credits from one entity won’t apply to another. |
| Editing Customer Info | Basic customer information like name, contact, and billing address can be edited and will reflect across entities. |
| Contacts & Cards | Contacts and saved payment methods are entity specific and cannot be shared across entities. |
| Invoice Notes | Site View: All invoices across entities are visible. |
| Comments | Site View: All comments across entities are visible. |
| Promotional Credits | Site View: Credits from all entities are visible. |
| Viewing Transactions & Events | Site View: Transactions from all entities are visible. |
| Merging Customers | If duplicate customer records exist across multiple entities for the same customer, you can merge them into a single record. |
| Self-Service Portals | Customer sharing across entities is currently not supported for customer portal. |
| Hosted Pages | Customer sharing across entities is currently not supported for Hosted Pages. |
| Hierarchy (Parent-Child Setup) | You can create parent-child customer relationships within the same entity. |
Your Chargebee catalog may be shared across all entities or remain entity-specific.
Unified Customer Profile: Maintain one profile with visibility into all subscriptions, regardless of entity.
Streamlined Billing: Generate separate invoices for each entity, allowing flexibility based on your operational preferences.
Tax & Branding Support: Apply entity-specific tax rates, logos, and contact details in invoices and emails.
Entity-Specific Subscriptions: Let each entity create and manage its own subscriptions under a shared customer record.
Frictionless Cross-Sell: Offer products and services from multiple entities without duplicating customer data.
Payment methods are not shared across entities. At checkout, only the customer’s payment methods associated with the specific checkout entity will be displayed.
Was this article helpful?