ЮMoney

В статье расскажем, как быстро подключиться к сервису для приема платежей

Если вам необходимо быстро подключить прием платежей как физическое лицо, то выбор очевиден — Ю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 для уведомлений

На сервисе Юмани для подключения к Сейлботу понадобится скопировать:

1. Секретный ключ:

Чтобы скопировать секретный ключ, нажмите "Показать секрет":

Рис. 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. Платежная форма

Обращаем внимание!

1. Ссылка на оплату живет ограниченное количество времени (несколько часов).

2. Ссылка генерируется после назначения переменной payment_sum, поэтому устанавливайте переменную перед отправкой ссылки. Также продумайте возможность повторной генерации ссылки.

3. Для совершения повторного платежа обязательно необходимо обнулить 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. Итоговая схема

1. Выберите тип блока "Стартовое условие" и пропишите ключевые слова, на которые будет реагировать бот:

Рис. 20. Настройка блока "Стартовое условие"

Так бот будет реагировать на приветственное сообщение от пользователя:

Рис. 21. Отработка ботом в режиме тестирования

1. Далее в этом же блоке создадим две кнопки "Базовый" и "Премиум", чтобы клиент переходил по стрелкам:

Рис. 22. Кнопки в настройках блока

1. Создаем два блока ниже. В настройках стрелки указываем в условие текст из кнопок:

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

Теперь схема выглядит следующим образом:

Рис. 24. Промежуточный вид схемы

Теперь в зависимости от того, на какую кнопку нажмет клиент "Премиум" или "Базовый", он перейдет в один из блоков состояние.

1. В настройках блока, стрелка к которому ведет по клику на кнопку "Премиум", укажем payment_sum = 300, а во втором блоке payment_sum = 150.

Рис. 25. Настройки блока, в который ведет стрелка с условием "Премиум"

Аналогичные настройки у второго блока "Состояние":

Рис. 26. Настройки блока, в который ведет стрелка с условием "Базовый"

1. Сформируем ссылку на оплату.

Создадим блок ниже, в котором будет лежать ссылка на оплату. К этому блоку проведем стрелки из двух предыдущих блоков, в которых лежит переменная payment_sum:

Рис. 27. Настройки блока с кнопкой, в которой лежит ссылка на оплату

Добавим кнопку с ссылкой на оплату:

Рис. 28. Настройки кнопки

Обратите внимание, что в поле url #{yandex_money_pay_url} — это ссылка на оплату.

Далее протягиваем стрелки из двух блоков к блоку с ссылкой на оплату:

Рис. 29. Настройки стрелки с таймером

В настройках стрелки указываем задержку "0 секунд".

Теперь наша схема выглядит следующим образом:

Рис. 30. Итоговая схема

Как работает схема:

1. Клиент пишет боту;

2. Бот отвечает клиенту и направляет кнопки для выбора тарифа.

3. Клиент выбирает тариф и бот формирует ссылку на оплату.

4. Ссылка на оплату формируется с суммой, которая указана в payment_sum. В зависимости от выбора тарифа сумма будет разная.

Тестирование схемы:

Сначала выберем базовый тариф:

Рис. 31. Тестирование схемы: выбираем тариф "Базовый"

При клике на кнопку оплаты клиент перейдет в форму оплаты Юмани с суммой в 150 рублей:

Рис. 32. Форма оплаты

Теперь выберем тариф "Премиум":

Рис. 33. Тестирование бота: выбираем тариф "Премиум"

Теперь перейдем по ссылке:

Рис. 34. Форма оплаты

Бот снова отработал верно, при этом мы даже не обнуляли данные клиента при тестировании.

Ссылка на оплату, когда клиент сам выбирает сумму

Теперь давайте сделаем чат-бота для благотворительности: в данном случае клиент сам будет выбирать, какую сумму отправлять вам на благотворительность.

1. Создаем блок "Стартовое условие" и прописываем основные настройки:

Рис. 35. Настройки блока "Стартовое условие"

1. Создаем блок ниже и в настройках стрелки указываем в поле "Условие" текст кнопки:

Рис. 36. Настройки стрелки

Кнопка в блоке "Стартовое условие" простая: функция "По умолчанию" без ссылки.

1. Далее во втором блоке спрашиваем у клиента, какую сумму он готов пожертвовать:

Рис. 37. Настройки блока "Состояние".

1. Создаем третий блок ниже и в настройках стрелки активируем чекбокс "Пользователь вводит данные" и указываем переменную payment_sum:

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

1. В третьем блоке создаем кнопку и прописываем любое сообщение:

Рис. 39. Настройки кнопки, в которой лежит ссылка на оплату

В поле url в настройках кнопки указываем #{yandex_money_pay_url} — это ссылка на оплату.

Рис. 40. Настройки третьего блока "Состояние", который будет отправлять клиенту кнопку с ссылкой на оплату

Как работает схема?

1. Пользователь пишет боту.

2. Бот отправляет пользователю блок с кнопкой и сообщением.

3. Если пользователь нажимает на кнопку "Я хочу пожертвовать приюту", то переходит в следующий блок. Если не нажимает, то остается в блоке "Стартовое условие".

4. Далее Бот спрашивает у пользователя, какую сумму пользователь хочет пожертвовать.

5. Пользователь пишет сумму цифрами, сумма записывается в переменную payment_sum.

6. Далее бот отправляет кнопку с ссылкой на оплату на сумму, которую написал клиент.

Тестирование схемы

В режиме тестирования бот отработался верно.

Рис. 41. Тестирование схемы чат-бота

При клике на кнопку с ссылкой на оплату, открывается форма оплаты с введенной суммой в боте:

Рис. 42. Форма оплаты

Готово!

Теперь вы знаете, как собрать чат-бот для благотворительности!

Видео-инструкция