Multi-Tenancy

This guide demonstrates how integrators and BPO organizations can efficiently manage payment infrastructure across multiple merchants using Shuttle's multi-tenancy capabilities.

Video Walkthrough: Setting Up Multi-Tenancy in Shuttle

Overview

Shuttle's multi-tenancy architecture enables service providers to manage distinct payment environments for multiple clients within a single platform. This approach delivers consistent user experiences across diverse payment processors while maintaining complete client separation and customization.

Key Benefits

• Centralized Management: Oversee all client payment operations from a single dashboard
• Processor Agnostic: Maintain consistent workflows regardless of underlying payment processors
• Client Isolation: Ensure complete separation of client data, configurations, and reporting
• Scalable Architecture: Efficiently onboard and manage hundreds of client organizations
• Unified APIs: Integrate once and deploy across all client environments

Implementation Guide

Step 1: Master Account Setup

Create your primary Shuttle account using your organization's business details (not individual client information). This serves as the master account for managing all client environments.

Step 2: Organization Management

1. Navigate to the main menu and select Edit
2. Choose My Organizations from the menu
3. Create a dedicated organization for each client

This organizational structure enables:

• Isolated user teams per client
• Separate billing and reporting
• Independent configuration management
• Custom branding and settings

Step 3: Environment Configuration

Within each client organization:

1. Configure required payment environments (Payment Links, Twilio integrations, etc.)
2. Install and configure relevant applications
3. Set up each with client-specific payment processors and gateways
4. Customize user journeys and branding

Advanced Use Cases

Geographic Separation

For complex organizations requiring regional management, create separate organizations by geography, for example:

• Client-US: North American operations and compliance
• Client-EMEA: European operations with local payment methods
• Client-APAC: Asia-Pacific specific configurations

This approach enables:

• Regional compliance management
• Localized payment methods
• Currency-specific configurations
• Regional team management

Department Isolation

Large enterprises may require departmental separation:

• Client-Sales: Customer-facing payment processes
• Client-Operations: Internal billing and reconciliation
• Client-Support: Refund and dispute management

Billing

By default, billing is configured at the organization level, with each client organization receiving separate invoices. This standard approach works well when end clients manage their own payment processing costs.

For system integrators and BPOs who prefer to handle billing centrally across all client organizations, consolidated billing options are available. Contact our support team to discuss consolidated billing arrangements for your multi-tenant setup.

This multi-tenancy approach enables service providers to deliver enterprise-grade payment solutions while maintaining the flexibility and customization each client requires.