Перейти к основному содержимому

Баланс магазина

Баланс магазина — внутренний кошелёк игрока на вашем магазине. Игрок пополняет его реальными деньгами и тратит на товары.

Как работает баланс​

  1. Игрок пополняет баланс через любой подключённый платёжный метод
  2. Средства зачисляются на PlayerWallet
  3. Игрок покупает товары → сумма списывается с баланса
  4. История всех операций хранится в WalletLedger (неизменяемый лог)

Кошелёк игрока (PlayerWallet)​

ПолеОписание
balanceMinorОсновной баланс (в копейках)
bonusMinorБонусный баланс (промокоды, бонусы)
currencyВалюта (всегда RUB)

Приоритет списания: сначала бонусный баланс, потом основной.

WalletLedger​

Каждая операция с балансом оставляет запись в логе:

ОперацияОписание
TOPUPПополнение баланса
PURCHASEПокупка товара
REFUNDВозврат средств
BONUSНачисление бонуса
PROMOПромокод
ADJUSTРучная корректировка администратором

Комиссии​

  • Пополнение: комиссию берёт платёжный провайдер (зависит от метода)
  • Покупка: без комиссии — игрок платит ровно цену товара
  • Tirify: не участвует в движении средств. Деньги идут напрямую от игрока владельцу

Пополнение (Top-Up)​

Игрок пополняет баланс в модальном окне:

  1. Нажимает «Пополнить» (в хедере или кабинете)
  2. Выбирает сумму или вводит свою
  3. Выбирает платёжный метод
  4. Перенаправляется на страницу оплаты
  5. После оплаты баланс обновляется автоматически

Бонусы при пополнении: владелец может настроить шкалу бонусов (например, +10% при пополнении от 1000 ₽).

Ручная корректировка​

Администратор может изменить баланс игрока вручную:

  1. Админка → Игроки → выбрать игрока → «Кошелёк»
  2. Указать сумму (положительную или отрицательную)
  3. Указать причину
  4. Запись попадает в WalletLedger с типом ADJUST

Следующие шаги​