Ваучеры пополнения

Ваучер пополнения - это предоплаченный код с фиксированной стоимостью, 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% для тега партии.

Создание ваучера

1. Нажмите Add.
2. Введите Voucher ID. Он должен быть уникальным.
3. Введите Book Value и выберите Currency.
4. Задайте Expiration Date или оставьте never.
5. Задайте Credit Lifetime, days (срок действия кредита, дней). См. таблицу ниже.
6. Введите Batch Tag, чтобы сгруппировать ваучер с другими.
7. Отметьте Use Secret PIN и введите Secret PIN, только цифры, если ваучер защищён PIN-кодом.
8. Нажмите 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 хранится в зашифрованном виде и больше никогда не показывается

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

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

1. Нажмите Generate.
2. Оставьте или измените шаблоны в Voucher ID и Secret PIN.
3. Введите Book Value, Currency, Expiration Date, Credit Lifetime, days и Batch Tag для партии.
4. Отметьте Use Secret PIN, если ваучерам нужен PIN.
5. Введите Number of Top-up Vouchers (количество ваучеров пополнения), от 1 до 10000.
6. Нажмите 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 с новыми ваучерами.

Осторожно

Сгенерированный файл - единственное место, где PIN-коды партии видны в открытом виде. Download (выгрузить) из списка оставляет колонку Secret PIN пустой, а форма показывает только маску. Сохраните файл в надёжном месте, прежде чем закрыть страницу.

Загрузка и выгрузка

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.

Удаление ваучера

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

Ваучеры для реселлеров

Реселлер может продавать собственные ваучеры своим аккаунтам:

1. Откройте My Customers → Permissions и отметьте для реселлера Vouchers +, e и -. См. Пользователи и права.
2. Нажмите Set в этой строке.
3. Попросите реселлера добавить процессор Vouchers или Vouchers with PIN в его собственных Payment Processors и создать ваучеры в своей панели.

Ваучеры одного клиента не могут погашать аккаунты другого, включая аккаунты его субреселлеров.

Совет

Используйте отдельный Batch Tag для каждого тиража или дистрибьютора. Если партия пропала, отфильтруйте по тегу и Not Redeemed, затем выполните Download и загрузите тот же файл с D в колонке действия, чтобы отменить всю партию сразу.

Связанные страницы

• Платежи
• Пополнение аккаунта ваучером
• Карты пополнения
• Аккаунты
• Курсы валют