New in Chargebee: Explore Reveal and understand your payment performance end-to-end.Try Now
Docschargebee docs
HomeBillingCPQPaymentsRevRecGrowthReveal
Support

Product Updates

  • Release Notes

Getting Started

  • Overview
  • Chargebee Billing Data Centers
  • Object Relationship Model
  • Understanding Sites
  • Chargebee Tech Glossary
  • Articles and FAQ

Implementing Chargebee

  • Implementation Guide
  • Go-live Checklist
  • Articles and FAQ

Agentic AI

  • Chargebee Copilot
  • Catalog Setup Assistant
  • MCP Servers

Developer Resources

  • Developer Resources Overview
  • API Explorer
  • Articles and FAQ

Chargebee Apps

  • Chargebee Apps CLI Developer Guide

Product Catalog

  • Product Catalog Overview
  • Coupons
  • Articles and FAQ

Subscriptions

  • Working with Subscriptions
  • Billing
  • Orders
  • Articles and FAQ

Customers

  • Managing Customers
  • Account Hierarchy
  • Email Notifications
  • Branding
  • Configure Multiple Languages
  • Articles and FAQ

Entitlements

  • Entitlements Overview
  • Features Overview
  • Feature Management
  • Managing Product Entitlements
  • Subscription Entitlements
  • Customer Entitlements
  • Grandfathering Entitlements
  • Articles and FAQ

Usage Based Billing

  • Overview
  • Use Cases
  • Setting up Usage Based Billing
  • Usage Alerts
  • Prepaid credits
  • Mid-term Subscription Changes
  • FAQs

Invoices, Credit Notes, and Quotes

  • Invoices
  • Credit Notes
  • Quotes [Legacy]
  • Transactions
  • Articles and FAQ

Taxes

  • Overview
  • Configuring Taxes
  • Country-specific Taxes
  • Articles and FAQ

E-Invoicing

  • Overview
  • Enabling E-Invoicing

Hosted Capabilities

  • Overview
  • Hosted Checkout
  • Hosted Self-Serve Portal
  • Hosted Pages Features
  • Additional Hosted Pages
  • Payment Components
  • Pricing Table
  • Mobile SDKs and Wrappers
  • Articles and FAQ

Site Configuration

  • Add Users & Assign Roles
  • Chargebee Notifications
  • Custom Fields & Metadata
  • Approvals
  • Mandatory Fields
  • File Attachments & Comments
  • Advanced Filter Options
  • Multicurrency Pricing
  • Multi-decimal Support
  • Configuring Reason Codes
  • Events and Webhooks
  • API Keys
  • OAuth Apps
  • Time Zone
  • Time Machine
  • Transfer Configurations
  • Articles and FAQ

Multi Business Entity

  • Multi Business Entity Overview
    • Limitations and Feature or Integration Support in Multi-Business Entity
    • Multi Business Entity Invoices
    • Multi Business Entity Taxes
    • Multi Business Entity Notifications
    • Multi Business Entity Reports and Analytics
    • Multiple Business Entity Offline Payments
    • Multi Business Entity Gateway Configuration
    • Multi Business Entity Smart Routing
    • Multi Business Entity Transfer Configuration
    • Multi Business Entity Integrations
    • Best Practice to Use API Keys for Multi Business Entity
    • Frequently Asked Questions
  • Customer Transfer Overview
  • Articles and FAQ

Mobile Subscriptions

  • Overview
  • Omnichannel Subscriptions
  • Omnichannel Subscriptions (Legacy)

Reports and Analytics

  • RevenueStory
  • Home Dashboard
  • Frequently Asked Questions
  • FAQs for Classic Reports Sunset
  • Articles and FAQ

Integrations

  • Sales
  • Customer Support and Success
  • Finance
  • Tax
  • E-Invoicing
  • Marketing
  • Stitch
  • Collaboration
  • Contract Management
  • Ecommerce Management
  • Articles and FAQ

Data Privacy & Security

  • Two Factor Authentication
  • SAML Single Sign-On
  • System for Cross-Domain Identity Management (SCIM)
  • EU-GDPR
  • Consent Management
  • Personal Data Management
  • Compliance Certificates
  • HIPAA Guidelines
  • PCI Recommendations and Integration Types
  • Articles and FAQ

Data Operations

  • Bulk Operations
  • Migration
  • Articles and FAQ
  1. Billing
  3. Multi Business Entity
  5. Multi Business Entity Overview
  6. Multi Business Entity Gateway Configuration
  1. Billing
  3. Multi Business Entity
  5. Multi Business Entity Overview
  6. Multi Business Entity Gateway Configuration

Multi Business Entity Gateway Configuration

The Multi Business Entity (MBE) feature enables you to configure payment gateways for each of your entities. Each entity can use its own gateways along with the gateways configured at the site level.

Prerequisites

  • Multi Business Entity is enabled on your Chargebee site, and the business entities you need are created.
  • Gateway configuration for a business entity is available on every Multi Business Entity site. No additional setup is required.

Gateways a business entity can use

A gateway you add for a business entity is available only to that entity. Other entities cannot use it, and the gateway's credentials and settings stay with that entity.

A gateway you add at the site level stays available to every business entity.

Smart Routing chooses which of those gateways processes a payment.

By default, the entity uses the Smart Routing rules configured at the site level. Checkout and the API follow those rules, including for a currency that has a gateway only at the site level.

Customize Smart Routing for an entity when that entity needs different rules from the site. If you customize it, set a gateway for each currency the entity accepts. Customizing Smart Routing does not remove site-level gateways from the entity. It changes which rules choose the gateway.

Configure a gateway for a business entity

Add the gateway while you are working in that entity. You configure it the same way you configure a gateway at the site level.

  1. Switch to the business entity.

  2. Click Settings > Configure Chargebee > Payment Gateways.

  3. Click Add Gateway, select the gateway, and complete its configuration.

    Add Gateway button on the Payment Gateways page

  4. The gateway is available only to that entity. Gateways added at the site level remain available to every entity.

GoCardless accounts on a Multi Business Entity site

A site can connect one GoCardless account. Add that account at the site level or for a business entity. You cannot connect a second GoCardless account.

Articles & FAQs

How do I switch between multiple entities?
How to enable Multiple Entities in Chargebee?
Smart routing rule vs preferred currency

Was this article helpful?