Платежи

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

Платежи

Как работает оплата

Онлайн-оплата (через сайт)

1. Гость бронирует номер на сайте
2. Система создаёт платёж и перенаправляет гостя на страницу оплаты провайдера
3. Гость оплачивает
4. Провайдер уведомляет систему (webhook)
5. Бронирование автоматически подтверждается

Ручной платёж (через админ-панель)

Для оплаты наличными, Kaspi-переводом или банковским переводом:

1. Нажмите Записать платёж в списке платежей
2. Выберите бронирование (поиск по номеру или имени гостя), укажите тип, сумму, способ оплаты, дату получения денег и при необходимости описание
3. Платёж фиксируется, баланс бронирования обновляется

Подсказка по сумме

Если открыть форму платежа из деталей бронирования, система подскажет остаток к оплате — его можно подставить в одно нажатие. Если введённая сумма больше остатка по брони, появится мягкое предупреждение (но создать платёж всё равно можно — это может быть оплата за другую бронь того же гостя).

Провайдеры

Провайдер	Описание
FreedomPay	Онлайн-эквайринг банковских карт (Visa, Mastercard, Apple Pay, Google Pay)
Kaspi	Оплата через Kaspi
Kaspi перевод	Перевод на личный Kaspi оператора — фиксируется вручную
Наличные	Оплата наличными — фиксируется вручную
Безналичный расчёт	Банковский перевод по реквизитам — фиксируется вручную
Тест	Тестовый провайдер (для проверки и разработки)

При ручной записи платежа доступны только способы Наличные, Kaspi перевод и Безналичный расчёт — онлайн-эквайеры (FreedomPay, Kaspi) подключаются только через сайт и webhook.

Настройка провайдеров

Подключение и настройка платёжных провайдеров (ключи доступа, режимы TEST / LIVE, юридические профили организации) выполняются на уровне организации — в разделе настроек «Платёжные провайдеры». Какие способы оплаты видит гость на сайте — настраивается отдельно для каждого проекта.

Типы платежей

Тип	Когда создаётся
Предоплата	Частичная оплата (например, 30%) при бронировании
Полная оплата	100% стоимости бронирования
Доплата	Оставшаяся сумма после предоплаты
Допродажа	Оплата дополнительных услуг сверх бронирования
Возврат	Возврат средств при отмене или по запросу

Статусы платежей

Статус	Значение
Ожидает	Платёж создан, ожидает действия гостя или оператора
Обработка	Платёж принят провайдером и обрабатывается
Выполнен	Оплата прошла успешно
Частичный возврат	Часть суммы платежа возвращена гостю
Возвращён	Платёж полностью возвращён
Ошибка	Попытка оплаты не удалась
Отменён	Платёж отменён до оплаты
Чарджбэк	Банк держателя карты принудительно вернул средства (оспаривание операции)

Детали платежа

Детали платежа

Страница платежа собрана как единая история «сколько / когда учтено / откуда»:

• Сводка — сумма платежа, возвращённая сумма и остаток (если был частичный возврат)
• Учётная дата — дата фактического получения денег (paidAt) и отчётный период (месяц), в котором платёж засчитан. Это поле определяет, в каком периоде платёж попадёт в отчёты
• Способ оплаты — провайдер; для ручных платежей способ можно изменить прямо здесь
• Бронирование и гость — ссылки на бронирование и профиль гостя (с телефоном)
• Описание — примечание к платежу (редактируется)
• Код провайдера — идентификатор операции в системе эквайера (например, pg_payment_id у FreedomPay), при наличии — ссылка в кабинет провайдера
• Хронология — события платежа во времени: создан, оплачен, ошибка, возврат, чарджбэк
• История изменений — журнал аудита по платежу (для аномальных статусов открыт сразу)

Учётная дата и платежи «задним числом»

Учётная дата (когда деньги фактически получены) может отличаться от даты создания записи. Если оператор после факта проставляет более раннюю дату — например, вписывает вчерашний приём наличных, — платёж может «уехать» в другой отчётный период.

Система подсвечивает такие платежи:

• В шапке детальной страницы появляется плашка «Задним числом · N минут / часов / дней»
• Под учётной датой показывается, насколько она раньше даты создания
• В списке платежей у такой записи стоит точка-маркер
• В тулбаре списка есть фильтр «Задним числом» — для бухгалтерского аудита учётной даты

Платёж считается проставленным задним числом, если учётная дата раньше даты создания более чем на минуту.

Действия

Действие	Описание
Проверить статус	Запросить у провайдера актуальный статус платежа (для статусов «Ожидает» и «Обработка»)
Сверить с FreedomPay	Сверить локальные данные о платеже и возвратах с данными провайдера
Возврат	Вернуть средства (полностью или частично)
Журнал аудита	Открыть полную историю изменений платежа (доступно администраторам организации)
Отметить как чарджбэк	Зафиксировать принудительный возврат средств банком (см. ниже)

Сверка с FreedomPay

Для платежей через FreedomPay доступна кнопка Сверить с FreedomPay. Она запрашивает у провайдера актуальное состояние платежа и возвратов и сравнивает его с данными системы.

Сверка проходит в два шага:

1. Просмотр — система показывает, совпадают ли данные. Если нет — видно, какие возвраты есть у провайдера, но отсутствуют в системе (и наоборот)
2. Применить — создаёт недостающие записи возвратов на основе данных провайдера и пересчитывает баланс бронирования

Это нужно, если возврат был сделан напрямую в личном кабинете провайдера, а в системе не отобразился. Сверка ничего не удаляет — только добавляет недостающие записи. Если данные уже совпадают, кнопка применения не появляется.

Чарджбэк (оспаривание платежа)

Чарджбэк — это принудительный возврат средств, который инициирует банк держателя карты по жалобе клиента. FreedomPay не присылает уведомлений о чарджбэках — оператор узнаёт о них из письма от провайдера и фиксирует вручную.

Пометка чарджбэка доступна только для карточных платежей (FreedomPay, Kaspi) в статусе «Выполнен» или «Частичный возврат». Действие находится в блоке «Опасная зона» внизу страницы платежа:

1. Нажмите Отметить
2. Подтвердите галочкой, что получили email от провайдера об оспаривании
3. Укажите причину или номер диспута (необязательно)
4. Введите подтверждающее слово CHARGEBACK и подтвердите

После этого:

• Статус платежа меняется на «Чарджбэк» (необратимо)
• Сумма платежа за вычетом уже возвращённого вычитается из предоплаты бронирования — бронь считается недоплаченной
• Действие фиксируется в журнале аудита
• Обычный возврат через провайдера становится недоступен

Когда платёж помечен чарджбэком, на странице появляется информационный блок с датой открытия диспута, датой разрешения (если есть) и причиной.

Действие необратимо

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

Редактирование платежа

В деталях платежа можно изменить:

• Способ оплаты — только для ручных платежей (наличные, Kaspi перевод, безналичный расчёт); меняется прямо в блоке способа оплаты
• Учётная дата — фактическая дата получения средств (определяет отчётный период)
• Описание — примечание к платежу

Способ оплаты онлайн-платежей изменить нельзя.

Возвраты

Возврат можно оформить из деталей бронирования (вкладка «Платежи») или из деталей платежа:

1. Нажмите кнопку Возврат у выполненного платежа (или частично возвращённого)
2. Укажите сумму — кнопки-пресеты подставят полную сумму («Вся сумма») или сумму без оплаченных допуслуг («Без допов»)
3. Укажите причину (обязательное поле)
4. Подтвердите

Частичный возврат

Можно вернуть не всю сумму платежа, а только часть. К возврату доступна сумма платежа за вычетом уже возвращённого. Баланс бронирования пересчитается автоматически.

Если сумма возврата затрагивает оплаченные допродажи, система предупредит об этом: статус допуслуг при возврате не меняется автоматически — это нужно проверить вручную и подтвердить галочкой.

Система:

• Инициирует возврат через провайдера (для онлайн-платежей)
• Обновит баланс бронирования (предоплату и остаток)
• Зафиксирует возврат в хронологии платежа

Связь с бронированием и продажами

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

Платежи по бронированиям влияют на статус:

Событие	Результат
Полная оплата поступила	Бронирование → Подтверждено
Частичная оплата	Бронирование → Частично оплачен
Полный возврат	Бронирование → Ожидает оплаты

Платежи по продажам услуг создаются автоматически при оформлении продажи или вручную через детали продажи.

Фильтры

Фильтр	Описание
Поиск	По номеру бронирования, имени гостя или ID платежа
Статус	Ожидает, Обработка, Выполнен, Частичный возврат, Возвращён, Ошибка, Отменён, Чарджбэк
Провайдер	FreedomPay, Kaspi, Kaspi перевод, Наличные, Безналичный расчёт, Тест
Тип	Предоплата, Полная оплата, Доплата, Допродажа
Даты	Диапазон дат
Сумма	Минимальная и максимальная сумма
Задним числом	Только платежи, у которых учётная дата раньше даты создания

Список можно сортировать по столбцам, настраивать видимость колонок и плотность таблицы. Активные фильтры показываются пилюлями над списком — их можно снимать по одному или сбросить все сразу.

Права доступа

Доступ к платежам разграничен по ролям: просмотр списка и деталей, ручная запись платежа, возвраты и чарджбэки, сверка с провайдером — отдельные права. Если какого-то действия нет на экране, у вашей роли нет соответствующего разрешения.