Интеграция с PayTR позволяет принимать платежи через PayTR — турецкого поставщика платежных услуг. Клиенты совершают оплату на защищенной платежной странице PayTR, где могут использовать турецкие банковские карты и другие локальные способы оплаты.

Получение учетных данных для интеграции

Перед подключением PayTR заключите договор с PayTR и получите доступ к своему мерчант-аккаунту.

В левом меню откройте Bilgi (Информация) и найдите раздел API Entegrasyon Bilgileri. Скопируйте следующие значения:

Панель управления PayTR	Поле в Mavibot
Mağaza No	Merchant ID (`merchant_id`)
Mağaza Anahtarı	Merchant Key (`merchant_key`)
Mağaza Şifresi	Merchant Salt (`merchant_salt`)

Примечание: Эти учетные данные доступны только Ana Kullanıcı (Главному пользователю) и Teknik Sorumlu (Техническому ответственному). Если вы не видите этот раздел, попросите владельца основного аккаунта предоставить вам необходимые разрешения.

Вам не нужно настраивать URL-адрес уведомления о платеже (callback) в панели управления PayTR. Mavibot автоматически отправляет callback-URL с каждым запросом на создание платежной ссылки.

Подключение PayTR

Откройте настройки Эквайринг в Mavibot и выберите PayTR.

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

Merchant ID (merchant_id) — ваш Mağaza No
Merchant Key (merchant_key) — ваш Mağaza Anahtarı
Merchant Salt (merchant_salt) — ваш Mağaza Şifresi

Сохраните настройки для завершения интеграции.

Создание платежной ссылки

Используйте функцию калькулятора:

get_paytr_payment_url(amount, description, currency, customer_email, product_name, expired, language)

Параметры

Параметр	Обязательный	Описание
`amount`	✅	Сумма платежа.
`description`	Нет	Описание платежа (товара или услуги). Отображается на платежной странице PayTR.
`currency`	Нет	Валюта платежа: `TL`, `USD`, `EUR`, `GBP` или `RUB`. По умолчанию: `TL`.
`customer_email`	Нет	Адрес электронной почты клиента.
`product_name`	Нет	Название товара, отображаемое на платежной странице.
`expired`	Нет	Время жизни платежной ссылки в секундах. Если не указано, ссылка действует бессрочно.
`language`	Нет	Язык платежной страницы: `tr` (турецкий) или `en` (английский). По умолчанию: `tr`.

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

Примечания

Код валюты TRY автоматически преобразуется в TL.
Если указана неподдерживаемая валюта, автоматически используется TL.
Название товара должно содержать от 4 до 200 символов.
- Названия короче 4 символов дополняются точками (.).
- Названия длиннее 200 символов автоматически обрезаются.

Пример

Шаг 1

Создайте сообщение с просьбой к клиенту ввести адрес электронной почты.

Шаг 2

Создайте следующий блок под сообщением и откройте настройки стрелки.

Настройте Соединение следующим образом:

Тип сопоставления: Регулярное выражение
Включите опцию Пользователь вводит данные.
Введите имя переменной: customer_email

Сохраните настройки Соединения.

Шаг 3

Введите параметры функции в калькуляторе.

Создание кнопки оплаты

Чтобы отправить кнопку оплаты в Mavibot:

Создайте блок с кнопкой.

Выберите тип Выставление счета.
Выберите PayTR в качестве платежного провайдера.
Укажите:
- Название товара
- Сумму платежа
- Валюту
При необходимости укажите переменную, содержащую адрес электронной почты клиента.

Callback-уведомления о платежах

После завершения платежа клиентом Mavibot получает callback-уведомление и публикует его в диалоге.

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

SDJ91MTKTT_success 100

Где:

SDJ91MTKTT — первые 10 символов вашего Merchant Key (merchant_key).
100 — сумма платежа.

Чтобы реагировать на успешные или неудачные платежи, скопируйте значение callback-уведомления и создайте блок Старт (или блок Триггер).

Введите текст callback-уведомления в триггер.

Затем создайте сообщение, информирующее клиента об успешности или неудаче платежа.

Из этого блока вы можете продолжить работу вашего чат-бота по мере необходимости.

Примечание: Конфигурация триггера, показанная в этом примере, будет реагировать на каждый успешный платеж, так как используется только префикс callback-уведомления без суммы платежа.
Если вы хотите реагировать только на покупку конкретного товара или определенную сумму платежа, введите полный текст callback-уведомления, включая сумму платежа, и измените Тип сопоставления на Точное совпадение.

Неудачный платеж

SDJ91MTKTT_fail 100

Примечание: Платежные ссылки PayTR являются одноразовыми. После успешного платежа ссылка автоматически деактивируется. Создавайте новую платежную ссылку для каждого нового платежа.

Переменные клиента после успешного платежа

Переменная	Описание
`paytr_callback_data`	Информация о платеже, полученная от PayTR.
`paytr_payment_completed`	`"True"`, если платеж был успешно обработан.
`paytr_merchant_oid`	Идентификатор транзакции PayTR (`merchant_oid`).