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

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

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

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

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

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

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

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

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

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

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

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

Погашення

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

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

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

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

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

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