Skip to main content

Tenant Management

Platform administration and multi-tenant configuration capabilities.

Features​

Tenant Configuration​

  • Platform identity and branding
  • Global settings and defaults
  • Multi-tenant isolation and security
  • Database schema management
  • Plugin configuration at scp level
  • BI (Business Intelligence) configuration and analytics dashboards

Customer Onboarding​

  • Create and manage customers (holding companies)
  • Customer-level settings and customization
  • Merchant provisioning workflow
  • Customer billing and subscription management
  • Sales pipeline tracking via Prospect Context

User & Access Management​

  • Platform admin user management
  • Role-based access control (RBAC)
  • Permissions at tenant, customer, and merchant levels
  • Impersonation for support workflows
  • User authentication and session management

Platform Monitoring​

  • Audit logs for compliance tracking
  • System health monitoring
  • Usage analytics and metrics
  • Security event tracking
  • Database interceptor for data access logging

Plugin Administration​

  • Configure default plugins (payment, SMS, email)
  • Plugin inheritance across tenant → customer → merchant
  • API key and credential management
  • Integration health monitoring
  • Plugin versioning and updates

Multi-Tenant Architecture​

The scp uses a hierarchical multi-tenant model:

Tenant (Platform Operator)
  ├─> Default Plugins
  ├─> Platform Users
  └─> Customers (Holding Companies)
       ├─> Customer Plugins (inherit or override)
       └─> Merchants (Individual Businesses)
            ├─> Merchant Plugins (inherit or override)
            └─> End Customers

Security Model​

  • Row-level security via owner_id pattern
  • Skip owner checks for scp queries using skip_owner_id: true
  • Audit logging for all administrative actions
  • Encryption at rest and in transit
  • Database interceptor for access control

See the API Reference for tenant management endpoints:

  • GET /api/tenants - Tenant configuration
  • GET /api/merchant-orgs - Customer/holding company management
  • GET /api/users - User management
  • GET /api/roles - Role-based access control
  • GET /api/audit-logs - Audit logs