Данная инструкция позволит настроить интеграцию интернет-эквайринга от Юкасса
Регистрация и подача заявки
Для подключения интернет-эквайринга от Юкасса к Telegram-магазину необходимо быть зарегистрированным в Юкассе, для этого подайте заявку ссылке.
Регистрация в Юкасса
Выберите юр.лицо или самозанятость для регистрации
Выберите cпособ подключения “с помощью телеграм-бота”.
Настройка способа приема платежей
Важно перед подачей заявки:
В личном кабинете TGShop перейдите в настройки магазина —> Приветственное сообщение —> в приветственном сообщении Telegram-магазина обязательно добавьте следующую информацию для успешного прохождения проверки Юкассы:
«Продажу товаров осуществляет:
ИП ФИО / Название компании
Все права защищены. ОГРНИП: (укажите номер)
Контакты службы поддержки:
📧 Ссылка на менеджера
🔗 Ссылка на канал (при наличии)»
В заявке укажите ссылку на ваш бот с активированным магазином и товарами, чтобы быстро пройти проверку. Ссылка на бот в формате: https://t.me/названиевашегобота_bot — вы можете найти название бота в ЛК TGShop ниже названия магазина или в @BotFather в Telegram, где вы создавали бота.
Заполнение анкеты для регистрации в Юкассе
Настройте выставление чеков вашим клиентам, по умолчанию Юкасса предлагает подключить свой сервис “Облачные чеки от Юкасса” либо вы можете выбрать другую онлайн-кассу и подключить ее. В обоих случаях - подключение онлайн-кассы происходит в ЛК Юкассы, дополнительно подключать онлайн-кассу в лк TGShop не требуется.
Настройка онлайн-кассы для выставления чеков
В зависимости от выбранного вами типа: ИП / ООО / Самозанятый - пройдите по инструкции Юкассы и заполните все данные и отправьте заявку на проверку.
Настройка тестового терминала
В ЛК Юкасса нажмите на номер заявки → раздел “Магазины” → Добавить тестовый магазин
Выберите способ приема платежей
Раздел "магазины"
Далее выберите “без сайта” и нажмите “Добавить”. После этого в течение 15-30 минут в ЛК Юкасса у вас появится тестовый магазин.
Подключение тестового магазина для тестирования платежей
После того, как у вас появился тестовый магазин в ЛК Юкасса, перейдите в BotFather и нажмите команду /mybots, выберете бота, которого вы подключили в TGShop в личном кабинете.
Важно: для настройки платежей - вы должны быть владельцем бота (то есть создателем или тем, кому передали права на бота).
Подключение тестового терминала к боту
Выберете раздел payments
Настройка бота
Выберите платежную систему Юkassa
Выбор платежной системы
Выберите “Connect ЮКасса Test”
Настройка тестового терминала
Далее начните диалог с ботом от Юкасса и выберите “войти и выдать доступ”. Для этого у вас должен быть доступ в ЛК Юкасса.
Настройка тестовых платежей от Юкасса
Разрешите доступ Юкассе к боту
Настройка разрешения доступа бота тестовому ShopID от Юкасса
Выберите ShopID присвоенный тестовому магазину:
Выдача доступа для бота к вашему ShopID
После получения уведомления от бота Юкассы подключение тестового терминала к боту можно считать успешным.
Вернитесь в Botfather. Тестовый токен должен появиться в BotFather → /mybots → выберите бота, к которому вы подключали тестовый терминал → payments
Токен для подключения тестового терминала к магазину
Далее подключаем интеграцию с Юкасса в ЛК TGShop:
Перейдите в настройки → раздел “оплата” → добавить способ “онлайн-оплата” → ЮКасса
Настройки в ЛК TGShop
Раздел "Оплата" -> онлайн-оплата
Укажите токен, который вы получили при настройке тестового терминала в ботфазер. А также заполните другие поля и сохраните изменения.
Настройка интеграции с Юкасса в лк TGShop
А также заполните остальные поля и сохраните изменения. Для тестового терминала вы можете заполнить эти поля сразу также как и для рабочего терминала.
При успешном сохранении настроек, подключение тестового терминала можно считать завершенным. Вы можете проводить тестовые платежи.
Подключение тестового терминала к магазину успешно завершена
Подключение рабочего терминала
Важно: вы можете подключить рабочий терминал, только после одобрения вашей заявки на подключение интернет-эквайринга и получения рабочего ShopID в ЛК Юкассы.
Перейдите в BotFather и нажмите команду /mybots, выберете бота, которого вы подключили в TGShop в личном кабинете.
Выбор бота для подключения рабочего терминала
Выберите раздел payments
Настройки бота
Выберите платежную систему Юкасса
Выбор платежного решения
Выберите “Connect ЮКасса Live”
Подключение рабочего терминала от Юкасса к боту
Запустите бота и выберите “войти и выдать доступ”. Для этого у вас должен быть доступ в ЛК Юкасса.
Настройка рабочего терминала
После получения уведомления от бота Юкассы, подключение рабочего терминала к боту можно считать успешным. В Botfather появится второй токен Юкасса Live.
Перейдите в настройки → раздел “оплата” → ЮКасса “редактировать” → вставьте токен рабочего терминала и сохраните изменения.
После этого интеграцию с Юкасса для приема оплат можно считать завершенной.