Подключение 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 без списания реальных средств. Отключите эту опцию для приема реальных платежей. |
После заполнения всех полей интеграция готова к использованию.
Генерация платежной ссылки
Используйте следующую функцию Калькулятора:
get_telr_payment_url(amount, description, currency, product_name)
Параметры
| Параметр | Описание |
|---|---|
amount |
Сумма платежа. Обязательно. |
description |
Описание платежа. Необязательно. Максимальная длина: 63 символа. |
currency |
Трехбуквенный код валюты (AED, SAR, USD, EUR, GBP и другие валюты, доступные для вашего аккаунта Telr). Необязательно. По умолчанию: AED. |
product_name |
Название товара. Необязательно. |
Функция возвращает URL-адрес платежа.
Важно! Платежные ссылки действительны в течение ограниченного времени. Отправьте ссылку клиенту сразу после ее генерации.
Пример
Кнопка платежной ссылки
Чтобы отправить кнопку оплаты:
- Создайте кнопку с функцией Оплатить.
- Выберите 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). |