# Onboarding (/fr/merchants/onboarding)



















Avant de pouvoir traiter des paiements, un commerçant doit effectuer l’onboarding KYB (Know Your Business). Tapaya vérifie l’identité du commerçant et les informations sur son entreprise afin de satisfaire aux exigences du processeur de paiement et aux exigences réglementaires régionales.

<div className="bg-background relative h-auto w-full overflow-hidden rounded-lg border">
  <FlickeringGrid className="absolute inset-0 z-0 size-full" squareSize="4" gridGap="6" maxOpacity="0.1" flickerChance="0.1" height="800" width="2000" />

  <KybStatusDiagram />
</div>

## Activer les paiements en ligne [#enable-online-payments]

Le Checkout est disponible pour les commerçants approuvés. Lors de l’onboarding, sélectionnez les paiements en ligne, ou à la fois les paiements en ligne et en magasin. Indiquez le site web de la boutique et les informations sur l’activité en ligne. Un onboarding limité au Checkout ne nécessite pas de terminaux.

Les commerçants qui demandent les paiements en ligne apparaissent automatiquement dans la section **Checkout** de la [Tapaya Platform](https://platform.tapaya.com/checkout-settings). Ils ne peuvent pas accepter de paiements tant que le processeur en ligne ne les a pas approuvés et que leur passerelle de paiement n’est pas configurée. Une approbation existante pour les paiements en magasin ne suffit pas à elle seule à activer le Checkout. Le commerçant doit également être actif.

Vérifiez que le commerçant affiche **Ready** dans le tableau des commerçants du Checkout, puis configurez les clés, les portefeuilles et les éventuelles URL de retour du Hosted Checkout dans les [paramètres du Checkout](/online/integration/checkout_settings). La création d’une fiche commerçant ou d’une clé API ne suffit pas à elle seule à activer les paiements.

## Matrice des responsabilités [#responsibility-matrix]

Chaque parcours se termine par la même décision de vérification, mais le travail qui y mène est réparti différemment. Vérifiez qui est responsable de chaque étape avant de vous engager dans l’un des parcours ci-dessous.

<ResponsibilityMatrix
  columns="[
  { key: &#x22;platform&#x22;, label: &#x22;Platform UI&#x22; },
  { key: &#x22;own&#x22;, label: &#x22;Votre propre interface&#x22; },
  { key: &#x22;invite&#x22;, label: &#x22;Invitation par e-mail&#x22; },
  { key: &#x22;campaign&#x22;, label: &#x22;Lien de campagne&#x22; },
]"
  rows="[
  { label: &#x22;Créer la fiche commerçant&#x22;, cells: { platform: &#x22;you&#x22;, own: { owner: &#x22;you&#x22;, note: &#x22;via l’API&#x22; }, invite: { owner: &#x22;you&#x22;, note: &#x22;ou l’invitation la crée&#x22; }, campaign: { owner: &#x22;merchant&#x22;, note: &#x22;s’inscrit lui-même&#x22; } } },
  { label: &#x22;Fournir le formulaire et les règles de validation&#x22;, cells: { platform: &#x22;tapaya&#x22;, own: &#x22;you&#x22;, invite: { owner: &#x22;tapaya&#x22;, note: &#x22;hébergé&#x22; }, campaign: { owner: &#x22;tapaya&#x22;, note: &#x22;hébergé&#x22; } } },
  { label: &#x22;Diffuser le lien&#x22;, cells: { platform: &#x22;none&#x22;, own: &#x22;none&#x22;, invite: { owner: &#x22;you&#x22;, note: &#x22;un destinataire&#x22; }, campaign: { owner: &#x22;you&#x22;, note: &#x22;tout canal&#x22; } } },
  { label: &#x22;Saisir les informations sur l’entreprise, les coordonnées bancaires et les informations sur les propriétaires&#x22;, cells: { platform: &#x22;you&#x22;, own: { owner: &#x22;merchant&#x22;, note: &#x22;dans votre interface&#x22; }, invite: &#x22;merchant&#x22;, campaign: &#x22;merchant&#x22; } },
  { label: &#x22;Consentir aux conditions de Tapaya et à la Politique de confidentialité&#x22;, cells: { platform: &#x22;merchant&#x22;, own: &#x22;merchant&#x22;, invite: &#x22;merchant&#x22;, campaign: &#x22;merchant&#x22; } },
  { label: &#x22;Soumettre la demande au processeur&#x22;, cells: { platform: &#x22;tapaya&#x22;, own: &#x22;tapaya&#x22;, invite: &#x22;tapaya&#x22;, campaign: &#x22;tapaya&#x22; } },
  { label: &#x22;Vérifier la demande (KYB)&#x22;, cells: { platform: &#x22;tapaya&#x22;, own: &#x22;tapaya&#x22;, invite: &#x22;tapaya&#x22;, campaign: &#x22;tapaya&#x22; } },
  { label: &#x22;Suivre le statut de vérification&#x22;, cells: { platform: &#x22;you&#x22;, own: &#x22;you&#x22;, invite: &#x22;you&#x22;, campaign: &#x22;you&#x22; } },
  { label: &#x22;Corriger les informations refusées ou manquantes&#x22;, cells: { platform: &#x22;you&#x22;, own: &#x22;you&#x22;, invite: &#x22;merchant&#x22;, campaign: &#x22;merchant&#x22; } },
]"
/>

Lors d’un onboarding assisté dans la Platform UI, votre opérateur remplit le formulaire au nom du commerçant. C’est toutefois toujours le commerçant qui consent aux conditions de Tapaya et à la Politique de confidentialité ; assurez-vous donc qu’il en a pris connaissance et y a consenti avant de soumettre.

## Choisir un parcours d’onboarding [#choose-an-onboarding-flow]

Choisissez le parcours en fonction de la personne qui doit saisir les informations du commerçant et de la manière dont vous souhaitez diffuser l’onboarding. Tous les parcours sont disponibles depuis la Tapaya Platform UI. Si vous souhaitez l’automatiser, utilisez l’API correspondante décrite dans [Merchant Onboarding API](/platform-api/merchant_onboarding).

<Tabs defaultValue="platform" groupId="merchant-onboarding-flow" className="border-0 bg-transparent">
  <TabsList>
    <TabsTrigger value="platform">
      Platform UI
    </TabsTrigger>

    <TabsTrigger value="api">
      Votre propre interface
    </TabsTrigger>

    <TabsTrigger value="email">
      Invitation par e-mail
    </TabsTrigger>

    <TabsTrigger value="campaign">
      Lien de campagne
    </TabsTrigger>
  </TabsList>

  <TabsContent value="platform">
    ### Tapaya Platform UI [#tapaya-platform-ui]

    Un administrateur saisit les informations du commerçant et effectue l’onboarding en son nom dans la [Tapaya Platform](https://platform.tapaya.com). Cette option convient à l’onboarding assisté, aux portefeuilles de commerçants plus restreints ou aux cas où votre équipe opérationnelle dispose déjà des informations requises.

    **Comment démarrer :** Créez ou sélectionnez le commerçant dans la Tapaya Platform et ouvrez son onboarding. Le même parcours peut être lancé via l’[API](/platform-api/merchant_onboarding) lorsque vous avez besoin d’automatisation.

    Dans la barre latérale, développez **Payments** et ouvrez **Merchants**. Accédez à la section **Add a merchant**. Sur la carte **Add a merchant manually**, sélectionnez **Start onboarding**.

    <div className="bg-background relative w-full overflow-hidden rounded-lg border [&>p]:m-0 [&_img]:m-0 [&_img]:block [&_img]:w-full">
             <img alt="Lancer l’onboarding d’un commerçant depuis la Tapaya Platform" src="__img0" />
    </div>

    La Platform ouvre le formulaire d’onboarding guidé, avec les sections obligatoires sur l’entreprise, les coordonnées bancaires et les propriétaires.

    <div className="bg-background relative w-full overflow-hidden rounded-lg border [&>p]:m-0 [&_img]:m-0 [&_img]:block [&_img]:w-full">
             <img alt="Formulaire des informations sur l’entreprise du commerçant dans la Tapaya Platform" src="__img1" />
    </div>
  </TabsContent>

  <TabsContent value="api">
    ### Votre propre interface [#your-own-ui]

    Collectez les informations du commerçant dans votre propre produit et soumettez-les à Tapaya. Vous gardez ainsi le contrôle total de l’expérience et pouvez combiner l’onboarding avec votre parcours d’inscription ou de gestion de compte existant.

    Cette option vous oblige à maintenir votre formulaire et votre validation alignés sur les exigences d’onboarding en vigueur. La Tapaya Platform UI reste disponible pour examiner le commerçant et effectuer les actions de suivi.

    **Comment démarrer :** Utilisez le [parcours d’onboarding via l’API et ses exemples](/platform-api/merchant_onboarding) détaillés.

    Avant de soumettre les informations du commerçant via l’API, vous devez obtenir son consentement aux [Conditions générales de Tapaya pour les intégrateurs](https://tapaya.com/terms) et à la [Politique de confidentialité de Tapaya](https://tapaya.com/privacy). Vous pouvez ajouter à votre formulaire d’onboarding une case à cocher renvoyant vers les deux documents, ou faire référence aux documents de Tapaya dans le texte des conditions auxquelles le commerçant consent. Vous devez également mentionner Tapaya comme sous-traitant des données dans votre propre politique de confidentialité.

    Votre interface peut adopter n’importe quel design visuel adapté à votre produit. Un parcours type répartit les informations requises en sections faciles à gérer et affiche la progression avant la soumission.

    <div className="bg-background relative w-full overflow-hidden rounded-lg border [&>p]:m-0 [&_img]:m-0 [&_img]:block [&_img]:w-full">
             <img alt="Maquette fonctionnelle d’un formulaire d’onboarding commerçant personnalisé" src="__img2" />
    </div>
  </TabsContent>

  <TabsContent value="email">
    ### Invitation par e-mail [#email-invite]

    Vous pouvez effectuer l’onboarding d’un commerçant en l’invitant directement depuis la Tapaya Platform. Saisissez l’adresse e-mail du commerçant et
    Tapaya crée une invitation à usage unique contenant un lien sécurisé vers l’onboarding hébergé ; aucune intégration du SDK n’est nécessaire de son
    côté.

    Le commerçant ouvre le lien et suit le même parcours KYB guidé, puis revient dans votre produit une fois vérifié. C’est utile pour effectuer l’onboarding des commerçants avant qu’ils commencent à utiliser votre intégration, ou si vous préférez un parcours entièrement hébergé.

    Utilisez cette option pour des invitations individuelles, notamment lorsque vous savez qui est le commerçant mais souhaitez qu’il fournisse et confirme
    lui-même ses informations. Chaque invitation est destinée à un seul destinataire et expire si elle n’est pas utilisée.

    Si vous avez déjà créé le commerçant dans votre propre système et que l’onboarding hébergé de Tapaya doit se rattacher à cette fiche
    précise, créez d’abord la fiche commerçant de base, puis envoyez l’invitation avec le même `merchantToken`. C’est le parcours
    recommandé via l’API pour les intégrateurs :

    1. `POST /merchant/auth/register` ou `POST /integrator/merchant`
    2. `POST /integrator/merchant/send-registration-invite` avec `email` et le même `merchantToken`
    3. Le commerçant ouvre la `registrationUrl` renvoyée et remplit le formulaire KYB hébergé

    Sans `merchantToken`, la finalisation de l’invitation crée une nouvelle fiche commerçant.

    Quel que soit le parcours d’onboarding suivi par un commerçant, son compte suit le même cycle de vie de vérification que celui présenté ci-dessus.

    **Comment démarrer :** Envoyez et gérez l’invitation depuis la Tapaya Platform UI, ou automatisez les invitations
    via l’[API](/platform-api/merchant_onboarding#invite-a-merchant-to-complete-hosted-onboarding).

    Dans la barre latérale, développez **Payments** et ouvrez **Merchants**. Accédez à la section **Add a merchant**. Sur la carte **Invite via e-mail**, sélectionnez **Send invite link**.

    <div className="bg-background relative w-full overflow-hidden rounded-lg border [&>p]:m-0 [&_img]:m-0 [&_img]:block [&_img]:w-full">
             <img alt="Option d’invitation par e-mail dans la Tapaya Platform" src="__img3" />
    </div>

    Saisissez l’adresse e-mail du commerçant dans la boîte de dialogue d’invitation et choisissez la commission à appliquer.

    <div className="bg-background relative w-full overflow-hidden rounded-lg border [&>p]:m-0 [&_img]:m-0 [&_img]:block [&_img]:w-full">
             <img alt="Boîte de dialogue d’envoi d’une invitation d’inscription à un commerçant" src="__img4" />
    </div>
  </TabsContent>

  <TabsContent value="campaign">
    ### Lien de campagne [#campaign-link]

    Créez un lien d’inscription réutilisable et partagez-le sur votre site web, un portail partenaire, une newsletter ou tout autre canal. Plusieurs commerçants peuvent utiliser ce lien pour s’inscrire et effectuer l’onboarding dans l’interface hébergée par Tapaya.

    Utilisez cette option lorsque les destinataires ne sont pas connus à l’avance ou lorsque vous souhaitez un parcours d’acquisition en libre-service évolutif. Vous décidez de la date d’expiration du lien et pouvez le révoquer à la fin de la campagne.

    **Comment démarrer :** Créez et gérez le lien de campagne depuis la Tapaya Platform UI, ou automatisez-le via l’[API](/platform-api/merchant_onboarding).

    Dans la barre latérale, développez **Payments** et ouvrez **Merchants**. Accédez à la section **Campaign onboarding links**, puis sélectionnez **Manage links**.

    <div className="bg-background relative w-full overflow-hidden rounded-lg border [&>p]:m-0 [&_img]:m-0 [&_img]:block [&_img]:w-full">
             <img alt="Option des liens de campagne d’onboarding dans la Tapaya Platform" src="__img5" />
    </div>

    Nommez la campagne, définissez sa date d’expiration et choisissez la commission avant de partager le lien généré.

    <div className="bg-background relative w-full overflow-hidden rounded-lg border [&>p]:m-0 [&_img]:m-0 [&_img]:block [&_img]:w-full">
             <img alt="Boîte de dialogue de gestion des liens de campagne d’onboarding" src="__img6" />
    </div>
  </TabsContent>
</Tabs>

## Qui est responsable de quoi, globalement [#who-owns-what-overall]

Sur l’ensemble des quatre parcours, chaque étape de l’onboarding incombe à une ou plusieurs des trois parties. Une étape cochée deux fois est une étape dont le responsable dépend du parcours choisi ci-dessus.

<ResponsibilityMatrix
  rowHeader="Étape de l’onboarding"
  parties="[&#x22;tapaya&#x22;, &#x22;you&#x22;, &#x22;merchant&#x22;]"
  rows="[
  { label: &#x22;Choisir le parcours d’onboarding&#x22;, owners: [&#x22;you&#x22;] },
  { label: &#x22;Fournir le formulaire et les règles de validation&#x22;, owners: [&#x22;tapaya&#x22;, &#x22;you&#x22;] },
  { label: &#x22;Saisir les informations sur l’entreprise, les coordonnées bancaires et les informations sur les propriétaires&#x22;, owners: [&#x22;you&#x22;, &#x22;merchant&#x22;] },
  { label: &#x22;Diffuser les invitations et les liens de campagne&#x22;, owners: [&#x22;you&#x22;] },
  { label: &#x22;Consentir aux conditions de Tapaya et à la Politique de confidentialité&#x22;, owners: [&#x22;merchant&#x22;] },
  { label: &#x22;Soumettre la demande au processeur&#x22;, owners: [&#x22;tapaya&#x22;] },
  { label: &#x22;Vérifier la demande (KYB)&#x22;, owners: [&#x22;tapaya&#x22;] },
  { label: &#x22;Maintenir les exigences à jour avec la réglementation&#x22;, owners: [&#x22;tapaya&#x22;, &#x22;you&#x22;] },
  { label: &#x22;Suivre le statut de vérification&#x22;, owners: [&#x22;tapaya&#x22;, &#x22;you&#x22;] },
  { label: &#x22;Corriger les informations refusées ou manquantes&#x22;, owners: [&#x22;you&#x22;, &#x22;merchant&#x22;] },
]"
/>

## Responsabilités partagées [#where-responsibility-is-shared]

* **Fournir le formulaire et les règles de validation :** Tapaya fournit et maintient le formulaire pour la Platform UI, les invitations par e-mail et les liens de campagne. Si vous créez votre propre interface, le formulaire vous appartient et vous maintenez ses champs et sa validation alignés sur les exigences en vigueur.
* **Consentir aux conditions de Tapaya et à la Politique de confidentialité :** Tapaya présente ces documents dans ses parcours hébergés. Avec votre propre interface, vous devez présenter des liens vers les deux documents et obtenir le consentement du commerçant avant de soumettre ses informations d’onboarding via l’API. Vous devez également mentionner Tapaya comme sous-traitant des données dans votre propre politique de confidentialité.
* **Saisir les informations :** Votre équipe les saisit lors d’un onboarding assisté dans la Platform UI. Dans tous les parcours hébergés ou en libre-service, le commerçant saisit lui-même les siennes.
* **Maintenir les exigences à jour avec la réglementation :** Tapaya met à jour automatiquement les parcours hébergés. Avec votre propre interface, vous suivez les évolutions des [exigences d’onboarding de l’API](/platform-api/merchant_onboarding) et mettez à jour votre formulaire.
* **Suivre le statut de vérification :** Tapaya expose le statut dans la Platform UI, via `Accept.merchant.onboardingStatus()` dans l’Accept SDK et via l’API. C’est à vous d’y donner suite : relancez le commerçant lorsqu’un élément est manquant ou refusé.
* **Corriger les informations refusées ou manquantes :** C’est la partie qui a saisi les informations qui les corrige. Pour les parcours hébergés, cela signifie inviter le commerçant à les soumettre à nouveau.

Pour les responsabilités sur l’ensemble du cycle de vie du commerçant, et pas seulement l’onboarding, consultez [Responsabilités](./responsibilities).

## Statut de vérification [#verification-status]

Une fois le formulaire soumis par le commerçant, son compte passe à l’état d’examen. Le processeur de paiement examine la demande ; cela prend généralement quelques minutes, mais peut prendre plus de temps dans certains cas.

Un commerçant ne pourra pas traiter de transactions tant que son compte n’est pas vérifié. Vous pouvez consulter son statut à tout moment dans la Tapaya Platform UI. Les intégrations peuvent également le vérifier avec `Accept.merchant.onboardingStatus()` dans l’Accept SDK ou via l’API, et inviter le commerçant à soumettre à nouveau ses informations si elles sont manquantes ou refusées.