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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

3. Налаштуйте платіжну сторінку (Опційно)

   Для приймання платежів ви можете використовувати готову Для приймання платежів ви можете використовувати готову платіжну сторінку AI Fintech, яку можна оформити у вашому фірмовому стилі.

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

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

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

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