Модуль «Выплаты самозанятым (Райффайзен)» для HyperFlow CMS автоматизирует легальные выплаты исполнителям со статусом самозанятого (СМЗ) через Систему быстрых платежей (СБП). Деньги уходят на телефон получателя, а чек ФНС формируется банком автоматически — вам не нужны отдельные сервисы фискализации и ручная отправка чеков.

Решение построено на Raif Pay Payout API и уже протестировано в production на платформе [franch-taxi.ru](https://franch-taxi.ru) — SaaS для таксопарков на HyperFlow CMS.



Для кого этот модуль

- такси- и delivery-платформам с водителями-курьерами на НПД;
- маркетплейсам и агрегаторам с самозанятыми исполнителями;
- франчайзинговым сетям с выплатами партнёрам-СМЗ;
- любым проектам на HyperFlow, где нужны автоматические выплаты + чеки ФНС без ручной работы бухгалтерии.



Что умеет модуль

1. Онбординг самозанятого через API
- Привязка исполнителя к мерчанту через `POST/GET /self-employed/v1/bindings`.
- Получатель подтверждает согласие в приложении «Мой налог».
- Статусы отслеживаются автоматически: `IN_PROGRESS` → `TAXPAYER_SUCCESSFULLY_BOUND`.
- Кэш статуса привязки хранится в БД — повторные проверки не нагружают API.

2. Профиль СМЗ в настройках пользователя
- ИНН, фамилия, имя, отчество — заполняются один раз в личном кабинете.
- Кнопка «Проверить статус СМЗ» — актуальный статус привязки к банку.
- При выплате данные подставляются автоматически, форма не перегружена полями.

3. Фiscal-выплата по СБП
- Запрос `POST /v2/payouts` с параметром `fiscal: true`.
- Перевод на номер телефона получателя — без реквизитов р/с.
- Комиссия платформы (если настроена) учитывается до отправки в банк.
- Защита от двойной отправки (CSRF + одноразовый submit-token).

4. Автоматический чек ФНС
- После успешной выплаты банк возвращает `receiptLink` — ссылку на чек.
- Ссылка сохраняется в журнале и доступна пользователю и администратору.
- Чек формирует банк-партнёр ФНС, не ваш сервер — соответствие 422-ФЗ без отдельной онлайн-кассы для выплат.

5. Webhook и финальные статусы
- Приём уведомлений `COMPLETED` / `DECLINED` от Raif Pay.
- Проверка подписи `X-Api-Signature-SHA256` (HMAC-SHA-256).
- In-app уведомление пользователю при исполнении или отклонении выплаты.
- При потере статуса СМЗ — отклонение с `TAXPAYER_UNREGISTERED`, баланс не списывается.

6. Админ-панель и журнал
- Страница «Выплаты» — фильтр по датам, канал «СМЗ», статусы, суммы.
- Колонка «Чек ФНС» — прямая ссылка на чек.
- В карточке