Как подключить ЮKassa для оплаты участниками

Что потребуется

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

Не отправляйте секретный ключ в обращениях или скриншотах. Если возник вопрос о налогах или чеках, уточните применимые настройки у ЮKassa или своего специалиста.

Порядок подключения

1. Откройте шаг «ЮKassa» в мастере настройки клуба или настройки интеграций клуба.

   Где: Мои клубы → выберите клуб → Настройки → Интеграции → ЮKassa

   Открыть настройки ЮKassa (в новой вкладке)

   

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

3. Для выбранного непроверенного магазина нажмите «Проверить подключение» в настройках или мастере настройки клуба. Сохранение реквизитов и успешная проверка являются отдельными этапами.

   Открыть настройки ЮKassa (в новой вкладке)

   Если действие недоступно: Сохраните реквизиты и подтвердите настройки чеков перед проверкой.

4. При ошибке прочитайте сообщение, проверьте данные магазина и повторите проверку. Для замены ключа откройте «Настройки магазина», введите новое значение полностью и сохраните изменения. Shop ID в этой форме изменить нельзя.

   Открыть настройки ЮKassa (в новой вкладке)

Как сменить магазин клуба

В настройках ЮKassa клуба нажмите «Сменить магазин», выберите другой сохранённый магазин или создайте новый. Подтвердите смену в диалоге с Shop ID обоих магазинов и числом затронутых подписок. До подтверждения клуб использует текущий магазин. Если новый магазин уже сохранён, отмена смены оставит его в списке подключений. Магазин можно сменить в любой момент, в том числе на тестовый.

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

Запросите подключение автоплатежей

Для рабочего магазина автоплатежи подключает ЮKassa по отдельному запросу. Обратитесь к менеджеру или в поддержку своего магазина и дождитесь подтверждения, что функция включена. В тестовом магазине автоплатежи доступны по умолчанию.

Инструкция ЮKassa по подключению автоплатежей (в новой вкладке)

Для обращения в чат ЮKassa подготовьте Shop ID, ссылки на отмену подписки и скриншот с видимой адресной строкой. Используйте короткое сообщение и ссылки ниже. Публичный пример показывает отмену без входа; свою подписку участник отменяет в личном кабинете.

Сообщение и материалы для ЮKassa

Как проверить результат

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

Если подключение не проходит

Как проверить оплату и доступ в клуб

Перед запуском продаж пройдите путь участника через тестовый магазин ЮKassa: от оплаты до вступления в Telegram-группу. При тестовой оплате деньги не списываются.

1. В кабинете ЮKassa откройте список магазинов, нажмите «Добавить магазин» и выберите тестовый магазин. Настройте способы оплаты и чеки так же, как в рабочем магазине. Если используете онлайн-кассу, включите режим проверки чеков.

   Где: Кабинет ЮKassa → список магазинов → Добавить магазин

2. Получите Shop ID тестового магазина и выпустите его секретный ключ в разделе «Интеграция → Ключи API».

3. В настройках ЮKassa клуба нажмите «Сменить магазин» и выберите «Новый магазин»; если подключений ещё нет, нажмите «Подключить магазин». Укажите реквизиты тестового магазина, выберите ставку НДС и подтвердите настройки чеков. Сохраните подключение, подтвердите смену, если клуб уже использовал другой магазин, и нажмите «Проверить подключение».

   Где: Мои клубы → выберите клуб → Настройки → Интеграции → ЮKassa

   Открыть настройки ЮKassa (в новой вкладке)

4. Подготовьте и опубликуйте клуб: подключите Telegram и бота, проверьте права и готовность к запуску. Скопируйте публичную ссылку на страницу подписки.

   Где: Мои клубы → выберите клуб → Настройки → Инструменты продаж

   Открыть инструменты продаж (в новой вкладке)

5. Откройте ссылку как участник: укажите отдельный email, подключите Telegram-аккаунт для проверки и примите условия. Нажмите «Перейти к оплате» и завершите платёж тестовой картой из инструкции ЮKassa. Для автоплатежей выбирайте тестовую карту без 3-D Secure.

6. Дождитесь подтверждения оплаты в Clubbix. Нажмите «Подать заявку в Telegram-группу» и отправьте заявку с подключённого аккаунта. Проверьте, что бот принял заявку и участник получил доступ к группе.

7. В кабинете владельца проверьте оплаченный период и доступ тестового участника. Успешная оплата должна отображаться в платежах клуба и истории платежей тестового магазина ЮKassa.

   Где: Мои клубы → выберите клуб → Участники

   Открыть участников клуба (в новой вкладке)

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

Как создать и настроить тестовый магазин ЮKassa (в новой вкладке)

Тестовые карты и проверка платежей в ЮKassa (в новой вкладке)

Как подготовить клуб и открыть продажи (в новой вкладке)

Как пройти оплату и вступить в Telegram-группу (в новой вкладке)

Как отключить автопродление тестовой подписки (в новой вкладке)