Webpay

Белорусская система электронных платежей

Как подключить

Для подключения платежной системы Webpay переходим в личный кабинет https://billing.webpay.by перейти к разделу меню "Настройки" → "Компания".

Здесь нужно взять два значения. Первое — это идентификатор мерчанта (Биллинг ID):

Рис. 1. Копируем Биллнг ID

Второе — нужно заполнить поле Секретный ключ (рис. ниже) — заполняем случайной последовательностью символов за исключением знака &

Рис. 2. Заполнение поля "Секретный ключ"

Секретный ключ должен быть не короче 10 символов, без символа &

Сохраняем настройки, копируем введенный секретный ключ и переходим к настройкам в Salebot. Открываем раздел "Эквайринг", выбираем Webpay:

Рис. 3. Раздел "Эквайринг" в Сейлбот

Нужно ввести полученные данные:

Рис. 4. Подключение платежного сервиса

Далее нажмите на "Сохранить настройки", тогда сервис будет подключен к вашему проекту.

Как сформировать ссылку на оплату

Для генерации ссылки на оплату вам необходимо установить значение переменной payment_sum (например, 150 или 100.55 (через точку!))

Рис. 5. Указываем переменную payment_sum в калкуляторе

Сразу после этого появится переменная webpay_pay_url.

Ссылка имеет вид: https://secure.webpay.by?wt=581991eb9e6a9cd9eb574c15f455c073=596e5245614568686246564952314a76616b4e425348684564585a51636b56695a6d46455443395455455135646b564c4f4764765a6c4e4f65575a7063445a724f5659345530773463545673566b356d616d51304e512c2c

Переменную #{webpay_pay_url} указывается через конструкцию #{} в поле url в настройках вложений, либо в настройках кнопки, либо в тексте сообщения:

  1. В настройках кнопки:

Рис. 6. Указываем переменную #{webpay_pay_url} в поле url кнопки
Рис. 7. Настройки блока

  1. В поле url в настройках вложения:

Рис. 8. Указываем переменную #{webpay_pay_url} в поле url вложения

  1. В поле "Сообщение":

Рис. 9. Указываем переменную #{webpay_pay_url} в поле "Сообщение"

Также до установки значения переменной payment_sum, можно задать следующие необязательные переменные, для настройки платежа:

Внимание! По умолчанию установлена валюта Белорусский рубль, если нужна другая валюта, нужно установить значение переменной currency

currency — валюта заказа. Допустимые значения: BYN, USD, EUR, RUB

store_name — название магазина, которое будет отображаться на форме оплаты. По умолчанию берется из настроек биллинг-аккаунта

product_name – наименование товара

language — язык страницы оплаты, по умолчанию русский. Допустимые значения: russian, english

session_timeout — продолжительность жизни заказа в секундах. По умолчанию 1200 секунд (20 минут).

Рис. 10. Информация о платеже

Создадим ссылку на оплату в размере 10 бел. рублей (по умолчанию бел. рубль)

Рис. 11. Настройки калькулятора

Обратите внимание: - Сначала указываете необязательные параметры product_name и т.д. - И последней присваиваем значение переменной payment_sum

Обратите внимание, вначале задаем дополнительные переменные для настроек, затем payment_sum. Переменные можно задать и ранее в цепочке, а не в одном блоке, это пример.

Далее в нужном месте выводим переменную webpay_pay_url, в которой содержится ссылка (см. рис. 6 — 9).

Как обработать результат

После успешной оплаты в бот придут колбэки, по которым вы сможете понять, что была успешная оплата. Эти колбеки в системе вы видите как сообщения от пользователя, чтобы их не мог отправить пользователь, они состоят из 10 первых символов секретного ключа и приписки _success, например: 895f1840b9_success

Если секретный ключ менее 10 символов, то он будет использован полностью + приписка _success.

Рис. 12. Колбек об успешном платеже

Эти колбэки НЕ ВИДИТ пользователь, они отображаются только оператору. Тип сравнения должен быть "Полное совпадение"

Также после успешной оплаты переменная webpay_payment_completed устанавливается в True.

Например, можно сделать обработку успешной оплаты блоком с условием и вывести соответствующее сообщение пользователю:

Пример 1:

Рис. 13. Указываем колбек в поле условие в блоке "Стартовое условие"

Пример 2:

Рис. 13. Указываем колбек в поле условие в блоке "Стартовое условие"

Если вы не хотите выбивать клиента из основной схемы чат-бота, воспользуйтесь блоком "Не состояние с условием" — в этот блок нельзя перейти, поэтому клиента после оплаты не выбьет из основной воронки и при этом он получит уведомление об успешной оплате.

А если вам нужно продолжить воронку с реакции на успешную оплату, то используйте блок "Стартовое условие", тогда клиент из блока оплаты перейдет в блок "Стартовое условие", с которого вы можете продолжить воронку.

Подробнее о блоках с условием рассказали в одноименной статье.

Для совершения повторного платежа обязательно необходимо обнулить payment_sum, ранее сформированную ссылку и уже после переназначить переменную payment_sum для получения свежей ссылки. Можно указать предыдущее значение.

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

Как тестировать

Для проведения тестовых платежей установите переменной test_payments значение 1

PreviousStripeNextWayforpay

Last updated

Was this helpful?