Юкасса

Данная инструкция позволит настроить интеграцию интернет-эквайринга от Юкасса

Шаг 0. Зарегистрируйтесь в ЮKassa (если аккаунта ещё нет)

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

Если у вас уже есть аккаунт в ЮKassa с подключённым интернет-эквайрингом — пропустите этот шаг и переходите к Шагу 1

Регистрация в Юкасса

Выберите юр.лицо или самозанятость для регистрации

Выберите cпособ подключения “На сайте”.

Настройка способа приема платежей

Важно перед подачей заявки: В личном кабинете TGShop перейдите в настройки магазина —> Приветственное сообщение —> в приветственном сообщении Telegram-магазина обязательно добавьте следующую информацию для успешного прохождения проверки Юкассы:

«Продажу товаров осуществляет:

ИП ФИО / Название компании

Все права защищены. ОГРНИП: (укажите номер)

Контакты службы поддержки:

📧 Ссылка на менеджера

🔗 Ссылка на канал (при наличии)»

В заявке укажите ссылку на ваш бот с активированным магазином и товарами, чтобы быстро пройти проверку. Ссылка на бот в формате: https://t.me/названиевашегобота_bot — вы можете найти название бота в ЛК TGShop ниже названия магазина или в @BotFather в Telegram, где вы создавали бота.

Заполнение анкеты для регистрации в Юкассе

Настройте выставление чеков вашим клиентам, по умолчанию Юкасса предлагает подключить свой сервис “Облачные чеки от Юкасса” либо вы можете выбрать другую онлайн-кассу и подключить ее. В обоих случаях - подключение онлайн-кассы происходит в ЛК Юкассы, дополнительно подключать онлайн-кассу в лк TGShop не требуется.

Настройка онлайн-кассы для выставления чеков

В зависимости от выбранного вами типа: ИП / ООО / Самозанятый - пройдите по инструкции Юкассы и заполните все данные и отправьте заявку на проверку.

Шаг 1. Подключение Юкасса к TGShop

1. После того, как у вас появился магазин в ЛК Юкасса, перейдите в ЛК TGShop.

2. Перейдите в Настройки магазина и выберите вкладку Оплата.

3. Нажмите кнопку Добавить онлайн оплату и выберите из списка ЮKassa.

4. После добавления на странице появится карточка ЮKassa с кнопкой Авторизация. Нажмите на неё.

Важно: для настройки платежей - у вас должны быть соответствующие права в лк Юкасса.

Откроется страница авторизации ЮKassa. Сервис запросит доступ к вашему профилю со следующими правами: просмотр возвратов, создание платежей, сохранение и использование способов оплаты, просмотр платежей.

1. Нажмите Разрешить, чтобы продолжить.

Настройка разрешения доступа бота тестовому ShopID от Юкасса

1. На следующем экране выберите магазин, к которому хотите подключить TGShop. Магазины отображаются во вкладке Можно выдать доступ.

2. Отметьте нужный магазин и нажмите Выдать доступ.

Если нужного магазина нет в первой вкладке, проверьте вкладки Нельзя выдать доступ и Неактивные — возможно, у вас недостаточно прав или магазин неактивен.

Выдача доступа для бота к вашему ShopID

1. После успешного подключения кнопка на карточке ЮKassa изменится с Авторизация на Настроить.

Шаг 2. Настройка параметров оплаты

Нажмите Настроить на карточке ЮKassa. Откроется форма — заполните все поля.

Название способа оплаты — это название покупатель увидит в боте при оформлении заказа. Используйте понятную формулировку, например: «Оплата картой» или «Онлайн оплата»

Предмет расчёта — указывает, что именно оплачивает покупатель; отражается в фискальном чеке.

Признак способа расчёта — определяет, когда покупатель получает товар относительно оплаты.

Система налогообложения — укажите систему, которую применяете; данные попадают в фискальный чек. Если не уверены — уточните у бухгалтера.

Ставка НДС — также отражается в фискальном чеке.

Важно: для фискализации сначала подключите её в личном кабинете ЮKassa в настройках магазина.

Нажмите Сохранить — интеграция настроена.

Частые вопросы:

Нет нужного магазина в списке

Проверьте, что вы авторизованы в ЮKassa под аккаунтом с правами администратора магазина.

Кнопка «Сохранить» неактивна

Заполните все обязательные поля формы (предмет расчёта, признак способа расчёта, система налогообложения).

Хочу переподключить другой магазин

Нажмите на три точки (⋮) в правом верхнем углу карточки ЮKassa и выберите нужное действие.