Inscription des sous-marchands par API au Canada : KYB, documents et statuts

Inscription des sous-marchands par API au Canada : KYB, documents et statuts

Table des matières

Une API d'inscription des sous-marchands permet à votre plateforme de créer chaque locataire comme sous-marchand, de lui remettre un lien d'inscription, de recueillir ses documents KYB et de suivre son statut jusqu'à ce qu'il puisse accepter des paiements, le tout à partir de votre propre code. Chez TIB Finance, un seul appel CreateSubClient crée le locataire et renvoie son ServiceId et un BoardingRedirectUrl. Le locataire téléverse trois documents (une pièce de l'entreprise, un spécimen de chèque et la pièce d'identité du propriétaire), l'équipe de TIB analyse le dossier, et votre logiciel suit chaque statut, de Draft à Completed, avec GetServiceBoardingStatus. Tout le parcours fonctionne en français et en anglais.

Ce guide s'adresse aux SaaS, aux logiciels verticaux et aux places de marché canadiens qui offrent les paiements aux entreprises de leur plateforme. Ici, les locataires sont ces entreprises, et chacune devient un sous-marchand de votre plateforme une fois son inscription terminée. On parle aussi d'inscription des marchands par API. Ce guide prolonge notre page pilier sur le traitement des paiements multilocataire (multi-tenant).

En bref : créez le locataire par API, envoyez-lui le lien d'inscription dans votre application, laissez-le téléverser trois documents, suivez son statut de Draft à Completed, puis lancez les paiements. TIB prend en charge l'analyse KYB, et une vraie équipe humaine et bilingue vous accompagne dès votre premier locataire.

Parlez à notre équipe de votre plateforme, ou testez dans le bac à sable gratuit.

Qu'est-ce qu'une API d'inscription des sous-marchands?

La vérification KYB (Know Your Business, ou connaître son entreprise) est la vérification qu'un processeur de paiement fait sur une entreprise avant qu'elle puisse encaisser de l'argent : qui est l'entreprise, qui en est propriétaire et quel compte bancaire reçoit les fonds. Le KYC (Know Your Customer) applique la même idée à une personne. Sur une plateforme de paiement, chaque locataire passe par la vérification KYB, et une API d'inscription transforme ce processus en quelques appels que votre logiciel fait tout seul, au lieu d'échanges de courriels, de pièces jointes et de chiffriers.

TIB Finance est conçue pour le traitement des paiements B2B et multilocataire. Des entreprises bâtissent leur propre plateforme sur TIB, avec leurs propres locataires et sous-marchands en dessous. La structure se calque sur votre produit en quatre niveaux :

Votre plateforme = Client TIB
Chaque locataire = Service, créé par CreateSubClient
Chaque compte bancaire = Marchand
Leurs clients = Clients payeurs

Chaque sous-client obtient un environnement isolé, et son ServiceId remplace le vôtre dans les appels que vous faites en son nom. Chaque compte a son propre compte bancaire. Pour le modèle complet, lisez notre guide sur l'architecture de paiement multilocataire.

Comment fonctionne l'inscription des sous-marchands par API, étape par étape?

Sept étapes mènent un locataire de son arrivée dans votre application à son premier paiement :

  1. Créer le locataire. Votre plateforme appelle CreateSubClient avec le nom, la langue et la devise du locataire (CAD ou USD, CAD par défaut). Cet appel lance son inscription.
  2. Obtenir le lien d'inscription. La réponse renvoie le ServiceId du service par défaut du locataire, créé automatiquement, et le BoardingRedirectUrl, le lien vers l'assistant d'inscription.
  3. Envoyer le locataire vers le lien. Affichez-le dans votre application, sous forme de bouton ou dans un courriel. Le locataire téléverse trois documents : une pièce de l'entreprise, un spécimen de chèque et la pièce d'identité du propriétaire.
  4. Suivre les statuts. Le dossier passe par Draft, Submit, InReview et Completed. L'équipe de TIB analyse le dossier, pour que la vôtre n'ait pas à le faire.
  5. Lire le statut dans votre code. GetServiceBoardingStatus renvoie le statut d'inscription de tous les marchands d'un service. GetService indique le marchand principal avec son BoardingStatus, ses BoardingFiles et HasCompletedBoarding.
  6. Ajouter des comptes bancaires au besoin. AddBankAccount ajoute un compte bancaire, comme nouveau marchand, à un service déjà inscrit. Le compte est autorisé dès l'insertion, sans nouveau circuit d'approbation, et hérite du propriétaire et de la devise d'un marchand frère.
  7. Lancer les paiements. Une fois le statut à Completed, le locataire encaisse avec les modes de paiement activés pour son service, comme le débit préautorisé, le TEF, Interac et les cartes de crédit, et chaque événement de transaction que reçoit votre webhook porte son MerchantId et son MerchantName.

Les webhooks suivent la documentation officielle des webhooks : vous donnez l'URL de votre point de terminaison à votre représentant TIB et vous autorisez la plage d'adresses IP source 204.225.113.0/24. La référence complète des méthodes se trouve dans la documentation pour développeurs, et les fonctions pour plateformes sont résumées à la page des paiements intégrés pour plateformes, qui place l'inscription multilocataire par API parmi ses fonctions.

Quels documents KYB un sous-marchand fournit-il?

Trois documents sont exigés :

Pièce de l'entreprise

Une preuve de l'identité de l'entreprise, pour que TIB sache exactement quelle entreprise elle inscrit.

Spécimen de chèque

La preuve du compte bancaire qui reçoit les fonds du locataire.

Pièce d'identité du propriétaire

L'identification du propriétaire ou de l'actionnaire derrière l'entreprise.

En français ou en anglais

Le parcours est bilingue de bout en bout : un locataire de Québec le remplit en français, un locataire de Calgary en anglais.

Court et prévisible, c'est tout l'intérêt. Un locataire sait quoi préparer avant d'ouvrir le lien, et votre équipe de soutien sait quoi répondre. Les documents vont à TIB par le lien d'inscription, alors votre équipe n'a jamais à les recueillir par courriel ni à les conserver dans vos propres systèmes.

Que signifient les statuts d'inscription?

Le dossier de chaque locataire porte un seul statut à la fois. Votre plateforme le lit et montre au locataire où il en est :

Statut Ce que ça signifie Ce que votre plateforme affiche
Draft Le locataire a ouvert son dossier et prépare ses documents. Un rappel pour terminer le téléversement
Submit Le locataire a soumis son dossier. Dossier soumis, analyse à venir
InReview L'équipe de TIB analyse le dossier. Un état clair d'approbation en attente
Completed Le dossier est approuvé et le locataire peut traiter des paiements. Paiements activés

Concevez vos écrans d'inscription autour de cet état d'approbation en attente : le locataire voit sa progression, et votre code lit le statut de tous les marchands d'un service en un seul appel.

Certains locataires peuvent-ils sauter l'inscription?

Oui, dans les cas admissibles. ListServices expose deux indicateurs : SkipClientApprobation, quand les marchands créés sous le client sont autorisés immédiatement, et IsClientBoardingExempt, quand le client est exempté d'inscription. Pour un locataire exempté, le BoardingRedirectUrl renvoyé par CreateSubClient est nul, alors votre code saute l'étape du lien et passe directement à la suite. Quels locataires sont admissibles? C'est une conversation à avoir avec notre équipe.

Bâtir votre propre parcours KYB ou passer par TIB : comment se comparent-ils?

Trois façons de faire vérifier vos locataires et de les rendre prêts à encaisser, côte à côte :

Ce qu'il vous faut Inscription manuelle (courriels et formulaires) Parcours KYB bâti à l'interne API d'inscription TIB
Collecte des documents Pièces jointes par courriel, relancées à la main Écrans de téléversement et stockage sécurisé à bâtir Trois documents par le lien d'inscription
Analyse du dossier Votre équipe, au cas par cas Votre équipe, plus les règles à écrire L'équipe de TIB
Suivi du statut Un chiffrier Un modèle de statuts à concevoir Draft, Submit, InReview, Completed, par API
Langue Ce que votre équipe rédige Deux versions à bâtir et à maintenir Bilingue de bout en bout
Comptes bancaires supplémentaires Un nouveau formulaire chaque fois Votre propre logique d'approbation AddBankAccount, autorisé dès l'insertion
Données de cartes et bancaires Votre exposition à gérer Votre programme de sécurité à porter Formulaire Drop-In, aucune donnée sensible sur vos serveurs
Soutien Votre équipe seule Votre équipe seule Une vraie équipe bilingue chez TIB
Le temps de vos développeurs Passé sur l'administratif Passé sur la plomberie de conformité Investi dans votre produit

L'idée est simple : votre plateforme garde l'expérience et la relation, et TIB porte la vérification. Si vous pesez la question plus large de devenir vous-même facilitateur de paiement, lisez notre guide sur la solution de rechange au PayFac.

À quoi ça ressemble pour une vraie plateforme?

Prenons une plateforme québécoise de gestion immobilière qui accueille une nouvelle société de gestion avec trois immeubles, chacun avec son propre compte bancaire :

  • La société s'inscrit dans la plateforme. La plateforme appelle CreateSubClient en français, en CAD, et conserve le ServiceId.
  • L'écran d'inscription affiche un bouton Terminez votre vérification qui pointe vers le BoardingRedirectUrl. La gestionnaire téléverse la pièce de l'entreprise, un spécimen de chèque et sa pièce d'identité.
  • La plateforme appelle GetServiceBoardingStatus et affiche En analyse pendant que le dossier est à InReview.
  • À Completed, la perception des loyers par débit préautorisé s'active. Les deux autres immeubles obtiennent leur compte bancaire avec AddBankAccount, sans nouveau circuit d'approbation.
  • Chaque événement de paiement de loyer arrive par webhook avec le MerchantId du bon immeuble, prêt pour le rapprochement.

Les versements suivent la même structure : les versements aux propriétaires peuvent partir en paiements instantanés, en quelques secondes, 24/7/365, grâce au système propre de TIB. Voyez les versements instantanés pour plateformes et notre page sur les paiements instantanés.

Comment Zum Rails et VoPay abordent-ils l'inscription des marchands?

Chacun offre ses propres outils d'inscription. Zum Rails met de l'avant une vérification KYC propulsée par l'IA, et son inscription fait passer chaque client et chaque partenaire par une analyse de risque. VoPay offre une application d'inscription en marque blanche que génère un point de terminaison de son API, et son inscription peut commencer par une étape de vérification d'identité (le tout vérifié le 22 novembre 2026).

Deux annonces méritent aussi d'être connues. En septembre 2024, Zum Rails a officiellement établi son siège social américain à Miami et annoncé que son PDG s'y installerait de façon permanente. L'entreprise a dit se préparer à ce qu'au moins 50 % de l'ensemble de ses revenus proviennent des États-Unis dans les 18 mois suivants. Sa ronde de série A de 10,5 M$ CA a été menée par Arthur Ventures, une firme de Minneapolis. VoPay a annoncé l'établissement de son siège social mondial à Doha, au Qatar, en janvier 2026, et vopay.com/fr-ca/ renvoie une erreur de page introuvable : il n'existe pas de site VoPay en français (le tout vérifié le 22 novembre 2026). Comparaisons complètes : TIB Finance ou Zum Rails et TIB Finance ou VoPay.

Pour une plateforme qui a des locataires au Québec, la langue fait partie de l'inscription. Chez TIB, le parcours d'inscription, le site et l'équipe fonctionnent en français et en anglais, de bout en bout.

Qui analyse les dossiers et accompagne votre équipe?

TIB Finance est un processeur de paiement canadien souverain. Fondée en 2018 et établie à Montréal, l'entreprise est inscrite comme fournisseur de services de paiement auprès de la Banque du Canada en vertu de la LAAPD (voyez ce que cette inscription signifie). Rodée, carrée, et là pour ses clients, ses partenaires et les plateformes qui bâtissent sur elle : TIB traite plus de 600 millions de dollars par année pour plus de 1 000 entreprises, avec plus de 200 000 transactions chaque mois.

Le service, c'est ce que vous sentez en premier. Une vraie équipe humaine et bilingue accompagne chaque client et chaque partenaire. TIB Finance vous envoie des gens : notre équipe d'intégration s'installe dans vos processus jusqu'à ce que les paiements roulent tout seuls, et l'intégration est gratuite pour les entreprises admissibles (voyez notre page d'intégration d'affaires). Le formulaire de paiement sécurisé Drop-In accepte les cartes et les paiements bancaires dans votre application sans que vos serveurs manipulent de données sensibles, et TIB est certifiée PCI DSS de niveau 1. Les pages de paiement peuvent porter vos couleurs et votre logo, pour que les clients de vos locataires voient votre plateforme. Plus de détails dans notre guide sur les plateformes de paiement en marque blanche au Canada.

Combien coûte l'inscription des sous-marchands chez TIB?

Forfaits à partir de 25 $/mois, avec une tarification adaptée à votre volume et à votre modèle : parlez à notre équipe. Nous planifions avec vous la configuration pour vos locataires avant toute mise en ligne, et choisir un fournisseur est plus simple avec notre liste de vérification pour choisir un fournisseur de paiements intégrés.

Comment démarrer?

Quatre portes d'entrée :

Parlez à notre équipe

Un expert bilingue en paiements examine votre plateforme, vos locataires et votre parcours d'inscription. Demandez un appel.

Devenez partenaire

Pour les plateformes et les intégrateurs qui amènent leurs clients chez TIB : une carte-cadeau de 250 $ au premier mandat et jusqu'à 60 % de commissions. Joignez le réseau de partenaires.

Testez dans le bac à sable

Gratuit, avec des identifiants API par courriel, pour tester chaque flux de paiement de bout en bout. Ouvrez un bac à sable.

Ouvrez un compte

Prêt pour votre propre compte de paiement? Ouvrez votre compte de paiement d'entreprise en ligne.

Questions fréquentes

Qu'est-ce qu'une API d'inscription des sous-marchands?

C'est un ensemble d'appels API qui permet à une plateforme de paiement de créer chacun de ses locataires comme sous-marchand, de lui envoyer un lien d'inscription, de recueillir ses documents KYB et de suivre son statut jusqu'à ce qu'il puisse accepter des paiements. Chez TIB Finance, CreateSubClient crée le locataire et renvoie son ServiceId et son lien d'inscription, et GetServiceBoardingStatus renvoie son statut.

Quels documents TIB demande-t-elle pour inscrire un sous-marchand?

Trois documents : une pièce de l'entreprise, un spécimen de chèque pour le compte bancaire qui reçoit les fonds, et la pièce d'identité du propriétaire. Le locataire les téléverse par son lien d'inscription, en français ou en anglais.

Quels sont les statuts d'inscription chez TIB?

Un dossier passe par quatre statuts : Draft, Submit, InReview et Completed. Une fois le statut à Completed, le locataire peut traiter des paiements.

Comment ma plateforme sait-elle qu'un locataire est prêt?

Votre code appelle GetServiceBoardingStatus, qui renvoie le statut d'inscription de tous les marchands d'un service, ou GetService, qui indique le marchand principal avec son BoardingStatus, ses BoardingFiles et HasCompletedBoarding.

Un locataire peut-il faire son inscription en français?

Oui. Le parcours est bilingue de bout en bout : chaque locataire est créé avec sa propre langue, et l'équipe de TIB accompagne chaque client et chaque partenaire en français et en anglais.

Un locataire peut-il ajouter un autre compte bancaire après son inscription?

Oui. AddBankAccount ajoute un compte bancaire, comme nouveau marchand, à un service déjà inscrit. Le compte est autorisé dès l'insertion, sans nouveau circuit d'approbation, et hérite du propriétaire et de la devise d'un marchand frère.

Faut-il devenir facilitateur de paiement pour inscrire des sous-marchands?

Non. Chez TIB Finance, votre plateforme inscrit ses locataires par API pendant que TIB prend en charge l'analyse KYB et l'infrastructure PCI DSS de niveau 1. Notre guide sur la solution de rechange au PayFac compare les options.

Puis-je tester avant que mon premier locataire lance ses paiements?

Oui. Le bac à sable gratuit vient avec des identifiants API par courriel, pour que vos développeurs testent chaque flux de paiement de bout en bout avant que votre premier locataire lance ses paiements.

Combien coûte l'inscription des sous-marchands chez TIB?

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

Parlons de l'inscription de vos locataires

Venez jaser de votre projet : parlez-nous de vos locataires et de votre parcours d'inscription, et notre équipe bilingue planifiera l'inscription avec vous.

Parlez à notre équipe Devenez partenaire