Подключение ЮKassa

ЮKassa — платёжный сервис ЮMoney. Через неё Reefox Panel принимает оплату по СБП и банковской картой, а после отдельного разрешения ЮKassa — автопродление по СБП. Деньги приходят на ваш расчётный счёт.

В админке Reefox Panel провайдер называется YooKassa. Что где лежит в админке, описано в справочнике Настройки → Платежи. Здесь — всё, что нужно сделать в самой ЮKassa.

Что понадобитсяСкопировать ссылку

• Статус ИП или ООО и расчётный счёт в банке. Про самозанятых — ниже.
• Паспорт, ИНН, реквизиты организации и сведения о госрегистрации.
• Телефон и почта для входа в кабинет ЮKassa.
• Рабочий сайт сервиса на вашем домене: цены, пользовательское соглашение, политика конфиденциальности, контакты и реквизиты.
• Доступ к админке Reefox Panel.

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

Шаг 1. Выберите форму бизнесаСкопировать ссылку

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

Шаг 2. Как описать услугу при оформленииСкопировать ссылку

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

• «предоставление интернет-услуг»;
• «услуги доступа к сети» или «телекоммуникационные услуги»;
• «программное обеспечение» или «IT-сервис по подписке».

Слово «VPN» в названии магазина и в описании можно не выносить. Главное, чтобы описание совпадало с тем, что клиент видит на сайте и в боте.

Что проверяют на сайтеСкопировать ссылку

По требованиям ЮKassa на сайте должны быть:

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

В Reefox Panel цены пакетов видны на главной странице. Тексты соглашения и политики конфиденциальности задаются в Настройки → Бренд → Документы. Впишите туда свои реквизиты и контакты. Ссылки «Правила» и «Конфиденциальность» внизу главной ведут в кабинет. Откройте сайт в режиме инкогнито и проверьте, что модератор найдёт тексты, реквизиты и контакты без входа. Если нет — пришлите менеджеру прямые ссылки или тексты.

Что будет при нарушении правилСкопировать ссылку

По Правилам работы сервиса ЮKassa:

• нельзя продавать то, что запрещено законом или правилами платёжных систем (п. 6.1.10);
• о смене перечня услуг нужно предупредить ЮKassa не позже чем за 5 рабочих дней (п. 6.1.9);
• при нарушении обязательств ЮKassa может приостановить работу с вами до устранения нарушения или до расторжения договора (п. 3.5.5).

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

Шаг 3. РегистрацияСкопировать ссылку

Шаг 4. Анкета, проверка и договорСкопировать ссылку

Пока анкета на проверке, можно потренироваться на тестовом магазине — см. шаг 9.

Шаг 5. Способы оплатыСкопировать ссылку

Reefox Panel создаёт платёж ЮKassa сразу с выбранным способом: СБП или банковская карта. Клиент выбирает способ на вашем сайте или в Mini App, а не на странице ЮKassa. Поэтому у магазина должны быть включены оба способа.

Комиссию за СБП ЮKassa рассчитывает индивидуально. Если СБП нет в договоре, попросите менеджера подключить его. Без СБП способ «СБП» через ЮKassa у клиентов работать не будет: выберите для него Platega или выключите.

Шаг 6. Ключи APIСкопировать ссылку

Reefox Panel нужны два значения: shopId и секретный ключ.

Теперь в админке Reefox Panel откройте Настройки → Платежи → Подключения и раскройте YooKassa:

1. В Shop ID вставьте shopId.
2. В «Секретный ключ» вставьте ключ.
3. «Email для чеков» пока не трогайте — про него в шаге 8.
4. Включите переключатель «Включить YooKassa» и нажмите «Сохранить платежи».

Статус должен стать «Включён». Если «Нужны настройки» — одно из полей пустое. Подробнее о полях — в справочнике, раздел Подключения.

Шаг 7. HTTP-уведомленияСкопировать ссылку

Уведомления — это сообщения от ЮKassa о том, что платёж прошёл или отменён. По ним Reefox Panel выдаёт доступ сразу после оплаты.

• Адрес уведомлений всегда с основным доменом панели, а не с адресом зеркала или CDN.
• ЮKassa отправляет уведомления только на HTTPS и порты 443 или 8443. Обычная установка Reefox Panel этому отвечает.
• Если поля «Адрес уведомлений» в админке нет, у сервера не задан домен. Сначала закончите установку с доменом.

Шаг 8. Чеки по 54-ФЗСкопировать ссылку

ИП и ООО обязаны выдавать клиенту кассовый чек. У ЮKassa для этого есть встроенный сервис «Чеки от ЮKassa», можно подключить и стороннюю онлайн-кассу. Выбор согласуйте с бухгалтером.

Когда касса подключена в ЮKassa:

1. Заполните в Reefox Panel «Email для чеков», например receipts@example.com, и сохраните.
2. Reefox Panel будет передавать данные чека в каждом платеже: услуга, сумма, полная предоплата.
3. ЮKassa отправит чек на этот адрес и в налоговую.

• Если касса в ЮKassa не подключена, оставьте поле пустым. Тогда Reefox Panel не передаёт данные чека.
• Если касса подключена, а поле пустое, ЮKassa может отказать в создании платежа. Клиент увидит ошибку оплаты.
• Один адрес получает чеки по всем разовым платежам. Клиенту чек от ЮKassa при разовой оплате не приходит.
• Самозанятым: если ЮKassa сама регистрирует чеки в «Мой налог», не включайте Мой Налог в Reefox Panel — иначе доход задвоится. И наоборот.

Шаг 9. Проверочная оплатаСкопировать ссылку

Тестовый магазинСкопировать ссылку

Тестовый магазин работает без документов и договора. Его можно создать, пока анкета на проверке.

После проверки замените ключи на боевые и сохраните.

Настоящая оплатаСкопировать ссылку

Когда боевой магазин заработает, купите самый дешёвый пакет по СБП со своего Telegram-аккаунта. Проверьте, что доступ продлился. Затем верните деньги в кабинете ЮKassa: с событием refund.succeeded платёж в Reefox Panel отметится возвращённым, а доступ клиента не изменится.

АвтопродлениеСкопировать ссылку

Автопродление — ежемесячное списание по СБП без участия клиента. По умолчанию ЮKassa разрешает автоплатежи только в тестовом магазине. Для боевого их включает менеджер.

Здравствуйте! Магазин shopId 123456 принимает оплату подписки
по API. Прошу включить автоплатежи с сохранением способа оплаты
через СБП. Согласие клиента на автосписания берём при первой
оплате, отключить автопродление клиент может в личном кабинете.

10 ₽ списываются по-настоящему и приходят в ваш же магазин. Тест не создаёт подписку. Подробно о кнопках — в справочнике, раздел Автопродление.

ЮKassa требует, чтобы вы получили согласие клиента и дали ему способ отключить автоплатёж. Reefox Panel спрашивает согласие при оплате, а отключить продление можно в профиле кабинета. Опишите автопродление и в пользовательском соглашении.

Комиссии и лимитыСкопировать ссылку

Ставки указаны без НДС, по данным с сайта ЮKassa на октябрь 2026 года. Точные условия — в вашем договоре. При обороте больше 5 млн ₽ в месяц ЮKassa предлагает индивидуальные условия.

Минимальная сумма платежа в Reefox Panel для ЮKassa — 1 ₽.

Частые ошибкиСкопировать ссылку

ИсточникиСкопировать ссылку

• ЮKassa: как подключиться
• ЮKassa: шаги подключения
• ЮKassa: как подготовить сайт к подключению
• Правила работы сервиса ЮKassa
• ЮKassa: формат взаимодействия, shopId и ключи API
• ЮKassa: входящие уведомления
• ЮKassa: тестирование и тестовый магазин
• ЮKassa: чеки
• ЮKassa: чеки для самозанятых
• ЮKassa: коды ставок НДС
• ЮKassa: автоплатежи для разработчиков
• ЮKassa: автоплатежи, справка
• ЮKassa: тарифы
• ЮKassa: приём платежей для самозанятых