В статье расскажем, как быстро подключиться к сервису для приема платежей
Если вам необходимо быстро подключить прием платежей как физическое лицо, то выбор очевиден — ЮMoney
Вам не потребуется ни регистрация магазина, ни его проверка. Настройка занимает 10 минут.
Как настроить ЮMoney
Перейдите по ссылке, войдите в личный кабинет или зарегистрируйтесь. Вы перейдете на страницу с http-уведомлениями:
Рис. 1. Страница http-уведомлений
Здесь необходимо указать url в поле "Куда отправлять" и поставить галочку в поле "Отправлять HTTP-уведомления":
URL для уведомлений о платежах: https://chatter.salebot.pro/yandex_money_callback/result
Рис. 2. Страница уведомлений с заполненными полями
Важно!
Не забудьте установить галочку "Отправлять HTTP-уведомления"
Далее нажмите "Готово", тогда вы увидите pop-up с информацией, что уведомления будут приходить по указанному вами url Сейлбота:
Рис. 3. pop-up с url для уведомлений
На сервисе Юмани для подключения к Сейлботу понадобится скопировать:
Секретный ключ:
Чтобы скопировать секретный ключ, нажмите "Показать секрет":
Рис. 4. Копируем секретный ключ
Рис. 5. Копируем секретный ключ
Сохраните ключ поблизости (или не закрывайте вкладку с http-уведомлениями) — он понадобится нам в дальнейшем.
Шаг 2. Перейдите на главную страницу и скопируйте номер кошелька:
Рис. 6. Копируем номер кошелька
Готово! Теперь перейдем к подключению в Salebot.
Как подключить Юmoney к Salebot
Для подключения ЮMoney необходимо перейти в раздел "Эквайринг":
Рис. 7. Раздел "Эквайринг" в Сейлботе для подключения сервисов приема платежей
Далее необходимо просто указать данные, о которых говорили выше в форму.
Рис. 8. Заполняем поля номер кошелька и секретный ключ, которые ранее скопировали
на стороне Юмани
И нажмите "Сохранить настройки".
На этом подключение закончено. Теперь давайте разберемся как использовать данный функционал.
Указание суммы
Для генерации ссылки на оплату вам необходимо установить значение переменной payment_sum, сразу после этого появится переменная yandex_money_pay_url. Эту переменную можно вывести на экран ссылкой или разместить на кнопке с текстом "Оплатить".
Ссылка на оплату будет сгенерирована автоматически, вам необходимо вставить
#{yandex_money_pay_url} в поле URL вложения либо в кнопку. Как это сделать:
Шаг 1. В калькуляторе прописываем payment_sum:
Рис. 9. Указываем переменную payment_sum в калькуляторе в блоке
Минимальная сумма платежа — 10 рублей.
Далее протяните стрелку ко второму блоку, в которой будет лежать ссылка в виде #{yandex_money_pay_url}.
Шаг 2. В следующем блоке вставляем конструкцию #{yandex_money_pay_url}:
а) во вложение в виде ссылки:
Рис. 10. Пример № 1, указываем #{yandex_money_pay_url} в поле url для отправки вложения в виде ссылки
б) в кнопке в виде ссылки — для этого нужно создать кнопку во втором блоке:
Рис. 11. Пример " 2, указываем #{yandex_money_pay_url} в поле url настроек кнопки
Укажите конструкцию #{yandex_money_pay_url} в настройках кнопки в поле url
Шаг 3. Тестируем
а) Тестирование бота с ссылкой на оплату во вложении:
Рис. 12. Бот направляет ссылку в сообщении
При переходе по ссылке клиент попадает в платежную форму Юмани:
Рис. 13. Платежная форма
б) Тестирование бота с ссылкой на оплату в кнопке:
Бот отрабатывается верно и направляет клиенту кнопку с ссылкой на оплату.
Рис. 14. Отработка ботом схемы с кнопкой
При клике на кнопку клиент переходит в форму оплаты:
Рис. 15. Платежная форма
Обращаем внимание!
Ссылка на оплату живет ограниченное количество времени (несколько часов).
Ссылка генерируется после назначения переменной payment_sum, поэтому устанавливайте переменную перед отправкой ссылки. Также продумайте возможность повторной генерации ссылки.
Для совершения повторного платежа обязательно необходимо обнулить payment_sum, ранее сформированную ссылку и уже после переназначить переменную payment_sum для получения свежей ссылки.
Чтобы обнулить переменную payment_sum, в калькуляторе в следующем блоке присвойте ей значение, равное 0, а на следующей строке калькулятора указанть yandex_money_pay_url=""
Уведомление о результате оплаты
После успешной оплаты в бот придет колбек, по которому вы сможете понять, что оплата прошла. Этот колбек в системе вы видите как сообщения от пользователя, но пользователю он не отображается.
Рис. 16. Пример колбека
Колбек состоит из секрета и приписки со статусом, например: qxgZ7zkNX4HHnG8UpZ61_success. Также после успешной оплаты переменная yandex_money_payment_completed устанавливается в True.
Эти колбеки НЕ ВИДИТ пользователь, они отображаются только оператору.
Тип сравнения должен быть "Полное совпадение"
Для совершения повторного платежа обязательно необходимо обнулить payment_sum, ранее сформированную ссылку и уже после переназначить переменную payment_sum для получения свежей ссылки:
Пример обнуления переменных:
payment_sum=0
yandex_money_pay_url=""
После завершения оплаты клиенту добавится переменная yoomoney_callback_data, содержащая данные ответа платежной системы по совершенной операции. Из полученного словаря можно извлечь необходимые данные при помощи метода get.
Чтобы отреагировать на колбек, необходимо создать блок с условием. Это может быть блок "Стартовое условие" или "Не состояние с условием":
Рис. 17. Пример настройки реакции в блоке "Стартовое условие"
Рис. 18. Пример настройки реакции в блоке "Не состояние с условием"
Пример
Ссылка на оплату для разных тарифов
Пример схемы, которая позволит протестировать Чат-бота и быстро начать работу с ЮMoney:
Рис. 19. Итоговая схема
Выберите тип блока "Стартовое условие" и пропишите ключевые слова, на которые будет реагировать бот:
Рис. 20. Настройка блока "Стартовое условие"
Так бот будет реагировать на приветственное сообщение от пользователя:
Рис. 21. Отработка ботом в режиме тестирования
Далее в этом же блоке создадим две кнопки "Базовый" и "Премиум", чтобы клиент переходил по стрелкам:
Рис. 22. Кнопки в настройках блока
Создаем два блока ниже. В настройках стрелки указываем в условие текст из кнопок:
Рис. 23. Указываем в условии стрелки названия кнопок
Теперь схема выглядит следующим образом:
Рис. 24. Промежуточный вид схемы
Теперь в зависимости от того, на какую кнопку нажмет клиент "Премиум" или "Базовый", он перейдет в один из блоков состояние.
В настройках блока, стрелка к которому ведет по клику на кнопку "Премиум", укажем payment_sum = 300, а во втором блоке payment_sum = 150.
Рис. 25. Настройки блока, в который ведет стрелка с условием "Премиум"
Аналогичные настройки у второго блока "Состояние":
Рис. 26. Настройки блока, в который ведет стрелка с условием "Базовый"
Сформируем ссылку на оплату.
Создадим блок ниже, в котором будет лежать ссылка на оплату. К этому блоку проведем стрелки из двух предыдущих блоков, в которых лежит переменная payment_sum:
Рис. 27. Настройки блока с кнопкой, в которой лежит ссылка на оплату
Добавим кнопку с ссылкой на оплату:
Рис. 28. Настройки кнопки
Обратите внимание, что в поле url #{yandex_money_pay_url} — это ссылка на оплату.
Далее протягиваем стрелки из двух блоков к блоку с ссылкой на оплату:
Рис. 29. Настройки стрелки с таймером
В настройках стрелки указываем задержку "0 секунд".
Теперь наша схема выглядит следующим образом:
Рис. 30. Итоговая схема
Как работает схема:
Клиент пишет боту;
Бот отвечает клиенту и направляет кнопки для выбора тарифа.
Клиент выбирает тариф и бот формирует ссылку на оплату.
Ссылка на оплату формируется с суммой, которая указана в payment_sum. В зависимости от выбора тарифа сумма будет разная.
Бот снова отработал верно, при этом мы даже не обнуляли данные клиента при тестировании.
Ссылка на оплату, когда клиент сам выбирает сумму
Теперь давайте сделаем чат-бота для благотворительности: в данном случае клиент сам будет выбирать, какую сумму отправлять вам на благотворительность.
Создаем блок "Стартовое условие" и прописываем основные настройки:
Рис. 35. Настройки блока "Стартовое условие"
Создаем блок ниже и в настройках стрелки указываем в поле "Условие" текст кнопки:
Рис. 36. Настройки стрелки
Кнопка в блоке "Стартовое условие" простая: функция "По умолчанию" без ссылки.
Далее во втором блоке спрашиваем у клиента, какую сумму он готов пожертвовать:
Рис. 37. Настройки блока "Состояние".
Создаем третий блок ниже и в настройках стрелки активируем чекбокс "Пользователь вводит данные" и указываем переменную payment_sum:
Рис. 38. Указываем переменную payment_sum в настройках стрелки
В третьем блоке создаем кнопку и прописываем любое сообщение:
Рис. 39. Настройки кнопки, в которой лежит ссылка на оплату
В поле url в настройках кнопки указываем #{yandex_money_pay_url} — это ссылка на оплату.
Рис. 40. Настройки третьего блока "Состояние", который будет отправлять клиенту кнопку с ссылкой на оплату
Как работает схема?
Пользователь пишет боту.
Бот отправляет пользователю блок с кнопкой и сообщением.
Если пользователь нажимает на кнопку "Я хочу пожертвовать приюту", то переходит в следующий блок. Если не нажимает, то остается в блоке "Стартовое условие".
Далее Бот спрашивает у пользователя, какую сумму пользователь хочет пожертвовать.
Пользователь пишет сумму цифрами, сумма записывается в переменную payment_sum.
Далее бот отправляет кнопку с ссылкой на оплату на сумму, которую написал клиент.
Тестирование схемы
В режиме тестирования бот отработался верно.
Рис. 41. Тестирование схемы чат-бота
При клике на кнопку с ссылкой на оплату, открывается форма оплаты с введенной суммой в боте:
Рис. 42. Форма оплаты
Готово!
Теперь вы знаете, как собрать чат-бот для благотворительности!
