> For the complete documentation index, see [llms.txt](https://docs.salebot.pro/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.salebot.pro/integration/payments/priem-platezhei-cherez-yandeks.dengi.md). # ЮMoney Если вам необходимо быстро подключить прием платежей как физическое лицо, то выбор очевиден — ЮMoney Вам не потребуется ни регистрация магазина, ни его проверка. Настройка занимает 10 минут. ## Как настроить ЮMoney [Перейдите по ссылке](https://yoomoney.ru/transfer/myservices/http-notification), войдите в личный кабинет или зарегистрируйтесь. Вы перейдете на страницу с http-уведомлениями:

Рис. 1. Страница http-уведомлений

Здесь необходимо указать url в поле "Куда отправлять" и поставить галочку в поле "Отправлять HTTP-уведомления": **URL для уведомлений о платежах: **

Рис. 2. Страница уведомлений с заполненными полями

{% hint style="danger" %} Важно! Не забудьте установить галочку "**Отправлять HTTP-уведомления**" {% endhint %} Далее нажмите "Готово", тогда вы увидите pop-up с информацией, что уведомления будут приходить по указанному вами url Сейлбота:

Рис. 3. pop-up с url для уведомлений

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

Рис. 4. Копируем секретный ключ

Рис. 5. Копируем секретный ключ

Сохраните ключ поблизости (или не закрывайте вкладку с http-уведомлениями) — он понадобится нам в дальнейшем. Шаг 2. Перейдите на главную страницу и скопируйте номер кошелька:

Рис. 6. Копируем номер кошелька

{% hint style="success" %} Готово! Теперь перейдем к подключению в Salebot. {% endhint %} ## Как подключить Юmoney к Salebot Для подключения ЮMoney необходимо перейти в раздел "Эквайринг":

Рис. 7. Раздел "Эквайринг" в Сейлботе для подключения сервисов приема платежей

Далее необходимо просто указать данные, о которых говорили выше в форму.

Рис. 8. Заполняем поля номер кошелька и секретный ключ, которые ранее скопировали
на стороне Юмани

И нажмите "Сохранить настройки". На этом подключение закончено. Теперь давайте разберемся как использовать данный функционал. ### **Указание суммы** Для генерации ссылки на оплату вам необходимо установить значение переменной **payment\_sum,** сразу после этого появится переменная **yandex\_money\_pay\_url.** Эту переменную можно вывести на экран ссылкой или разместить на кнопке с текстом "Оплатить". Ссылка на оплату будет сгенерирована автоматически, вам необходимо вставить **#{yandex\_money\_pay\_url}** в **поле URL вложения либо в кнопку. Как это сделать:** Шаг 1. В калькуляторе прописываем payment\_sum:

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

{% hint style="success" %} Минимальная сумма платежа — 10 рублей. {% endhint %} Далее протяните стрелку ко второму блоку, в которой будет лежать ссылка в виде **#{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. Платежная форма

{% hint style="danger" %} Обращаем внимание! 1. Ссылка на оплату живет ограниченное количество времени (несколько часов). 2. Ссылка генерируется после назначения переменной **payment\_sum**, поэтому устанавливайте переменную перед отправкой ссылки. Также продумайте возможность повторной генерации ссылки. 3. Для совершения повторного платежа обязательно необходимо обнулить payment\_sum, ранее сформированную ссылку и уже после переназначить переменную payment\_sum для получения свежей ссылки. Чтобы обнулить переменную payment\_sum, в калькуляторе в следующем блоке присвойте ей значение, равное 0, а на следующей строке калькулятора указанть yandex\_money\_pay\_url="" {% endhint %} ## Уведомление о результате оплаты После успешной оплаты в бот придет колбек, по которому вы сможете понять, что оплата прошла. Этот колбек в системе вы видите как сообщения от пользователя, ***но пользователю он не отображается*****.**

Рис. 16. Пример колбека

Колбек состоит из секрета и приписки со статусом, например: **qxgZ7zkNX4HHnG8UpZ61\_success**. Также после успешной оплаты переменная **yandex\_money\_payment\_completed** устанавливается в **True.** {% hint style="success" %} Эти колбеки НЕ ВИДИТ пользователь, они отображаются только оператору. {% endhint %} {% hint style="danger" %} Тип сравнения должен быть "**Полное совпадение**" {% endhint %} {% hint style="warning" %} Для совершения повторного платежа обязательно необходимо обнулить payment\_sum, ранее сформированную ссылку и уже после переназначить переменную payment\_sum для получения свежей ссылки:\ \ Пример обнуления переменных:\ payment\_sum=0\ yandex\_money\_pay\_url="" {% endhint %} После завершения оплаты клиенту добавится переменная **yoomoney\_callback\_data**, содержащая данные ответа платежной системы по совершенной операции. Из полученного словаря можно извлечь необходимые данные при помощи метода **get**. Чтобы отреагировать на колбек, необходимо создать блок с условием. Это может быть блок "Стартовое условие" или "Не состояние с условием":

Рис. 17. Пример настройки реакции в блоке "Стартовое условие"

Рис. 18. Пример настройки реакции в блоке "Не состояние с условием"

## **Пример** ### **Ссылка на оплату для разных тарифов** Пример схемы, которая позволит протестировать Чат-бота и быстро начать работу с ЮMoney:

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

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

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

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

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

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

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

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

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

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

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

Теперь в зависимости от того, на какую кнопку нажмет клиент "Премиум" или "Базовый", он перейдет в один из блоков состояние. 3. В настройках блока, стрелка к которому ведет по клику на кнопку "Премиум", укажем payment\_sum = 300, а во втором блоке payment\_sum = 150.

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

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

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

3. Сформируем ссылку на оплату. Создадим блок ниже, в котором будет лежать ссылка на оплату. К этому блоку проведем стрелки из двух предыдущих блоков, в которых лежит переменная 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. Настройки блока "Стартовое условие"

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

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

{% hint style="success" %} Кнопка в блоке "Стартовое условие" простая: функция "По умолчанию" без ссылки. {% endhint %} 3. Далее во втором блоке спрашиваем у клиента, какую сумму он готов пожертвовать:

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

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

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

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

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

В поле url в настройках кнопки указываем **#{yandex\_money\_pay\_url} — это ссылка на оплату.**

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

Как работает схема? 1. Пользователь пишет боту. 2. Бот отправляет пользователю блок с кнопкой и сообщением. 3. Если пользователь нажимает на кнопку "Я хочу пожертвовать приюту", то переходит в следующий блок. Если не нажимает, то остается в блоке "Стартовое условие". 4. Далее Бот спрашивает у пользователя, какую сумму пользователь хочет пожертвовать. 5. Пользователь пишет сумму цифрами, сумма записывается в переменную payment\_sum. 6. Далее бот отправляет кнопку с ссылкой на оплату на сумму, которую написал клиент. Тестирование схемы В режиме тестирования бот отработался верно.

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

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

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

{% hint style="success" %} Готово! Теперь вы знаете, как собрать чат-бот для благотворительности! {% endhint %} ### Видео-инструкция {% embed url="" %}