Multi-tenant and white-label: embed the BCE API at your clients

In brief

The multi-tenant integration of the BCE API lets franchises, accounting networks and resellers embed Company Belgium under their own brand: dedicated landing page, custom branding, own domain. Configuration takes a few hours via a self-service API, with no redeployment required.

Multi-tenant isn't just database partitioning

For many software vendors, "multi-tenant" stops at partitioning databases. Necessary, but deeply insufficient. When a franchisee, accounting firm or reseller uses your platform to serve their own clients, they want the experience to bear their name, not yours.

We shipped this brick for integrators embedding the Company Belgium API into their own product.

When multi-tenant becomes strategic

• Franchises — every local outlet wants its own storefront.

• Accounting networks — firms reselling our BCE/KBO lookups and wanting to skin them to their brand.

• API resellers — integrators embedding our backend who don't want "Powered by Company Belgium" plastered everywhere.

What a tenant controls

Custom header and shell

The TenantHeader and TenantShell components consume the current tenant's config at render time. Logo, display name, navigation links, right-hand elements — all configurable without touching code.

Dedicated landing page

A landing engine lets them compose a home page out of reusable blocks. Rendering is dynamic: the same public URL renders the tenant's landing detected via subdomain or path.

Colors, typography, logo

CSS variables are driven by the tenant config. An admin change propagates instantly to rendering.

Domain and subdomain

• Subpath — companybelgium.be/my-partner, instant.

• Dedicated domain — my-partner.be, DNS + certificates handled automatically.

Self-service branding API

1
2
3
4

# Fetch the tenant branding config
curl https://companybelgium.be/api/tenant/branding \
  -H "X-API-Key: pk_live_..." \
  -H "X-API-Secret: sk_live_..."

1
2
3
4
5

# Update logo and primary color
curl -X PUT https://companybelgium.be/api/tenant/branding \
  -H "X-API-Key: pk_live_..." \
  -H "X-API-Secret: sk_live_..." \
  -d '{"logoUrl": "https://cdn.partner.be/logo.svg", "primaryColor": "#0066cc"}'

Security and isolation

• Logical DB isolation — sensitive entities carry a mandatory tenantId, checked on every request.

• Session scoping — a user logged into a tenant sees only that tenant's data.

• Logging — every action logged with the tenant.

Use cases already live

• An accounting firm in Wallonia — its own subdomain, BCE lookups in its name.

• A due diligence network — per-office landing, network-wide dashboard on top.

• An API reseller — resells the product with its own T&Cs. We stay invisible.

Who is it for?

If you run a network, franchise or reseller program, and you're considering "building our own portal", ask yourself: how much time, how much money, how many people? This brick delivers the same promise in a few hours of setup. Explore our partner program with automatic commission and our guide on securing API keys.