Перейти к содержанию

Платежи (ЮKassa)

Гости пополняют баланс картой прямо из приложения игрока. Приём платежей — через ЮKassa (сервис ЮMoney/Сбера). Деньги идут на ваш расчётный счёт по договору с ЮKassa; продукт денег не касается.

Что нужно

  1. Магазин в ЮKassa — заключите договор на yookassa.ru (нужны реквизиты ИП/ООО). После одобрения у вас появятся:
    • shopId — номер магазина;
    • секретный ключ (выпускается в личном кабинете ЮKassa: Интеграция → Ключи API).
  2. Публичный адрес клуба (домен с HTTPS) — чтобы ЮKassa могла присылать уведомления об оплате, приложение игрока должно быть доступно из интернета по HTTPS. Обычно это настраивается вместе с поставщиком (домен + сертификат).

Подключение

  1. Админка → Система → Настройки → раздел «Оплата и кредиты»: впишите «YooKassa Shop ID» и «YooKassa Secret Key».

  2. В личном кабинете ЮKassa → Интеграция → HTTP-уведомления укажите адрес:

    https://<ваш-домен>/api/v1/payments/webhook

    и включите события: платёж успешно завершён (payment.succeeded), ожидает подтверждения (payment.waiting_for_capture), отменён (payment.canceled), возврат выполнен (refund.succeeded) и возврат отменён (refund.canceled).

  3. Настройки → «Оплата и кредиты» → «Кто пробивает чеки онлайн-оплат»: «Наша касса (АТОЛ клуба)» (тогда в кабинете ЮKassa «Чеки от ЮKassa» выключены) или «ЮKassa» (чеки включены в кабинете). Подробнее — Касса и чеки.

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

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

Бонусы за пополнение

Настройки → бонусные правила: уровни «пополнил от N — получи +X%» (с ограничением максимума). Начисляется один, самый выгодный для гостя уровень. Витрина уровней автоматически показывается в приложении игрока.

Фискализация (чеки)

Чек по онлайн-оплате должен быть один: либо вашей кассой АТОЛ, либо самой ЮKassa — выбирается настройкой выше (шаг 3). Возвраты гостям через ЮKassa уходят автоматически из админки — см. «Возвраты» в Касса и чеки.

Если оплата «не пришла»

Гость оплатил, а баланс не пополнился — почти всегда это уведомление, которое не дошло до клуба. Что проверить — в диагностике.