PayTabs

Підключення PayTabs до Mavibot

Щоб підключити PayTabs до Mavibot, вам потрібно налаштувати кілька параметрів у вашому обліковому записі PayTabs.

1. Створіть API-ключ

У панелі керування PayTabs перейдіть до:

Розробники → API Keys

Створіть новий API-ключ.

Після створення API-ключа збережіть такі дані:

• Серверний ключ — потрібен для налаштування інтеграції.

• ID профілю — також потрібен для налаштування підключення.

2. Налаштуйте сповіщення про платежі

Перейдіть до:

Розробники → Configuration

Увімкніть сповіщення про платежі (callbacks).

Натисніть "+" і додайте таку URL-адресу callback:

https://chatter.mavibot.ai/paytabs_callback/result

Цю URL-адресу використовують для надсилання оновлень статусу платежу до Mavibot.

3. Налаштуйте PayTabs у Mavibot

У налаштуваннях Mavibot:

1. Перейдіть до Acquiring розділу

2. Виберіть PayTabs як платіжного провайдера

3. Введіть такі дані:

   • ID профілю

   • Серверний ключ

4. Виберіть свій регіон облікового запису PayTabs

Зверніть увагу! Обраний регіон має збігатися з регіоном, у якому зареєстровано ваш обліковий запис PayTabs.

Після збереження налаштувань налаштування інтеграції буде завершено.

Генерування платіжного посилання

Щоб згенерувати платіжне посилання, використайте таку функцію:

get_paytabs_payment_url(amount, description, currency, customer_email, customer_phone, full_name, language)

Параметри функції

Параметр	Опис
! amount	Сума платежу. Обов’язковий параметр
description	Опис платежу. Необов’язковий параметр
currency	Валюта платежу. Необов’язковий параметр
customer_email	Електронна адреса клієнта. Необов’язковий параметр
customer_phone	Номер телефону клієнта. Необов’язковий параметр
full_name	Повне ім’я клієнта. Необов’язковий параметр
language	Мова сторінки оплати. Необов’язковий параметр

Доступні валюти

Підтримуються такі коди валют:

SAR, AED, BHD, EGP, EUR, GBP, HKD, IDR,INR, IQD, JOD, JPY, KWD, MAD, OMR,PKR, QAR, USD

Доступні мови

en — англійськаar — арабськаfr — французька

Функція повертає URL-адресу платежу.

Якщо currency параметр не вказано, валюта буде автоматично вибрана на основі налаштованого регіону.

Використання платіжного посилання в кнопці

Щоб надіслати клієнту кнопку оплати:

1. Створіть кнопку з Payment типом

2. Виберіть PayTabs як платіжного провайдера

3. Вкажіть:

   • опис платежу;

   • суму платежу;

   • валюту.

---

Обробка статусу платежу

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

Успішний платіж

Приклад:

SDJ91MTKTT_success 100

Де:

• SDJ91MTKTT — перші 10 символів Серверний ключ

• 100 — сума платежу

Щоб створити дію для успішного платежу, перейдіть до Builder і створіть блок із тригером (це може бути Start блок або Trigger блок).

Потім у полі Trigger введіть:

• повне значення callback (якщо ви хочете запускати дію лише для певної суми платежу), або

• лише значення callback до суми платежу (якщо ви хочете запускати дію для всіх успішних платежів).

Блок "Start"

Блок "Trigger"

Невдалий платіж

Приклад:

SDJ91MTKTT_fail 100

Обробка невдалого платежу налаштовується так само, як і обробка успішного платежу.

Створіть блок із тригером і введіть значення callback у полі Trigger . Це дає змогу визначити дії, які будуть виконані, коли платіж не вдасться.

Змінні, збережені після успішного платежу

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

paytabs_callback_data Містить повне корисне навантаження webhook, отримане від платіжної системи.

paytabs_payment_completed

Значення:

True

Показує, що платіж успішно завершено.