Skip to main content

Multi-Tenancy

Paratro supports full multi-tenant isolation, allowing you to manage multiple organizations, business units, or end customers from a single deployment. Each tenant operates in a completely isolated environment with its own wallets, users, policies, and audit logs.

Tenant Isolation

Each tenant has:
  • Separate wallets — No cross-tenant wallet access
  • Independent policies — Each tenant defines its own approval workflows
  • Isolated users — Users belong to specific tenants with scoped permissions
  • Separate audit logs — Complete audit trail per tenant
  • Independent API keys — Keys are scoped to a single tenant

Use Cases

ScenarioDescription
Platform ProviderOffer wallet services to multiple end customers, each fully isolated
EnterpriseSeparate business units (treasury, operations, trading) with independent controls
Managed ServicesOperate wallets on behalf of multiple clients with audit separation

Creating Tenants

curl -X POST https://api.paratro.com/v1/tenants \
  -H "Authorization: Bearer ADMIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Acme Corp",
    "settings": {
      "max_wallets": 100,
      "allowed_chains": ["ethereum", "bitcoin", "tron"]
    }
  }'

Operating Within a Tenant

Use the X-Tenant-ID header to scope API requests to a specific tenant:
curl https://api.paratro.com/v1/wallets \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-Tenant-ID: tenant_acme"

Tenant Administration

Administrators can:
  • Create and manage tenants
  • Set resource limits per tenant (wallet count, transaction volume)
  • Configure allowed chains and asset types per tenant
  • View cross-tenant analytics and reporting
  • Manage tenant-specific API keys and user access