Помощь Витрины

Как подключить ЮKassa к Витрине: пошаговая инструкция

Пошаговая инструкция: как подключить свой магазин ЮKassa к Витрине, где взять Shop ID и секретный ключ, как настроить уведомления и проверить оплату.

Автор: Редакция Витрины

Обновлено:

Отдельно проверьте три результата

Действующее подключение сохраняется: работающий магазин можно продолжать использовать. При контрольной покупке проверьте подтверждение оплаты, получение материала и чека; при возврате — отдельный статус денежной операции.
РезультатКак проверить
ПлатёжУспешная оплата подтверждена вашим магазином ЮKassa; заказ имеет верный статус
ПокупкаФайл скачивается, урок открывается либо запись подтверждена по выбранному режиму
ПисьмоДетали покупки пришли на правильный email; предусмотрен повторный доступ
ЧекДля ИП фискализация подключена и настроена в ЮKassa; для НПД проверена применимая схема

Короткий ответ

Чтобы подключить ЮKassa, откройте в ЮKassa раздел «Интеграция → Ключи API», скопируйте Shop ID и секретный ключ, вставьте их вместе с ИНН в Кабинете Витрины → Настройки → Платежи, затем добавьте Webhook URL в «Интеграция → HTTP-уведомления». Покупатель платит в магазин автора, деньги идут продавцу, а Витрина открывает доступ после подтверждения платежа.

Главное для выбора

Куда поступают деньги?

В магазин ЮKassa автора, а не на счет Витрины.

Что делает Витрина?

Оформляет страницу продукта, создает заказ, получает статус платежа и открывает доступ после подтверждения.

Зачем ЮKassa, если есть СБП?

ЮKassa нужна для автоматической оплаты картой или СБП без ручной проверки каждого перевода.

Комиссия Витрины с продаж?

0% с продаж. Комиссия ЮKassa применяется отдельно по тарифу платежной системы.

Магазин, ключи и настройка оплаты

Шаг 1. Откройте магазин в ЮKassa, если его ещё нет. Понадобятся ИНН, контактные данные, счёт или карта для выплат и адрес вашей витрины. Проверку магазина проводит ЮKassa, срок зависит от неё.

Шаг 2. В кабинете ЮKassa откройте «Интеграция → Ключи API». Скопируйте Shop ID и выпустите или скопируйте секретный ключ.

Шаг 3. В Витрине откройте Кабинет → Настройки → Платежи, выберите ЮKassa и вставьте ИНН, Shop ID и секретный ключ. Введите ИНН длиной 10 или 12 цифр. Перед сохранением Витрина проверяет доступ, а ключ хранится в зашифрованном виде.

Уведомления, чеки и тестовая выдача

Шаг 4. Скопируйте Webhook URL из настроек Витрины и вставьте его в ЮKassa: «Интеграция → HTTP-уведомления». Включите события payment.succeeded и payment.canceled и сохраните.

Шаг 5. Настройте чеки под свой статус. Для ИП с кассовыми чеками по 54-ФЗ подключите фискализацию в ЮKassa, проверьте ставку НДС: Витрина передаёт данные заказа для автоматического формирования чека. Для самозанятого на НПД ЮKassa не формирует чек «Мой налог» автоматически — используйте «Мой налог» или отдельный подключённый сервис. Проверьте получение чека покупателем отдельно от письма с доступом.

Шаг 6. Проверьте выдачу тестовым заказом во Витрине. Затем проведите контрольную покупку через свой магазин ЮKassa: успешный платёж должен отправить HTTP-уведомление, подтвердить заказ и открыть материал. Получите письмо на свой адрес и повторно откройте покупку.

Проверка отдельного платежа и проблем с доступом

Webhook URL скопируйте из настроек своего магазина автора. После сохранения ключей проверьте покупку продукта: успешный платёж должен подтвердить заказ и открыть материал. Подписка на платформу оплачивается отдельной операцией от покупок у автора.

Перед проверкой убедитесь, что открываете опубликованный платный продукт, а не бесплатный материал. Запишите номер заказа и время проверки. После оплаты сопоставьте успешный платёж в ЮKassa, статус заказа в Витрине и доступ к файлу или курсу.

Если платёж успешен в ЮKassa, а заказ ожидает оплаты, проверьте URL HTTP-уведомлений и включённые события. Не просите покупателя платить повторно. Передайте поддержке номер заказа, идентификатор платежа и время; секретный ключ в переписку не отправляйте.

Доставка письма и критерии готовности

Если заказ оплачен и доступ уже открыт, но письма нет, сначала проверьте email и спам. Это отдельная проверка доставки письма, а не признак неработающей оплаты. Покупатель может восстановить доступ через «Мои покупки».

Если ошибка появляется ещё при подключении, проверьте Shop ID, ключ и выбранный магазин. Не смешивайте данные разных магазинов и не подставляйте ключ тарифной оплаты платформы: продажи идут в ваш магазин.

Критерий готовности: платёж подтверждён, заказ соответствует покупке, файл или курс открывается, письмо приходит на правильный адрес. Повторите путь на телефоне. Тестовая покупка Витрины проверяет выдачу; реальную оплату и доставку письма проверяют отдельно.

Оплата и доступ: где искать проблему

НаблюдениеЧто проверитьЧто сделать
Ключи сохраненыПодключение по реквизитам магазина автораПроверить отдельный заказ, оплату, выдачу и письмо
В ЮKassa успешно, заказ ожидаетHTTP-уведомления, URL и событияСопоставить заказ и платёж; обратиться в поддержку без повторной оплаты
Заказ оплачен, письма нетEmail, спам и доставкуОткрыть доступ через «Мои покупки»; автор может повторно отправить письмо
Пройден тест ВитриныРеальное списание и уведомления ещё не провереныОтдельно проверить платёж через магазин автора

Порядок запуска

  1. Открыть магазин в ЮKassa
  2. Скопировать Shop ID и секретный ключ в Интеграция → Ключи API
  3. Вставить ИНН, Shop ID и ключ в Настройки → Платежи
  4. Добавить Webhook URL в Интеграция → HTTP-уведомления
  5. Проверить применимые настройки чеков магазина
  6. Проверить тестовую выдачу, отдельный платёж через магазин и письмо

Вопросы

Где взять Shop ID и секретный ключ ЮKassa?

В кабинете ЮKassa: «Интеграция → Ключи API». Shop ID копируется, секретный ключ выпускается или копируется там же.

Куда вставлять Webhook URL?

В кабинете ЮKassa: «Интеграция → HTTP-уведомления». Включите события payment.succeeded и payment.canceled.

Витрина является продавцом продукта?

Нет. Продавец продукта — автор, который подключил свой платежный способ и отвечает за продукт, чек и возврат.

Есть ли скрытые расходы?

Витрина не берёт комиссию с продаж. Комиссию ЮKassa вы платите отдельно по тарифу своего магазина; ставку и налоги на неё уточняйте в договоре с ЮKassa.

Можно продавать без ручного подтверждения?

Да. При оплате через подключённый магазин ЮKassa платёж подтверждается автоматически, Витрина автоматически открывает материал и отправляет письмо. Вручную подтверждать каждую оплату и пересылать файлы не нужно. Для автоматических чеков подключите и настройте фискализацию в своём магазине; для НПД применяется отдельная схема чеков.

Что проверить перед публикацией?

Для самозанятого на НПД — что чек будет сформирован в «Мой налог» и передан покупателю. Для других режимов — применимые настройки чека и НДС. Для всех продавцов отдельно проверьте подключение магазина, подтверждение оплаты и выдачу.

Может ЮKassa отправлять чеки автоматически?

Да, для ИП с кассовыми чеками по 54-ФЗ после подключения и настройки подходящего решения фискализации. Витрина передаёт данные заказа. Для НПД автоматическое формирование чеков «Мой налог» через ЮKassa недоступно; чек оформляется через «Мой налог» или отдельный подключённый сервис.