Підключення Telr
Щоб використовувати платіжну систему Telr у MaviBot, потрібно отримати облікові дані магазину з вашого акаунта Telr та ввести їх у налаштуваннях платіжної системи.
Отримання облікових даних магазину
Укладіть угоду з Telr та отримайте доступ до вашого мерчант-акаунта.
У розділі Stores → Store details скопіюйте такі значення:
| Поле Telr | Поле MaviBot |
|---|---|
| Store ID | Store ID |
| Authentication key | Authentication Key |
Налаштування сповіщень про оплату
Відкрийте Payment Page (або Security) → Transaction advice та вкажіть наступну URL-адресу сповіщення:
https://chatter.mavibot.ai/telr_callback/result
Виберіть типи транзакцій, для яких потрібно отримувати сповіщення.
У цьому ж розділі скопіюйте Secret key. Цей ключ використовується для перевірки підписів сповіщень.
Важливо! Налаштування Transaction advice є обов'язковим. Без нього MaviBot не отримуватиме сповіщення про оплату, і колбек не буде надіслано боту.
Підключення Telr у MaviBot
Відкрийте Платіжні системи в налаштуваннях вашого проєкту, виберіть Telr та заповніть наступні поля:
| Поле | Опис |
|---|---|
| Store ID | Числовий ідентифікатор вашого магазину Telr. |
| Authentication Key | Використовується для генерації платіжних посилань. |
| Secret Key | Використовується для перевірки підписів сповіщень про оплату. Без нього сповіщення про оплату будуть відхилені. |
| Тестовий режим | Увімкнення тестових платежів за допомогою тестових карток Telr без списання реальних коштів. Вимкніть цю опцію, щоб приймати реальні платежі. |
Після заповнення всіх полів інтеграція готова до використання.
Генерація платіжного посилання
Використовуйте наступну функцію Calculator:
get_telr_payment_url(amount, description, currency, product_name)
Параметри
| Параметр | Опис |
|---|---|
amount |
Сума платежу. Обов'язково. |
description |
Опис платежу. Необов'язково. Максимальна довжина: 63 символи. |
currency |
Трилітерний код валюти (AED, SAR, USD, EUR, GBP та інші валюти, доступні для вашого акаунта Telr). Необов'язково. За замовчуванням: AED. |
product_name |
Назва товару. Необов'язково. |
Функція повертає URL-адресу платежу.
Важливо! Платіжні посилання залишаються дійсними протягом обмеженого часу. Надішліть посилання клієнту одразу після його генерації.
Приклад
Кнопка платіжного посилання
Щоб надіслати кнопку оплати:
- Створіть кнопку з функцією Pay.
- Виберіть Telr як платіжну систему.
- Вкажіть:
- Назву товару
- Суму платежу
- Валюту
Колбеки платежів
Після завершення оплати клієнтом MaviBot автоматично отримує колбек.
Успішний платіж
Приклад:
SDJ91MTKTT_success 100
Де:
-
SDJ91MTKTT— перші 10 символів вашого Authentication Key. -
100— сума платежу.
Невдалий або скасований платіж
Приклад:
SDJ91MTKTT_fail 100
Платіж на банківській перевірці
Якщо платіж авторизовано, але поставлено на утримання банком для додаткової перевірки, колбек не надсилається до завершення перевірки.
Після того, як банк схвалить або відхилить транзакцію, Telr надсилає сповіщення, і колбек доставляється до MaviBot автоматично.
Змінні клієнта після успішного платежу
| Змінна | Опис |
|---|---|
telr_callback_data |
Інформація про платіж, отримана від платіжної системи Telr. |
telr_payment_completed |
"True", якщо платіж успішно оброблено. |
telr_tran_ref |
Посилання на транзакцію Telr (tran_ref). |