# Onboarding (/cs/merchants/onboarding)



















Než může obchodník zpracovávat platby, musí dokončit onboarding KYB (Know Your Business). Tapaya ověřuje totožnost obchodníka a údaje o jeho podnikání, aby byly splněny požadavky zpracovatele plateb a regionální regulatorní požadavky.

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

## Povolení online plateb [#enable-online-payments]

Checkout je dostupný pro schválené obchodníky. Během onboardingu zvolte online platby, nebo online platby i platby v prodejně. Uveďte web obchodu a údaje o online podnikání. Onboarding pouze pro Checkout nevyžaduje terminály.

Obchodníci, kteří žádají o online platby, se automaticky zobrazí v sekci **Checkout** v [Tapaya Platform](https://platform.tapaya.com/checkout-settings). Platby nemohou přijímat, dokud je neschválí zpracovatel online plateb a dokud nemají nakonfigurovanou platební bránu. Samotné existující schválení pro platby v prodejně Checkout nepovolí. Obchodník musí být také aktivní.

V tabulce obchodníků Checkoutu ověřte stav **Ready** a poté v [nastavení Checkoutu](/online/integration/checkout_settings) nakonfigurujte klíče, peněženky a případné návratové URL adresy pro hostovaný Checkout. Samotné vytvoření záznamu obchodníka nebo API klíče platby nepovolí.

## Matice odpovědností [#responsibility-matrix]

Každý postup končí stejným rozhodnutím o ověření, ale práce, která k němu vede, je rozdělena různě. Než se pro některý z níže uvedených postupů rozhodnete, ujasněte si, kdo odpovídá za jednotlivé kroky.

<ResponsibilityMatrix
  columns="[
  { key: &#x22;platform&#x22;, label: &#x22;Platform UI&#x22; },
  { key: &#x22;own&#x22;, label: &#x22;Vlastní UI&#x22; },
  { key: &#x22;invite&#x22;, label: &#x22;E-mailová pozvánka&#x22; },
  { key: &#x22;campaign&#x22;, label: &#x22;Odkaz kampaně&#x22; },
]"
  rows="[
  { label: &#x22;Vytvoření záznamu obchodníka&#x22;, cells: { platform: &#x22;you&#x22;, own: { owner: &#x22;you&#x22;, note: &#x22;přes API&#x22; }, invite: { owner: &#x22;you&#x22;, note: &#x22;nebo jej vytvoří pozvánka&#x22; }, campaign: { owner: &#x22;merchant&#x22;, note: &#x22;registruje se sám&#x22; } } },
  { label: &#x22;Poskytnutí formuláře a pravidel validace&#x22;, cells: { platform: &#x22;tapaya&#x22;, own: &#x22;you&#x22;, invite: { owner: &#x22;tapaya&#x22;, note: &#x22;hostovaný&#x22; }, campaign: { owner: &#x22;tapaya&#x22;, note: &#x22;hostovaný&#x22; } } },
  { label: &#x22;Distribuce odkazu&#x22;, cells: { platform: &#x22;none&#x22;, own: &#x22;none&#x22;, invite: { owner: &#x22;you&#x22;, note: &#x22;jeden příjemce&#x22; }, campaign: { owner: &#x22;you&#x22;, note: &#x22;libovolný kanál&#x22; } } },
  { label: &#x22;Zadání údajů o podnikání, bankovních údajů a údajů o vlastnictví&#x22;, cells: { platform: &#x22;you&#x22;, own: { owner: &#x22;merchant&#x22;, note: &#x22;ve vašem UI&#x22; }, invite: &#x22;merchant&#x22;, campaign: &#x22;merchant&#x22; } },
  { label: &#x22;Souhlas s podmínkami Tapaya a zásadami ochrany osobních údajů&#x22;, cells: { platform: &#x22;merchant&#x22;, own: &#x22;merchant&#x22;, invite: &#x22;merchant&#x22;, campaign: &#x22;merchant&#x22; } },
  { label: &#x22;Odeslání žádosti zpracovateli&#x22;, cells: { platform: &#x22;tapaya&#x22;, own: &#x22;tapaya&#x22;, invite: &#x22;tapaya&#x22;, campaign: &#x22;tapaya&#x22; } },
  { label: &#x22;Ověření žádosti (KYB)&#x22;, cells: { platform: &#x22;tapaya&#x22;, own: &#x22;tapaya&#x22;, invite: &#x22;tapaya&#x22;, campaign: &#x22;tapaya&#x22; } },
  { label: &#x22;Sledování stavu ověření&#x22;, cells: { platform: &#x22;you&#x22;, own: &#x22;you&#x22;, invite: &#x22;you&#x22;, campaign: &#x22;you&#x22; } },
  { label: &#x22;Oprava odmítnutých nebo chybějících údajů&#x22;, cells: { platform: &#x22;you&#x22;, own: &#x22;you&#x22;, invite: &#x22;merchant&#x22;, campaign: &#x22;merchant&#x22; } },
]"
/>

Při asistovaném onboardingu v Platform UI vyplňuje formulář za obchodníka váš operátor. Stranou, která uděluje souhlas s podmínkami Tapaya a zásadami ochrany osobních údajů, je však stále obchodník, proto si před odesláním ověřte, že se s nimi seznámil a souhlasil s nimi.

## Výběr postupu onboardingu [#choose-an-onboarding-flow]

Postup zvolte podle toho, kdo má zadávat údaje obchodníka a jak chcete onboarding distribuovat. Všechny postupy jsou dostupné v Tapaya Platform UI. Pokud je chcete automatizovat, použijte odpovídající API popsané v části [API pro onboarding obchodníků](/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">
      Vlastní UI
    </TabsTrigger>

    <TabsTrigger value="email">
      E-mailová pozvánka
    </TabsTrigger>

    <TabsTrigger value="campaign">
      Odkaz kampaně
    </TabsTrigger>
  </TabsList>

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

    Administrátor zadá informace o obchodníkovi a dokončí onboarding jeho jménem v [Tapaya Platform](https://platform.tapaya.com). Tento postup je vhodný pro asistovaný onboarding, menší portfolia obchodníků nebo případy, kdy váš provozní tým již potřebné informace má.

    **Jak začít:** Vytvořte nebo vyberte obchodníka v Tapaya Platform a otevřete jeho onboarding. Pokud potřebujete automatizaci, lze stejný postup zahájit přes [API](/platform-api/merchant_onboarding).

    V postranním panelu rozbalte **Payments** a otevřete **Merchants**. Přejděte do sekce **Add a merchant**. Na kartě **Add a merchant manually** zvolte **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="Zahájení onboardingu obchodníka v Tapaya Platform" src="__img0" />
    </div>

    Tapaya Platform otevře řízený formulář onboardingu s povinnými sekcemi pro údaje o podnikání, bankovní údaje a údaje o vlastnictví.

    <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="Formulář s údaji o podnikání obchodníka v Tapaya Platform" src="__img1" />
    </div>
  </TabsContent>

  <TabsContent value="api">
    ### Vlastní UI [#your-own-ui]

    Shromážděte informace o obchodníkovi ve vlastním produktu a odešlete je do Tapaya. Získáte tak plnou kontrolu nad uživatelským prostředím a můžete onboarding propojit se stávajícím postupem registrace nebo správy účtu.

    Tato možnost vyžaduje, abyste svůj formulář a validaci udržovali v souladu s aktuálními požadavky na onboarding. Tapaya Platform UI zůstává k dispozici pro kontrolu obchodníka a dokončení navazujících kroků.

    **Jak začít:** Použijte podrobný [postup onboardingu přes API včetně příkladů](/platform-api/merchant_onboarding).

    Před odesláním údajů obchodníka přes API musíte získat jeho souhlas s [obchodními podmínkami Tapaya pro integrátory](https://tapaya.com/terms) a [zásadami ochrany osobních údajů Tapaya](https://tapaya.com/privacy). Do formuláře onboardingu můžete přidat zaškrtávací políčko s odkazy na oba dokumenty, nebo na dokumenty Tapaya odkázat z textu podmínek, se kterými obchodník souhlasí. Tapaya také musíte uvést jako zpracovatele osobních údajů ve svých vlastních zásadách ochrany osobních údajů.

    Vaše rozhraní může mít libovolný vizuální design, který odpovídá vašemu produktu. Typický postup rozděluje požadované informace do přehledných sekcí a před odesláním zobrazuje průběh.

    <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="Drátěný model vlastního formuláře onboardingu obchodníka" src="__img2" />
    </div>
  </TabsContent>

  <TabsContent value="email">
    ### E-mailová pozvánka [#email-invite]

    Onboarding obchodníka můžete provést tak, že jej pozvete přímo z Tapaya Platform. Zadejte e-mailovou adresu obchodníka a
    Tapaya vytvoří jednorázovou pozvánku se zabezpečeným odkazem na hostovaný onboarding; na jeho straně není potřeba žádná
    integrace SDK.

    Obchodník otevře odkaz, projde stejným řízeným postupem KYB a po ověření se vrátí do vašeho produktu. To se hodí pro onboarding obchodníků dříve, než začnou používat vaši integraci, nebo pokud dáváte přednost plně hostovanému postupu.

    Tento postup použijte pro jednotlivé pozvánky, zejména pokud víte, o jakého obchodníka jde, ale chcete, aby své údaje
    zadal a potvrdil sám. Každá pozvánka je určena pro jednoho příjemce, a pokud není použita, vyprší.

    Pokud jste obchodníka již vytvořili ve svém systému a potřebujete, aby se hostovaný onboarding Tapaya připojil právě
    k tomuto záznamu, nejprve vytvořte základní záznam obchodníka a poté odešlete pozvánku se stejným `merchantToken`. Toto je
    doporučený postup přes API pro integrátory:

    1. `POST /merchant/auth/register` nebo `POST /integrator/merchant`
    2. `POST /integrator/merchant/send-registration-invite` s `email` a stejným `merchantToken`
    3. Obchodník otevře vrácenou `registrationUrl` a vyplní hostovaný formulář KYB

    Bez `merchantToken` vytvoří dokončení pozvánky nový záznam obchodníka.

    Bez ohledu na to, kterým postupem obchodník onboardingem prochází, jeho účet podléhá stejnému životnímu cyklu ověření, jaký je znázorněn výše.

    **Jak začít:** Pozvánku odešlete a spravujte v Tapaya Platform UI, nebo pozvánky automatizujte přes
    [API](/platform-api/merchant_onboarding#invite-a-merchant-to-complete-hosted-onboarding).

    V postranním panelu rozbalte **Payments** a otevřete **Merchants**. Přejděte do sekce **Add a merchant**. Na kartě **Invite via e-mail** zvolte **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="Možnost e-mailové pozvánky v Tapaya Platform" src="__img3" />
    </div>

    V dialogu pozvánky zadejte e-mailovou adresu obchodníka a zvolte provizi, která se má uplatnit.

    <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 pro odeslání registrační pozvánky obchodníkovi" src="__img4" />
    </div>
  </TabsContent>

  <TabsContent value="campaign">
    ### Odkaz kampaně [#campaign-link]

    Vytvořte jeden opakovaně použitelný registrační odkaz a sdílejte jej na svém webu, v partnerském portálu, v newsletteru nebo prostřednictvím jiného kanálu. Odkaz může použít více obchodníků k registraci a dokončení onboardingu v UI hostovaném společností Tapaya.

    Tento postup použijte, pokud příjemce předem neznáte nebo pokud chcete škálovatelný samoobslužný akviziční postup. O tom, kdy odkaz vyprší, rozhodujete vy a po skončení kampaně jej můžete zrušit.

    **Jak začít:** Odkaz kampaně vytvořte a spravujte v Tapaya Platform UI, nebo jej automatizujte přes [API](/platform-api/merchant_onboarding).

    V postranním panelu rozbalte **Payments** a otevřete **Merchants**. Přejděte do sekce **Campaign onboarding links** a zvolte **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="Možnost odkazů kampaně pro onboarding v Tapaya Platform" src="__img5" />
    </div>

    Před sdílením vygenerovaného odkazu kampaň pojmenujte, nastavte datum vypršení platnosti a zvolte provizi.

    <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 pro správu odkazů kampaně pro onboarding" src="__img6" />
    </div>
  </TabsContent>
</Tabs>

## Kdo za co odpovídá celkově [#who-owns-what-overall]

Napříč všemi čtyřmi postupy připadá každý krok onboardingu jedné nebo více ze tří stran. Krok zaškrtnutý dvakrát je takový, jehož vlastník závisí na postupu, který jste zvolili výše.

<ResponsibilityMatrix
  rowHeader="Krok onboardingu"
  parties="[&#x22;tapaya&#x22;, &#x22;you&#x22;, &#x22;merchant&#x22;]"
  rows="[
  { label: &#x22;Výběr postupu onboardingu&#x22;, owners: [&#x22;you&#x22;] },
  { label: &#x22;Poskytnutí formuláře a pravidel validace&#x22;, owners: [&#x22;tapaya&#x22;, &#x22;you&#x22;] },
  { label: &#x22;Zadání údajů o podnikání, bankovních údajů a údajů o vlastnictví&#x22;, owners: [&#x22;you&#x22;, &#x22;merchant&#x22;] },
  { label: &#x22;Distribuce pozvánek a odkazů kampaní&#x22;, owners: [&#x22;you&#x22;] },
  { label: &#x22;Souhlas s podmínkami Tapaya a zásadami ochrany osobních údajů&#x22;, owners: [&#x22;merchant&#x22;] },
  { label: &#x22;Odeslání žádosti zpracovateli&#x22;, owners: [&#x22;tapaya&#x22;] },
  { label: &#x22;Ověření žádosti (KYB)&#x22;, owners: [&#x22;tapaya&#x22;] },
  { label: &#x22;Udržování požadavků v souladu s předpisy&#x22;, owners: [&#x22;tapaya&#x22;, &#x22;you&#x22;] },
  { label: &#x22;Sledování stavu ověření&#x22;, owners: [&#x22;tapaya&#x22;, &#x22;you&#x22;] },
  { label: &#x22;Oprava odmítnutých nebo chybějících údajů&#x22;, owners: [&#x22;you&#x22;, &#x22;merchant&#x22;] },
]"
/>

## Kde je odpovědnost sdílená [#where-responsibility-is-shared]

* **Poskytnutí formuláře a pravidel validace:** Tapaya poskytuje a udržuje formulář pro Platform UI, e-mailové pozvánky a odkazy kampaní. Pokud vytvoříte vlastní UI, formulář je váš a jeho pole a validaci udržujete v souladu s aktuálními požadavky vy.
* **Souhlas s podmínkami Tapaya a zásadami ochrany osobních údajů:** Tapaya tyto dokumenty předkládá ve svých hostovaných postupech. U vlastního UI musíte předložit odkazy na oba dokumenty a získat souhlas obchodníka dříve, než jeho údaje pro onboarding odešlete přes API. Tapaya také musíte uvést jako zpracovatele osobních údajů ve svých vlastních zásadách ochrany osobních údajů.
* **Zadání údajů:** Při asistovaném onboardingu v Platform UI je zadává váš tým. Ve všech hostovaných nebo samoobslužných postupech zadává obchodník své údaje sám.
* **Udržování požadavků v souladu s předpisy:** Tapaya aktualizuje hostované postupy automaticky. U vlastního UI sledujete změny [požadavků na onboarding přes API](/platform-api/merchant_onboarding) a aktualizujete svůj formulář vy.
* **Sledování stavu ověření:** Tapaya zpřístupňuje stav v Platform UI, prostřednictvím `Accept.merchant.onboardingStatus()` v Accept SDK a přes API. Reagovat na něj je na vás: vyzvěte obchodníka, pokud něco chybí nebo bylo odmítnuto.
* **Oprava odmítnutých nebo chybějících údajů:** Údaje opravuje ten, kdo je zadal. U hostovaných postupů to znamená vyzvat obchodníka k jejich opětovnému odeslání.

Odpovědnosti v rámci celého životního cyklu obchodníka, nikoli jen onboardingu, najdete v části [Odpovědnosti](./responsibilities).

## Stav ověření [#verification-status]

Jakmile obchodník odešle formulář, jeho účet přejde do stavu kontroly. Podání kontroluje zpracovatel plateb; kontrola obvykle proběhne během několika minut, v některých případech však může trvat déle.

Obchodník nebude moci zpracovávat transakce, dokud nebude jeho účet ověřen. Jeho stav můžete kdykoli zkontrolovat v Tapaya Platform UI. Integrace jej mohou zjistit také pomocí `Accept.merchant.onboardingStatus()` v Accept SDK nebo přes API a vyzvat obchodníka k opětovnému odeslání, pokud údaje chybí nebo byly odmítnuty.