Установка и настройка биллинга

Интеграция с Universal Terminals

Под выражением "Universal Terminals" подразумеваются платежные системы по приему оплаты через терминалы, которые могут работать по любой предложенной им схеме взаимодействия (требуемая схема взаимодействия описана ниже).

• Добавить платежную систему "Universal Terminals" в биллинге RootPanel
  
  Настройки платежной системы:
  
  1. Валюта - указать валюту, используемую платежной системой
  2. Логин платежной системы - указать логин, выданный платежной системой
  3. Пароль платежной системы - указать пароль, выданный платежной системой
  
  

Для зачисления платежа на счет пользователя, платежная система должна выполнить запрос к биллинговой системе по протоколу HTTP(S) с передачей требуемых для этого параметров методом GET.

• Адрес для запросов
  
  http(s)://ваш_домен/_rootpay/uniterm/online.php
  
  Пример запроса для проверки существования пользователя:
  
  https://ваш_домен/_rootpay/uniterm/online.php?action=check&uniterm_login=test&user_id=1000&hash=c5550d7d03382e6bd36e777b1d818888
  
  Пример запроса для зачисления платежа на счет пользователя:
  
  https://ваш_домен/_rootpay/uniterm/online.php?action=pay&uniterm_login=test&uniterm_id=25&user_id=1000&amount=200&txn=123123123&hash=d5690d7d02482e6bd36e777b1d819799
  
  
• Параметры запросов
  
  Обязательные параметры для всех запросов:
  
  1. action - тип запроса. Допустимые значения: check - проверка существования пользователя; pay - зачисление платежа на счет пользователя
  2. uniterm_login - логин платежной системы (выдается платежной системой). Рекомендуется использовать название платежной системы. Допустимые символы: a-z0-9_
  3. user_id - уникальный идентификатор (ID) пользователя в биллинговой системе. Допустимые символы: 0-9
  4. hash - контрольная подпись. Метод формирования контрольной подписи описан ниже. Допустимые символы: a-zA-Z0-9
  
  Обязательные параметры для зачисления платежа на счет пользователя:
  
  1. amount - полная сумма платежа (включая комиссию платежной системы) в валюте платежной системы. Допустимые символы: 0-9.,
  2. txn - уникальный идентификатор (ID) платежа в платежной системе. Допустимые символы: a-z0-9_
  
  Не обязательные параметры для зачисления платежа на счет пользователя:
  
  1. uniterm_id - уникальный идентификатор (ID) терминала, через который произведен платеж. Допустимые символы: a-zA-Z0-9_
  
  
• Формирование контрольной подписи
  
  Контрольная подпись формируется путем получения md5-хеша для строки, полученной путем склеивания определенных параметров запроса с md5-хешем пароля платежной системы (выдается платежной системой, далее password):
  
  hash = md5( uniterm_login + user_id + amount + txn + md5(password) )
  
  Пример на PHP:
  
  $hash = md5($uniterm_login.$user_id.$amount.$txn.md5($password));
  
  
• Ответ на запрос для проверки существования пользователя
  
  В качестве ответа на запрос, биллинговая система возвращает XML-документ в кодировке UTF-8, содержащий код ответа и его расшифровку (возможные коды и их расшифровки описаны ниже), а так же, в случае успешной проверки, полное имя пользователя (Фамилия Имя Отчество).
  
  Пример положительного ответа:
  
  <?xml version="1.0" encoding="utf-8" ?>
  <response>
  <code>0</code>
  <message>Пользователь существует, возможен прием платежей.</message>
  <name>Иванов Петр Михайлович</name>
  </response>
  
  Пример отрицательного ответа:
  
  <?xml version="1.0" encoding="utf-8" ?>
  <response>
  <code>6</code>
  <message>Пользователь с указанным ID не найден.</message>
  </response>
  
  
• Ответ на запрос для зачисления платежа на счет пользователя
  
  В качестве ответа на запрос, биллинговая система возвращает XML-документ в кодировке UTF-8, содержащий код ответа и его расшифровку (возможные коды и их расшифровки описаны ниже), а так же, в случае успешного зачисления платежа на счет пользователя, дату/время проведения платежа и id платежа в биллинговой системе.
  
  Пример положительного ответа:
  
  <?xml version="1.0" encoding="utf-8" ?>
  <response>
  <code>0</code>
  <message>Платеж принят.</message>
  <id>1015</id>
  <date>2016-01-25 13:24:41</date>
  </response>
  
  Пример отрицательного ответа:
  
  <?xml version="1.0" encoding="utf-8" ?>
  <response>
  <code>8</code>
  <message>Платеж с указанным ID уже существует.</message>
  </response>
  
  
• Коды ответов на запрос
  
  0 - Пользователь существует, возможен прием платежей.
  0 - Платеж принят.
  1 - Не указан входящий параметр.
  2 - Платежная система не найдена.
  2 - Платежная система не активна.
  3 - Внутренний баланс отключен.
  4 - Неправильная контрольная подпись.
  5 - IP-адрес отсутствует в списке доступа.
  6 - Пользователь с указанным ID не найден.
  6 - Пользователь с указанным ID заблокирован.
  7 - Недопустимая сумма платежа.
  8 - Платеж с указанным ID уже существует.
  
  

Примечание: Если у Вас возникли какие-либо вопросы или проблемы с установкой, обновлением или настройкой, либо Вы заметили неточности в инструкции, пожалуйста, свяжитесь с нами!