Перейти до вмісту
FlySIPFlySIP Docs

Генерація акаунтів і ваучерів за шаблонами

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

Коли ви продаєте передплачені картки або ваучери, вам потрібні сотні записів з унікальними випадковими номерами й PIN-кодами. Замість того щоб готувати їх у таблиці, ви вписуєте в поле шаблон, і комутатор заповнює його новим випадковим значенням для кожного запису. У цьому посібнику ви генеруєте партію ваучерів поповнення в панелі й бачите ті самі шаблони для акаунтів, створених через API. Розраховуйте приблизно на 10 хвилин.

Перед початком

Розділ «Перед початком»
  • У вас є доступ Administrator (адміністратор) до панелі з правом додавати ваучери поповнення.
  • Ви знаєте номінал, валюту й дату закінчення дії партії.

Крок 1: Виберіть шаблони

Розділ «Крок 1: Виберіть шаблони»

Поле містить або фіксоване значення, або рівно один шаблон. Шаблон не можна поєднувати з фіксованим текстом в одному полі.

Шаблон Що генерує Приклад Результат
${N:n} n випадкових цифр; перша цифра ніколи не 0 ${N:10} 4093817265
${N:[…][…]…} Одну цифру на кожну пару дужок: діапазон [0-6], список [0,4,9] або фіксовану цифру [5] ${N:[2,3,4][0-8][0-9][0-9]} 2000–2899, 3000–3899 або 4000–4899
${P:n} Випадковий пароль з n літер і цифр, що містить принаймні одну цифру ${P:12} k3XbQ9pLm2Ra
${C:Field} Копію значення, згенерованого для іншого поля того самого запису ${C:Account Name} Те саме значення, що й Account Name (ім’я акаунта)

Щоб кожен номер починався з фіксованого префікса, дайте кожній цифрі префікса окрему пару дужок: ${N:[7][7][0-9][0-9][0-9][0-9][0-9][0-9]} дає восьмизначні номери, що починаються з 77.

Крок 2: Згенеруйте ваучери поповнення

Розділ «Крок 2: Згенеруйте ваучери поповнення»
  1. Відкрийте Payments → Top-Up Vouchers (ваучери поповнення).
  2. Натисніть Generate (згенерувати).
  3. Залиште або змініть Voucher ID (ID ваучера). Значення за замовчуванням ${N:[0-9][0-9][0-9][0-9][0-9][0-9][0-9][0-9][0-9][0-9]} дає десять випадкових цифр.
  4. Введіть Book Value (номінал), виберіть Currency (валюта) і задайте Expiration Date (дата закінчення дії) та Credit Lifetime, days (термін дії кредиту, днів).
  5. Введіть Batch Tag (тег партії), наприклад promo-2026-11, щоб пізніше знайти партію.
  6. Позначте Use Secret PIN (використовувати секретний PIN), якщо клієнт має також вводити PIN, і залиште або змініть шаблон Secret PIN (секретний PIN). Значення за замовчуванням дає чотири випадкові цифри.
  7. Введіть Number of Top-up Vouchers (кількість ваучерів поповнення), від 1 до 10000.
  8. Натисніть Generate.
Screenshot "tutorials/vouchers-generate" has not been generated yet — see scripts/screenshots/screens.yml.

Результат: браузер завантажує файл Top-up Vouchers з одним рядком на ваучер, зокрема зі згенерованими Voucher ID і Secret PIN. Ваучери з’являються у списку з тегом партії.

Крок 3: Згенеруйте акаунти через API

Розділ «Крок 3: Згенеруйте акаунти через API»

Метод createAccount XML-RPC API приймає ті самі шаблони у своїх параметрах і повертає згенеровані облікові дані. Викликайте його один раз на кожну картку, наприклад зі скрипта:

request
call("createAccount", {
    "username": "${N:[1-9][0-9][0-9][0-9][0-9][0-9][0-9][0-9][0-9][0-9]}",
    "authname": "${C:username}",
    "voip_password": "${N:[0-9][0-9][0-9][0-9]}",
    "web_password": "${P:12}",
    # … the other required parameters of createAccount
})

В API ${C:…} приймає ім’я іншого параметра, а не підпис поля в панелі. Інші параметри описано на сторінці Створення акаунтів. Щоб натомість завантажити акаунти з файлу, використовуйте Upload… (завантажити) на екрані Accounts (акаунти); файл приймає лише фіксовані значення. Див. Акаунти.

Крок 4: Перевірте

Розділ «Крок 4: Перевірте»
  1. Відкрийте Payments → Top-Up Vouchers і відфільтруйте список за Batch Tag партії.
  2. Переконайтеся, що кількість ваучерів, Book Value і статус Active (активний) відповідають очікуваним.
  3. Активуйте один ваучер на тестовому акаунті й переконайтеся, що його баланс зріс на номінал.

Що далі

Розділ «Що далі»