Paytabs

Подключение PayTabs к Mavibot

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

1. Создайте API-ключ

В панели управления PayTabs перейдите в:

Developers → API Keys

Создайте новый API-ключ.

После создания API-ключа сохраните следующие данные:

• Server Key — требуется для настройки интеграции.

• Profile ID — также требуется для настройки подключения.

2. Настройте уведомления о платежах

Перейдите в:

Developers → Configuration

Включите уведомления о платежах (обратные вызовы).

Нажмите "+" и добавьте следующий URL обратного вызова:

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

Этот URL используется для отправки обновлений статуса платежа в Mavibot.

3. Настройте PayTabs в Mavibot

В настройках Mavibot:

1. Перейдите в Acquiring раздел

2. Выберите PayTabs в качестве платежного провайдера

3. Введите следующие данные:

   • Profile ID

   • Server Key

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. Создайте кнопку с Платеж типом

2. Выберите PayTabs в качестве платежного провайдера

3. Укажите:

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

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

   • валюту.

---

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

После того как клиент откроет платежную ссылку и завершит оплату, в диалог будет отправлено событие обратного вызова.

Успешный платеж

Пример:

SDJ91MTKTT_success 100

Где:

• SDJ91MTKTT — первые 10 символов Server Key

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

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

Затем в Trigger поле введите:

• полное значение обратного вызова (если вы хотите запускать действие только для определенной суммы платежа), или

• только значение обратного вызова до суммы платежа (если вы хотите запускать действие для всех успешных платежей).

Блок "Start"

Блок "Trigger"

Неуспешный платеж

Пример:

SDJ91MTKTT_fail 100

Обработка неуспешного платежа настраивается так же, как и обработка успешного платежа.

Создайте блок с триггером и введите значение обратного вызова в Trigger поле. Это позволяет определить действия, которые будут выполняться при неуспешном платеже.

Переменные, сохраняемые после успешного платежа

После успешного платежа для клиента автоматически сохраняются следующие переменные:

paytabs_callback_data Содержит полную полезную нагрузку webhook, полученную от платежной системы.

paytabs_payment_completed

Значение:

True

Указывает, что платеж был успешно завершен.