Підключення PayTabs до Mavibot
Щоб підключити PayTabs до Mavibot, потрібно налаштувати кілька параметрів у вашому обліковому записі PayTabs.
1. Створення API-ключа
У панелі керування PayTabs перейдіть до:
Developers → API Keys
Створіть новий API-ключ.
Після створення API-ключа збережіть такі дані:
- Server Key — необхідний для налаштування інтеграції.
- Profile ID — також потрібен для налаштування з'єднання.
2. Налаштування сповіщень про оплату
Перейдіть до:
Developers → Configuration
Увімкніть сповіщення про оплату (callbacks).
Натисніть "+" і додайте наступну URL-адресу зворотного виклику:
https://chatter.mavibot.ai/paytabs_callback/result
Ця URL-адреса використовується для надсилання оновлень статусу платежу до Mavibot.
3. Налаштування PayTabs у Mavibot
У налаштуваннях Mavibot:
- Перейдіть до розділу Acquiring
- Виберіть PayTabs як платіжного провайдера
- Введіть такі дані:
- Profile ID
- Server Key
- Виберіть регіон облікового запису 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 — Englishar — Arabicfr — French
Функція повертає URL-адресу платежу.
Якщо параметр currency не вказано, валюта буде автоматично вибрана на основі налаштованого регіону.
Використання платіжного посилання в кнопці
Щоб надіслати клієнту кнопку оплати:
- Створіть кнопку типу Payment
- Виберіть PayTabs як платіжного провайдера
- Вкажіть:
- опис платежу;
- суму платежу;
- валюту.
Обробка статусу платежу
Після того, як клієнт відкриє платіжне посилання та завершить оплату, до розмови буде надіслано подію зворотного виклику.
Успішний платіж
Приклад:
SDJ91MTKTT_success 100
Де:
- SDJ91MTKTT — перші 10 символів Server Key
- 100 — сума платежу
Щоб створити дію для успішного платежу, перейдіть до Builder і створіть блок з тригером (це може бути блок Start або блок Trigger).
Потім у полі Trigger введіть:
- повне значення зворотного виклику (якщо ви хочете запускати дію лише для певної суми платежу), або
- лише значення зворотного виклику до суми платежу (якщо ви хочете запускати дію для всіх успішних платежів).
Невдалий платіж
Приклад:
SDJ91MTKTT_fail 100
Обробка невдалого платежу налаштовується так само, як і обробка успішного платежу.
Створіть блок з тригером і введіть значення зворотного виклику в поле Trigger. Це дозволяє визначити дії, які будуть виконані, коли платіж не вдасться.
Змінні, збережені після успішного платежу
Після успішного платежу для клієнта автоматично зберігаються такі змінні:
paytabs_callback_data
Містить повну корисну інформацію вебхука, отриману від платіжної системи.
paytabs_payment_completed
Значення:
True
Вказує на те, що платіж успішно завершено.