Фінанси Babunia

Зміст

Посібник користувача: способи оплати й платіжні системи, як рухаються гроші бронювання між клієнтом, виконавцем і платформою, що бачить і робить кожен - клієнт (оплата і платежі в профілі), виконавець (гаманець і виплати), адміністратор (усі платежі, повернення, повторне списання, комісія платформи, виплати, довідники). Застосунок для компаній не розглядається.

1. Фінанси: як рухаються гроші
   • 1.1. Де знаходиться
   • 1.2. Способи оплати й платіжні системи
   • 1.3. Гроші одного бронювання
   • 1.4. Статуси платежу
2. Фінанси для клієнта
   • 2.1. Гаманець
   • 2.2. Способи оплати
   • 2.3. Запросити повернення
   • 2.4. Сповіщення
3. Фінанси для виконавця
   • 3.1. Гаманець
   • 3.2. Запит на виплату
4. Фінанси в адмін-панелі
   • 4.1. Огляд
   • 4.2. Платежі: повернення і повторне списання
   • 4.3. Транзакції гаманців
   • 4.4. Запити на виплату
   • 4.5. Довідники платежів
   • 4.6. Рахунки агенціям (заплановано)
5. Виправлено під час підготовки документа та відкриті питання
   • 5.1. Виправлено
   • 5.2. Відкриті питання (потрібне рішення)

1. Фінанси: як рухаються гроші

Клієнт платить за бронювання карткою (через сторінку платіжної системи) або готівкою виконавцю. Платформа бере з кожного оплаченого бронювання свою комісію, а решта — заробіток виконавця — накопичується в його гаманці, доки він не попросить виплату. Адміністратор бачить усі гроші платформи, повертає кошти клієнтам, повторно списує неоплачене, виплачує виконавцям без компанії й веде довідники платежів.

1.1. Де знаходиться

1.2. Способи оплати й платіжні системи

Повернення завжди йде через ту платіжну систему, якою платили, навіть якщо налаштування змінили пізніше. Валюта платежів — EUR.

1.3. Гроші одного бронювання

Приклад пізнього скасування. Клієнт сплатив передоплату 100 EUR і скасував за 6 годин до початку. За правилами послуги йому повертається 50% — 50 EUR. Решта 50 EUR лишається неповерненою й ділиться за «Часткою платформи при пізньому скасуванні» (за замовчуванням 50%): 25 EUR отримує виконавець як компенсацію за зірваний час, 25 EUR лишається платформі. Обидві суми записуються: виконавцю — у гаманець, платформі — окремим рухом, який адміністратор бачить в «Огляді» (картки «Частка платформи при скасуванні» і «Дохід платформи») і в «Транзакції гаманців» (4.1, 4.3).

Комісія задається для кожної послуги в «Каталог послуг»: відсоток від ціни, фіксована сума або підписка (поки не стягується). Там же «Частка платформи при пізньому скасуванні» і «Борг, що блокує»: якщо від'ємний баланс виконавця сягає цієї суми, нові заявки на цю послугу йому недоступні, доки не покриє борг. Поточні ставки видно в «Фінанси» → «Огляд» (4.1).

1.4. Статуси платежу

2. Фінанси для клієнта

Клієнт лише платить: карткою на сторінці платіжної системи або готівкою виконавцю. Як платити передоплату, залишок і що повертається при скасуванні — посібник «Бронювання». Усі свої гроші клієнт бачить у гаманці — так само, як виконавець.

2.1. Гаманець

«Мій профіль» → «Профіль користувача» → вкладка «Гаманець» (туди ж веде старе посилання /payments). Баланс (реферальні винагороди) і всі рухи грошей, нові вгорі, з фільтром «Сьогодні / Тиждень / Місяць / Рік / Довільний період»:

Невдала спроба оплати в гаманець не потрапляє — гроші тоді не списано. Оплата карткою йде з картки, а не з балансу гаманця, тому баланс від неї не змінюється.

2.2. Способи оплати

Вкладка «Способи оплати» (стара адреса /payment-methods веде сюди): таблиця збережених карток.

• Зліва — «Додати картку»: відкриває сторінку платіжної системи. Після повернення профіль сам відкривається на цій вкладці з новою карткою.
• Фільтри: «Останні цифри картки» і тип картки (VISA, MASTERCARD…), «Очистити фільтри». Пошук, сортування (картка, «Діє до», «Додано») і сторінки (10 / 25 / 50) працюють на сервері.
• Колонки: картка, «Діє до» (прострочену позначено червоним), «Додано», «Основна».
• Дії: зірочка — «Зробити основною», кошик — «Видалити» (з підтвердженням «Видалити картку VISA **** 4242? Оплачувати нею вже не вийде.»).

Основну картку адміністратор використовує для повторного списання, якщо оплата бронювання не пройшла (4.2).

Оплата збереженою карткою. На сторінці бронювання кнопка «Сплатити передоплату …» / «Сплатити …»:

• немає збережених карток — сторінка платіжної системи, як і раніше;
• одна картка — під кнопкою «Буде списано з картки VISA **** 4242.»; натискання одразу списує з неї (без сторінки платіжної системи) → «Оплачено карткою VISA **** 4242», бронювання переходить у «Підтверджено» / «Оплачено». Поруч — «Оплатити іншою карткою» (сторінка платіжної системи);
• кілька карток — додатковий крок «Чим оплатити»: список карток (основна вибрана наперед) і «Нова картка (сторінка платіжної системи)» → «Оплатити».

Якщо банк відхилив картку — повідомлення «Банк відхилив оплату цією карткою. Спробуйте іншу картку.», бронювання чекає оплати далі; в історії платежу — «Неуспішно». Успішна оплата в історії платежу (адмінка, 4.2) — «Сплачено збереженою карткою (клієнт)».

2.3. Запросити повернення

Гроші при скасуванні повертаються самі (за правилами послуги). Будь-яке інше повернення — через підтримку: на сторінці бронювання під платежами кнопка «Запросити повернення» (видно, поки за картковим платежем є що повертати). Вона відкриває форму нового звернення, вже заповнену: тема «Повернення коштів за бронювання BK-…», категорія «Оплата», опис із номером платежу й сумою — клієнт дописує причину й надсилає. Звернення потрапляє в чергу підтримки; адміністратор повертає гроші в «Фінанси» → «Платежі» (4.2). Мобільний застосунок створює таке саме звернення одразу (POST /clients/payments/my-payments/:id/refund-request).

2.4. Сповіщення

3. Фінанси для виконавця

Виконавець отримує гроші в гаманець і просить виплату на свій банківський рахунок. Виконавцю, який працює в компанії, виплачує компанія; виконавцю без компанії — адміністратор платформи (4.4).

3.1. Гаманець

«Мій профіль» → «Профіль користувача» → «Гаманець»: баланс і всі рухи коштів з фільтром «Сьогодні / Тиждень / Місяць / Рік / Довільний період». Тип і опис — мовою виконавця:

Від'ємний баланс — це борг за комісію з готівкових бронювань; він покривається наступними картковими бронюваннями.

3.2. Запит на виплату

«Мій профіль» → «Запит на виплату» або кнопка «Запит на виплату» в гаманці. Угорі — «Доступний баланс» і кнопка «Запросити виплату». Вона відкриває вікно: баланс, рахунок, на який прийдуть гроші (банк та IBAN з «Налаштування» → «Реквізити для виплат»; якщо їх немає — посилання на налаштування, надіслати запит не можна), поле «Сума» (за замовчуванням увесь баланс, більше не дозволить) і «Надіслати запит». Одночасно може чекати лише один запит — тоді кнопка неактивна з підказкою «Запит уже очікує розгляду».

«Історія виплат» — таблиця: дата, сума, статус («Очікує», «Виплачено», «Відхилено», «Скасовано»), примітка (дата виплати або причина відхилення від адміністратора) і «Скасувати запит» для запиту, що ще очікує (наприклад, помилилися із сумою). Після «Виплачено» сума списується з гаманця; сторінка оновлюється сама.

Коли адміністратор виплатив або відхилив запит, виконавцю приходить сповіщення: у дзвіночку («60.00 EUR переказано на ваш рахунок» або «Запит на виплату … відхилено: причина») і push у мобільний застосунок. Клік по сповіщенню відкриває гаманець.

4. Фінанси в адмін-панелі

Меню «Фінанси»: «Огляд», «Платежі», «Транзакції гаманців», «Запити на виплату», «Довідники платежів». Розділ видно ролям, яким дано модуль «Платежі» (суперадміністратор — за замовчуванням); перегляд — право читання, повернення, списання, виплати й зміни довідників — право редагування.

4.1. Огляд

Гроші платформи за період: «Сьогодні», «7 днів», «Цей місяць» (за замовчуванням), «Цей рік», «За весь час» або «Свій період».

Нижче — «Комісія за послугами»: для кожної активної послуги комісія (відсоток, фіксована сума, «не задано»), частка платформи при пізньому скасуванні й борг, що блокує. Змінюються в «Каталог послуг» (посилання «Змінити в каталозі послуг»).

4.2. Платежі: повернення і повторне списання

Усі платежі всіх клієнтів, нові вгорі: платіж і дата, бронювання й за що, клієнт → виконавець, сума (і скільки повернуто), спосіб (картка •••• 4242, платіжна система), статус. Фільтри: статус, спосіб, номер бронювання, період. Кнопка-око відкриває платіж: усі дані, номер транзакції в платіжній системі, помилка банку (якщо є) та «Історія статусів» — коли, з якого статусу в який, хто змінив (платіжна система, адміністратор…) і причина.

Автоматичні повернення при скасуванні бронювання (за правилами послуги) робить система сама — адміністратору нічого натискати не треба; вони теж видно тут і в історії платежу.

4.3. Транзакції гаманців

Усі рухи коштів у гаманцях усіх користувачів: дата, чий гаманець (посилання на профіль виконавця / клієнта), тип, опис мовою адміністратора, сума (+ зелена, − червона), баланс після. Фільтри: тип (наприклад, «Комісія платформи» — усі комісії), власник (виконавець / клієнт / компанія), ID користувача, період.

Дохід платформи від пізніх скасувань тут теж видно окремими рядками: «Чий гаманець» — «Платформа», тип «Частка платформи за скасування», опис «Частка платформи за скасоване бронювання BK-…». Поруч — компенсація виконавцю за те саме бронювання. Щоб побачити лише їх, оберіть у фільтрі тип «Частка платформи за скасування».

Гаманець конкретної людини — також у її профілі («Керування користувачами» → «Клієнти платформи» / «Виконавці платформи» → вкладка «Гаманець»): той самий список, що бачить вона сама (у клієнта — оплати бронювань і повернення, у виконавця — заробіток, комісія, виплати). Там же «Поповнити» / «Списати» — ручне коригування з типом і описом (посібник «Мій профіль»).

4.4. Запити на виплату

Запити виконавців без компанії (виконавцям компаній платить компанія у своєму застосунку). Фільтр «Очікує» (за замовчуванням), «Виплачено», «Відхилено», «Скасовано», «Усі». У рядку: дата, виконавець (посилання на профіль, email), банк і IBAN з його налаштувань, сума, поточний баланс гаманця (червоний, якщо менший за суму).

1. Перекажіть суму на IBAN банківським переказом.
2. «Виплачено» → за бажанням «Номер переказу» → «Гроші переказано - позначити виплаченим». Сума списується з гаманця виконавця («Виплата #N»), запит — «Виплачено», номер переказу видно в рядку. Якщо на балансі вже не вистачає — помилка, нічого не списано.

«Відхилити» — з причиною (щонайменше 3 символи), її бачить виконавець. Гаманець не змінюється.

Фільтри (усі на сервері, разом зі сторінками 10 / 20 / 50 / 100): статус, «ID виконавця», «Період» (дата запиту, обидва дні включно), «Сума від» / «Сума до»; «Очистити фільтри».

Кілька запитів одразу. Позначте рядки галочками (галочка в заголовку — уся сторінка). Над таблицею з'являється панель: «Вибрано: N на суму X», а якщо за фільтром запитів більше, ніж на сторінці, — «Вибрати всі N за фільтром» (до 1000). Вибір зберігається при переході між сторінками.

• «Позначити виплаченими (k)» — k = запити «Очікує» серед вибраних (інші пропускаються). Вікно показує список (виконавець, IBAN, сума) і загальну суму, один «Номер переказу» для всіх. Кожен запит обробляється окремо: списання з гаманця, статус «Виплачено», сповіщення виконавцю. Підсумок: «Запитів: 2, на суму …». Якщо якийсь не вдалося (наприклад, на балансі вже не вистачає), відкривається список «Не всі запити оброблено» з причиною для кожного; решта оброблені.
• «Відхилити (k)» — одна причина для всіх вибраних запитів «Очікує».
• «Зняти вибір».

Експорт в Excel (.xlsx): якщо щось вибрано — «Експорт вибраних в Excel», інакше «Експорт в Excel» — усі запити за поточним фільтром (до 1000). Колонки: ID, дата запиту, виконавець, email, банк, IBAN, сума, валюта, статус, дата обробки, примітка (номер переказу або причина відхилення); останній рядок — «Разом».

4.5. Довідники платежів

Вкладки: «Способи оплати», «Статуси платежів», «Типи платежів», «Типи рухів гаманця», «Типи транзакцій», «Хто змінив статус». У кожному записі: код (за ним працює система, не змінюється), як показується в панелі, збережена назва, опис, порядок. Олівець — змінити збережену назву (її показують мобільні застосунки й місця без перекладу), опис і порядок. Способи оплати можна вимикати й вмикати: вимкнений більше не пропонується; готівка й корпоративний рахунок увімкнені «завжди». Статуси й типи не вимикаються — на них спирається логіка платежів.

4.6. Рахунки агенціям (заплановано)

Виставлення рахунків агенціям за роботу на платформі ще не налаштоване для бронювань. У бекенді є модуль рахунків (створення, надсилання, PDF, оплата, прострочені) з часів таксі-платформи — його буде адаптовано, коли з'являться агенції.

5. Виправлено під час підготовки документа та відкриті питання

Фінанси клієнта, виконавця й адміністратора пройдено в браузері, кожна дія перевірена в базі: Playwright frontend-tests/e2e/finance/finance-guide.spec.ts, API — backend-tests/api/admin-finance/test-admin-finance.ps1. На продакшн виправлення потраплять з наступним деплоєм.

5.1. Виправлено

5.2. Відкриті питання (потрібне рішення)

• Продакшн у тестовому режимі. Ключі LiqPay (sandbox) на продакшні є; з 2026-11-07 там PAYMENT_GATEWAY_TEST_MODE=true — оплата йде через тестову сторінку без грошей. Перед запуском: false, бойові ключі LiqPay, LIQPAY_SANDBOX=false і налаштування головної компанії payment_gateway = liqpay (без нього — Stripe, ключа якого немає).
• Рахунки агенціям — заплановано (4.6).
• Збережені назви в довідниках англійською (мобільні застосунки показують їх як є).