Подключение 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 — английскийar — арабскийfr — французский
Функция возвращает 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
Указывает, что платеж был успешно завершен.