Платный доступ к сайту через ЮKassa: настройка по шагам

1 сентября 2026 г.

Платный доступ на Tuqo работает на вашем собственном договоре с платёжным сервисом: покупатель платит напрямую в ваш магазин ЮKassa, Tuqo не касается денег и не берёт комиссию с продаж. Ниже — настройка по шагам; у ЮKassa есть одна особенность, о которой стоит знать заранее: тестовый и боевой магазины — это два разных магазина, у каждого свои ключи.

Что понадобится

Договор с ЮKassa и магазин в личном кабинете;
касса для чеков 54-ФЗ (у ЮKassa есть встроенные решения фискализации);
сайт на Tuqo и тариф «Профи» — либо опция «Платный доступ» за 499 ₽/мес.

Шаг 1. Реквизиты продавца и документы для покупателей

В карточке «Продавец» укажите наименование (ФИО ИП или организацию), ИНН, при наличии ОГРН/ОГРНИП и адрес электронной почты для вопросов покупателей. По закону покупатель должен видеть продавца до оплаты: эти сведения появятся на экране оплаты и в письме «доступ открыт»; без них витрина не продаёт — посетители видят «Продажи ещё не открыты», а сам режим включить можно и раньше.

Дальше — блок документов на той же вкладке «Видимость». Минимум один документ (оферта или условия) обязателен: покупатель соглашается с ним перед оплатой, без документа витрина не продаёт. Документ — название и https://-ссылка на текст.

Шаг 2. Продукт и цена

Название, описание и цена — это витрина. Модель на выбор: разовая (оплатил один раз — доступ навсегда) или на срок (N дней; продление прибавляет дни к концу оплаченного срока). По желанию — до трёх преимуществ, кнопка дополнительной информации. Срок доступа (до какой даты витрина продаёт) и количество доступов — на вкладке «Условия доступа».

Шаг 3. Тестовый магазин

В ЛК ЮKassa создайте тестовый магазин — он отделён от боевого и платежи в нём ненастоящие. Понадобятся два значения: shopId и секретный ключ (раздел «Интеграция» → «Ключи API»).

В панели Tuqo, в карточке «Приём оплаты», выберите провайдера «ЮKassa», набор «Тестовый» и впишите оба значения. Сохранённые ключи не показываются — хранятся в зашифрованном виде; при смене ключей владельцу проекта уходит письмо.

Шаг 4. HTTP-уведомления

Скопируйте URL вебхука из панели Tuqo и вставьте его в ЛК ЮKassa: «Интеграция» → «HTTP-уведомления». Отметьте события:

payment.succeeded — платёж прошёл (открывает доступ);
payment.canceled — платёж отменён;
refund.succeeded — возврат (закрывает доступ).

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

Шаг 5. Тестовый платёж

Откройте сайт в приватном окне: витрина → email → код из письма → оплата. ЮKassa покажет тестовую форму — оплатите тестовой картой из её документации. Страница «Подтверждаем оплату» дождётся уведомления и впустит на сайт.

Чеклист в панели: ключи ✓ → уведомление получено ✓ → тестовый платёж ✓. Пока чеклист не зелёный, боевой режим включать рано.

Шаг 6. Фискализация

В карточке «Фискализация (54-ФЗ)» укажите систему налогообложения, ставку НДС и отметьте, включена ли у магазина фискализация («касса подключена»):

включена — Tuqo передаёт данные для чека (email покупателя, наименование, сумму, ставку НДС и СНО), чек формирует решение ЮKassa;
не включена — данные чека не передаются. Флаг в панели должен совпадать с настройкой магазина: если у магазина фискализация обязательна, а чек не передан, платёж не пройдёт.

Чеки, налоги, возвраты и претензии покупателей — обязанность продавца, то есть ваша. При включении режима вы подтверждаете это явно.

Шаг 7. Боевой магазин и включение

Впишите shopId и секретный ключ боевого магазина в набор «Боевой», в его ЛК настройте те же HTTP-уведомления на тот же URL, переключите «Боевой режим» и включите режим «Платный доступ» на вкладке «Видимость».

Режим можно включить и раньше — хоть первым шагом: пока продукт, ключи, реквизиты продавца и документ не заполнены, посетители видят заглушку «Продажи ещё не открыты», а панель показывает, чего не хватает. Витрина откроется сама, как только всё собрано.

Пометка «боевой вебхук подтверждён» появится с первым реальным платежом — до того чеклист честно показывает, что боевой канал уведомлений ещё не проверен.

Если что-то пошло не так

Уведомления не приходят. Сверьте URL в ЛК ЮKassa с URL из панели и проверьте, что события payment.succeeded, payment.canceled и refund.succeeded отмечены. Пока уведомлений нет, работает страховка: Tuqo сверяет статус зависших платежей с ЮKassa каждые две минуты — оплата откроет доступ и без уведомления, чуть позже.
Платёж не создаётся. Обычно это рассинхрон фискализации: у магазина чеки обязательны, а флаг «касса подключена» в панели снят — или наоборот. Сверьте.
Тестовый платёж не видно. Проверьте, что ключи тестового магазина вписаны в набор «Тестовый»: боевой и тестовый магазины ЮKassa — разные, их ключи не взаимозаменяемы.
Покупатель заплатил, доступ не открылся. Смотрите чеклист и настройку уведомлений; сверка каждые две минуты дожмёт зависший платёж. Не помогло — поддержка, категория «Интеграции».

Сколько это стоит

Режим входит в тариф «Профи»; на младших тарифах — опция «Платный доступ» за 499 ₽/мес за сайт (включает и режим «Регистрация»). С продаж Tuqo не берёт ничего. Комиссия ЮKassa — по вашему договору с сервисом.

Нужен другой эквайринг — Сбер, Альфа, Точка, Робокасса, CloudPayments? Напишите в поддержку: подключаем за 72 часа с момента передачи доступов.