# Онбординг (/uk/merchants/onboarding)



















Перш ніж мерчант зможе обробляти платежі, він повинен пройти онбординг KYB (Know Your Business). Tapaya верифікує особу мерчанта та дані про його бізнес, щоб виконати вимоги платіжного процесора та регіональні регуляторні вимоги.

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

## Увімкнення онлайн-платежів [#enable-online-payments]

Checkout доступний для схвалених мерчантів. Під час онбордингу виберіть онлайн-платежі або одночасно онлайн-платежі й платежі в торговій точці. Укажіть вебсайт магазину та дані про онлайн-бізнес. Онбординг лише для Checkout не потребує терміналів.

Мерчанти, які подають запит на онлайн-платежі, автоматично з'являються в розділі **Checkout** у [Tapaya Platform](https://platform.tapaya.com/checkout-settings). Вони не можуть приймати платежі, доки їх не схвалить процесор онлайн-платежів і доки не буде налаштовано їхній платіжний шлюз. Наявне схвалення для платежів у торговій точці саме по собі не вмикає Checkout. Мерчант також має бути активним.

Перевірте статус **Ready** у таблиці мерчантів Checkout, а потім налаштуйте ключі, гаманці та URL-адреси повернення для хостованого Checkout (за потреби) в [налаштуваннях Checkout](/online/integration/checkout_settings). Саме лише створення запису мерчанта чи API-ключа не вмикає платежі.

## Матриця відповідальності [#responsibility-matrix]

Кожен сценарій завершується тим самим рішенням щодо верифікації, але робота, що до нього веде, розподіляється по-різному. Перш ніж обрати один зі сценаріїв нижче, з'ясуйте, хто відповідає за кожен крок.

<ResponsibilityMatrix
  columns="[
  { key: &#x22;platform&#x22;, label: &#x22;Platform UI&#x22; },
  { key: &#x22;own&#x22;, label: &#x22;Власний інтерфейс&#x22; },
  { key: &#x22;invite&#x22;, label: &#x22;Запрошення електронною поштою&#x22; },
  { key: &#x22;campaign&#x22;, label: &#x22;Посилання кампанії&#x22; },
]"
  rows="[
  { label: &#x22;Створення запису мерчанта&#x22;, cells: { platform: &#x22;you&#x22;, own: { owner: &#x22;you&#x22;, note: &#x22;через API&#x22; }, invite: { owner: &#x22;you&#x22;, note: &#x22;або його створює запрошення&#x22; }, campaign: { owner: &#x22;merchant&#x22;, note: &#x22;реєструється сам&#x22; } } },
  { label: &#x22;Надання форми та правил валідації&#x22;, cells: { platform: &#x22;tapaya&#x22;, own: &#x22;you&#x22;, invite: { owner: &#x22;tapaya&#x22;, note: &#x22;хостована&#x22; }, campaign: { owner: &#x22;tapaya&#x22;, note: &#x22;хостована&#x22; } } },
  { label: &#x22;Поширення посилання&#x22;, cells: { platform: &#x22;none&#x22;, own: &#x22;none&#x22;, invite: { owner: &#x22;you&#x22;, note: &#x22;один отримувач&#x22; }, campaign: { owner: &#x22;you&#x22;, note: &#x22;будь-який канал&#x22; } } },
  { label: &#x22;Введення даних про бізнес, банківських даних і даних про власників&#x22;, cells: { platform: &#x22;you&#x22;, own: { owner: &#x22;merchant&#x22;, note: &#x22;у вашому інтерфейсі&#x22; }, invite: &#x22;merchant&#x22;, campaign: &#x22;merchant&#x22; } },
  { label: &#x22;Згода з умовами Tapaya та Політикою конфіденційності&#x22;, cells: { platform: &#x22;merchant&#x22;, own: &#x22;merchant&#x22;, invite: &#x22;merchant&#x22;, campaign: &#x22;merchant&#x22; } },
  { label: &#x22;Подання заявки процесору&#x22;, cells: { platform: &#x22;tapaya&#x22;, own: &#x22;tapaya&#x22;, invite: &#x22;tapaya&#x22;, campaign: &#x22;tapaya&#x22; } },
  { label: &#x22;Верифікація заявки (KYB)&#x22;, cells: { platform: &#x22;tapaya&#x22;, own: &#x22;tapaya&#x22;, invite: &#x22;tapaya&#x22;, campaign: &#x22;tapaya&#x22; } },
  { label: &#x22;Відстеження статусу верифікації&#x22;, cells: { platform: &#x22;you&#x22;, own: &#x22;you&#x22;, invite: &#x22;you&#x22;, campaign: &#x22;you&#x22; } },
  { label: &#x22;Виправлення відхилених або відсутніх даних&#x22;, cells: { platform: &#x22;you&#x22;, own: &#x22;you&#x22;, invite: &#x22;merchant&#x22;, campaign: &#x22;merchant&#x22; } },
]"
/>

Під час асистованого онбордингу в Platform UI форму від імені мерчанта заповнює ваш оператор. Проте згоду з умовами Tapaya та Політикою конфіденційності все одно надає мерчант, тому перед надсиланням переконайтеся, що він ознайомився з ними та погодився.

## Вибір сценарію онбордингу [#choose-an-onboarding-flow]

Вибирайте сценарій залежно від того, хто має вводити дані мерчанта і як ви хочете поширювати онбординг. Усі сценарії доступні в Tapaya Platform UI. Якщо ви хочете їх автоматизувати, використовуйте відповідний API, описаний у розділі [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">
      Власний інтерфейс
    </TabsTrigger>

    <TabsTrigger value="email">
      Запрошення електронною поштою
    </TabsTrigger>

    <TabsTrigger value="campaign">
      Посилання кампанії
    </TabsTrigger>
  </TabsList>

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

    Адміністратор вводить інформацію про мерчанта й завершує онбординг від його імені в [Tapaya Platform](https://platform.tapaya.com). Цей сценарій підходить для асистованого онбордингу, невеликих портфелів мерчантів або випадків, коли ваша операційна команда вже має потрібну інформацію.

    **Як почати:** Створіть або виберіть мерчанта в Tapaya Platform і відкрийте його онбординг. Якщо потрібна автоматизація, той самий сценарій можна ініціювати через [API](/platform-api/merchant_onboarding).

    На бічній панелі розгорніть **Payments** і відкрийте **Merchants**. Перейдіть до розділу **Add a merchant**. На картці **Add a merchant manually** виберіть **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="Початок онбордингу мерчанта в Tapaya Platform" src="__img0" />
    </div>

    Tapaya Platform відкриває покрокову форму онбордингу з обов'язковими розділами для даних про бізнес, банківських даних і даних про власників.

    <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="Форма з даними про бізнес мерчанта в Tapaya Platform" src="__img1" />
    </div>
  </TabsContent>

  <TabsContent value="api">
    ### Власний інтерфейс [#your-own-ui]

    Збирайте інформацію про мерчанта у власному продукті та надсилайте її до Tapaya. Так ви отримуєте повний контроль над користувацьким досвідом і можете поєднати онбординг із наявним процесом реєстрації чи керування обліковим записом.

    Цей варіант вимагає, щоб ви підтримували свою форму та валідацію відповідно до актуальних вимог до онбордингу. Tapaya Platform UI залишається доступним для перегляду мерчанта та виконання подальших дій.

    **Як почати:** Використовуйте докладний [сценарій онбордингу через API з прикладами](/platform-api/merchant_onboarding).

    Перш ніж надсилати дані мерчанта через API, ви повинні отримати його згоду з [Умовами та положеннями Tapaya для інтеграторів](https://tapaya.com/terms) і [Політикою конфіденційності Tapaya](https://tapaya.com/privacy). Ви можете додати до форми онбордингу прапорець із посиланнями на обидва документи або послатися на документи Tapaya в тексті умов, з якими погоджується мерчант. Ви також повинні зазначити Tapaya як обробника даних у власній політиці конфіденційності.

    Ваш інтерфейс може мати будь-який візуальний дизайн, що відповідає вашому продукту. Типовий сценарій розподіляє потрібну інформацію на зручні розділи та показує прогрес перед надсиланням.

    <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="Каркасний макет власної форми онбордингу мерчанта" src="__img2" />
    </div>
  </TabsContent>

  <TabsContent value="email">
    ### Запрошення електронною поштою [#email-invite]

    Ви можете провести онбординг мерчанта, запросивши його безпосередньо з Tapaya Platform. Введіть адресу електронної пошти мерчанта, і
    Tapaya створить одноразове запрошення із захищеним посиланням на хостований онбординг; інтеграція SDK на його боці
    не потрібна.

    Мерчант відкриває посилання, проходить той самий покроковий процес KYB і після верифікації повертається до вашого продукту. Це зручно для онбордингу мерчантів ще до того, як вони почнуть використовувати вашу інтеграцію, або якщо ви надаєте перевагу повністю хостованому сценарію.

    Використовуйте цей сценарій для індивідуальних запрошень, особливо коли ви знаєте, хто є мерчантом, але хочете, щоб він сам
    надав і підтвердив свою інформацію. Кожне запрошення призначене для одного отримувача, і його термін дії спливає, якщо його не використано.

    Якщо ви вже створили мерчанта у своїй системі й потрібно, щоб хостований онбординг Tapaya прив'язався саме до цього
    запису, спочатку створіть базовий запис мерчанта, а потім надішліть запрошення з тим самим `merchantToken`. Це
    рекомендований сценарій API для інтеграторів:

    1. `POST /merchant/auth/register` або `POST /integrator/merchant`
    2. `POST /integrator/merchant/send-registration-invite` з `email` і тим самим `merchantToken`
    3. Мерчант відкриває повернений `registrationUrl` і заповнює хостовану форму KYB

    Без `merchantToken` завершення запрошення створює новий запис мерчанта.

    Яким би сценарієм мерчант не проходив онбординг, його обліковий запис має той самий життєвий цикл верифікації, показаний вище.

    **Як почати:** Надсилайте запрошення та керуйте ними в Tapaya Platform UI або автоматизуйте запрошення через
    [API](/platform-api/merchant_onboarding#invite-a-merchant-to-complete-hosted-onboarding).

    На бічній панелі розгорніть **Payments** і відкрийте **Merchants**. Перейдіть до розділу **Add a merchant**. На картці **Invite via e-mail** виберіть **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="Варіант запрошення електронною поштою в Tapaya Platform" src="__img3" />
    </div>

    У діалоговому вікні запрошення введіть адресу електронної пошти мерчанта та виберіть комісію, яка має застосовуватися.

    <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="Діалогове вікно надсилання запрошення мерчанту на реєстрацію" src="__img4" />
    </div>
  </TabsContent>

  <TabsContent value="campaign">
    ### Посилання кампанії [#campaign-link]

    Створіть одне багаторазове реєстраційне посилання та поширюйте його через свій вебсайт, партнерський портал, розсилку чи інший канал. Кілька мерчантів можуть використати це посилання, щоб зареєструватися та пройти онбординг в інтерфейсі, розміщеному Tapaya.

    Використовуйте цей сценарій, коли отримувачі заздалегідь невідомі або коли вам потрібен масштабований сценарій самостійного залучення. Ви визначаєте, коли спливає термін дії посилання, і можете відкликати його після завершення кампанії.

    **Як почати:** Створюйте посилання кампанії та керуйте ним у Tapaya Platform UI або автоматизуйте це через [API](/platform-api/merchant_onboarding).

    На бічній панелі розгорніть **Payments** і відкрийте **Merchants**. Перейдіть до розділу **Campaign onboarding links**, а потім виберіть **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="Варіант посилань кампанії для онбордингу в Tapaya Platform" src="__img5" />
    </div>

    Перш ніж поширювати згенероване посилання, дайте кампанії назву, установіть дату закінчення терміну дії та виберіть комісію.

    <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="Діалогове вікно керування посиланнями кампанії для онбордингу" src="__img6" />
    </div>
  </TabsContent>
</Tabs>

## Хто за що відповідає загалом [#who-owns-what-overall]

У всіх чотирьох сценаріях кожен крок онбордингу належить одній або кільком із трьох сторін. Якщо крок позначено двічі, то хто за нього відповідає, залежить від сценарію, який ви обрали вище.

<ResponsibilityMatrix
  rowHeader="Крок онбордингу"
  parties="[&#x22;tapaya&#x22;, &#x22;you&#x22;, &#x22;merchant&#x22;]"
  rows="[
  { label: &#x22;Вибір сценарію онбордингу&#x22;, owners: [&#x22;you&#x22;] },
  { label: &#x22;Надання форми та правил валідації&#x22;, owners: [&#x22;tapaya&#x22;, &#x22;you&#x22;] },
  { label: &#x22;Введення даних про бізнес, банківських даних і даних про власників&#x22;, owners: [&#x22;you&#x22;, &#x22;merchant&#x22;] },
  { label: &#x22;Поширення запрошень і посилань кампаній&#x22;, owners: [&#x22;you&#x22;] },
  { label: &#x22;Згода з умовами Tapaya та Політикою конфіденційності&#x22;, owners: [&#x22;merchant&#x22;] },
  { label: &#x22;Подання заявки процесору&#x22;, owners: [&#x22;tapaya&#x22;] },
  { label: &#x22;Верифікація заявки (KYB)&#x22;, owners: [&#x22;tapaya&#x22;] },
  { label: &#x22;Підтримання вимог відповідно до чинного регулювання&#x22;, owners: [&#x22;tapaya&#x22;, &#x22;you&#x22;] },
  { label: &#x22;Відстеження статусу верифікації&#x22;, owners: [&#x22;tapaya&#x22;, &#x22;you&#x22;] },
  { label: &#x22;Виправлення відхилених або відсутніх даних&#x22;, owners: [&#x22;you&#x22;, &#x22;merchant&#x22;] },
]"
/>

## Де відповідальність спільна [#where-responsibility-is-shared]

* **Надання форми та правил валідації:** Tapaya надає та підтримує форму для Platform UI, запрошень електронною поштою та посилань кампаній. Якщо ви створюєте власний інтерфейс, форма належить вам, і ви підтримуєте її поля та валідацію відповідно до актуальних вимог.
* **Згода з умовами Tapaya та Політикою конфіденційності:** Tapaya показує ці документи у своїх хостованих сценаріях. У власному інтерфейсі ви повинні надати посилання на обидва документи та отримати згоду мерчанта, перш ніж надсилати його дані для онбордингу через API. Ви також повинні зазначити Tapaya як обробника даних у власній політиці конфіденційності.
* **Введення даних:** Під час асистованого онбордингу в Platform UI їх вводить ваша команда. У всіх хостованих сценаріях і сценаріях самообслуговування мерчант вводить свої дані сам.
* **Підтримання вимог відповідно до чинного регулювання:** Tapaya оновлює хостовані сценарії автоматично. У власному інтерфейсі ви відстежуєте зміни [вимог до онбордингу через API](/platform-api/merchant_onboarding) й оновлюєте свою форму.
* **Відстеження статусу верифікації:** Tapaya надає статус у Platform UI, через `Accept.merchant.onboardingStatus()` в Accept SDK і через API. Реагувати на нього маєте ви: повідомте мерчанта, якщо чогось бракує або щось відхилено.
* **Виправлення відхилених або відсутніх даних:** Дані виправляє той, хто їх вводив. Для хостованих сценаріїв це означає попросити мерчанта надіслати їх повторно.

Обов'язки впродовж усього життєвого циклу мерчанта, а не лише онбордингу, описано в розділі [Обов'язки](./responsibilities).

## Статус верифікації [#verification-status]

Після того як мерчант надішле форму, його обліковий запис переходить у стан перевірки. Подані дані перевіряє платіжний процесор; зазвичай це триває кілька хвилин, але в деяких випадках може зайняти більше часу.

Мерчант не зможе обробляти транзакції, доки його обліковий запис не буде верифіковано. Ви можете будь-коли перевірити його статус у Tapaya Platform UI. Інтеграції також можуть перевірити його за допомогою `Accept.merchant.onboardingStatus()` в Accept SDK або через API та попросити мерчанта надіслати дані повторно, якщо їх бракує або їх відхилено.