Портал клієнта та поширення

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

Що робить портал:

• Публічний перегляд рахунка — посилання на основі токена відкриває рахунок у браузері. Без входу, без пароля, без перешкод для клієнта.
• Завантаження PDF — клієнт завантажує піксельно точний PDF формату A4 свого рахунка одним кліком.
• Онлайн-платіж (Pro) — кнопка «Оплатити зараз» веде клієнта до безпечного оформлення Stripe для повної чи часткової оплати.
• Відстеження переглядів — кожне відкриття журналюється: коли, звідки, кількість переглядів і позначка часу першого/останнього перегляду.
• Налаштування email — відписка в один клік і детальний контроль над тим, які листи отримує клієнт.

Два типи посилань:

• Посилання на один рахунок (/invoice/{token}) — показує один конкретний рахунок із його повними деталями та дією завантаження/оплати.
• Посилання на портал клієнта (/portal/{token}) — уніфікований перегляд останніх рахунків клієнта, його загального непогашеного балансу, будь-якої позначки прострочення та балансу кредит-нот, кожен рахунок зі своєю дією оплати.

Тарифи: Публічний перегляд, завантаження PDF, відстеження переглядів і керування налаштуваннями email доступні в кожному тарифі. Онлайн-платіж із порталу потребує тарифу Pro із підключеним Stripe.

Кожна сторінка порталу брендована назвою та логотипом вашого бізнесу, несе тихий нижній колонтитул "Powered by Invotify" і позначена noindex, тож ніколи не з'являється в пошукових системах.

Поширення рахунка створює унікальний, важко вгадуваний токен поширення та перетворює його на публічне посилання, яке ваш клієнт може відкрити без входу. Токен — це випадковий UUID, його не можна вгадати, збільшуючи число, і він зіставляється рівно з одним рахунком.

Як працює токен поширення:

• Генерація посилання створює share_token для рахунка та повертає URL-адресу виду https://your-app/invoice/{token}.
• Якщо токен для цього рахунка вже існує, Invotify повертає той самий — повторне поширення не змінить посилання та не зламає URL, який ви вже надіслали.
• Посилання — єдиний реквізит доступу. Будь-хто з ним може переглянути рахунок, тож ставтеся до нього як до приватного посилання.
• Ви можете відкликати посилання поширення будь-коли. Відкликання очищає токен, і стара URL негайно припиняє працювати (повертає «не знайдено»). Згенеруйте свіже посилання, щоб поділитися знову.

Дозволи: Генерація чи відкликання посилання поширення потребує дозволу «Керування рахунками», тож лише авторизовані учасники команди можуть розкрити рахунок.

Що отримує клієнт: Коли ви надсилаєте рахунок електронною поштою, посилання (а в Pro — платіжне посилання) може супроводжувати його. Ви також можете скопіювати URL поширення та надіслати його будь-яким каналом — чатом, вашим власним поштовим клієнтом, месенджером.

Поширення PDF у WhatsApp, Telegram, Slack тощо: Діалог поширення на рахунках і пропозиціях передає відображений PDF прямо в панель поширення вашого пристрою (на телефонах, планшетах і сучасних настільних браузерах). Торкніться WhatsApp, Telegram, Slack чи Messenger, і PDF уже прикріплено — виберіть одержувача та надішліть. У браузерах без підтримки файлів у панелі поширення Invotify повертається до завантаження PDF і відкривання застосунку, щоб ви могли прикріпити його вручну.

Коли клієнт відкриває посилання поширення, він потрапляє на чисту, зручну для мобільних сторінку, що не потребує входу. Є два варіанти досвіду залежно від посилання.

Сторінка одного рахунка (`/invoice/{token}`): Клієнт бачить повний рахунок — назву та логотип вашого бізнесу, номер і статус рахунка, дати видачі та оплати, платіжні дані, кожну позицію з кількостями та підсумками та будь-які додані вами нотатки. Унизу — дії: - Завантажити PDF — генерує та завантажує професійний PDF формату A4, ідентичний тому, що ви надіслали б. Генерується на стороні сервера на вимогу. - Оплатити зараз — з'являється, лише коли платіжне посилання доступне та рахунок ще не оплачено й не скасовано (Pro — див. «Онлайн-платіж» нижче).

Уніфікована сторінка порталу (`/portal/{token}`): Огляд у стилі панелі керування для клієнта по всіх його рахунках із вами: - Непогашений баланс — загальна сума, що досі винна за всіма неоплаченими рахунками (не лише за тим, який він відкрив), із позначкою прострочення, якщо якісь минули термін. - Баланс кредит-нот — будь-який виданий чи застосований кредит, який він має. - Список рахунків — його останні нечернеткові рахунки, розбиті на сторінки, кожен показує номер, дати, статус, суму та дію оплати.

Конфіденційність за дизайном: Портал завжди повертає лише безпечну підмножину даних. Внутрішні ID, сам токен поширення та все, не пов'язане з цим клієнтом, прибираються з відповіді. Уніфікований портал суворо обмежується одним клієнтом, якому належить токен. Відповіді порталу надсилаються з кешуванням no-store, тож ніщо чутливе не кешується посередниками.

У тарифі Pro з підключеним Stripe портал перетворює перегляд на платіж. Клієнт натискає «Оплатити зараз» і потрапляє на безпечне розміщене оформлення Stripe — Invotify ніколи не торкається даних його картки.

Як проходить платіж із порталу: 1. Клієнт відкриває свій рахунок чи уніфікований портал і натискає «Оплатити». 2. Invotify створює сесію Stripe Checkout для цього рахунка та перенаправляє клієнта до неї. 3. Клієнт платить на розміщеній сторінці Stripe. Його email попередньо заповнено для швидшого оформлення. 4. У разі успіху його повертають на сторінку підтвердження; якщо він скасовує, він плавно повертається назад. 5. Stripe підтверджує платіж, і статус рахунка автоматично оновлюється на «Оплачено».

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

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

Важливо: Онлайн-платіж потребує тарифу Pro та підключеного облікового запису Stripe. Без підключеного Stripe портал усе ще працює для перегляду та завантаження — просто немає кнопки «Оплатити».

Перестаньте гадати, чи ваш клієнт справді відкрив рахунок. Щоразу, коли поширений рахунок переглядається, Invotify це записує — тож ви точно знаєте, коли він його побачив, скільки разів і звідки.

Що записується при кожному перегляді: - Позначка часу — коли відбувся перегляд. - Джерело — звідки прийшов перегляд: link (поширене посилання на один рахунок), email, portal чи api. За замовчуванням link. - IP переглядача — IP-адреса клієнта (розібрана із заголовка пересилання), тож ви можете відрізнити повторні відкриття з того самого місця від нових. - User-agent — рядок браузера/пристрою, скорочений до безпечної довжини.

Агреговану статистику Invotify зберігає для кожного рахунка: - Кількість переглядів — поточний підсумок відкриттів. - Уперше переглянуто — точно, коли рахунок уперше відкрили (позначається один раз, ніколи не перезаписується). - Востаннє переглянуто — найновіше відкриття. - Унікальні IP — скільки окремих IP-адрес його переглянули.

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

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

Кожен лист, який Invotify надсилає клієнту, несе посилання відписки / налаштувань, тож клієнти завжди контролюють те, що потрапляє в їхню скриньку. Посилання працює без жодного входу — сам токен відписки підтверджує право власності на адресу електронної пошти.

Що клієнти можуть контролювати: - Листи з документами — рахунки, пропозиції та інші документи, надіслані їм. - Листи-нагадування — нагадування про прострочені та майбутні платежі. - Маркетингові листи — будь-які рекламні чи інформаційні повідомлення.

Кожна категорія — це незалежний перемикач увімк./вимк. Клієнт, який хоче лише рахунки, але не нагадування, може мати саме це — це не все-або-нічого.

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

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

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