NoDeny - Внесок користувача [uk]

Модуль лояльности 2

2025-11-14T14:29:48Z

Sv: /* Дополнительные параметры */

==Принцип работы==
При завершении услуги типа «интернет», абонент получает бонус - процент от стоимости завершаемой услуги. Процент зависит от «стажа», а именно от количества раз, сколько он использовал услуги интернет. Процент задается в настройках, в таблице «месяцев стажа = процент». В даннном случае принимается, что услуги интернет имеют длительность месяц.

В отличие от модуля лояльности 1, где стаж расчитывается от даты договора или от даты подключения первой услуги, в данном случае стаж хранится в поле допданных. Это дает возможность его редактировать (можно разрешить редактирование только суперадмину), а также учитывать случаи перерывов, когда абонент перестал пользоваться услугами и потом возобновил - как было сказано ранее, стаж считается по количеству раз подключения услуги интернет.

Поле «стаж» увеличивается на единицу при каждом завершении услуги, перед начислением бонуса.

==Настройка==

Настройки → Дополнительные поля → Дополнительный набор: создаем поле
* имя: Месяцев стажа
* имя в бд: _loyality_months
* тип: целое положительное
* можно поставить галку «запретить редактирование»

Настройки → Кабинет абонента → Список плагинов в порядке отображения в меню: добавляем loyalty

Настройки → Группы: поставить галку отключения модуля лояльности для тех групп, где он не нужен

==Дополнительные параметры==

* Количество дней после завершения услуги, по прошествии которых стаж будет обнулен. 0 - не использовать фичу обнуления. При обнулении создается комментарий клиенту, который видят только админы, в какое время произошло данное событие
* поле _loyality_months в таблице допданных 2 (data1) или в таблице основных допданных (data0)
* переключатель да/нет - стаж и процент начисляются только за услуги с тегом loyalty
* Отключить модуль если у абонента установлена скидка

==Нюансы==

* Если услуга завершается оператором досрочно - бонус начисляется пропорционально времени использования услуги
* Если услуга завершается оператором досрочно и время ее использования меньше 50% - счетчик стажа не увеличивается на единицу

Hummingbot

2025-11-12T08:28:40Z

Sv: Sv перейменував сторінку з CityPay на Hummingbot без створення перенаправлення

==hummingbot==
Сторінка: https://github.com/hummingbot/hummingbot

Звідти інфо як ставити:

<pre>
git clone https://github.com/hummingbot/hummingbot.git
cd hummingbot
docker compose up -d
docker attach hummingbot
</pre>

Тут: клонується проєкт, запускається докер контейнер а також піключаємося до консолі. Там псевдографічний інтерфейс. Спочатку виводять попередження, що трейдінг не для дітей. Потім просять придумати пароль. Для тесту я ввожу admin

==hummingbot-api==

Сторінка: https://github.com/hummingbot/hummingbot-api

Звідти інфо як ставити:

<pre>
git clone https://github.com/hummingbot/hummingbot-api.git
cd hummingbot-api
chmod +x setup.sh
./setup.sh
</pre>

<pre>
docker compose up -d
</pre>

Відкриваю в браузері http://127.0.0.1:8000/ і отримую

<pre>
{"name":"Hummingbot API","version":"1.0.1","status":"running"}
</pre>

- апі працює

==запуск скрипту формування rsi==

Робив по цій докє: https://hummingbot.org/v2-strategies/walkthrough/

Сходу не запуститься бо:

# воно зробить конфіг і там треба його поправити - сказати яку пару моніторить і де брати інфу
# ввести ключи від того, де будемо брати інфо

Може є якісь конектори, які можуть без ключів отримувати дані, я не знаю - у мене бу ключ бінанса. Тому я набрав в консолі hummingbot-а (в його псевдографічному інтерфейсі):

<pre>
connect binance_perpetual
</pre>

воно спитало ключ API і секретний ключ. Я ввів їх. Після чого в консолі:

<pre>
connect binance_perpetual
</pre>

Воно вивело можливі конекшини і напроти binance_perpetual поставило yes-yes.

В основній системі редагую hummingbot/conf/scripts/conf_v2_directional_rsi_1.yml - міняю пару, а також exchange: binance_perpetual

Hummingbot

2025-11-07T11:33:39Z

Sv: /* запуск скрипту формування rsi */

Hummingbot

2025-11-07T11:33:02Z

Sv: /* запуск скрипту формування rsi */

==hummingbot==
Сторінка: https://github.com/hummingbot/hummingbot

Звідти інфо як ставити:

<pre>
git clone https://github.com/hummingbot/hummingbot.git
cd hummingbot
docker compose up -d
docker attach hummingbot
</pre>

Тут: клонується проєкт, запускається докер контейнер а також піключаємося до консолі. Там псевдографічний інтерфейс. Спочатку виводять попередження, що трейдінг не для дітей. Потім просять придумати пароль. Для тесту я ввожу admin

==hummingbot-api==

Сторінка: https://github.com/hummingbot/hummingbot-api

Звідти інфо як ставити:

<pre>
git clone https://github.com/hummingbot/hummingbot-api.git
cd hummingbot-api
chmod +x setup.sh
./setup.sh
</pre>

<pre>
docker compose up -d
</pre>

Відкриваю в браузері http://127.0.0.1:8000/ і отримую

<pre>
{"name":"Hummingbot API","version":"1.0.1","status":"running"}
</pre>

- апі працює

==запуск скрипту формування rsi==

Робив по цій докє: https://hummingbot.org/v2-strategies/walkthrough/

Сходу не запуститься бо:

# воно зробить конфіг і там треба його поправити - сказати яку пару моніторить і де брати інфу
# ввести ключи від того, де будемо брати інфо

Може є якісь конектори, які можуть без ключів отримувати дані, я не знаю - у мене бу ключ бінанса. Тому я набрав в консолі hummingbot (в його псевдографічному інтерфейсі):

<pre>
connect binance_perpetual
</pre>

воно спитало 2 ключ API і секретний ключ. Я ввів їх. Після чого в консолі:

<pre>
connect binance_perpetual
</pre>

Воно вивело можливі конекшини і напроти binance_perpetual поставило yes-yes.

В основній системі редагую hummingbot/conf/scripts/conf_v2_directional_rsi_1.yml - міняю пару, а також exchange: binance_perpetual

Hummingbot

2025-11-07T11:32:23Z

Sv: /* запуск скрипту формування rsi */

==hummingbot==
Сторінка: https://github.com/hummingbot/hummingbot

Звідти інфо як ставити:

<pre>
git clone https://github.com/hummingbot/hummingbot.git
cd hummingbot
docker compose up -d
docker attach hummingbot
</pre>

Тут: клонується проєкт, запускається докер контейнер а також піключаємося до консолі. Там псевдографічний інтерфейс. Спочатку виводять попередження, що трейдінг не для дітей. Потім просять придумати пароль. Для тесту я ввожу admin

==hummingbot-api==

Сторінка: https://github.com/hummingbot/hummingbot-api

Звідти інфо як ставити:

<pre>
git clone https://github.com/hummingbot/hummingbot-api.git
cd hummingbot-api
chmod +x setup.sh
./setup.sh
</pre>

<pre>
docker compose up -d
</pre>

Відкриваю в браузері http://127.0.0.1:8000/ і отримую

<pre>
{"name":"Hummingbot API","version":"1.0.1","status":"running"}
</pre>

- апі працює

==запуск скрипту формування rsi==

Робив по цій докє: https://hummingbot.org/v2-strategies/walkthrough/

Сходу не запуститься бо:

# воно зробить конфіг і там треба його поправити - сказати яку пару моніторить і де брати інфу
# ввести ключи від того, де будемо брати інфо

Може є якість конектори, які можуть без ключів отримувати дані, я не знаю - у мене бу ключ бінанса. Тому я набрав в консолі hummingbot (в його псевдографічному інтерфейсі):

<pre>
connect binance_perpetual
</pre>

воно спитало 2 ключ API і секретний ключ. Я ввів їх. Після чого в консолі:

<pre>
connect binance_perpetual
</pre>

Воно вивело можливі конекшини і напроти binance_perpetual поставило yes-yes.

В основній системі редагую hummingbot/conf/scripts/conf_v2_directional_rsi_1.yml - міняю пару, а також exchange: binance_perpetual

Hummingbot

2025-11-07T11:31:19Z

Sv:

==hummingbot==
Сторінка: https://github.com/hummingbot/hummingbot

Звідти інфо як ставити:

<pre>
git clone https://github.com/hummingbot/hummingbot.git
cd hummingbot
docker compose up -d
docker attach hummingbot
</pre>

Тут: клонується проєкт, запускається докер контейнер а також піключаємося до консолі. Там псевдографічний інтерфейс. Спочатку виводять попередження, що трейдінг не для дітей. Потім просять придумати пароль. Для тесту я ввожу admin

==hummingbot-api==

Сторінка: https://github.com/hummingbot/hummingbot-api

Звідти інфо як ставити:

<pre>
git clone https://github.com/hummingbot/hummingbot-api.git
cd hummingbot-api
chmod +x setup.sh
./setup.sh
</pre>

<pre>
docker compose up -d
</pre>

Відкриваю в браузері http://127.0.0.1:8000/ і отримую

<pre>
{"name":"Hummingbot API","version":"1.0.1","status":"running"}
</pre>

- апі працює

==запуск скрипту формування rsi==

Робив по цій докє: https://hummingbot.org/v2-strategies/walkthrough/

Сходу не запуститься бо:
1) воно зробить конфіг і там треба його поправити - сказати яку пару моніторить і де брати інфу
2) ввести ключи від того, де будемо брати інфо

Може є якість конектори, які можуть без ключів отримувати дані, я не знаю - у мене бу ключ бінанса. Тому я набрав в консолі hummingbot (в його псевдографічному інтерфейсі):

<pre>
connect binance_perpetual
</pre>

воно спитало 2 ключ API і секретний ключ. Я ввів їх. Після чого в консолі:

<pre>
connect binance_perpetual
</pre>

Воно вивело можливі конекшини і напроти binance_perpetual поставило yes-yes.

В основній системі редагую hummingbot/conf/scripts/conf_v2_directional_rsi_1.yml - міняю пару, а також exchange: binance_perpetual

Hummingbot

2025-11-07T11:21:56Z

Sv:

2025-10-26T07:56:40Z

Sv: Створена сторінка: [https://www.ottclub.tv/ OttClub] - сервис онлайн телевидения. ==Настройка== В административном интерфейсе NoDeny заходим в раздел Настройки→Модули→OttClub и заполняем поля согласно данным, выданным компанией OttClub. Переходим в раздел «Кабинет клиента» и в поле «Список п...

Main Page

2025-10-26T07:48:22Z

Sv:

* [[Принять решение переходить ли на NoDeny]]
* [[Краткая информация]]
** [http://nodeny.com.ua/ Официальный сайт]
** [http://forum.nodeny.com.ua/ Форум]
* [[Установка NoDeny]]
* [[NoDeny Next]]
* FAQ
** [[Узнать версию NoDeny]]
** [[Установка модулей]]
** [[Debug режим]]
** [[Безопасность]]
** [[Ip абонента|Выдача ip абоненту]]
** Услуги
*** [[Заморозка услуг|Заморозка]]
*** [[Разрешить подключать услугу только один раз|Подключить только один раз]]
** [[Ядро]]
*** [[Запуск модулей ядра|Запуск модулей]]
** [[Зависимые выпадающие списки]]
** [[Уникальные поля учетной записи]]
** [[Пуш-уведомления]]
** [[Трафик в другой БД]]
** [[Push уведомления]]
** [[Теги в услугах]]
* [[Сервер доступа]]
** FreeBSD / Linux
*** [[Dhcp|DHCP]]
**** [[Dhcp без Radius]]
**** [[Dhcp+Radius|Dhcp + Radius 2]]
**** [[Dhcp + Radius 3|Dhcp + Radius 2 (FreeBSD)]]
*****[[Dhcp запускается на FreeBSD]]
**** [[Dhcp + Radius 3 (Linux)]]
**** [[dhcp-конфиг с помощью make config|Автогенерация конфига]]
*** [[PPPoE|PPPoE (Freeradius 2)]]
*** [[Pppoe (mpd5 + freeradius 3)|PPPoE (Freeradius 3)]]
** [[Микротик]]
*** DHCP
**** [[mirkotik dhcp|с использованием Radius]]
**** [[Конфиг для Mikrotik с помощью make config|без использования Radius]]
*** [[Микротик#Заглушка|Заглушка]]
*** [[Pppoe|PPPoE]]
* [[Подключения]]

==[[Модули]]==
* Авторизация в личном кабинете
** [[Авторизация через Google|через Google]]
** [[Авторизация через Facebook|через Facebook]]
** [[Авторизация через Telegram|через Telegram]]
* Услуги
** [[Честные услуги]]
** [[Длинные услуги]]
** [[Короткие услуги]]
** [[Модуль приостановки услуг|Приостановка услуг]]
** [[Service_rules|Правила смены услуг]]
** [[Снятие за меньший тариф]]
** [[Массовое изменение «следующей» услуги]]
** [[Услуга с настраиваемым периодом]]
** [[Короткий доступ]]
** [[Цена из допполя]]
** [[Услуги по формуле]]
** [[Модуль группировки списаний|Группировка списаний]]
* IP
** [[Привязка ip к login]]
** [[Модуль Place ip|Place ip]]
* [[Sms]]
**[[TurboSms]]
**[[TurboSms viber/sms]]
**[[LifeSms]]
**[[Sms о пополнении счета]]
**[[Sms с балансами всем абонентам]]
* [[Модуль DHCP|DHCP]]
* [[Карта]]
** [[Google карти|Google]]
** [[Leaflet карти|Leaflet]]
* [[Пингсервер]]
* [[Редактор ВОЛС]]
* [[Заглушка]]
* [[Модуль "Акция"|Акция]]
* [[Модуль "Бонусный счет"|Бонусный счет]]
* [[Модуль "Поделись балансом"|Поделись балансом]]
* [[Модуль лояльности и "Приведи друга"]]
* [[Модуль лояльности 2]]
* [[Родительский контроль]]
* [[Карточки пополнения счета]]
* [[Кредит. Версия 2]]
* [[Платежи из файла]]
* [[Binotel телефония]]
* [[COA|COA (old version)]]
* [[COA new version|COA]]
* [[WebCoa]]
* [[Netflow]]
* [[Make config]]
* [[Pingserver]]
* [[Radius атрибуты]]
* [[Snmp]]
**[[dhcp-конфиг с помощью make config|Пример для dhcp-сервера]]
**[[Конфиг для Mikrotik с помощью make config|Пример для Mikrotik]]
* [[Ограничения доступа персонала по времени]]
* [[Ограничение доступа персонала по ip]]
* [[Блокировка ненастроенных учеток]]
* [[Допполе «линк»]]
* [[Тикетная система]]
**[[Настройка тикетной системы|Настройка]]
** [[Сообщения в Telegram]]
* Видеосервисы
** [[OmegaTV|Omega TV]]
** [[Omega TV. Оптимизация API]]
** [[OttClub]]
** [[TrinityTV|Trinity TV]]
** [[Trinity-TV. Оптимизация API|Trinity TV. Оптимизация API]]
** [[Megogo]]
** [[Megogo. Оптимизация API]]
** [[Iptvportal]]
* Платежные системы
** [[Терминалы Приватбанка]]
** [[Терминалы Приватбанка, версия 2]]
** [[Liqpay]]
** [[Liqpay 3]]
** [[24nonStop]]
** [[City24]]
** [[CityPay]]
** [[CloudPayments]]
** [[Easypay]]
** [[E-pay]]
** [[E-ПЛАТЕЖКА]]
** [[Fondy]]
** [[Globalmoney]]
** [[IBox]]
** [[Monobank]]
** [[Monobank терминалы]]
** [[Paymaster]]
** [[Platezhka]]
** [[Platon]]
** [[Portmone]]
** [[Qiwi]]
** [[Tascombank]]
** [[Ukrpays]]
** [[Walletone]]

==Иное==

* [[Фичи на заметку]]
* [[Подсчет трафика]]
** [[Модуль ядра ses_traf]]
* [[Интерфейс контроля для гос.органов]]
* [[Дополнительные возможности]]
** [[Гостевой режим]]
** Личный кабинет
*** [[Краткая иформация о кабинете абонента|Краткая иформация]]
*** [[Локализация и пиктограммы у пунктов меню]]
*** [[Настройка меню кабинета абонента|Разное меню для разных групп]]
*** [[Дизайн личного кабинета]]
**** [[Дизайн страницы оплаты]]
*** [[Переменные шаблона личного кабинета]]
** [[Шаблоны для экспорта платежей]]
** [[Бланк настроек]]
** Разработчикам
*** [[Таблицы базы данных]]
*** [[Шаблонизатор]]
*** [[Программирование]]
**** [[Рисуем графики]]
*** [[Патчинг файлов]]
*** [[Разработчикам: заморозка услуг]]
* [[Записки админа]]
* [http://app.nodeny-plus.com.ua/docs/index.html Старая документация]

Fondy

2025-08-22T13:29:40Z

Sv:

==Описание==
[https://fondy.ua/ru/?connect=46 Fondy] - платежная система, работающая в Украине и в Европе. Преимуществом является возможность осуществлять выплаты не только юридическим лицам, но и физлицам на пластиковые карты.

==Процесс оплаты==
Абонент заходит в личный кабинет и в разделе «Оплата через сервис Fondy» вводит сумму, на которую желает пополнить счет. Если в данный момент баланс отрицательный, модуль подсказывает сумму. После этого абонент переходит на сайт Fondy и вводит реквизиты пластиковой карты. После успешной оплаты, сервис Fondy связывается с вашим сервером NoDeny и платеж проводится в вашей системе. Обычно это происходит довольно быстро.

Дополнительные возможности модуля:

* Позволяет переложить комиссию на абонента как процент от суммы платежа
* Позволяет использовать для разных абонентов разные мерчанты. Например, в вашей организации будет несколько предпринимателей, между которыми вы хотите распределять поступления с оплат абонентов

==Настройка==

После регистрации и создания мерчанта в Fondy, там же необходимо зайти в технические настройки вашего магазина (мерчанта) и получить 2 параметра: id мерчанта и ключ платежа (публичный и приватный ключи). Эти параметры внести в настройки в раздел «Платежные системы» → «Fondy» в админке вашего биллинга. Заполните остальные параметры этого раздела и не забудьте, как там указано в комментарии проверить «Url NoDeny обработчика ответов от API Fondy».

Осуществите тестовую оплату. Через небольшое время посмотрите, не появился ли платеж в NoDeny на заданную сумму. Если нет, смотрите логи:

<pre>/usr/local/nodeny/logs/fondy_err.log
/usr/local/nodeny/logs/fondy_ok.log
</pre>

Вы можете запросить повторную посылку сигнала «платеж успешен» на странице Fondy - это называется «послать callback».

===Несколько мерчантов===

Если вы хотите, чтобы оплаты шли через разные мерчанты для разных клиентов, вам нужно:

* Создать дополнительное поле с именем, например, «ФОП куратора» или «Мерчант», с именем поля в бд «_merchant» и типом «выпадающий список». Это поле будет говорить о том, какой мерчант использовать при оплате
* У абонентов заполнить это поле, допустим будут такие варианты:
** Иванов
** Петров
** Сидоров
* В настойках модуля Fondy в параметре «Имя допполя» ввести «_merchant»
* В параметре «В каждой строке перечислите через двоеточие»:

<pre>
Иванов:i1234560:xxxxxxxx
Петров:i1234561:yyyyyyyy
Сидоров:i1234562:zzzzzzzz
</pre>

где i1234560 и xxxxxxxx соответственно публичный и приватный ключи

==Оплата без участия абонента==

Есть возможность автоматического пополнения счета без участия абонента. Если в настройках установить в «да» параметр «Использовать возможность автоматической оплаты по токену без участия абонента», то после успешной оплаты, NoDeny получит от Fondy токен, по которому сможет производить списания с карты без ее номера и без подтверждения.

[[Файл:Autopay.png|833px]]

Списание происходит в момент когда баланс становится отрицательным, например, после подключения услуги. Что нужно:
* Установить в «да» параметр «Использовать возможность автоматической оплаты по токену без участия абонента» а настройках модуля Fondy
* В настройках Ядро→Балансы установить в «да» параметр «При отрицательном балансе автоматически пополнять счет абонента, используя токен, выданный платежной системой»
* Рестартнуть ядро
* В настройках «Кабинет клиента» добавить плагин autopays
* Обратиться в поддержку Fondy чтобы они включили возможность оплаты по токену

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

===Дополнительная информация===
Токены для пополнения хранятся в таблице paysystems_tokens базы данных.

Чтобы убедиться, что Fondy передает токены, нужно после успешной оплаты посмотреть в лог /usr/local/nodeny/logs/fondy_ok.log и обнаружить присутствие rectoken в фагменте:

<pre>
{
'input' => {
...
...
'rectoken' => 'xxxxxxxxxxxxxxxxxxxxxxxxxxx',
...
},
...
};
</pre>

Принять решение переходить ли на NoDeny

2025-07-06T19:53:29Z

Sv: /* Большое количество модулей */

<div style='margin-top: 1.5em'>
Есть ли у вас сеть или еще нет, вы хотите взвесить «за» и «против» для принятия решение нужен ли вам NoDeny. В данном разделе мы попытаемся убедить использовать NoDeny.</div>

==Большая история==
<div style='margin-top: 1.5em'>
NoDeny больше 20 лет. Он разрабатывался в реальной сети с 2004 года. Автор работал в данной сети и реализовывал пожелания как обычных пользователей так и персонала. Тогда биллинг начал распространяться и стал поступать дополнительный фидбек от множества сетей.
</div>

==Больше чем биллинг==
<div style='margin-top: 1.5em'>
Биллинг NoDeny это гораздо больше чем управление счетами абонентов. Это система управления всей сетью. Это широкий спектр оборудования и технологий. Это мониторинг с различной визуализацией (графики, карты, схемы). Это тикетная система. Это большое количество платежных систем. И много всего еще.
</div>

==Большое количество модулей==
<div style='margin-top: 1.5em'>
В NoDeny более 100 модулей! Каждый модуль добавляет какое-либо удобство в работе и персоналу и клиентам, что является конкурентным преимуществом в выборе провайдера.
</div>

<div style='margin-top: 1.5em'>
NoDeny поддерживает порядка 20 платежных систем. Ваши клиенты смогут оплатить интернет вне дома, например, через мобильник или терминал. Естественно, деньги поступают на счет в автоматическом режиме. Возможно автоматическое списание финансов с карты (этим, естественно, может управлять абонент).
</div>

<div style='margin-top: 1.5em'>
Отправка смс через разных провайдеров. О будущем списании средств. О пополнении счета. Восстановление пароля. Информирование о чем угодно. Можно отослать и массово и одному абоненту.
</div>

==Большое количество схем тарификаций==
<div style='margin-top: 1.5em'>
В NoDeny мощнейший механизм управлениями тарифами. Тарифы могут быть любой длительности: несколько минут, день, месяц, год или любой иной период. Тарифы могут подстраиваться под любое число месяца, например, сами выйти на списание с 1-е по 1-е число. Тариф может перейти на посуточное списание, если недостаточно финансов на счету. Тариф может быть автоматически заморожен при недостаточности финансов и автоматически разморожен при поступлении денег. Тариф может иметь разную длительность и стоимость для разных абонентов. При подключении тарифа могут учитываться разные условия, например тариф не будет разрешено устанавливать если не заполнены важные данные в учетке абонента. При переходе на более дешевый тариф начисление "штрафа". Тариф, который нельзя поменять определенный период времени (например, полученный по акции).
</div>

==Мощная система привилегий==
<div style='margin-top: 1.5em'>
С NoDeny может работать широкий круг работников, у которых будут свои персональные доступы практически на любое действие. Вы можете дать разрешение на просмотр только определенных групп или даже определенных полей учеток. Вы можете настроить NoDeny так, чтобы не произошло утечки информации от недобросовестного персонала. Или, например, дать доступ к конролирующим органам так, чтобы они не могли получить информацию ни сколько у вас абонентов, ни сколько они платят. Любые действия логируются как в базе данных так и в файлах-логах.
</div>

== Перенос абонентов с иного биллинга ==
Самый простой способ, который годится для биллингов даже неизвестных автору - экспорт базы данных в формат [https://ru.wikipedia.org/wiki/CSV csv]. Csv - это текстовый файл, где через символ-разделитель идут текстовые поля данных абонентов. Автор обычно пишет персональный скрипт для переноса из csv в NoDeny в течение суток.

Кроме варианта csv, возможен перенос информации путем конвертации базы данных с иных биллингов.

== Тестовый стенд ==
Вы всегда можете развернуть тестовый стенд, например, просто на виртуальной машине на вашем ноутбуке и пройтись по менюшкам биллинга с уже импортированными данными ваших абонентов. Прогнать типичные действия типа проведения платежей, подключение тарифа, проверить доступ и скорость в интернет, поиск, фильтры и т.д. Таким образом, перед боевым запуском вы будете готовы к вопросам абонентов, будете знать поведение биллинга и как им управлять.

Принять решение переходить ли на NoDeny

2025-07-06T19:52:50Z

Sv: /* Большая история */

<div style='margin-top: 1.5em'>
Есть ли у вас сеть или еще нет, вы хотите взвесить «за» и «против» для принятия решение нужен ли вам NoDeny. В данном разделе мы попытаемся убедить использовать NoDeny.</div>

==Большая история==
<div style='margin-top: 1.5em'>
NoDeny больше 20 лет. Он разрабатывался в реальной сети с 2004 года. Автор работал в данной сети и реализовывал пожелания как обычных пользователей так и персонала. Тогда биллинг начал распространяться и стал поступать дополнительный фидбек от множества сетей.
</div>

==Больше чем биллинг==
<div style='margin-top: 1.5em'>
Биллинг NoDeny это гораздо больше чем управление счетами абонентов. Это система управления всей сетью. Это широкий спектр оборудования и технологий. Это мониторинг с различной визуализацией (графики, карты, схемы). Это тикетная система. Это большое количество платежных систем. И много всего еще.
</div>

==Большое количество модулей==
<div style='margin-top: 1.5em'>
В NoDeny практически 100 модулей! Каждый модуль добавляет какое-либо удобство в работе и персоналу и клиентам, что является конкурентным преимуществом в выборе провайдера.
</div>

<div style='margin-top: 1.5em'>
NoDeny поддерживает порядка 20 платежных систем. Ваши клиенты смогут оплатить интернет вне дома, например, через мобильник или терминал. Естественно, деньги поступают на счет в автоматическом режиме. Возможно автоматическое списание финансов с карты (этим, естественно, может управлять абонент).
</div>

<div style='margin-top: 1.5em'>
Отправка смс через разных провайдеров. О будущем списании средств. О пополнении счета. Восстановление пароля. Информирование о чем угодно. Можно отослать и массово и одному абоненту.
</div>

==Большое количество схем тарификаций==
<div style='margin-top: 1.5em'>
В NoDeny мощнейший механизм управлениями тарифами. Тарифы могут быть любой длительности: несколько минут, день, месяц, год или любой иной период. Тарифы могут подстраиваться под любое число месяца, например, сами выйти на списание с 1-е по 1-е число. Тариф может перейти на посуточное списание, если недостаточно финансов на счету. Тариф может быть автоматически заморожен при недостаточности финансов и автоматически разморожен при поступлении денег. Тариф может иметь разную длительность и стоимость для разных абонентов. При подключении тарифа могут учитываться разные условия, например тариф не будет разрешено устанавливать если не заполнены важные данные в учетке абонента. При переходе на более дешевый тариф начисление "штрафа". Тариф, который нельзя поменять определенный период времени (например, полученный по акции).
</div>

==Мощная система привилегий==
<div style='margin-top: 1.5em'>
С NoDeny может работать широкий круг работников, у которых будут свои персональные доступы практически на любое действие. Вы можете дать разрешение на просмотр только определенных групп или даже определенных полей учеток. Вы можете настроить NoDeny так, чтобы не произошло утечки информации от недобросовестного персонала. Или, например, дать доступ к конролирующим органам так, чтобы они не могли получить информацию ни сколько у вас абонентов, ни сколько они платят. Любые действия логируются как в базе данных так и в файлах-логах.
</div>

== Перенос абонентов с иного биллинга ==
Самый простой способ, который годится для биллингов даже неизвестных автору - экспорт базы данных в формат [https://ru.wikipedia.org/wiki/CSV csv]. Csv - это текстовый файл, где через символ-разделитель идут текстовые поля данных абонентов. Автор обычно пишет персональный скрипт для переноса из csv в NoDeny в течение суток.

Кроме варианта csv, возможен перенос информации путем конвертации базы данных с иных биллингов.

== Тестовый стенд ==
Вы всегда можете развернуть тестовый стенд, например, просто на виртуальной машине на вашем ноутбуке и пройтись по менюшкам биллинга с уже импортированными данными ваших абонентов. Прогнать типичные действия типа проведения платежей, подключение тарифа, проверить доступ и скорость в интернет, поиск, фильтры и т.д. Таким образом, перед боевым запуском вы будете готовы к вопросам абонентов, будете знать поведение биллинга и как им управлять.

Monobank терминалы

2025-07-06T07:48:13Z

Sv: /* Расщепление */

Модуль '''monoterminal''' - предназначен для пополнения счета через терминалы Монобанка. Поддерживает расщепление платежей и/или распределение между мерчантами.

Настройки расщепления задаются в файле modules/monoterminal/monoterminal.pl в ключе rules:

<pre>
rules => [
правило 1,
правило 2,
...
],
</pre>

<blockquote>Если вам не нужно расщепление или распределение финансов, у вас должно быть всего одно правило</blockquote>

Правило - это блок {...} в котором находятся 3 параметра:

* field_name (необязательное)
* field_value (необязательное)
* params (обязательное) - параметры ответа платежной системе

Когда модуль получает запрос от платежной системы, он проверяет правила сверху вниз. Если правило срабатывает - модуль формирует ответ согласно этому правилу и прекращает их (правил) обработку. Правило указывает какие данные должны быть у абонента и если эти данные совпадают - считается, что правило сработало. Например, правило может звучать так: если у абонента поле «обслуживает ФОП» равно «Снеосиков», то ответить платежной системе, что выплаты должны идти на ФОП Снеосиков.

Правила задаются как perl-код - здесь он чем-то похож на json, тем не менее можно ошибиться в синтаксисе и он вообще не будет запускаться. Поэтому после изменения проверяем его так:

<pre>
cd /usr/local/nodeny/ && perl -c modules/monoterminal/monoterminal.pl
</pre>

От json правила отличаются тем, что:
* вместо двоеточия используются символы =>
* ключи можно не обрамлять кавычками
* можно использовать одинарные кавычки

Пример правил:

<pre>
rules => [
{
field_name => '_fop',
field_value => ['sneosikov'],
params => [
{
percent => 100,
companyCode => '111111',
serviceCode => '222222',
name => 'Доступ до мережі Інтернет',
companyInfo => {
edrpou => '13456789',
name => 'ТОВ СНЕОСІКОВ',
bankName => 'БАНК ПРЯМИЙ',
iban => 'UA783052990000026001041606722',
}
},
]
},
{
params => [
{
percent => 100,
companyCode => '333333',
serviceCode => '444444',
name => 'Доступ до мережі Інтернет',
companyInfo => {
edrpou => '7777777',
name => 'ТОВ ДЕРЖАК',
bankName => 'БАНК НЕПРЯМИЙ',
iban => 'UA783052990000026001111111111',
}
},
]
},
],
</pre>

В данном примере 2 правила:
* для клиентов, у которых допполе «обслуживает ФОП» равно «Снеосиков»
* для всех остальных клиентов

Детали для данного примера:
* в вашем NoDeny должно существовать допполе «обслуживает ФОП» с именем _fop в базе данных
* поле percent указывает на процент платежа, который пойдет на данный ФОП. В примере 100% - это означает, что полная сумма. Таким образом, это пример не использующий расщепление, а просто распределение платежей между ФОП-ами
* во втором правиле не указаны условия (поля field_name и field_value), что означает «все другие абоненты»
* поле field_value - должно ссылаться на массив значений (нужно помещать значения в квадратные скобки). Например, если field_value => ['sneosikov', 'volyk'], то правило сработает на клиентов ФОП-а Снеосиков и на клиентов ФОП-а Волик

==Расщепление==

Управляется параметром percent, который указывает на процент от суммы платежа. В каждом правиле есть параметр params, который описывает ответ платежной системе. Внутри этого параметра несколько блоков {...}, в котором указывается процент, а также параметры ФОП (или не ФОП). Если вам необходимо перераспределять финансы в соотношении 40% и 60%, то это будет выглядеть примерно так:

<pre>
rules => [
{
field_name => '_fop',
field_value => ['sneosikov'],
params => [
{
percent => 40,
companyCode => '111111',
serviceCode => '222222',
name => 'Доступ до мережі Інтернет',
companyInfo => {
...,
}
},
{
percent => 60,
companyCode => '888888',
serviceCode => '999999',
name => 'Послуга техпідтримки',
companyInfo => {
...,
}
},
]
},
...
],
</pre>

field_name может указывать на допполе или номер (id) группы, в которой находится абонент (field_name => 'grp')

2025-06-13T08:46:34Z

Sv: /* Правила расщепления */

Portmone

2025-06-13T08:44:59Z

Sv:

=== Версия 3 ===

==Правила расщепления==

Версия 3 позволяет очень гибко перераспределять поступающие средства, используя такие фичи как расщепление и мультимерчант. Правила задаются в виде JSON:
<pre>
[
{
"field_name": "grp",
"field_value": [1, 2, 13],
"params": [
{
"percent": 100,
"payee_id": 123456,
"description": "Доступ до мережі Інтернет для {{user.fio}}"
}
]
},
{
"field_name": "_district",
"field_value": ["obolon"],
"params": [
{
"percent": 10,
"payee_id": 1000,
"description": "Доступ до мережі Інтернет ({{user.ppc}})"
},
{
"percent": 20,
"payee_id": 1001,
"description": "Послуга техпідтримки"
},
{
"percent": 70,
"payee_id": 1002,
"description": "Послуга відпочинку"
}
]
},
{
"params": [
{
"percent": 100,
"payee_id": 1005,
"description": "Доступ до мережі Інтернет"
}
]
}
]
</pre>

Правило - это блок {...} в котором находятся 3 параметра:
* field_name (необязательный)
* field_value (необязательный)
* params (обязательный) - параметры расщепления

Правила проверяются сверху вниз, и если условия правила совпадают с данными абонента - модуль формирует правила расщепления и прекращает обработку правил.

В примере выше, если група абонента 1, 2 или 13, то расщепление фактически выключается, 100% суммы оплаты пойдет мерчанту 123456.
Если же абонент не находится в этих группах, то проверяется, что его допполе _district имеет значение obolon. В этом случае платеж распределяется между тремя мерчантами 1000, 1001 и 1002.
Во всех остальных случаях 100% суммы оплаты пойдет мерчанту 1005

В поле description в { {...} } можно указывать данные клиента:
<pre>
user.id : id пользователя
user.name : логин
user.fio : ФИО
user.ppc : платежный код
user.grp : номер группы клиента
user.grp_name : имя группы
user.state : on - доступ открыт, off - закрыт
user.state_off : установлен если state равен off
user.contract : договор
user.contract_date : дата договора (timestamp)
user.contract_date_as_text : дата договора в виде dd.mm.yyyy
user.balance : баланс
user.limit_balance : граница отключения
user.block_if_limit : отключать ли запись при достижении границы отключения
user.cstate : техническое состояние (настроить/ремонт/вирусы...) в виде числа
user.cstate_time : время изменения поля cstate (timestamp)
user.comment : комментарий
user.lstate : нужна авторизация/всегда онлайн
user.discount : скидка
user.traf : суммарный трафик
user.traf_in : суммарный трафик к клиенту
user.traf_out : суммарный трафик от клиента
user.traf1 : трафик в байтах направления 1
...
user.traf4 : трафик в байтах направления 4
user.in1 : входящий трафик направления 1
user.out1 : исходящий трафик направления 1
user.recommended_pay : рекомендованная сумма платежа
user.dopdata : дополнительные данные
user.services : подключенные услуги
user.ips : ip адреса
user.pays : платежи
</pre>

Portmone

2025-06-13T08:37:14Z

Sv: /* Правила расщепления */

=== Версия 3 ===

==Правила расщепления==

Версия 3 позволяет очень гибко перераспределять поступающие средства, используя такие фичи как расщепление и мультимерчант. Правила задаются в виде JSON:
<pre>
[
{
"field_name": "grp",
"field_value": [1, 2, 13],
"params": [
{
"percent": 100,
"payee_id": 123456,
"description": "Доступ до мережі Інтернет для {{user.fio}}"
}
]
},
{
"field_name": "_district",
"field_value": ["obolon"],
"params": [
{
"percent": 10,
"payee_id": 1000,
"description": "Доступ до мережі Інтернет ({{user.ppc}})"
},
{
"percent": 20,
"payee_id": 1001,
"description": "Послуга техпідтримки"
},
{
"percent": 70,
"payee_id": 1002,
"description": "Послуга відпочинку"
}
]
},
{
"params": [
{
"percent": 100,
"payee_id": 1005,
"description": "Доступ до мережі Інтернет"
}
]
}
]
</pre>

Правило - это блок {...} в котором находятся 3 параметра:
* field_name (необязательный)
* field_value (необязательный)
* params (обязательный) - параметры расщепления

Правила проверяются сверху вниз, и если условия правила совпадают с данными абонента - модуль формирует правила расщепления и прекращает обработку правил.

В примере выше, если група абонента 1, 2 или 13, то расщепление фактически выключается, 100% суммы оплаты пойдет мерчанту 123456.
Если же абонент не находится в этих группах, то проверяется, что его допполе _district имеет значение obolon. В этом случае платеж распределяется между тремя мерчантами 1000, 1001 и 1002.
Во всех остальных случаях 100% суммы оплаты пойдет мерчанту 1005

В поле description в {{...}} можно указывать данные клиента:
<pre>
user.id : id пользователя
user.name : логин
user.fio : ФИО
user.ppc : платежный код
user.grp : номер группы клиента
user.grp_name : имя группы
user.state : on - доступ открыт, off - закрыт
user.state_off : установлен если state равен off
user.contract : договор
user.contract_date : дата договора (timestamp)
user.contract_date_as_text : дата договора в виде dd.mm.yyyy
user.balance : баланс
user.limit_balance : граница отключения
user.block_if_limit : отключать ли запись при достижении границы отключения
user.cstate : техническое состояние (настроить/ремонт/вирусы...) в виде числа
user.cstate_time : время изменения поля cstate (timestamp)
user.comment : комментарий
user.lstate : нужна авторизация/всегда онлайн
user.discount : скидка
user.traf : суммарный трафик
user.traf_in : суммарный трафик к клиенту
user.traf_out : суммарный трафик от клиента
user.traf1 : трафик в байтах направления 1
...
user.traf4 : трафик в байтах направления 4
user.in1 : входящий трафик направления 1
user.out1 : исходящий трафик направления 1
user.recommended_pay : рекомендованная сумма платежа
user.full : блок информации об абоненте для администратора
user.dopdata : дополнительные данные
user.services : подключенные услуги
user.ips : ip адреса
user.pays : платежи
</pre>

Portmone

2025-06-12T17:46:34Z

Sv:

Portmone

2025-06-12T17:45:54Z

Sv:

2025-01-13T19:25:35Z

Sv:

==Общая информация==
АPI запросы выполняются по http(s)-протоколу, в ответ приходит json. Тестировать АPI можно с консоли, например:

<source lang="bash">
curl 'https://app.nodeny-plus.com.ua/cgi-bin/noapi.pl'
</source>

В ответ приходит сообщение об ошибке «запрос не авторизован»:
<source lang="javascript">
{
"error" : "Вы не авторизованы",
"err_cod" : "unauthorized"
}
</source>

Если в ответе АPI будет присутствовать ключ error - это означает, что произошла ошибка и в данном ключе текст ошибки. В большинстве случаев данный текст можно показывать абонентам. Может присутствовать ключ err_cod - код ошибки, который не зависит от локализации. Варианты:

unauthorized - либо не передана сессия, либо некорректная, либо устарела
wrong_password - неудачная авторизация

Чтобы выполнить АPI-запрос необходимо сперва залогиниться под логином и паролем пользователя и получить идентификатор сессии, который использовать в cookie в последующих запросах.

В cookie в параметре nolang можно указать язык, например, nolang=UA

==Авторизация==

Логин: test
Пароль: 123

<source lang="bash">
curl 'http://app.nodeny-plus.com.ua/cgi-bin/noapi.pl?_uu=test&_pp=123'
</source>

Если логин и пароль верные, приходит ответ:

<source lang="javascript">
{
"ses" : "hHuidO6MqAwTcqOnZF4Qg",
"data" : {
"trust" : 1,
"id" : "357",
"role" : "user"
},
"result" : "auth ok"
}</source>

Нас интересует параметр ses, который необходимо посылать во всех запросах в cookie с именем noses

Обратите внимание на параметр role - показывает кто авторизовался, админ или пользователь

==Версия NoDeny==
<source lang="bash">
curl 'http://app.nodeny-plus.com.ua/cgi-bin/noapi.pl?a=version' --cookie 'noses=hHuidO6MqAwTcqOnZF4Qg'
</source>

<br>

==Функция аpi для пользователя==
===Получение данных пользователя===

<source lang="bash">
curl 'http://app.nodeny-plus.com.ua/cgi-bin/noapi.pl?a=u_main' --cookie 'noses=hHuidO6MqAwTcqOnZF4Qg'
</source>

В полученном ответе:

usr : данные пользователя
services: подключенные услуги
credits : кредиты
pays : платежи

Например:

<source lang="javascript">
{
"services" : [
{
"id" : "1537",
"service_id" : "33",
"next_service_id" : "33",
"auto_renew" : "0",
"tm_start" : "1468324004",
"tm_end" : "1783684004",
"grp_list" : ",1,",
"pay_id" : "4544",
"category" : "",
"module" : "unlim",
"uid" : "357",
"no_renew" : "1",
"description" : "50 Mb unlim",
"tags" : ",speed=123,",
"finish_count" : "1",
"price" : "10",
},{
...
}
}
</source>

Видно, что подключено несколько услуг (2я и последующие заменены на троеточие). next_service_id - id услуги, которая будет подключена когда завершится текущая. Поскольку service_id = next_service_id - будет подключена таже услуга, которая действует в данный момент

===Получение списка сообщений===

<source lang="bash">
curl 'http://app.nodeny-plus.com.ua/cgi-bin/noapi.pl?a=u_message' \
--cookie "noses=hHuidO6MqAwTcqOnZF4Qg"
</source>

Параметр category:
426 - сообщение через внешний сервис
491 - сообщение от клиента
492 - сообщение от клиента
493 - сообщение клиента со смартфона
480 - сообщение клиенту
481 - сообщение клиенту, клиент ознакомлен
482 - сообщение клиенту, блокирующее доступ до ознакомления
488 - многоадресное сообщение клиентам

Параметр from:
user - сообщение от клиента
admin - сообщение клиенту

===Отправка сообщения администрации===

<source lang="bash">
curl 'http://app.nodeny-plus.com.ua/cgi-bin/noapi.pl?a=u_message' \
--cookie "noses=hHuidO6MqAwTcqOnZF4Qg" \
-X POST -d "msg=У меня не работает интернет"
</source>

<br>

===История подключений===

<source lang="bash">
curl 'http://app.nodeny-plus.com.ua/cgi-bin/noapi.pl?a=u_auth_log' \
--cookie "noses=hHuidO6MqAwTcqOnZF4Qg"
</source>

Если параметр end = 0 - подключение в данный момент активно

===Список услуг, которые можно подключить===

<source lang="bash">
curl 'http://app.nodeny-plus.com.ua/cgi-bin/noapi.pl?a=u_srv_select' \
--cookie "noses=hHuidO6MqAwTcqOnZF4Qg"
</source>

Если в услуге установлен ключ why_not, то в нем указана причина, почему данную услугу нельзя подключить. Варианты:
* already - эта услуга уже подключена
* analog - подключена аналогичная услуга и существует запрет на подключение схожих услуг, например, нельзя подключить два тарифа для доступа в интернет

===Подключение услуги===

<source lang="bash">
curl 'http://app.nodeny-plus.com.ua/cgi-bin/noapi.pl?a=u_srv_add&service_id=63' \
--cookie "noses=hHuidO6MqAwTcqOnZF4Qg"
</source>

===Установка "следующей" услуги===

<source lang="bash">
curl 'http://app.nodeny-plus.com.ua/cgi-bin/noapi.pl?a=u_srv_add&cmd=set_next&usr_service_id=1234&service_id=63' \
--cookie 'noses=hHuidO6MqAwTcqOnZF4Qg'
</source>

usr_service_id - это id уже установленной услуги абонента (поле id в таблице users_services)

===Получение кредита===

Информация о кредите, который можно получить:
<source lang="bash">
curl 'http://app.nodeny-plus.com.ua/cgi-bin/noapi.pl?a=u_credit' \
--cookie 'noses=hHuidO6MqAwTcqOnZF4Qg'
</source>

<pre>
{
"credit" : {
"gr" : "грн",
"full_amt" : "3.16",
"commission" : 0,
"days" : 3,
"amt" : 3.16
},
"result" : "ok"
}
</pre>

Получение кредита:
<source lang="bash">
curl 'http://app.nodeny-plus.com.ua/cgi-bin/noapi.pl?a=u_credit&go=1' \
--cookie 'noses=hHuidO6MqAwTcqOnZF4Qg'
</source>

<br><br>

Результат в ключе result:
<pre>
ok : успешно
blocked : существует платеж-блокировка взятия кредита
other_exists : существует активный кредит
no_more : ранее брался кредит и он уже возвращен. Тем не менее после него не было платежей на сумму бОльшую суммы кредита
many_nopay_days : не было ни одного положительного платежа за количество дней, указанных в настройках модуля
</pre>

Пример ответа:
<pre>
{
"result" : "blocked"
}
</pre>

<br><br>

===Пополнение счета карточкой пополнения счета===

<source lang="bash">
curl 'http://app.nodeny-plus.com.ua/cgi-bin/noapi.pl?a=u_cards&cod=21242830587619' \
--cookie 'noses=hHuidO6MqAwTcqOnZF4Qg'
</source>

<br>

Результат в ключе result:
<pre>
ok : успешно
wrong_code : неверный код пополнения
already_activated : карточка уже активирована
</pre>

<br><br>

===Регистрация токена для пуш-уведомлений===

<source lang="bash">
curl 'http://app.nodeny-plus.com.ua/cgi-bin/noapi.pl?a=u_gcm&reg_id=c-kkWVxpBpM:APA91bFZGzWjxjWtnX2m0iu4yq-koveiZCk' \
--cookie 'noses=hHuidO6MqAwTcqOnZF4Qg'
</source>

В результате параметр reg_id должен записаться в таблицу notifications_users

<br><br>

===Создание заявки на оплату в платежной системе Fondy===

<source lang="bash">
curl 'http://app.nodeny-plus.com.ua/cgi-bin/noapi.pl?a=u_fondy&amt=100' \
--cookie 'noses=OIcU//chVAcIQH1AX158Ww'
</source>

Будет возвращен id платежа-заявки для оплаты, а также сумма для оплаты (сумма может быть больше заказанной из-за комиссии)

<br>

===Создание заявки на оплату в платежной системе Liqpay===

<source lang="bash">
curl 'http://app.nodeny-plus.com.ua/cgi-bin/noapi.pl?a=u_lpay&amt=100' \
--cookie 'noses=o5U0SSeFy5FiJWv5GaWjng'
</source>

Будет возвращен id платежа-заявки для оплаты, а также сумма для оплаты (сумма может быть больше заказанной из-за комиссии)

<br><br>

===Автоматическое пополнение счета===
====Список токенов====
<br>
<source lang="bash">
curl 'http://app.nodeny-plus.com.ua/cgi-bin/noapi.pl?a=u_autopays' \
--cookie 'noses=hHuidO6MqAwTcqOnZF4Qg'
</source>

<br>

Результат в ключе result:
<pre>
{
"result" : [
{
"expire_time" : "0",
"last_pay_time" : "28.11.2021 19:48",
"id" : "107",
"type" : "paytoken",
"enabled" : "0",
"uid" : "188",
"create_time" : "1638121721",
"paysystem" : "fondy",
"card" : "473118XXXXXX9680",
"token" : "1e5aXXXXXXXXXXXXXX5b3"
}
]
}

</pre>

Или когда нет ни одного токена:
<pre>
{
"err_cod" : "no_tokens",
"error" : "Ще не підключено жодної карти, по якій можна здійснювати автоматичні платежі.
Вам потрібно здійснити оплату як зазвичай і ми додамо карту, яку ви використовували"
}
</pre>
<br>
<br>

====Включение токена====
<br>
<source lang="bash">
curl 'http://app.nodeny-plus.com.ua/cgi-bin/noapi.pl?a=u_autopays&id=107&act=on' \
--cookie 'noses=hHuidO6MqAwTcqOnZF4Qg'
</source>
<br>

====Выключение токена====
<br>
<source lang="bash">
curl 'http://app.nodeny-plus.com.ua/cgi-bin/noapi.pl?a=u_autopays&id=107&act=off' \
--cookie 'noses=hHuidO6MqAwTcqOnZF4Qg'
</source>
<br>

===Модуль опроса===
<br>
[[Модуль опроса. АPI|Документация]]
<br>
<br>

==Функции аpi для администратора==
===Получение данных абонентов===

<source lang="bash">
curl 'http://app.nodeny-plus.com.ua/cgi-bin/noapi.pl?a=api_users' \
--cookie 'noses=OIcU//chVAcIQH1AX158Ww'
</source>

В ответе:
* dopdata - дополнительные поля учетной записи
* services - активные услуги
** next_title - имя услуги, которая будет подключена после завершения текущей
** next_service_id - id услуги, которая будет подключена после завершения текущей
** set_next_time - время, когда в последний раз была заказана смена услуги (null если не было заказов)
* last_traf - время последней активности по трафику
* last_auth - время последней активности по авторизации

Начиная с ревизии 681: если необходимо получить только определенные поля, то их имена надо задать через запятую в параметре fields:

<source lang="bash">
curl 'http://app.nodeny-plus.com.ua/cgi-bin/noapi.pl?a=api_users&fields=name,last_auth' \
--cookie 'noses=OIcU//chVAcIQH1AX158Ww'
</source>

Для получения всех допполей: fields=dopfields

<br>

===Получение списка тикетов===

<source lang="bash">
curl 'http://app.nodeny-plus.com.ua/cgi-bin/noapi.pl?a=op&act=tickets&start_date=31.01.2023&end_date=16.09.2023' \
--cookie 'noses=OIcU//chVAcIQH1AX158Ww'
</source>

start_date и end_date фильтруют список по дате создания (включительно, т.е. в примере будут получены все тикеты с датой создания от 31.01.2023 00:00:00 до 16.09.2023 23:59:59). end_date необязательный параметр.

Возможные фильтры:
* creator - id создателя тикета
* performer - id любого из исполнителей (performer=0 - без исполнителя)
* level - приоритет
* type - тип (в виде числа). Типы задаються вами в настройках тикетов
* search_str - поиск по фрагменту текста в теме/комментарии или в любом сообщении тикета
* state - состояние:
** -1 - незакрытый тикет
** new - открытый
** active - в работе
** failed - не может быть исполнен
** check - необходима проверка
** alert - тревога
* private - приватность (1 - приватные, 0 - нет)

В ответе:
* id - id тикета
* subject - тема тикета
* comment - комментарий
* state - статус тикета
* client_informed (1 - клиент проинформирован)
* performer_informed (1 - исполнитель проинформирован)
* creator - кто создал тикет
* updater - кто последним изменил тикет
* client - с кем связан тикет, если ни с кем, то {}
* performer - исполнитель 1 или {}
* performer2 - исполнитель 2 или {}
* performer3 - исполнитель 3 или {}
* performer_grp - поле "передано в отдел", когда исполнитель не выбран, однако известно в какой группе он должен быть

Чтобы администратор (оператор) имел доступ к тикетам, необходимо чтобы его административная запись была связана с какой-либо учетной записью в списке клиентов - рекомендуем сделать групу «сотрудники»/«техподдержка»/«монтажники»...

Также у административной записи существует привилегия «Руководитель. Доступ ко всем тикетам». Если данная галка не стоит, то оператор увидит только те тикеты, которые либо не связаны ни с каким абонентом, либо связаны с абонентом, к группе которого есть доступ. Однако недоступный тикет может стать доступным, если в качестве исполнителя (любого из трех) будет назначен текущий оператор либо же параметр «передать в отдел» будет таким же как группа оператора (например, передано в отдел «монтажники»). Таким образом, монтажникам можно не давать доступ к абонентам, а руководитель будет назначать тикет конкретному монтажнику или передавать в отдель и там монтаджники сами разберутся

===Получение всех данных тикета #165 ===

<source lang="bash">
curl 'http://app.nodeny-plus.com.ua/cgi-bin/noapi.pl?a=op&act=tickets&op=edit&id=165' \
--cookie 'noses=OIcU//chVAcIQH1AX158Ww'
</source>

В ответе:

* data - текущие данные тикета
* history - лог изменений

Структура лога:

* created_ts - таймстамп события
* created_time - время события в текстовом виде
* author - id кто изменил запись (по таблице администраторов)
* changes - список измененных полей:
** имя поля
** предыдущее значение
** установленное значение

===Получение данных абонента===

Для учетной записи с id=5:
<source lang="bash">
curl 'http://app.nodeny-plus.com.ua/cgi-bin/noapi.pl?a=u_main&uid=5' \
--cookie 'noses=OIcU//chVAcIQH1AX158Ww'
</source>

<br>

===Получение данных по всем услугам===

<source lang="bash">
curl 'http://app.nodeny-plus.com.ua/cgi-bin/noapi.pl?a=api_services' \
--cookie 'noses=OIcU//chVAcIQH1AX158Ww'
</source>

<br>

===Получение информации по дополнительным полям учетных записей===

<source lang="bash">
curl 'http://app.nodeny-plus.com.ua/cgi-bin/noapi.pl?a=api_dopdata' \
--cookie 'noses=OIcU//chVAcIQH1AX158Ww'
</source>

В ответе:
* title - имя поля
* name - имя поля в базе данных в таблице data0
* flags - параметры поля
** b - убирать пробелы в начале
** c - убирать пробелы в конце
** f - убирать все пробелы
** d - преобразовать к нижнему регистру
** e - транслировать в латинские символы
** q - титульное поле (выводится в общем списке клиентов)
** h - уникальное
** i - запретить редактирование (кроме суперадмина)
** j - сортировать как число на странице поиска абонентов
** k - можно выбрать несколько значений
* type - тип поля

Если тип поля select, то в param будет список значений для данного поля, при этом ключ - строка, которая хранится в базе, значение - строка, которая отображается пользователю

АPI для платежных терминалов

2025-01-13T19:22:12Z

Sv: Sv перейменував сторінку з API для платежных терминалов на АPI для платежных терминалов без створення перенаправлення

==Общая информация==
API запросы выполняются по http(s)-протоколу, в ответ приходит json. В ключе error - код ошибки (0 - отсутствие ошибки)

Тестировать API можно с консоли, например:

<source lang="bash">
curl 'https://app.nodeny-plus.com.ua/cgi-bin/api.pl'
</source>

Опрос урла без каких-либо параметров должен возвращать result = 0:
<pre>
{"error":0}
</pre>

Это можно использовать для тестирования доступности и работоспособности API

==Подписывание данных==

Вместе с данными, терминал должен прислать в параметре '''signature''' строку, которая вычисляется по следующей формуле:
* необходимо отсортировать по именам все посылаемые параметры и объединить символом '|' (вертикальная черта): параметр|значение|параметр|значение
* к полученной строке добавить символ '|' и пароль к API NoDeny
* получить md5 хеш от полученной строки

Например, терминал посылает на API следующие данные:

<pre>
command = info
account = 5982
</pre>

После сортировки и конкатенации получаем строку: '''account|5982|command|info'''

После добавления к полученной строке '''|пароль_от_api''' получаем '''account|5982|command|info|пароль_от_api'''

Далее применяем алгоритм md5 и получаем результат: '''3eb6d78df0be8d54e170b15d596c7706'''

Пример на языке perl:

<pre>
$signature = Digest::MD5->new->add($string.'|'.$api_password)->hexdigest;
</pre>

Пример на bash:
<pre>
echo -n 'account|5982|command|info|hardpassword' | md5sum
</pre>

Итоговый запрос будет следующим:

<source lang="bash">
https://app.nodeny-plus.com.ua/cgi-bin/api.pl?command=info&account=5982&signature=3eb6d78df0be8d54e170b15d596c7706
</source>

==Получение информации об абоненте==

<pre>
command = info
account = персональный платежный код абонента
</pre>

==Создать платеж==

<pre>
command = pay
account = персональный платежный код абонента
amount = денежная сумма
order_id = уникальный id платежа
terminal = идентификатор терминала (необязательный параметр)
</pre>

amount - число с плавающей запятой, разделитель точка, 2 знака после запятой.

При посылке запроса с тем же order_id, который был послан ранее, платеж не создается, но при этом возвращается error = 0.

==Попросить NoDeny залогировать информацию==

<pre>
command = message
message = какой-либо текст
terminal = идентификатор терминала (необязательный параметр)
</pre>

Это можно использовать, например, для регистрации какого-либо события не связанного с завершением пополнения счета. Скажем, клиент ввел свой логин, получил информацию, вставил поддельную купюру или забыл получить сдачу

==Ограничения==

* В данных запрещен символ '|' (вертикальная черта)
* В параметре order_id и terminal не рекомендуется использовать символ двоеточия

==Коды ошибок==

{| class="wikitable"
|-
|1
|Проблема на стороне NoDeny. Возможно следует повторить запрос через время
|-
|2
|API NoDeny отключено
|-
|10
|Со стороны терминала присланы некорректные данные. Если терминал пошлет эти же самые данные - будет возвращена ошибка
|-
|11
|Аккаунт в NoDeny не найден
|-
|12
|Не задана команда
|-
|13
|Неверно задана денежная сумма
|-
|14
|Неверный order id
|}