Ваучери — продаж, випуск і погашення

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

Що можна продавати

• Довільна сума — набір номіналів, необов’язкова власна сума, мінімум, максимум і крок суми.
• Фіксована вартість — задана вартість ваучера; ціна продажу може відрізнятися від номіналу.
• Пропозиція — послуга, товар, страва, пакет або враження з назвою, описом, категорією, зображенням, тривалістю, ціною й перекладами.

Ресторанну пропозицію можна пов’язати з позицією меню. У режимі exact item ваучер надає право на конкретну позицію, яку також визначає SKU; у вартісному режимі він працює як задана сума.

Налаштування

У розділі Налаштування → Ваучери власник або уповноважений менеджер налаштовує:

• пропозицію та порядок позицій;
• номінали й довільну суму;
• строк дії: без обмеження, кількість днів після купівлі або фіксовану дату;
• часткове або одноразове погашення;
• типи ваучерів, дозволені як перевага в Ordering;
• логотип, кольори, повідомлення, фон, зображення, макети PDF і палітри;
• контент, перекладений публічними мовами;
• нагадування перед завершенням строку.

Публічне посилання має вигляд /{slug}/voucher. Сторінка балансу окремого ваучера використовує його код і показує поточний стан. Посилання з приватним токеном не можна публікувати або передавати третім особам.

Продаж і доставка

Під час онлайн-купівлі Reven створює очікувану покупку й перенаправляє до налаштованого платіжного сценарію. Ваучер створюється лише після підтвердження правильної суми, валюти й платежу. Клієнт отримує лист і PDF відповідно до налаштувань. Під час купівлі кількох ваучерів випуск має завершитися для всієї очікуваної кількості, а не лише для першої позиції.

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

Погашення

У розділі Ваучери → Сканування працівник вводить або сканує код, перевіряє статус і баланс, а потім підтверджує суму погашення. Частковий режим залишає залишок; одноразовий режим використовує весь ваучер за правилами пропозиції. Операцію слід виконати один раз і зберегти в історії.

В Ordering клієнт може застосувати підтримуваний ваучер до кошика. Сервер заново розраховує вартість переваги, ціни, доставку й суму до сплати. Якщо ваучер не покриває всю суму, залишок можна сплатити карткою. У разі повернення замовлення з комбінованою оплатою баланс ваучера відновлюється лише після підтвердження відповідної операції повернення.

Wallet, повідомлення й строк дії

Ваучер можна зберегти в Apple Wallet або Google Wallet, якщо інтеграцію налаштовано для компанії та продукту. Повідомлення на збережену картку не замінює email і формально не змінює умов. Строк дії та нагадування обробляють системні задачі; компанія має підтримувати актуальні контактні дані й тексти умов.

Часті перевірки

У разі фінансової невідповідності не створюйте другий ваучер і не робіть ручне коригування до перевірки транзакції та історії операцій.

На спільному екрані сканера під час ручної покупки Loyalty попередньо вибирається відсканований доступний подарунок або єдиний доступний варіант. Працівник перевіряє вибір, заклад та умови перед підтвердженням; явний вибір «без подарунка» зберігається. Створення PDF ваучера саме собою не підтверджує надсилання листа: також перевіряйте результат завдання та прийняття повідомлення поштовим провайдером.