Multi-tenant et white-label : intégrer l'API BCE chez vos clients

En bref

L'intégration multi-tenant de l'API BCE permet à franchises, réseaux comptables et revendeurs d'embarquer Company Belgium sous leur propre marque : landing dédiée, branding personnalisé, domaine propre. La configuration se fait en quelques heures via une API self-service, sans redéploiement.

Le multi-tenant ne se limite pas à la base de données

Parler de « multi-tenant », pour beaucoup d'éditeurs, ça se limite à cloisonner des bases de données. C'est nécessaire, mais très insuffisant. Quand un franchisé, un cabinet comptable ou un revendeur utilise votre plateforme pour servir ses propres clients, il veut que l'expérience porte son nom, pas le vôtre. Sa landing. Son logo. Ses couleurs. Idéalement, son domaine.

Nous avons livré cette brique pour les intégrateurs qui embarquent l'API Company Belgium dans leur propre produit.

Quand le multi-tenant devient stratégique

• Les franchises — chaque point de vente ou cabinet local veut sa propre vitrine, tout en partageant les outils du réseau.

• Les réseaux comptables — fiduciaires qui revendent nos recherches BCE/KBO à leurs clients et veulent les habiller à leur marque.

• Les revendeurs API — intégrateurs qui embarquent notre backend dans leur propre produit et ne veulent pas que « Powered by Company Belgium » apparaisse à tout bout de champ.

Ce qu'un tenant contrôle

Header et shell personnalisés

Les composants TenantHeader et TenantShell consomment la configuration du tenant courant au moment du rendu. Logo, nom affiché, liens de navigation, éléments de droite (contact, espace client) — tout est paramétrable sans toucher au code.

Landing page dédiée

Un moteur de landing permet de composer une page d'accueil à partir de blocs réutilisables (hero, features, témoignages, tarifs, FAQ, CTA). Le rendu est dynamique : la même URL publique affiche la landing du tenant détecté via le sous-domaine ou le chemin.

Couleurs, typographie, logo

Les variables CSS sont pilotées par la configuration du tenant. Un changement dans l'interface admin se répercute immédiatement sur le rendu — pas de build, pas de redéploiement.

Domaine et sous-domaine

Deux modes :

• Sous-chemin — companybelgium.be/mon-partenaire, mise en place instantanée.

• Domaine dédié — mon-partenaire.be, configuration DNS + certificat gérés automatiquement par notre couche edge.

API de branding en self-service

Le tenant ne doit pas nous appeler pour modifier son logo. Une API REST lui permet de lire et mettre à jour sa configuration :

1
2
3
4

# Récupérer la configuration branding du tenant
curl https://companybelgium.be/api/tenant/branding \
  -H "X-API-Key: pk_live_..." \
  -H "X-API-Secret: sk_live_..."

1
2
3
4
5

# Mettre à jour le logo et la couleur primaire
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"}'

L'interface admin utilise elle-même cette API — donc le tenant a exactement le même niveau de contrôle que nos opérateurs. Pour aller plus loin, consultez notre guide sur la sécurisation des clés API.

Sécurité et isolation

Trois couches complémentaires :

• Isolation logique en base — toutes les entités sensibles (clients, factures, contrats, utilisateurs, clés API) portent un tenantId obligatoire, vérifié dans chaque requête.

• Scoping des sessions — un utilisateur connecté sur un tenant ne voit que les données de ce tenant, jamais celles d'un autre.

• Journalisation — chaque action est loggée avec le tenant concerné. Un contrôle ou incident peut être tracé précisément.

Cas d'usage déjà en production

• Un cabinet comptable en Wallonie — son propre sous-domaine, sa charte, recherches BCE à son nom alors que le backend est le nôtre.

• Un réseau de due diligence — landing dédiée, rôles et permissions scopés, tableau de bord global côté réseau.

• Un intégrateur API — revend le produit en ajoutant ses propres CGV et son support. Nous restons invisibles.

Pour qui ?

Si vous pilotez un réseau, une franchise ou un programme revendeur, et que vous envisagez de « construire votre portail vous-même », posez-vous la question : combien de temps, combien d'euros, combien de personnes ? Cette brique multi-tenant offre la même promesse en quelques heures de configuration. Découvrez aussi notre programme partenaires avec commission automatique et les nouveautés API v1 de mars 2026.