Настройка процессинга ЮKassa для Telegram-бота

Quick Resto реализовала интеграцию с процессинговым сервисом ЮKassa. Данный сервис помогает работать с онлайн-платежами в мини-приложении Telegram-бота.

С подключением процессинга ЮKassa гостям заведения будет доступно несколько удобных способов оплаты:

• Банковская карта.
• SberPay.
• Кошелек ЮМоney.
• Mir Pay (для устройств на базе Android).

Подключение интеграции с процессингом ЮKassa

Настройка интеграции вашего облака с сервисом ЮKassa состоит из следующих этапов:

1. Регистрация в системе ЮKassa. Для регистрации необходимо обратиться в отдел продаж, службу технической поддержки или абонентский отдел Quick Resto. Написав на электронную почту wl_app@quickresto.ru или позвонив по номеру телефона 8-800-550-98-87.

Сотрудник Quick Resto отправит ссылку. Именно по этой ссылке пройдите регистрацию в системе ЮKassa, иначе интеграция не будет работать. Затем заполните необходимые данные (номер телефона, имя, электронную почту, форму бизнеса, номер ИНН, пароль).

Также вы можете осуществить регистрацию по Сбер ID.

2. Заполнение сведений для заключения договора. После регистрации вам станет доступен личный кабинет (ЛК) партнёра, в котором заполните следующие данные о вашей организации:

• реквизиты счёта организации.
• сведения о государственной регистрации.
• фотография или отсканированный паспорт руководителя.
• паспортные данные других владельцев.

Также в разделе Данные для договора — Чеки необходимо указать способ фискализации данных. Quick Resto предлагает стандартный метод фискализации без облачной фискализации. Использование облачной фискализации может увеличить процент комиссии для клиента. Поэтому для обеспечения корректной работы важно выбрать правильный вариант, расположенный на правой стороне страницы.

После того как заполните данные в личном кабинете, сообщите об этом сотруднику Quick Resto. Он оповестит сервис ЮKassa, и начнется банковская проверка.

3. Подписание договора. После проверки предоставленных сведений в личном кабинете партнёра появится договор. Данный договор распечатайте, подпишите и прикрепите фотографию в ЛК ЮKassa.

ЮKassa создаст виртуальные устройства, которые можно будет подключить для работы интернет-эквайринга в мини-приложении.

4. Предоставление сотруднику Quick Resto доступ к личному кабинету. После подписания договора, необходимо предоставить доступ в личный кабинет ЮKassa сотруднику Quick Resto для дальнейшей технического поддержки и помощи в настройке.

Способ 1. В разделе Интеграция — Готовые решения — В поле Пригласите разработчика нажмите на кнопку Выдать доступ. Откроется новая вкладка, где необходимо ввести электронную почту wl_app@quickresto.ru и нажать на кнопку Подтвердить.

Способ 2. В разделе Пользователи нажмите на кнопку Пригласить. Вставьте роль Разработчик и укажите почту wl_app@quickresto.ru.

5. Настройка callback-уведомлений. В личном кабинете ЮKassa — В разделе Интеграция — HTTP-уведомления — В поле URL для уведомлений вставьте ссылку, подставив в нее первоначальное имя вашего облака в системе Quick Resto:

https://<название_облака>.quickresto.ru/wlcrm/payment/yookassastatus

Например: https://pir2021.quickresto.ru/wlcrm/payment/yookassastatus

Заполнив необходимое поле, нажмите Сохранить.

Настройка процессинга ЮKassa в бэк-офисе

Для того чтобы в мини-приложении Telegram-бота принимать онлайн-оплату, необходимо настроить процессинг ЮKassa.

После подключения интеграции, в бэк-офисе перейдите в раздел Устройства — Процессинг — Нажмите Создать на верхней панели инструментов и в выпадающем меню выберите Процессинг ЮКасса.

Откроется окно создания процессинга ЮKassa. Заполните в нём следующие поля:

• Наименование — название процессинга.
• Организация, к которой привязан фискальный регистратор.
• Активность — если флаг активен, то оплата будет возможна в мини-приложении через процессинг ЮKassa.
• Идентификатор магазина, полученный при подключении процессинга в ЮKassa (находится в личном кабинете в поле shopId).
• Секретный ключ, полученный при подключении процессинга в ЮKassa (находится в личном кабинете ЮKassa в разделе Интеграции — Ключ API — в поле Секретный ключ). В случае, если секретный ключ не был сохранен в бэк-офисе, то в личном кабинете партнера нажмите на кнопку Перевыпустить ключ (две круговые стрелки в круге справа от поля).

Заполнив необходимые поля, нажмите Создать.

После этого перейдите в раздел Приложение и сайт — Заведение — Выберите заведение — Перейдите на вкладку Основное — Активируйте флаг В заведении доступен предзаказ, чтобы появилось поле выбора процессинга — В поле Процессинг для оплаты картой установите созданный Процессинг ЮКасса.

Автосохранение ранее использованных карт

Функция автосохранения позволяет легко и быстро возвращаться к ранее использованным картам. Этот инструмент особенно полезен для тех, кто часто делает заказы и регулярно использует банковские карты. Автосохранение обеспечивает мгновенный доступ к оформлению заказа, значительно упрощая процесс покупок.

Подключение автосохранения карт для облаков осуществляется по-разному:

• Франшиза и сеть заведений на одном облаке. Если вы хотите, чтобы гости могли видеть ранее сохраненные карты при заказе в любом из заведений (даже в разных городах), необходимо обратиться к менеджеру Quick Resto для подписания дополнительного соглашения с сервисом ЮKassa. Это соглашение позволит объединить shopId.
• Одиночное облако. Чтобы реквизиты карт гостей сохранялись в мини-приложении Telegram-бота, выполните следующие шаги:

1. Оповестите вашего менеджера Quick Resto любым удобным способом о желании подключить автосохранение.

2. Уведомите систему ЮKassa о вашем намерении произвести подключение.

Способ 1: Напишите на электронную почту ecommerce@yoomoney.ru, указав в теме письма ваш ИНН/ShopId/Quick Resto. В свободной форме опишите ваши пожелания по подключению автоплатежей (сохранению карт).

А также приложите скриншот, на котором видны поля Выбора способа оплаты с ранее использованными картами. Данное поле можно найти в разделе Корзина — Оплата.

Способ 2: В личном кабинете в правом нижнем углу нажмите на круглый знак вопроса (?). Откроется диалоговое окно, в котором выберите тему Нужно что-то подключить. Затем выберите Автоплатежи и привязка карт. Появятся поля, где в свободной форме опишите ваши пожелания по подключению этой функции. Не забудьте прикрепить скриншот на котором видны поля Выбора способа оплаты с ранее использованными картами.

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

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

1. Гость нажимает на кнопку Корзина.

2. В поле Оплата выбирает способ оплаты Новой картой.

3. Нажимает на кнопку Оформить заказ.

4. Откроется платёжный виджет ЮKassa, в котором необходимо выбрать раздел Банковская карта.

5. Вводит реквизиты карты и ставит флаг в поле Разрешаю автосписания.

В таком случае, при следующем заказе, автоматически будет выбрана сохранённая карта. После нажатия на кнопку Оформить заказ средства будут списаны сразу, а заказ отправится на кассовый терминал.

Чтобы удалить сохранённые карты, выполните следующие шаги:

1. Гость нажимает на кнопку Корзина.

2. В поле Оплата нажимает на знак удаления рядом с нужной сохранённой банковской картой.