API для платежных терминалов: відмінності між версіями

Версія за 15:01, 9 серпня 2016

Общая информация

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

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

curl 'https://app.nodeny-plus.com.ua/cgi-bin/api.pl'

Опрос урла без каких-либо параметров должен возвращать result = 0:

   {"error":0}

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

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

Вместе с данными, терминал должен прислать в параметре signature строку, которая вычисляется по следующей формуле:

необходимо отсортировать по именам все посылаемые параметры и объединить символом '|' (вертикальная черта): параметр|значение|параметр|значение
к полученной строке добавить символ '|' и пароль к API NoDeny
получить mdp5 хеш для полученной строки

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

command = info
account = 5982

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Ограничения

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

Коды ошибок

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

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