# Платежи и финансы

Руководство по управлению платежами, тарифами и финансовой отчетностью.

## 💳 Платежная система

Платформа ИКОН использует **ЮКасса** для приема онлайн-платежей от участников.

### Поддерживаемые способы оплаты

- 💳 **Банковские карты** (Visa, MasterCard, Мир)
- ⚡ **СБП** (Система быстрых платежей) - минимальная комиссия 0,4%
- 💰 **ЮMoney** (электронный кошелек)
- 🏦 **Сбербанк Онлайн**
- 📱 **QIWI Кошелек**

## 🔧 Настройка приема платежей

### Шаг 1: Регистрация в ЮКасса

1. Перейдите на [yookassa.ru](https://yookassa.ru)
2. Зарегистрируйтесь как юридическое лицо или ИП
3. Пройдите верификацию (потребуются документы)
4. Получите доступ к личному кабинету

### Шаг 2: Получение ключей API

1. В личном кабинете ЮКасса перейдите в **"Настройки"**
2. Выберите **"Интеграция"**
3. Скопируйте:
   - **Shop ID** (идентификатор магазина)
   - **Secret Key** (секретный ключ)

```{warning}
Никогда не публикуйте Secret Key публично! Храните его в безопасном месте.
```

### Шаг 3: Настройка на платформе ИКОН

1. Войдите в личный кабинет организатора
2. Перейдите в **"Настройки организации"**
3. Выберите **"Платежные настройки"**
4. Введите данные ЮКасса:
   - Shop ID
   - Secret Key
5. Нажмите **"Сохранить и проверить"**

Платформа автоматически проверит подключение к ЮКасса.

### Шаг 4: Настройка webhook

```{admonition} Что такое webhook?
:class: tip

Webhook - это автоматическое уведомление от ЮКасса о статусе платежа.
Без webhook платформа не узнает об успешной оплате!
```

**В личном кабинете ЮКасса:**
1. Перейдите в **"Настройки" → "Уведомления"**
2. Включите HTTP-уведомления
3. Укажите URL:
   ```
   https://ikong.ru/api/payments/webhook/
   ```
4. Выберите события:
   - ☑ payment.succeeded (платеж успешен)
   - ☑ payment.canceled (платеж отменен)
   - ☑ refund.succeeded (возврат успешен)
5. Сохраните настройки

## 💰 Ценообразование

### Динамические цены (Early Bird)

Настройте разные цены в зависимости от времени регистрации:

**Пример:**
```
Early Bird (до 01.02.2025):  2000₽
Regular (до 01.03.2025):     2500₽
Late (до 14.03.2025):        3000₽
```

**Настройка:**
1. При создании соревнования выберите **"Динамическое ценообразование"**
2. Укажите периоды и цены:
   - Early: дата окончания + цена
   - Regular: дата окончания + цена
   - Late: дата окончания + цена
3. Система автоматически переключит цену в нужную дату

### Разные цены по категориям

Установите индивидуальную цену для каждой категории:

```
RX Men:        3000₽
RX Women:      3000₽
Scaled Men:    2500₽
Scaled Women:  2500₽
Teens:         1500₽
```

**Настройка:**
1. Перейдите в **"Категории"** соревнования
2. Для каждой категории укажите цену
3. Если не указана - используется базовая цена

### Бесплатное участие

Для бесплатных соревнований:
1. Установите цену **0₽**
2. Регистрация будет работать без оплаты
3. Участники сразу получат подтверждение

## 📊 Отслеживание платежей

### Панель платежей

Доступна в личном кабинете:
```
💰 Общая статистика
├─ Всего платежей:      150 000₽
├─ Успешных:            140 000₽ (56 платежей)
├─ В ожидании:           5 000₽ (2 платежа)
├─ Отмененных:           3 000₽ (1 платеж)
└─ Возвращенных:         2 000₽ (1 возврат)
```

### Список транзакций

Для каждого платежа отображается:
- **Дата и время** - когда был создан/оплачен
- **Участник** - кто оплатил
- **Сумма** - размер платежа
- **Статус** - succeeded/pending/canceled
- **Способ оплаты** - карта/СБП/кошелек
- **ID платежа** - уникальный идентификатор ЮКасса

### Фильтрация

```
Фильтры:
├─ Статус: Все / Успешные / В ожидании / Отмененные
├─ Период: Выберите даты
├─ Соревнование: Выберите соревнование
└─ Способ оплаты: Все / Карта / СБП / Кошелек
```

### Экспорт отчетов

Доступные форматы:
- **Excel (XLSX)** - для бухгалтерии
- **CSV** - для импорта в другие системы
- **PDF** - для печати

**Содержание отчета:**
- Список всех транзакций
- Сумма по каждой
- Комиссия ЮКасса
- Чистая прибыль
- Итоговые суммы

## 💸 Комиссии

### Комиссия ЮКасса

Зависит от способа оплаты:

| Способ оплаты | Комиссия | Рекомендация |
|---------------|----------|--------------|
| СБП | 0.4% - 0.7% | ⭐ Лучший вариант! |
| Банковские карты | 2.8% - 3.5% | Популярный |
| ЮMoney | 2.8% | Средний |
| QIWI | 3.5% | Высокая |

```{admonition} Рекомендуем СБП!
:class: tip

Мотивируйте участников использовать СБП - это выгоднее для всех:
- Минимальная комиссия 0.4%
- Моментальное зачисление
- Доступно в большинстве банковских приложений
```

### Комиссия платформы ИКОН

Платформа взимает комиссию за использование:

**Тарифы:**
- **Базовый:** 5% от стоимости регистрации (мин. 50₽)
- **Профессиональный:** 3% (при >10 соревнований/год)
- **Корпоративный:** индивидуальные условия

**Что входит:**
- Неограниченное количество регистраций
- Техническая поддержка
- Автоматический лидерборд
- Уведомления участникам
- Хранение результатов

### Калькулятор комиссий

```python
# Пример расчета для регистрации 2500₽ через СБП
Стоимость участия:        2500₽
Комиссия ЮКасса (0.7%):    -18₽
Комиссия ИКОН (5%):       -125₽
──────────────────────────────
Вы получите:              2357₽
```

## 🔄 Возврат средств

### Политика возвратов

**Организатор сам определяет политику:**
- Полный возврат до определенной даты
- Частичный возврат (например, 50%)
- Без возврата

**Рекомендуем:**
```
- За 14+ дней: 100% возврат
- За 7-14 дней: 50% возврат
- Менее 7 дней: без возврата
```

### Процесс возврата

1. Участник отправляет запрос на возврат
2. Вы получаете уведомление
3. Проверяете причину и сроки
4. Принимаете решение:
   - **Одобрить** - возврат через ЮКасса
   - **Отклонить** - с указанием причины

**Как оформить возврат:**
1. Найдите регистрацию участника
2. Нажмите **"Отменить регистрацию"**
3. Выберите **"С возвратом средств"**
4. Укажите сумму возврата:
   - Полная (100%)
   - Частичная (укажите %)
5. Подтвердите возврат

```{warning}
Комиссия ЮКасса при возврате НЕ возвращается!
```

### Сроки возврата

- Возврат на карту: **3-10 рабочих дней**
- Возврат на ЮMoney: **1-3 рабочих дня**
- Возврат через СБП: **до 1 рабочего дня**

## 📈 Финансовая аналитика

### Общая выручка

График выручки с разбивкой:
```
Месяц       Регистрации    Выручка      Комиссии     Чистая
Январь      45             112 500₽     8 438₽       104 062₽
Февраль     67             167 500₽     12 563₽      154 937₽
Март        89             222 500₽     16 688₽      205 812₽
```

### Прогноз выручки

На основе динамики регистраций:
```
Текущие регистрации: 56
Прогноз до закрытия: 85
Ожидаемая выручка:   212 500₽
Чистая прибыль:      ~195 000₽
```

### Анализ по категориям

```
RX Men:      35 рег. × 3000₽ = 105 000₽ (49%)
Scaled Men:  28 рег. × 2500₽ =  70 000₽ (33%)
RX Women:    12 рег. × 3000₽ =  36 000₽ (17%)
Scaled Women: 8 рег. × 2500₽ =  20 000₽ ( 9%)
```

## 💼 Вывод средств

### Автоматический вывод

ЮКасса автоматически переводит средства на ваш расчетный счет:
- **Период:** ежедневно или еженедельно (настраивается)
- **Минимальная сумма:** 100₽
- **Комиссия за вывод:** 0₽

### График поступлений

```
Дата платежа   Дата зачисления   Сумма
15.03.2025  →  16.03.2025       15 000₽
16.03.2025  →  17.03.2025       22 500₽
17.03.2025  →  18.03.2025       18 000₽
```

### Документы для бухгалтерии

Доступны в личном кабинете ЮКасса:
- **Акт оказанных услуг** - ежемесячно
- **Счет-фактура** - по запросу
- **Реестр платежей** - ежедневно/еженедельно

## 📋 Отчетность для налоговой

### УСН (упрощенная система)

Для ИП и ООО на УСН:
1. Экспортируйте отчет за период
2. Сумма выручки = **чистая прибыль** (после комиссий)
3. Включите в книгу доходов

### ОСН (общая система)

Для ООО на ОСН:
1. Требуется счет-фактура от ЮКасса
2. НДС выделяется отдельно
3. Получите акт оказанных услуг

### Самозанятые

Для самозанятых (НПД):
1. Формируйте чек через приложение "Мой налог"
2. Укажите покупателя - участника
3. Отправьте чек участнику

## 🔒 Безопасность платежей

### Защита данных

- **PCI DSS** - сертификация ЮКасса
- **3D Secure** - подтверждение по SMS
- **Токенизация** - данные карт не хранятся
- **SSL/TLS** - шифрование всех данных

### Защита от мошенничества

ЮКасса автоматически:
- Проверяет карты на блеклист
- Блокирует подозрительные транзакции
- Требует подтверждение для крупных сумм

### Ваша ответственность

```{warning}
Организатор НЕ имеет доступа к:
- Полным номерам карт
- CVV кодам
- Другим банковским данным

Все обрабатывается на стороне ЮКасса!
```

## ❓ Частые вопросы

### Когда я получу деньги?

Средства поступают на ваш счет согласно настройкам вывода в ЮКасса (обычно на следующий день).

### Участник оплатил, но регистрация не подтверждена

1. Проверьте статус платежа в списке транзакций
2. Если статус "pending" - платеж еще обрабатывается (до 15 минут)
3. Если статус "succeeded" - свяжитесь с поддержкой

### Можно ли изменить цену после начала регистраций?

Да, но:
- Новая цена будет применяться только к **новым** регистрациям
- Уже оплатившие участники платят по старой цене

### Нужно ли заключать договор с платформой?

Да, договор оферты заключается автоматически при регистрации. Дополнительные документы для корпоративных клиентов - по запросу.

### Как получить детализацию для бухгалтерии?

1. Перейдите в **"Финансы" → "Отчеты"**
2. Выберите период
3. Скачайте отчет в формате Excel/CSV
4. Для официальных документов - запросите в ЮКасса

## 💡 Рекомендации

### 1. Настройте Early Bird цены

Стимулируйте ранние регистрации:
- Больше времени на подготовку
- Лучшее планирование бюджета
- Высокая конверсия

### 2. Продвигайте оплату через СБП

Преимущества:
- Минимальная комиссия (больше выручка)
- Быстрее зачисление
- Удобно для участников

### 3. Четко опишите политику возвратов

В описании соревнования укажите:
- Условия возврата
- Сроки для возврата
- Процент возврата

### 4. Отслеживайте метрики

Анализируйте:
- Конверсию регистраций в оплаты
- Динамику продаж
- Популярные способы оплаты
- Средний чек

## 🔗 См. также

- [Создание соревнования](create-competition.md) - настройка цен
- [Управление участниками](manage-participants.md) - обработка регистраций
- [Начало работы](getting-started.md) - первые шаги

## 📞 Поддержка

- **Email:** payments@ikong.ru
- **Telegram:** @ikong_payments
- **Поддержка ЮКасса:** help@yookassa.ru