Інтеграція 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 автоматично надсилає URL-адресу зворотного виклику з кожним запитом на створення платіжного посилання.

Підключення PayTR

Відкрийте налаштування Acquiring у 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

Створіть наступний блок під повідомленням та відкрийте налаштування стрілки.

Налаштуйте з'єднання наступним чином:

Тип збігу: Регулярний вираз
Увімкніть опцію User enter data.
Введіть назву змінної: customer_email

Збережіть налаштування з'єднання.

Крок 3

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

Створення платіжної кнопки

Щоб надіслати платіжну кнопку в Mavibot:

Створіть блок з кнопкою.

Виберіть тип Billing.
Виберіть PayTR як платіжного провайдера.
Вкажіть:
- Назву товару
- Суму платежу
- Валюту
За бажанням вкажіть змінну, що містить адресу електронної пошти клієнта.

Зворотні виклики платежів

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

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

SDJ91MTKTT_success 100

Де:

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

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

Введіть текст зворотного виклику в тригері.

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

З цього блоку ви можете продовжити роботу вашого чат-бота за потреби.

Примітка: Налаштування тригера, показане в цьому прикладі, реагуватиме на кожен успішний платіж, оскільки використовує лише префікс зворотного виклику без суми платежу.
Якщо ви хочете реагувати лише на покупку конкретного товару або суму платежу, введіть повний текст зворотного виклику, включаючи суму платежу, та змініть Тип збігу на Точний збіг.

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

SDJ91MTKTT_fail 100

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

Змінні клієнта після успішного платежу

Змінна	Опис
`paytr_callback_data`	Інформація про платіж, отримана від PayTR.
`paytr_payment_completed`	`"True"`, якщо платіж було успішно оброблено.
`paytr_merchant_oid`	Ідентифікатор транзакції PayTR (`merchant_oid`).