Webpay
Белорусская система электронных платежей
Как подключить
Для подключения платежной системы Webpay переходим в личный кабинет https://billing.webpay.by перейти к разделу меню "Настройки" → "Компания".
Здесь нужно взять два значения. Первое — это идентификатор мерчанта (Биллинг ID):
Второе — нужно заполнить поле Секретный ключ (рис. ниже) — заполняем случайной последовательностью символов за исключением знака &
Секретный ключ должен быть не короче 10 символов, без символа &
Сохраняем настройки, копируем введенный секретный ключ и переходим к настройкам в Salebot. Открываем раздел платежные системы, выбираем Webpay. Нужно ввести полученные данные.
Для генерации ссылки на оплату вам необходимо установить значение переменной payment_sum (например, 150 или 100.55 (через точку!))
Сразу после этого появится переменная webpay_pay_url. Эту переменную можно вывести на экран ссылкой или разместить на кнопке с текстом "Оплатить".
Также до установки значения переменной payment_sum, можно задать следующие необязательные переменные, для настройки платежа:
Внимание! По умолчанию установлена валюта Белорусский рубль, если нужна другая валюта, нужно установить значение переменной currency
currency — валюта заказа. Допустимые значения: BYN, USD, EUR, RUB
store_name — название магазина, которое будет отображаться на форме оплаты. По умолчанию берется из настроек биллинг-аккаунта
product_name – наименование товара
language — язык страницы оплаты, по умолчанию русский. Допустимые значения: russian, english
session_timeout — продолжительность жизни заказа в секундах. По умолчанию 1200 секунд (20 минут).
Как сформировать ссылку на оплату
Создадим ссылку на оплату в размере 10 бел. рублей (по умолчанию бел. рубль)
Обратите внимание: - Сначала указываете необязательные параметры product_name и т.д. - И последней присваиваем значение переменной payment_sum
Обратите внимание, вначале задаем дополнительные переменные для настроек, затем payment_sum. Переменные можно задать и ранее в цепочке, а не в одном блоке, это пример.
Далее в нужном месте выводим переменную webpay_pay_url, в которой содержится ссылка
Как обработать результат
После успешной оплаты в бот придут колбэки, по которым вы сможете понять, что была успешная оплата. Эти колбеки в системе вы видите как сообщения от пользователя, чтобы их не мог отправить пользователь, они состоят из 10 первых символов секретного ключа и приписки _success, например: 895f1840b9_success
Если секретный ключ менее 10 символов, то он будет использован полностью + приписка _success.
Эти колбэки НЕ ВИДИТ пользователь, они отображаются только оператору. Тип сравнения должен быть "Полное совпадение"
Также после успешной оплаты переменная webpay_payment_completed устанавливается в True.
Например, можно сделать обработку успешной оплаты блоком с условием и вывести соответствующее сообщение пользователю:
Для совершения повторного платежа обязательно необходимо обнулить payment_sum, ранее сформированную ссылку и уже после переназначить переменную payment_sum для получения свежей ссылки. Можно указать предыдущее значение.
После завершения оплаты клиенту добавится переменная webpay_callback_data, содержащая данные ответа платежной системы по совершенной операции. Из полученного словаря можно извлечь необходимые данные при помощи метода get.
Как тестировать
Для проведения тестовых платежей установите переменной test_payments значение 1
Last updated
