Ваучери поповнення

Цей переклад зроблено автоматично і ще не вичитано. Читати англійську версію

Ваучер поповнення - це передплачений код із фіксованою вартістю, Book Value (номінальна вартість). Ви створюєте ваучери заздалегідь, друкуєте чи продаєте їх, а акаунт погашає ваучер, щоб додати його вартість до балансу. Погашення працює на порталі самообслуговування в розділі Make Payment (здійснити платіж) і через XML-RPC API. Кожен ваучер можна погасити один раз і лише акаунтом клієнта, який його створив.

Де знайти

Відкрийте Payments → Top-Up Vouchers (ваучери поповнення) у лівій бічній панелі. URL - /vouchers.php. Пункт показується, коли ви можете додавати ваучери або вже маєте якісь, і не показується веб-користувачам з обмеженим рівнем доступу. Add, Generate (згенерувати), редагування й Delete залежать від ваших прав на додавання, редагування й видалення ваучерів.

Screenshot "admin-panel/vouchers-list" has not been generated yet — see scripts/screenshots/screens.yml.

Перш ніж почати

Акаунти можуть погашати ваучери лише через платіжний процесор. Додайте його в Payments → Payment Processors (платіжні процесори) зі шлюзом, що відповідає вашим ваучерам. Див. Платежі.

Payment Gateway	Приймає	На порталі акаунт вводить
Vouchers (ваучери)	Ваучери без PIN	Voucher ID (ідентифікатор ваучера)
Vouchers with PIN (ваучери з PIN)	Лише ваучери з Use Secret PIN (використовувати секретний PIN)	Voucher ID і Secret PIN (секретний PIN)

Currency (валюта) процесора має збігатися з Payment Currency (валюта платежу) акаунта. Ваучер, що не відповідає типу процесора, відхиляється: ваучер з PIN не можна погасити через Vouchers, а ваучер без PIN - через Vouchers with PIN. Оберіть один вид для всіх ваучерів однієї валюти.

Що ви бачите

Колонка	Значення
Voucher ID	Код, надрукований на ваучері, посилання на форму
Book Value	Вартість, перерахована в Display Currency (валюта відображення) фільтра, за замовчуванням вашу базову валюту
Batch Tag (тег партії)	Мітка партії, до якої належить ваучер
Status (статус)	Active (активний) з датою закінчення дії або `does not expire`; Expired on (термін дії минув) із датою; або Redeemed by (погашено) акаунтом у певну дату, з посиланням на платіж

Швидкий фільтр зіставляє Voucher ID з умовами is like / is not like і статус Any Status, Not Redeemed (не погашено) або Redeemed (погашено). Filters (фільтри) додає Batch Tag, Book Value, Display Currency, Redeemed by, Redemption Date (дата погашення) (Redeemed before, Redeemed after) і Expiration Date (дата закінчення дії) (Expired before, Expired since, Expires by, Expires not earlier than). Текстові шаблони зіставляються з усім значенням; використовуйте % як підстановний символ, наприклад 2025-06% для тегу партії.

Створення ваучера

Натисніть Add.
Введіть Voucher ID. Він має бути унікальним.
Введіть Book Value і виберіть Currency.
Задайте Expiration Date або залиште never.
Задайте Credit Lifetime, days (термін дії кредиту, днів). Див. таблицю нижче.
Введіть Batch Tag, щоб згрупувати ваучер з іншими.
Позначте Use Secret PIN і введіть Secret PIN, лише цифри, якщо ваучер захищено PIN-кодом.
Натисніть Save & Close.

Поле	Значення
Book Value	Сума, що додається до балансу, у Currency ваучера. Під час погашення перераховується у валюту акаунта за вашими курсами валют. Має бути додатною
Expiration Date	Останній день, коли ваучер можна погасити. `never` - без обмежень
Credit Lifetime, days	Скільки акаунт залишається придатним до використання після поповнення: кількість днів від погашення, From Account (з акаунта), щоб використати Lifetime (days) (термін дії, днів) акаунта, або Never Expires (безстроково). Дата закінчення дії акаунта переноситься на нову дату, якщо акаунт ще не спливає пізніше; акаунт з фіксованим терміном дії так ніколи не стає безстроковим
Batch Tag	Довільна мітка, яку пропонують знову в наступних ваучерах і у фільтрі
Use Secret PIN, Secret PIN	Вимагати PIN під час погашення. PIN зберігається зашифрованим і більше ніколи не показується

Погашений ваучер доступний лише для читання.

Масова генерація ваучерів

Натисніть Generate.
Залиште або змініть шаблони в Voucher ID і Secret PIN.
Введіть Book Value, Currency, Expiration Date, Credit Lifetime, days і Batch Tag для партії.
Позначте Use Secret PIN, якщо ваучерам потрібен PIN.
Введіть Number of Top-up Vouchers (кількість ваучерів поповнення), від 1 до 10000.
Натисніть Generate.

Шаблони утворюють випадкові цифри: ${N:[0-9][0-9][0-9][0-9]} дає чотири цифри, по одній дужці на цифру. Дужка містить діапазон, як-от [1-9], або список, як-от [2,3,4], тож ${N:[1-9][0-9][0-9][0-9][0-9][0-9][0-9][0-9][0-9][0-9]} дає десять цифр без нуля на початку. За замовчуванням Voucher ID має 10 цифр, а Secret PIN - 4. Кожен згенерований ID перевіряється на збіг з наявними ваучерами; якщо шаблон залишає замало вільних комбінацій, генерація зупиняється з помилкою. Той самий синтаксис використовує генератор акаунтів, див. Генератор акаунтів.

Коли генерація завершується, браузер завантажує файл Top-up Vouchers з новими ваучерами.

Завантаження й вивантаження

Download експортує ваучери, що відповідають фільтрам, у вашому форматі вивантаження: Id, Voucher ID, Book Value, Expiration Date, Currency, Credit Lifetime, Batch Tag, Use Secret PIN, Redemption Date та акаунт, який його погасив. Upload (завантажити) приймає той самий файл назад із колонкою Action [A|D|U]: A додає рядок, U оновлює ваучер із заданим Id, D видаляє його. Рядки з помилками повертаються у файлі Top-up Vouchers errors.

Видалення ваучера

Значок кошика в рядку видаляє ваучер після підтвердження. Видаляйте загублені чи викрадені ваучери до того, як їх погасять; погашений ваучер уже зарахував кошти на баланс, і його видалення не повертає гроші.

Ваучери для реселерів

Реселер може продавати власні ваучери своїм акаунтам:

Відкрийте My Customers → Permissions і позначте для реселера Vouchers +, e і -. Див. Користувачі та права.
Натисніть Set у цьому рядку.
Попросіть реселера додати процесор Vouchers або Vouchers with PIN у його власних Payment Processors і створити ваучери у своїй панелі.

Ваучери одного клієнта не можуть погашати акаунти іншого, зокрема акаунти його субреселерів.