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

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

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

Прогрес інтеграції0 / 20 кроків

11. Знайомство з мерчант-порталом22. Налаштування інтеграції та проведення тестових платежів33. Налаштування вебхуків44. Робота зі звітною інформацією55. Вихід онлайн

1

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

0/3

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

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

➡️ Iнструкція з реєстрації

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

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

➡️ Додавання користувачів

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

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

➡️ Тестовий проєкт

2

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

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

0/7

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

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

➡️ Служба підтримки Tranzzo

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

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

➡️ Варіанти інтеграції

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

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

➡️ Тестова оплата

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

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

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

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

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

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

➡️ Перевірка картки

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

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

➡️ Методи оплати

3

Налаштування вебхуків

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

0/3

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

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

➡️ Вебхуки

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

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

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

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

4

Робота зі звітною інформацією

0/2

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

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

➡️ Отримання інформації про платежі

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

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

5

Вихід онлайн

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

0/5

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

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

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

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

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

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

• Платіжний віджет, інтегрований у вашу сторінку.
• Токенізаційний віджет, який додається безпосередньо на ваш сайт.
• Готову платіжну сторінку Tranzzo, яку можна оформити у вашому фірмовому стилі.
• Мобільний SDK з кастомізацією кольорових схем платіжного екрану.

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

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

➡️ Програмний РРО

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

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