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

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

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

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

Обновлено:

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

Чтобы подключить Ю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. Проверьте настройки чеков и ставку НДС, соответствующую вашему налоговому статусу. Фискализация и отправка чеков зависят от настроек магазина и подключённых услуг ЮKassa; письмо Витрины с доступом не заменяет чек.

Шаг 6. Сделайте тестовую покупку во Витрине, чтобы проверить оформление заказа и выдачу доступа. Она не проверяет реальное списание и HTTP-уведомления ЮKassa. Отдельно проверьте платёж через свой магазин и поступление уведомления об успешной оплате; после этого проверьте статус заказа и письмо покупателю.

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

Сохранённые ключи означают, что магазин подключён, но не доказывают успешную выдачу по платежу. 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 автора и платеж успешно подтверждается автоматически.

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

Подключение магазина, HTTP-уведомления, применимые настройки чеков, путь тестовой выдачи, отдельный платёж через свой магазин и фактическую доставку письма.