Architecture de paiement multilocataire (multi-tenant) : isoler chaque locataire sur une seule plateforme de paiement

Architecture de paiement multilocataire (multi-tenant) : isoler chaque locataire sur une seule plateforme de paiement

Table des matières

Une architecture de paiement multilocataire (multi-tenant) permet à une seule plateforme logicielle de traiter les paiements de nombreuses entreprises, ses locataires, au moyen d'une seule intégration, tandis que les marchands, les payeurs, les comptes bancaires, les frais et les données de chaque locataire restent isolés de ceux de tous les autres. Chez TIB Finance, le multilocataire n'est pas une fonction ajoutée par-dessus : c'est le modèle de données. Votre organisation est le client, chaque locataire est un service créé en un seul appel d'API, chaque compte bancaire est un marchand, et le serveur lui-même fait respecter les cloisons entre les locataires.

TIB Finance est un processeur de paiement souverain canadien, dont le siège est à Montréal, fondé en 2018 et conçu pour le B2B et le traitement de paiements multilocataire. Des entreprises bâtissent leur propre plateforme sur TIB, avec leurs propres clients et sous-marchands, et une vraie équipe humaine et bilingue accompagne chaque client et chaque partenaire. TIB sert plus de 1 000 entreprises, traite plus de 600 millions de dollars par année et plus de 200 000 transactions chaque mois.

Ici, la plateforme, c'est vous. Un locataire est l'un de vos clients, par exemple un gestionnaire immobilier, un prêteur ou une franchise. Un marchand est un compte bancaire d'un locataire et le nom que voient ses payeurs. Les payeurs paient vos locataires.

En bref : un client TIB (vous) regroupe de nombreux services (vos locataires). Chaque service a ses propres marchands, payeurs, modes de paiement, grille de frais et limites. Une session marchand ne voit que son propre marchand, le serveur y refuse les appels d'administration, les clés d'idempotence sont propres à chaque identifiant de connexion, et chaque webhook de transaction porte le MerchantId et le MerchantName. TIB garde les locataires séparés.

Vous bâtissez une plateforme multilocataire? Parlez à notre équipe, ou essayez le bac à sable gratuit.

Qu'est-ce qu'une architecture de paiement multilocataire?

Toute plateforme qui encaisse ou verse de l'argent pour ses clients fait face aux trois mêmes questions. Où aboutit l'argent de chaque locataire? Qui peut voir quelles données? Comment chaque paiement, chaque frais et chaque événement est-il rattaché au bon locataire? Une architecture de paiement multilocataire répond aux trois dans la couche de paiement elle-même, pour que votre application n'ait pas à rebâtir les cloisons dans son propre code.

Une plateforme peut greffer des sous-comptes à un système conçu pour un seul marchand et compter sur son propre code pour les garder séparés, ou bâtir sur un processeur dont le modèle de données est multilocataire dès le premier enregistrement. TIB Finance est du deuxième type. Vous envisagez plutôt de devenir facilitateur de paiement? Lisez notre guide sur la solution de rechange au PayFac au Canada, ou voyez le traitement de paiements multilocataire pour plateformes B2B pour la vue d'affaires.

Comment TIB Finance modélise-t-elle chaque locataire?

Chaque entité sur TIB s'inscrit dans une seule hiérarchie : client, puis service, puis marchand, puis payeur, puis mode de paiement. Les factures, les paiements et les virements sont rattachés à un marchand, et chaque marchand a son propre compte bancaire de destination.

Client : votre plateforme
Service : locataire AService : locataire BService : locataire C
Marchand : compte bancaire 1Marchand : compte bancaire 2
Payeurs et modes de paiement
  • Votre organisation est le client TIB. Vous vous connectez une seule fois et gardez la vue sur tous vos locataires.
  • Chaque locataire est un service. Un seul appel CreateSubClient le crée avec son propre nom, sa propre langue et sa propre devise, CAD ou USD, et retourne le nouveau ServiceId. Ce ServiceId remplace ensuite le vôtre dans chaque appel fait pour ce locataire.
  • Chaque compte bancaire ou unité est un marchand. CreateMerchant l'ajoute, avec le MerchantName que les payeurs voient sur les factures et les pages de paiement, ainsi qu'un ExternalSystemId qui le relie à sa fiche dans votre propre ERP ou CRM et un ExternalSystemGroupId qui regroupe des marchands liés.
  • Chaque payeur appartient à ce locataire et n'est jamais partagé avec un autre locataire.

Chaque sous-client obtient son propre environnement isolé, avec ses marchands, ses payeurs et ses modes de paiement dédiés. Quand un locataire doit être inscrit, CreateSubClient retourne aussi un BoardingRedirectUrl, et GetServiceBoardingStatus montre où en est chaque marchand d'un service.

Comment le serveur garde-t-il les locataires séparés?

Une isolation qui ne vit que dans votre code est à un bogue d'une fuite. Chez TIB, les cloisons sont appliquées côté serveur, dans la session elle-même.

Sessions délimitées

CreateSession ouvre une session au niveau client. GetLoginAccessList liste les accès d'un identifiant au niveau client, service ou marchand, et Login ouvre une session au niveau choisi.

MerchantId imposé par le serveur

Dans une session marchand, le serveur fixe le MerchantId à celui du marchand de la session, peu importe la valeur envoyée. Un locataire ne peut ni lire ni modifier les données d'un autre locataire.

Administration refusée

Une session marchand ne peut pas créer de marchands ni de sous-clients, ajouter des comptes bancaires, supprimer des marchands, ni lire les paramètres du service et l'état de l'inscription. CreateSubClient est aussi refusé dans une session service.

Lecture seule et 2FA

Un accès peut être en lecture seule, et sa session en hérite. Des échecs de connexion répétés verrouillent le compte, et l'authentification à deux facteurs s'ajoute aux opérations protégées.

La pratique est d'ouvrir une session par locataire, jamais partagée entre locataires. Les SDK officiels prennent en charge la même connexion en deux étapes pour les utilisateurs de niveau marchand et de niveau service. La documentation pour développeurs couvre chaque appel.

Chaque locataire peut-il avoir ses propres frais, limites et modes de paiement?

Oui. Chaque service porte sa propre grille de frais et ses propres règles, et votre plateforme les relit avec GetService. C'est là que vit votre modèle d'affaires.

  • Frais par locataire : carte de crédit, débit et virement instantané, chacun avec un mode, un pourcentage et un montant fixe; frais de commodité et d'annulation; frais de dépôt et d'encaissement Interac; frais de NSF, d'échec de carte, d'arrêt de paiement et de retour Interac.
  • Limites par locataire : limites d'encaissement et de dépôt par opération et par jour, limites par compte bancaire, un coussin NSF et un délai de dépôt au marchand.
  • Modes de paiement par locataire : la liste des modes permis pour l'encaissement et pour le dépôt, et l'option de bloquer les dépôts gratuits et les paiements aux fournisseurs.
  • Vos propres revenus : une plateforme peut facturer ses propres frais sur les paiements, et les frais d'un service peuvent être facturés à un marchand précis.

Un prêteur à grand volume et un propriétaire de cinq logements peuvent partager votre plateforme avec des modèles économiques complètement différents.

Comment les fonds et les rapports sont-ils séparés par locataire?

L'argent suit la hiérarchie. Chaque marchand a son propre compte bancaire de destination, donc un paiement créé sous le marchand d'un locataire est réglé dans ce compte bancaire et nulle part ailleurs. Les rapports suivent les mêmes lignes : ListExecutedOperations filtre par ServiceId, par MerchantId (imposé dans une session marchand), par groupe de virements et par type de date, et chaque opération porte son MerchantId.

Deux autres protections comptent à l'échelle d'une plateforme :

  • Idempotence par identifiant de connexion. Les clés d'idempotence sont propres à l'identifiant qui les envoie et sont respectées sur 12 opérations, dont CreatePayment, CreateTransferBatch, CreateCustomerV2 et RevertTransfer.
  • Lots avec approbation. CreateTransferBatch traite jusqu'à 5 000 opérations par appel, et les virements peuvent exiger une double approbation. GetPendingTransferApprovals ne retourne rien pour un service qui n'est pas le vôtre.

Les rapports et le rapprochement sont intégrés : voyez notre guide du rapprochement automatisé des paiements et gérer un grand volume de paiements.

Comment les webhooks indiquent-ils à quel locataire appartient un événement?

Chaque webhook TransactionEvent dit à qui il appartient. Son contenu comprend la cible, Target (Client ou Merchant), la direction, Direction (Collect ou Deposit), l'étape, Step (Validation, Transmission, StatusCheck ou Payback), le statut, Status, un DescriptionCode, le montant, Amount, ainsi que le MerchantId et le MerchantName. Votre plateforme achemine chaque événement vers le bon locataire directement à partir du contenu reçu.

Vous transmettez l'URL de votre webhook à votre représentant TIB, et les webhooks proviennent d'une plage d'adresses IP publiée que vous pouvez autoriser. La référence complète des champs se trouve dans la documentation officielle des webhooks.

Comment les locataires encaissent-ils les paiements dans votre produit?

Les payeurs de vos locataires paient sans quitter votre produit. Le formulaire de paiement sécurisé Drop-In accepte les cartes et les paiements bancaires dans votre application sans que votre plateforme manipule de données sensibles. Il se charge dans un iframe avec un jeton à usage unique, ce qui garde votre plateforme hors de la portée PCI, et TIB Finance est elle-même certifiée PCI DSS niveau 1.

Les pages de paiement peuvent porter vos couleurs et votre logo : votre marque, notre infrastructure. Les payeurs choisissent Interac, le TEF ou la carte de crédit, en français ou en anglais. Les paiements instantanés se font en quelques secondes, 24/7/365, par le système de paiement instantané propre à TIB. Voyez les versements instantanés pour plateformes au Canada et combien de temps prend un paiement au Canada.

Comment TIB se compare-t-elle à Zum Rails et VoPay pour les plateformes multilocataires?

Zum Rails et VoPay servent tous deux les plateformes, et le font sérieusement. Zum Rails offre aux partenaires un portail pour inscrire des clients, gérer la conformité et suivre les paiements, avec DocuSign intégré (portail partenaire de Zum Rails). VoPay offre aux développeurs une API étendue, avec plus de 250 points de terminaison (« over 250 endpoints ») et plus de 300 partenaires (« 300+ partners ») (page d'accueil de VoPay), ainsi qu'une API partenaire (Partner API) pour les ISO, les ISV et les PayFac (API partenaire de VoPay). Sources vérifiées le 22 novembre 2026. La différence, c'est la profondeur. Chez TIB, le locataire est le modèle de données, et l'isolation, le modèle économique et l'acheminement en découlent.

SujetTIB FinanceZum RailsVoPay
Inscription des locatairesUn seul appel CreateSubClient par locataire, avec inscription par APILe partenaire ajoute des clients dans le portail partenaire, sous Customers, puis Add new (base de connaissances)Les nouveaux comptes sont inscrits par API ou dans le portail partenaire (Partner Portal) (documentation)
Structure des locatairesClient, service, marchand, payeur, avec un compte bancaire par marchandLes partenaires peuvent gérer les clés d'API de leurs sous-clients (documentation)Les comptes peuvent avoir des sous-comptes (Sub-Accounts), par nom commercial, unité d'affaires ou région (documentation)
Modèle économique par locataireUne grille de frais complète et des limites par service, lisibles par APILa facturation du client est précisée à l'annexe A de son contrat (base de connaissances)Les partenaires gèrent les permissions, les limites et les ententes commerciales des comptes qu'ils créent (documentation)
SiègeMontréal, fondée en 2018Siège américain à Miami, annoncé en septembre 2024 avec le déménagement de son PDG (annonce)Siège mondial à Doha, au Qatar, annoncé en janvier 2026 (communiqué Business Wire)
FrançaisPlateforme, soutien et pages pour développeurs bilinguesSite en français (zumrails.com/fr)Aucune version française : vopay.com/fr-ca/ renvoie une erreur 404

Faits sur les concurrents tirés des pages en lien, contenu vérifié le 22 novembre 2026.

La profondeur de TIB, c'est ce qu'une ligne de tableau ne peut pas contenir : un MerchantId imposé par le serveur, des appels d'administration refusés, une idempotence propre à chaque identifiant et le MerchantId sur chaque webhook. Pour des comparaisons complètes, voyez TIB Finance ou Zum Rails et TIB Finance ou VoPay.

Pourquoi bâtir une plateforme canadienne sur un processeur canadien?

TIB Finance est un processeur de paiement souverain canadien, fondé en 2018, dont le siège est au 360, rue Saint-Jacques, à Montréal. L'entreprise est inscrite auprès de la Banque du Canada à titre de fournisseur de services de paiement en vertu de la Loi sur les activités associées aux paiements de détail (LAAPD) (registre de la Banque du Canada). Zum Rails figure dans le même registre, comme l'indique sa page d'accueil (vérifié le 22 novembre 2026) : sur l'inscription, les deux sont à égalité.

La direction que prennent les entreprises est une autre affaire. Zum Rails a ouvert son siège américain à Miami en septembre 2024 et a annoncé que son PDG s'y installerait de façon permanente (annonce de Zum Rails). Sa série A de 10,5 millions de dollars canadiens avait un seul investisseur, Arthur Ventures, une firme de Minneapolis (BetaKit, Arthur Ventures). Selon son PDG, les États-Unis devraient représenter plus de 60 % de ses revenus en 2028 (Mergermarket). En janvier 2026, VoPay a annoncé l'établissement de son siège mondial à Doha, au Qatar (communiqué Business Wire). Le tout vérifié le 22 novembre 2026.

TIB Finance reste concentrée sur les entreprises canadiennes et les plateformes qui les servent. Voyez les fournisseurs de services de paiement inscrits au Canada et choisir un processeur de paiement canadien.

Comment commencer à bâtir votre plateforme multilocataire sur TIB?

Un processeur typique vous remet une clé d'API et un lien vers sa documentation. TIB Finance envoie des gens. Une équipe d'intégration dédiée travaille au cœur de vos processus jusqu'à ce que les paiements roulent d'eux-mêmes, et l'intégration est gratuite pour les entreprises admissibles.

  1. Parlez à notre équipe. Décrivez vos locataires, vos flux et votre modèle d'affaires, et nous les transposons sur TIB avec vous.
  2. Testez dans le bac à sable. Ouvrez un compte gratuit dans le bac à sable, recevez vos identifiants d'API par courriel, et faites passer chaque flux de paiement de bout en bout avant la mise en ligne, avec notre guide pour tester les intégrations de paiement.
  3. Connectez-vous une seule fois. Branchez l'API, le Drop-In et les webhooks avec le guide d'intégration de l'API de paiement, les cas d'utilisation de l'API et le portail des développeurs. Un serveur MCP permet aussi aux agents d'IA et aux flux de travail automatisés d'interroger les transactions et de déclencher des opérations de paiement.
  4. Grandissez locataire par locataire. Chaque nouveau client devient un service de plus, avec la même structure et les mêmes contrôles.

Forfaits à partir de 25 $/mois, avec une tarification adaptée à votre volume et à votre modèle d'affaires : parlez à notre équipe. Si vous revendez TIB ou la recommandez à votre réseau, le programme de partenaires offre une carte-cadeau de 250 $ à votre premier mandat et jusqu'à 60 % de commissions, avec du co-marketing, de la co-vente et des partenariats d'intégration.

Quelles questions les équipes de plateformes posent-elles sur les paiements multilocataires?

Qu'est-ce qu'une architecture de paiement multilocataire?

Une architecture de paiement multilocataire permet à une plateforme de traiter les paiements de nombreuses entreprises, ses locataires, au moyen d'une seule intégration, tandis que les marchands, les payeurs, les comptes bancaires, les frais et les données de chaque locataire restent isolés. Chez TIB Finance, votre organisation est le client, chaque locataire est un service et chaque compte bancaire est un marchand, et le serveur fait respecter l'isolation.

Comment créer un locataire sur TIB Finance?

Un seul appel CreateSubClient crée un locataire, appelé service, avec son propre nom, sa langue et sa devise, CAD ou USD. Il retourne le nouveau ServiceId, que vous utilisez dans chaque appel pour ce locataire, et un BoardingRedirectUrl quand le locataire doit être inscrit.

Un locataire peut-il voir les données d'un autre locataire?

Non. Dans une session marchand, le serveur fixe le MerchantId à celui du marchand de la session, peu importe la valeur envoyée, et refuse les appels d'administration comme la création de marchands ou de sous-clients. Les accès peuvent aussi être en lecture seule, et l'authentification à deux facteurs protège les opérations sensibles.

Comment les webhooks identifient-ils le locataire?

Chaque webhook TransactionEvent porte le MerchantId et le MerchantName, avec la cible, la direction, l'étape, le statut et le montant, pour que votre plateforme achemine chaque événement vers le bon locataire directement à partir du contenu reçu.

Comment TIB Finance se compare-t-elle à Zum Rails et VoPay pour les plateformes?

Les trois servent les plateformes. Zum Rails offre un portail partenaire avec des sous-clients, et VoPay offre une API partenaire avec des sous-comptes (vérifié le 22 novembre 2026). TIB Finance fait du locataire son modèle de données, avec une isolation appliquée par le serveur, des frais et des limites par locataire et le MerchantId sur chaque webhook, le tout soutenu par une équipe bilingue à Montréal.

TIB Finance est-elle une entreprise canadienne?

Oui. TIB Finance est un processeur de paiement souverain canadien, fondé en 2018 et établi à Montréal, inscrit auprès de la Banque du Canada à titre de fournisseur de services de paiement en vertu de la LAAPD. Elle sert plus de 1 000 entreprises et traite plus de 600 millions de dollars par année.

Combien coûte TIB Finance pour une plateforme?

Forfaits à partir de 25 $/mois, avec une tarification adaptée à votre volume et à votre modèle d'affaires. Parlez à notre équipe pour une proposition taillée pour votre plateforme.

Comment commencer?

Parlez à notre équipe de vos locataires et de vos flux de paiement. L'intégration est accompagnée et gratuite pour les entreprises admissibles, et les développeurs peuvent tout tester dans un bac à sable gratuit.

Bâtissez votre plateforme multilocataire sur TIB

Parlez-nous de vos locataires et de vos flux de paiement. Une vraie équipe bilingue à Montréal transpose votre plateforme sur TIB avec vous.

Parlez à notre équipe Essayer le bac à sable

Vous bâtissez une plateforme ou revendez des paiements? Devenez partenaire TIB.