Перейти до основного вмісту

Як провести iнтеграцiю - контрольний список

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

Етап 1. Знайомство з мерчант-порталом​

  1. Створіть обліковий запис​

    Для підключення до Tranzzo та роботи із платежами вам потрібно зареєструватися у мерчант-порталі
    ➡️ Iнструкція з реєстрації.

  2. Додайте інших членів вашої команди​

    Ви можете одразу дати своїй команді доступ до облікового запису. Рівні доступу можна контролювати за допомогою набору ролей, які вже передбачені у мерчант-порталі ➡️ Додавання користувачів.

  3. Ознайомтесь з тестовим проєктом і скористайтеся його API-ключами​

    Після реєстрації у вас відразу буде доступ до тестового проєкту та його авторизаційних даних — API-ключів. Вони потрібні, щоб налаштувати і протестувати оплату перед початком роботи на робочому проєкті
    ➡️ Тестовий проєкт.

Етап 2. Налаштування інтеграції та проведення тестових платежів​

Перш ніж приймати оплату на вашому робочому проєкті, переконайтесь у коректності налаштувань та процесів.

  1. Пройдіть онбординг​

    Зв’яжіться з нашою Службою підтримки для проходження верифікації даних та визначення умов співпраці
    ➡️ Служба підтримки Tranzzo.

  2. Налаштуйте інтеграцію​

    Оберіть необхідний спосіб інтеграції та проведіть відповідні налаштування, використовуючи дані тестового проєкту ➡️ Варіанти інтеграції.

  3. Проведіть тестові платежі​

    Використовуйте тестові платіжні дані та перевірте різні сценарії оплати картками ➡️ Тестова оплата.

  4. Опрацюйте помилки та неуспішні платежі​

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

  5. Проведіть повернення та скасування резервів​

    Перевірте, як працює функціонал повернення коштів та/або скасування резерву (якщо ви використовуєте двостадійну оплату). Протестувати ці можливості можна за допомогою тестових платежів, які ви провели раніше.

  6. Налаштуйте перевірку платіжної картку (опційно)​

    Ця функція дозволяє пересвідчитися, що вказана платником картка дійсна, а її реквізити — правильні
    ➡️ Перевірка картки.

  7. Налаштуйте альтернативні способи оплати (опційно)​

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

Етап 3. Налаштування вебхуків​

Вебхуки — це метод, який Tranzzo використовує, щоб передавати інформацію про різні платіжні події (івенти). Зокрема, про статус платежів, успішне проходження 3DS, списання або резервування коштів; про повернення, зарахування резерву чи його скасування. Тому, щоб отримувати ці дані, вам треба налаштувати взаємодію із сервісом вебхуків.

  1. Визначте структуру вебхуків​

    Ознайомтесь із обовʼязковими та опційними параметрами вебхуків та визначте, які саме необхідні вам
    ➡️ Вебхуки.

  2. Відкрийте ендпоїнт для вебхуків​

    Щоб ендпоїнт міг отримувати наші вебхуки, надайте його загальнодоступний URL.

  3. Приймайте та опрацьовуйте сповіщення​

    Приймайте та опрацьовуйте сповіщення з інформацією про платежі та окремі операції, а також їхній статус.

Етап 4. Робота зі звітною інформацією​

  1. Отримуйте більше інформації за платежами​

    Квитанції, інформації за певними транзакціями, замовленнями тощо ➡️ Отримання інформації про платежі.

  2. Налаштуйте отримання реєстрів платежів (опційно)​

    Автоматично отримуйте реєстри за платежами за API або через планувальник отримання реєстрів у мерчант-порталі. Обсяг даних, дату і час відправки та формат реєстрів ви визначаєте самі.

Етап 5. Вихід онлайн​

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

  1. Створіть робочий проєкт​

    Зайдіть у мерчант-портал та своріть робочий проєкт. Замініть на вашій стороні автентифікаційні дані тестового проєкту на дані робочого.

  2. Посильте безпеку облікового запису​

    • Налаштуйте двофакторну автентифікацію (рекомендовано).
    • Визначте перелік дозволених IP-адрес для взаємодії з API (опційно).

  3. Налаштуйте платіжну сторінку або платіжний чи токенізаційний віджет (опційно)​

    Для приймання платежів ви можете використовувати:

  4. Налаштуйте програмний реєстратор розрахункових операцій (опційно)​

    Якщо ви працюєте на українському ринку і вам потрібно фіскалізувати онлайн-платежі, скористайтеся нашим готовим рішенням ➡️ Програмний РРО.

  5. Проведіть комплексне тестування​

    Фінальний етап інтеграції — перевірити, що всі етапи та сценарії вашого платіжного циклу працюють коректно.