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

2025-01-13T19:22:12Z

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
|}

АPI для платежных терминалов - Історія редагувань

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