# Onboarding (/de/merchants/onboarding)



















Bevor ein Händler Zahlungen abwickeln kann, muss er das KYB-Onboarding (Know Your Business) abschließen. Tapaya verifiziert die Identität und die Geschäftsdaten des Händlers, um die Anforderungen des Zahlungsabwicklers und die regionalen regulatorischen Anforderungen zu erfüllen.

<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>

## Online-Zahlungen aktivieren [#enable-online-payments]

Checkout ist für freigegebene Händler live. Wählen Sie beim Onboarding Online-Zahlungen oder sowohl Online-Zahlungen als auch Zahlungen vor Ort. Geben Sie die Website des Shops und die Angaben zum Online-Geschäft an. Ein Onboarding nur für Checkout erfordert keine Terminals.

Händler, die Online-Zahlungen beantragen, erscheinen automatisch unter **Checkout** in der [Tapaya Platform](https://platform.tapaya.com/checkout-settings). Sie können erst Zahlungen annehmen, wenn der Online-Zahlungsabwickler sie freigegeben hat und ihr Payment Gateway konfiguriert ist. Eine bestehende Freigabe für Zahlungen vor Ort allein aktiviert Checkout nicht. Der Händler muss außerdem aktiv sein.

Prüfen Sie in der Händlertabelle von Checkout, ob **Ready** angezeigt wird, und konfigurieren Sie anschließend Schlüssel, Wallets und gegebenenfalls Rücksprung-URLs für Hosted Checkout in den [Checkout-Einstellungen](/online/integration/checkout_settings). Das Anlegen eines Händlerdatensatzes oder eines API-Schlüssels allein aktiviert noch keine Zahlungen.

## Verantwortlichkeitsmatrix [#responsibility-matrix]

Jeder Ablauf endet mit derselben Entscheidung über die Verifizierung, doch die vorangehenden Arbeiten sind unterschiedlich verteilt. Klären Sie, wer für welchen Schritt zuständig ist, bevor Sie sich für einen der folgenden Abläufe entscheiden.

<ResponsibilityMatrix
  columns="[
  { key: &#x22;platform&#x22;, label: &#x22;Platform UI&#x22; },
  { key: &#x22;own&#x22;, label: &#x22;Eigene Oberfläche&#x22; },
  { key: &#x22;invite&#x22;, label: &#x22;E-Mail-Einladung&#x22; },
  { key: &#x22;campaign&#x22;, label: &#x22;Kampagnenlink&#x22; },
]"
  rows="[
  { label: &#x22;Händlerdatensatz anlegen&#x22;, cells: { platform: &#x22;you&#x22;, own: { owner: &#x22;you&#x22;, note: &#x22;über die API&#x22; }, invite: { owner: &#x22;you&#x22;, note: &#x22;oder die Einladung legt ihn an&#x22; }, campaign: { owner: &#x22;merchant&#x22;, note: &#x22;registriert sich selbst&#x22; } } },
  { label: &#x22;Formular und Validierungsregeln bereitstellen&#x22;, cells: { platform: &#x22;tapaya&#x22;, own: &#x22;you&#x22;, invite: { owner: &#x22;tapaya&#x22;, note: &#x22;gehostet&#x22; }, campaign: { owner: &#x22;tapaya&#x22;, note: &#x22;gehostet&#x22; } } },
  { label: &#x22;Link verteilen&#x22;, cells: { platform: &#x22;none&#x22;, own: &#x22;none&#x22;, invite: { owner: &#x22;you&#x22;, note: &#x22;ein Empfänger&#x22; }, campaign: { owner: &#x22;you&#x22;, note: &#x22;beliebiger Kanal&#x22; } } },
  { label: &#x22;Geschäfts-, Bank- und Eigentümerdaten eingeben&#x22;, cells: { platform: &#x22;you&#x22;, own: { owner: &#x22;merchant&#x22;, note: &#x22;in Ihrer Oberfläche&#x22; }, invite: &#x22;merchant&#x22;, campaign: &#x22;merchant&#x22; } },
  { label: &#x22;Den Bedingungen und der Datenschutzerklärung von Tapaya zustimmen&#x22;, cells: { platform: &#x22;merchant&#x22;, own: &#x22;merchant&#x22;, invite: &#x22;merchant&#x22;, campaign: &#x22;merchant&#x22; } },
  { label: &#x22;Antrag an den Zahlungsabwickler übermitteln&#x22;, cells: { platform: &#x22;tapaya&#x22;, own: &#x22;tapaya&#x22;, invite: &#x22;tapaya&#x22;, campaign: &#x22;tapaya&#x22; } },
  { label: &#x22;Antrag verifizieren (KYB)&#x22;, cells: { platform: &#x22;tapaya&#x22;, own: &#x22;tapaya&#x22;, invite: &#x22;tapaya&#x22;, campaign: &#x22;tapaya&#x22; } },
  { label: &#x22;Verifizierungsstatus überwachen&#x22;, cells: { platform: &#x22;you&#x22;, own: &#x22;you&#x22;, invite: &#x22;you&#x22;, campaign: &#x22;you&#x22; } },
  { label: &#x22;Abgelehnte oder fehlende Angaben korrigieren&#x22;, cells: { platform: &#x22;you&#x22;, own: &#x22;you&#x22;, invite: &#x22;merchant&#x22;, campaign: &#x22;merchant&#x22; } },
]"
/>

Beim unterstützten Onboarding über die Platform UI füllt Ihr Mitarbeiter das Formular im Namen des Händlers aus. Die Zustimmung zu den Bedingungen und der Datenschutzerklärung von Tapaya erteilt jedoch weiterhin der Händler. Vergewissern Sie sich daher vor dem Absenden, dass er die Dokumente gesehen und ihnen zugestimmt hat.

## Onboarding-Ablauf wählen [#choose-an-onboarding-flow]

Wählen Sie den Ablauf danach, wer die Daten des Händlers eingeben soll und wie Sie das Onboarding verteilen möchten. Jeder Ablauf ist in der Tapaya Platform UI verfügbar. Wenn Sie ihn automatisieren möchten, verwenden Sie die entsprechende API, die in der [Merchant Onboarding API](/platform-api/merchant_onboarding) beschrieben ist.

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

    <TabsTrigger value="api">
      Eigene Oberfläche
    </TabsTrigger>

    <TabsTrigger value="email">
      E-Mail-Einladung
    </TabsTrigger>

    <TabsTrigger value="campaign">
      Kampagnenlink
    </TabsTrigger>
  </TabsList>

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

    Ein Administrator gibt die Daten des Händlers ein und schließt das Onboarding im Namen des Händlers in der [Tapaya Platform](https://platform.tapaya.com) ab. Das eignet sich für unterstütztes Onboarding, kleinere Händlerportfolios oder Fälle, in denen Ihr Operations-Team die erforderlichen Informationen bereits hat.

    **So starten Sie:** Legen Sie den Händler in der Tapaya Platform an oder wählen Sie ihn aus und öffnen Sie sein Onboarding. Derselbe Ablauf kann über die [API](/platform-api/merchant_onboarding) gestartet werden, wenn Sie Automatisierung benötigen.

    Klappen Sie in der Seitenleiste **Payments** auf und öffnen Sie **Merchants**. Gehen Sie zum Bereich **Add a merchant**. Wählen Sie auf der Karte **Add a merchant manually** die Option **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="Händler-Onboarding in der Tapaya Platform starten" src="__img0" />
    </div>

    Die Plattform öffnet das geführte Onboarding-Formular mit den erforderlichen Abschnitten zu Geschäfts-, Bank- und Eigentümerdaten.

    <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="Formular für die Geschäftsdaten des Händlers in der Tapaya Platform" src="__img1" />
    </div>
  </TabsContent>

  <TabsContent value="api">
    ### Eigene Oberfläche [#your-own-ui]

    Erheben Sie die Daten des Händlers in Ihrem eigenen Produkt und übermitteln Sie sie an Tapaya. So haben Sie die volle Kontrolle über das Nutzererlebnis und können das Onboarding mit Ihrem bestehenden Registrierungs- oder Kontoverwaltungsablauf kombinieren.

    Bei dieser Option müssen Sie Ihr Formular und Ihre Validierung laufend an die aktuellen Onboarding-Anforderungen anpassen. Die Tapaya Platform UI steht weiterhin zur Verfügung, um den Händler zu prüfen und Folgeaktionen abzuschließen.

    **So starten Sie:** Verwenden Sie den ausführlichen [API-Onboarding-Ablauf mit Beispielen](/platform-api/merchant_onboarding).

    Bevor Sie die Daten des Händlers über die API übermitteln, müssen Sie seine Zustimmung zu den [Tapaya Integrators Terms and Conditions](https://tapaya.com/terms) und der [Tapaya-Datenschutzerklärung](https://tapaya.com/privacy) einholen. Sie können Ihrem Onboarding-Formular ein Kontrollkästchen hinzufügen, das auf beide Dokumente verweist, oder aus dem Text der Bedingungen, denen der Händler zustimmt, auf die Tapaya-Dokumente verlinken. Außerdem müssen Sie Tapaya in Ihrer eigenen Datenschutzerklärung als Auftragsverarbeiter aufführen.

    Ihre Oberfläche kann jedes visuelle Design verwenden, das zu Ihrem Produkt passt. Ein typischer Ablauf teilt die erforderlichen Informationen in überschaubare Abschnitte auf und zeigt vor dem Absenden den Fortschritt an.

    <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="Wireframe eines eigenen Formulars für das Händler-Onboarding" src="__img2" />
    </div>
  </TabsContent>

  <TabsContent value="email">
    ### E-Mail-Einladung [#email-invite]

    Sie können das Onboarding eines Händlers starten, indem Sie ihn direkt aus der Tapaya Platform einladen. Geben Sie die E-Mail-Adresse des Händlers ein, und
    Tapaya erstellt eine Einladung zur einmaligen Verwendung mit einem sicheren, gehosteten Onboarding-Link; auf seiner Seite ist keine SDK-Integration
    erforderlich.

    Der Händler öffnet den Link, durchläuft denselben geführten KYB-Ablauf und kehrt nach der Verifizierung zu Ihrem Produkt zurück. Das ist nützlich, um das Onboarding von Händlern abzuschließen, bevor sie Ihre Integration nutzen, oder wenn Sie einen vollständig gehosteten Ablauf bevorzugen.

    Verwenden Sie diese Option für einzelne Einladungen, insbesondere wenn Sie wissen, wer der Händler ist, er seine Daten aber selbst angeben
    und bestätigen soll. Jede Einladung ist für einen Empfänger bestimmt und läuft ab, wenn sie nicht verwendet wird.

    Wenn Sie den Händler bereits in Ihrem eigenen System angelegt haben und das gehostete Onboarding von Tapaya genau diesem
    Datensatz zugeordnet werden soll, legen Sie zuerst den Basis-Händlerdatensatz (Merchant Shell) an und senden Sie dann die Einladung mit demselben `merchantToken`. Dies ist der empfohlene
    API-Ablauf für Integratoren:

    1. `POST /merchant/auth/register` oder `POST /integrator/merchant`
    2. `POST /integrator/merchant/send-registration-invite` mit `email` und demselben `merchantToken`
    3. Der Händler öffnet die zurückgegebene `registrationUrl` und füllt das gehostete KYB-Formular aus

    Ohne `merchantToken` wird beim Abschließen der Einladung ein neuer Händlerdatensatz angelegt.

    Unabhängig davon, über welchen Ablauf ein Händler das Onboarding durchläuft, folgt sein Konto demselben oben gezeigten Lebenszyklus der Verifizierung.

    **So starten Sie:** Versenden und verwalten Sie die Einladung in der Tapaya Platform UI, oder automatisieren Sie Einladungen über die
    [API](/platform-api/merchant_onboarding#invite-a-merchant-to-complete-hosted-onboarding).

    Klappen Sie in der Seitenleiste **Payments** auf und öffnen Sie **Merchants**. Gehen Sie zum Bereich **Add a merchant**. Wählen Sie auf der Karte **Invite via e-mail** die Option **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 für die E-Mail-Einladung in der Tapaya Platform" src="__img3" />
    </div>

    Geben Sie im Einladungsdialog die E-Mail-Adresse des Händlers ein und wählen Sie die Provision, die gelten soll.

    <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="Dialog zum Senden einer Registrierungseinladung an einen Händler" src="__img4" />
    </div>
  </TabsContent>

  <TabsContent value="campaign">
    ### Kampagnenlink [#campaign-link]

    Erstellen Sie einen wiederverwendbaren Registrierungslink und teilen Sie ihn über Ihre Website, ein Partnerportal, einen Newsletter oder einen anderen Kanal. Mehrere Händler können sich über den Link registrieren und das Onboarding in der von Tapaya gehosteten Oberfläche abschließen.

    Verwenden Sie diese Option, wenn die Empfänger nicht im Voraus bekannt sind oder Sie einen skalierbaren Self-Service-Ablauf zur Händlergewinnung wünschen. Sie bestimmen, wann der Link abläuft, und können ihn widerrufen, wenn die Kampagne endet.

    **So starten Sie:** Erstellen und verwalten Sie den Kampagnenlink in der Tapaya Platform UI, oder automatisieren Sie ihn über die [API](/platform-api/merchant_onboarding).

    Klappen Sie in der Seitenleiste **Payments** auf und öffnen Sie **Merchants**. Gehen Sie zum Bereich **Campaign onboarding links** und wählen Sie dann **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 für Kampagnenlinks zum Onboarding in der Tapaya Platform" src="__img5" />
    </div>

    Benennen Sie die Kampagne, legen Sie ihr Ablaufdatum fest und wählen Sie die Provision, bevor Sie den generierten Link teilen.

    <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="Dialog zur Verwaltung von Kampagnenlinks für das Onboarding" src="__img6" />
    </div>
  </TabsContent>
</Tabs>

## Wer wofür insgesamt zuständig ist [#who-owns-what-overall]

Über alle vier Abläufe hinweg fällt jeder Onboarding-Schritt einer oder mehreren der drei Parteien zu. Ein doppelt angehakter Schritt ist einer, dessen Zuständigkeit vom oben gewählten Ablauf abhängt.

<ResponsibilityMatrix
  rowHeader="Onboarding-Schritt"
  parties="[&#x22;tapaya&#x22;, &#x22;you&#x22;, &#x22;merchant&#x22;]"
  rows="[
  { label: &#x22;Onboarding-Ablauf wählen&#x22;, owners: [&#x22;you&#x22;] },
  { label: &#x22;Formular und Validierungsregeln bereitstellen&#x22;, owners: [&#x22;tapaya&#x22;, &#x22;you&#x22;] },
  { label: &#x22;Geschäfts-, Bank- und Eigentümerdaten eingeben&#x22;, owners: [&#x22;you&#x22;, &#x22;merchant&#x22;] },
  { label: &#x22;Einladungen und Kampagnenlinks verteilen&#x22;, owners: [&#x22;you&#x22;] },
  { label: &#x22;Den Bedingungen und der Datenschutzerklärung von Tapaya zustimmen&#x22;, owners: [&#x22;merchant&#x22;] },
  { label: &#x22;Antrag an den Zahlungsabwickler übermitteln&#x22;, owners: [&#x22;tapaya&#x22;] },
  { label: &#x22;Antrag verifizieren (KYB)&#x22;, owners: [&#x22;tapaya&#x22;] },
  { label: &#x22;Anforderungen regulatorisch aktuell halten&#x22;, owners: [&#x22;tapaya&#x22;, &#x22;you&#x22;] },
  { label: &#x22;Verifizierungsstatus überwachen&#x22;, owners: [&#x22;tapaya&#x22;, &#x22;you&#x22;] },
  { label: &#x22;Abgelehnte oder fehlende Angaben korrigieren&#x22;, owners: [&#x22;you&#x22;, &#x22;merchant&#x22;] },
]"
/>

## Wo die Verantwortung geteilt ist [#where-responsibility-is-shared]

* **Formular und Validierungsregeln bereitstellen:** Tapaya stellt das Formular für die Platform UI, E-Mail-Einladungen und Kampagnenlinks bereit und pflegt es. Wenn Sie eine eigene Oberfläche entwickeln, gehört das Formular Ihnen, und Sie passen seine Felder und Validierung laufend an die aktuellen Anforderungen an.
* **Den Bedingungen und der Datenschutzerklärung von Tapaya zustimmen:** Tapaya zeigt diese Dokumente in seinen gehosteten Abläufen an. Bei einer eigenen Oberfläche müssen Sie Links zu beiden Dokumenten anzeigen und die Zustimmung des Händlers einholen, bevor Sie seine Onboarding-Daten über die API übermitteln. Außerdem müssen Sie Tapaya in Ihrer eigenen Datenschutzerklärung als Auftragsverarbeiter aufführen.
* **Daten eingeben:** Beim unterstützten Onboarding über die Platform UI gibt Ihr Team sie ein. In jedem gehosteten oder Self-Service-Ablauf gibt der Händler seine Daten selbst ein.
* **Anforderungen regulatorisch aktuell halten:** Tapaya aktualisiert die gehosteten Abläufe automatisch. Bei einer eigenen Oberfläche verfolgen Sie Änderungen an den [Anforderungen für das API-Onboarding](/platform-api/merchant_onboarding) und aktualisieren Ihr Formular.
* **Verifizierungsstatus überwachen:** Tapaya stellt den Status in der Platform UI, über `Accept.merchant.onboardingStatus()` im Accept SDK und über die API bereit. Darauf zu reagieren ist Ihre Aufgabe: Weisen Sie den Händler darauf hin, wenn etwas fehlt oder abgelehnt wurde.
* **Abgelehnte oder fehlende Angaben korrigieren:** Wer die Angaben eingegeben hat, korrigiert sie auch. Bei gehosteten Abläufen bedeutet das, den Händler zum erneuten Einreichen aufzufordern.

Verantwortlichkeiten über den gesamten Lebenszyklus des Händlers hinweg, nicht nur beim Onboarding, finden Sie unter [Verantwortlichkeiten](./responsibilities).

## Verifizierungsstatus [#verification-status]

Nachdem der Händler das Formular abgesendet hat, geht sein Konto in den Prüfstatus über. Der Zahlungsabwickler prüft die Einreichung; das dauert in der Regel nur wenige Minuten, kann in manchen Fällen aber länger dauern.

Ein Händler kann erst Transaktionen abwickeln, wenn sein Konto verifiziert ist. Sie können seinen Status jederzeit in der Tapaya Platform UI prüfen. Integrationen können ihn auch mit `Accept.merchant.onboardingStatus()` im Accept SDK oder über die API prüfen und den Händler zum erneuten Einreichen auffordern, wenn Angaben fehlen oder abgelehnt wurden.