Платежи
Здесь отслеживаются все платежи — по бронированиям и продажам услуг. Онлайн-оплаты через провайдеров, наличные, банковские переводы, возвраты и чарджбэки.
Как работает оплата
Заголовок раздела «Как работает оплата»Онлайн-оплата (через сайт)
Заголовок раздела «Онлайн-оплата (через сайт)»- Гость бронирует номер на сайте
- Система создаёт платёж и перенаправляет гостя на страницу оплаты провайдера
- Гость оплачивает
- Провайдер уведомляет систему (webhook)
- Бронирование автоматически подтверждается
Платёж через админ-панель
Заголовок раздела «Платёж через админ-панель»Кнопка Записать платёж одна — для денег, которые приняли у стойки через провайдера, и для тех, что прошли мимо системы:
- Нажмите Записать платёж в списке платежей
- Выберите бронирование (поиск по номеру или имени гостя) — например, RST-2026-00288, Paul Koch
- Укажите сумму: под полем встанут подсказки «весь остаток», «предоплата N %» и «1 ночь», любую можно подставить в одно нажатие. В поле типа стоит «По сумме»: тип система определит при записи — по брони с предоплатой это «Доплата», сумма на весь остаток — «Полная оплата», меньше — «Предоплата». Тип можно выбрать и самому, а пункт «По сумме» в том же списке снова отдаёт выбор системе
- Выберите способ оплаты. Список делится на две группы:
- Принять сейчас — деньги проходят через подключённого провайдера объекта. «Код на экране»: гость наводит камеру телефона на QR-код. «Счёт на телефон»: гостю приходит запрос в приложение провайдера, номер берётся из брони и его можно поправить. «Код гостя»: гость показывает код из приложения, вы считываете его сканером. Какие из трёх способов доступны, зависит от провайдера; дата здесь не спрашивается — её ставит провайдер
- Отметить полученное — наличные, терминал, перевод и другие способы из справочника: оплата уже прошла мимо системы, укажите дату и время получения денег
- Нажмите Записать (для онлайн-способов — «Показать код гостю», «Отправить счёт» или «Списать по коду») — платёж встаёт первой строкой в списке, баланс бронирования обновляется
Если у объекта нет подключённого онлайн-провайдера, группы «Принять сейчас» не будет — вместо неё подсказка со ссылкой в настройки объекта → Способы оплаты.
Ожидание оплаты у стойки
Заголовок раздела «Ожидание оплаты у стойки»После онлайн-способа та же панель становится экраном ожидания: сумма крупно, QR-код в кольце-таймере и сколько ещё действует код (обычно 30 минут). Для счёта на телефон — карточка «Счёт отправлен на номер» с кнопками Отправить ещё раз и Показать код на экране: платёж при этом тот же, второй не создаётся.
- Развернуть гостю — панель на весь экран без служебных данных: объект, сумма, QR-код и одна фраза гостю. «Назад к панели» возвращает форму
- Оплачено — как только провайдер подтвердит оплату, панель покажет сумму, остаток по брони и ссылку на чек провайдера (если он его выдаёт) и закроется сама через несколько секунд
- Не оплачен, срок вышел — код перестал действовать, платёж закрыт как несостоявшийся; кнопка «Показать код заново» начнёт новый
- Провайдер отклонил платёж — на экране причина и что делать; платёж можно начать заново
- Свернуть — панель прячется, код продолжает действовать; Закрыть ожидание — гость передумал или платит наличными: платёж закрывается, форма снова принимает ручные способы. Перед закрытием система сверяется с провайдером — если гость уже успел заплатить, платёж не закроется, а покажет «Оплачено». Если гость уже начал оплату в Payme, кнопка серая до её завершения или отмены: у Payme на это до 12 часов, а вернуть дошедшую позже оплату можно только из кабинета Payme
Пока по брони ждём оплату, форма не даст записать по ней другой платёж — при открытии появится плашка «Ждём оплату … · код действует ещё …» с кнопками Открыть и Закрыть. Дождитесь оплаты, окончания срока или закройте ожидание. Если гость всё же оплатит по старому коду после закрытия, оплата попадёт в бронь — проверьте свод, прежде чем записывать наличные.
Провайдеры
Заголовок раздела «Провайдеры»| Провайдер | Описание |
|---|---|
| FreedomPay | Онлайн-эквайринг банковских карт (Visa, Mastercard, Apple Pay, Google Pay) |
| Kaspi | Оплата через Kaspi |
| Kaspi перевод | Перевод на личный Kaspi оператора — фиксируется вручную |
| Наличные | Оплата наличными — фиксируется вручную |
| Безналичный расчёт | Банковский перевод по реквизитам — фиксируется вручную |
| Тест | Тестовый провайдер (для проверки и разработки) |
В группе «Отметить полученное» — только ручные способы (Наличные, Kaspi перевод, Безналичный расчёт и другие из справочника). Онлайн-эквайер появляется в группе «Принять сейчас», если он подключён к объекту как способ оплаты; оплату он подтверждает сам.
Типы платежей
Заголовок раздела «Типы платежей»| Тип | Когда создаётся |
|---|---|
| Предоплата | Частичная оплата (например, 30%) при бронировании |
| Полная оплата | 100% стоимости бронирования |
| Доплата | Оставшаяся сумма после предоплаты |
| Допродажа | Оплата допродажи — услуги, проданной на стойке сверх бронирования |
| Возврат | Возврат средств при отмене или по запросу |
Статусы платежей
Заголовок раздела «Статусы платежей»| Статус | Значение |
|---|---|
| Ожидает | Платёж создан, ожидает действия гостя или оператора |
| Обработка | Платёж принят провайдером и обрабатывается |
| Выполнен | Оплата прошла успешно |
| Частичный возврат | Часть суммы платежа возвращена гостю |
| Возвращён | Платёж полностью возвращён |
| Ошибка | Попытка оплаты не удалась |
| Отменён | Платёж отменён до оплаты |
| Чарджбэк | Банк держателя карты принудительно вернул средства (оспаривание операции) |
Детали платежа
Заголовок раздела «Детали платежа»Нажмите на строку списка, чтобы открыть страницу платежа. Она собрана как единая история «сколько / когда учтено / откуда»:
- Сводка — сумма платежа, возвращённая сумма и остаток (если был частичный возврат)
- Учётная дата — дата фактического получения денег (
paidAt) и отчётный период (месяц), в котором платёж засчитан. Это поле определяет, в каком периоде платёж попадёт в отчёты - Способ оплаты — провайдер; для ручных платежей способ можно изменить прямо здесь
- Бронирование и гость — ссылки на бронирование и профиль гостя (с телефоном)
- Описание — примечание к платежу (редактируется)
- Код провайдера — идентификатор операции в системе эквайера (например,
pg_payment_idу FreedomPay), при наличии — ссылка в кабинет провайдера - Чек провайдера — ссылка на фискальный чек, если провайдер его выдаёт (например, Click или Payme в Узбекистане); у Payme после отмены появляется и чек возврата
- Хронология — события платежа во времени: создан, оплачен, ошибка, возврат, чарджбэк
- История изменений — журнал аудита по платежу (для аномальных статусов открыт сразу)
Учётная дата и платежи «задним числом»
Заголовок раздела «Учётная дата и платежи «задним числом»»Учётная дата (когда деньги фактически получены) может отличаться от даты создания записи. Если оператор после факта проставляет более раннюю дату — например, вписывает вчерашний приём наличных, — платёж может «уехать» в другой отчётный период.
Система подсвечивает такие платежи:
- В шапке детальной страницы появляется плашка «Задним числом · N дней»
- Под учётной датой показывается, насколько она раньше даты создания
- В списке платежей у такой записи стоит точка-маркер
- В окне «Фильтр» над списком есть переключатель «Только задним числом» — для бухгалтерского аудита учётной даты. Пока он включён, кнопка «Фильтр» и пилюля фильтра подсвечены тем же цветом, что и маркер
Платёж считается проставленным задним числом, если учётная дата раньше даты создания больше чем на сутки. Фильтр отбирает ровно те платежи, у которых стоит маркер.
Действия
Заголовок раздела «Действия»| Действие | Описание |
|---|---|
| Проверить статус | Запросить у провайдера актуальный статус платежа (для статусов «Ожидает» и «Обработка») |
| Сверить с FreedomPay | Сверить локальные данные о платеже и возвратах с данными провайдера |
| Возврат | Вернуть средства (полностью или частично) |
| Аннулировать | Отменить ошибочную ручную запись — например, записанную дважды (см. ниже) |
| Журнал аудита | Открыть полную историю изменений платежа (доступно администраторам организации) |
| Отметить как чарджбэк | Зафиксировать принудительный возврат средств банком (см. ниже) |
Если действие у платежа есть, но сейчас недоступно, кнопка погашена. Наведите на неё: подсказка назовёт причину и что сделать — например, «возврат уже в работе у эквайера, дождитесь его исхода» или «у вашей роли нет права, попросите владельца организации выдать его». Кнопок, которых у такого платежа не бывает (проверка статуса у наличных, возврат у платежа площадки), на странице нет.
Пока возврат передан эквайеру и ещё не проведён, в сводке стоит строка «Возврат передан эквайеру и ещё не проведён»: деньги пока у объекта, второй возврат и отметка чарджбэка недоступны. Как только эквайер ответит, возврат проведётся или отклонится сам; ускорить можно сверкой.
Аннулирование ошибочной записи
Заголовок раздела «Аннулирование ошибочной записи»Ручную запись (наличные, перевод, терминал), которую внесли по ошибке, не возвращают, а аннулируют: денег не было, возвращать гостю нечего.
- Нажмите Аннулировать в шапке платежа
- Укажите, почему запись ошибочная (обязательное поле) — например, «записали дважды»
- Подтвердите
Запись получает статус «Отменён» и перестаёт учитываться в кассе, отчётах и балансе брони. Если запись была разнесена по броням, разнесение снимется, и баланс каждой брони пересчитается. Если это оплата продажи услуги, продажа останется и станет неоплаченной — внесите правильную оплату заново.
Если этим платежом брони были оплачены допродажи «на счёт брони», они вернутся в «Ожидает» — кроме тех, что покрывают другие деньги брони: такие остаются оплаченными. Окно аннулирования заранее называет только допродажи, которые уйдут в «Ожидает».
Аннулировать можно только проведённую запись без возвратов. Если деньги действительно были и часть уже вернули гостю, оформите возврат остатка. Платёж через онлайн-провайдера не аннулируется — его деньги возвращаются только возвратом.
Сверка с FreedomPay
Заголовок раздела «Сверка с FreedomPay»Для платежей через FreedomPay доступна кнопка Сверить с FreedomPay. Она запрашивает у провайдера актуальное состояние платежа и возвратов и сравнивает его с данными системы.
Сверка проходит в два шага:
- Просмотр — система показывает, совпадают ли данные. Если нет — видно, какие возвраты есть у провайдера, но отсутствуют в системе (и наоборот)
- Применить — создаёт недостающие записи возвратов на основе данных провайдера и пересчитывает баланс бронирования
Это нужно, если возврат был сделан напрямую в личном кабинете провайдера, а в системе не отобразился. Сверка ничего не удаляет — только добавляет недостающие записи. Если данные уже совпадают, кнопка применения не появляется.
Чарджбэк (оспаривание платежа)
Заголовок раздела «Чарджбэк (оспаривание платежа)»Чарджбэк — это принудительный возврат средств, который инициирует банк держателя карты по жалобе клиента. FreedomPay не присылает уведомлений о чарджбэках — оператор узнаёт о них из письма от провайдера и фиксирует вручную.
Пометка чарджбэка доступна только для карточных платежей онлайн-провайдера (FreedomPay, PAYONE, Stripe) в статусе «Выполнен» или «Частичный возврат». У Click, Payme и OCTO банк держателя карты платёж не оспаривает — кнопка погашена с подсказкой; если деньги вернули гостю, оформите возврат. Пока по платежу идёт возврат у эквайера, отметка тоже погашена: дождитесь исхода возврата. Действие находится в блоке «Опасная зона» внизу страницы платежа:
- Нажмите Отметить
- Подтвердите галочкой, что получили email от провайдера об оспаривании
- Укажите причину или номер диспута (необязательно)
- Введите подтверждающее слово
CHARGEBACKи подтвердите
После этого:
- Статус платежа меняется на «Чарджбэк» (необратимо)
- Сумма платежа за вычетом уже возвращённого вычитается из предоплаты бронирования — бронь считается недоплаченной
- Действие фиксируется в журнале аудита
- Обычный возврат через провайдера становится недоступен
Когда платёж помечен чарджбэком, на странице появляется информационный блок с датой открытия диспута, датой разрешения (если есть) и причиной.
Редактирование платежа
Заголовок раздела «Редактирование платежа»В деталях платежа можно изменить:
- Способ оплаты — только для ручных платежей (наличные, Kaspi перевод, безналичный расчёт); меняется прямо в блоке способа оплаты
- Учётная дата — фактическая дата получения средств (определяет отчётный период)
- Описание — примечание к платежу
Способ оплаты онлайн-платежей изменить нельзя.
Возвраты
Заголовок раздела «Возвраты»Возврат можно оформить из деталей бронирования (вкладка «Платежи») или из деталей платежа:
- Нажмите кнопку Возврат у выполненного платежа (или частично возвращённого)
- Укажите сумму — кнопки-пресеты подставят полную сумму («Вся сумма») или сумму без оплаченных допродаж («Без допов»)
- Укажите причину (обязательное поле)
- Нажмите Подтвердить возврат
Если сумма возврата затрагивает оплаченные допродажи, система предупредит об этом: статус допродаж при возврате не меняется автоматически — это нужно проверить вручную и подтвердить галочкой.
Система:
- Инициирует возврат через провайдера (для онлайн-платежей)
- Обновит баланс бронирования (предоплату и остаток)
- Зафиксирует возврат в хронологии платежа
Связь с бронированием и продажами
Заголовок раздела «Связь с бронированием и продажами»Платёж может быть привязан к бронированию, к продаже услуги или к обоим.
Платежи по бронированиям влияют на статус:
| Событие | Результат |
|---|---|
| Оплачено не меньше предоплаты объекта | Бронирование «Ждёт оплаты» → «Подтверждён», остаток доплачивается по плану |
| Оплачено меньше предоплаты объекта | Статус не меняется — бронь ждёт оплаты |
| Оплата по уже отменённой брони | Статус не меняется — бронь попадает в «Требует внимания» → «Оплата после отмены» |
| Полный возврат | Статус не меняется — у брони появляется отметка «Средства возвращены» |
Платежи по продажам услуг создаются автоматически при оформлении продажи или вручную через детали продажи.
Фильтры
Заголовок раздела «Фильтры»Над списком одна строка: поиск, «Дата платежа» и кнопка «Фильтр», справа — число платежей, настройка колонок и плотность таблицы. Остальные фильтры собраны в окне «Фильтр». Число на кнопке показывает, сколько условий выбрано, а «Сбросить всё» внизу окна снимает их разом.
| Фильтр | Где | Описание |
|---|---|---|
| Поиск | В строке | По номеру бронирования, имени гостя или ID платежа |
| Дата платежа | В строке | Диапазон дат |
| Статус | «Фильтр» | Ожидает, Обработка, Выполнен, Частичный возврат, Возвращён, Ошибка, Отменён, Чарджбэк |
| Провайдер | «Фильтр» | FreedomPay, Kaspi, Kaspi перевод, Наличные, Безналичный расчёт, Тест |
| Тип | «Фильтр» | Предоплата, Полная оплата, Доплата, Допродажа |
| Сумма | «Фильтр» | Минимальная и максимальная сумма |
| Только задним числом | «Фильтр» | Только платежи, у которых учётная дата раньше даты создания |
Список можно сортировать по столбцам. Активные фильтры показываются пилюлями над списком — их можно снимать по одному или сбросить все сразу.