PayControl3.x Регистрация прикладной системы — различия между версиями

Материал из PayControl Wiki
Перейти к: навигация, поиск
Строка 39: Строка 39:
 
:: 2. Выполните команду
 
:: 2. Выполните команду
 
:::<syntaxhighlight lang="bash">curl --header "Content-Type: text/xml;charset=UTF-8" --header "SOAPAction: registerSystem" --data @request.xml  http://<host>:<port>/ws/PayControlServiceV3</syntaxhighlight>
 
:::<syntaxhighlight lang="bash">curl --header "Content-Type: text/xml;charset=UTF-8" --header "SOAPAction: registerSystem" --data @request.xml  http://<host>:<port>/ws/PayControlServiceV3</syntaxhighlight>
 +
:: 3. В ответ должен быть получен XML-ответ от сервиса с указанием '''systemId''', либо ошибка с описанием

Версия 17:44, 23 ноября 2018

PayControl в своей работе оперирует понятием Прикладная система.
Это идентификатор в формате GUID, который идентифицирует систему, работающую с PayControl. К Прикладной системе привязаны пользователи, к ним, в свою очередь, ключи, транзакции и прочее. К свойствам Прикладной системы относятся URL-ы для взаимодействия с сервером, различные настройки и пр.

Запрос на регистрацию

Запрос на регистрацию Прикладной системы формируется в SafeTech и, при необходимости, передаётся Заказчику в текстовом виде. Для формирования запроса необходимы следующие параметры:

  1. Название системы
  2. Описание системы (произвольное)
  3. URL PayControl Interaction Server (External) - адрес, на который будут обращаться мобильные устройства
  4. URL PayControl Interaction Server (Internal) - адрес сервиса отправки пуш-уведомлений (может быть PC Inform)
  5. Срок жизни ключей
  6. Тип биллинга (Pre-pay, Post-pay)
  7. Биллинговый период

Регистрация при помощи SOAP UI

Для выполнения запроса через графический интерфейс SOAP UI необходимо

  1. Скачать и установить SOAP UI https://www.soapui.org/downloads/soapui.html
  2. Добавить новый проект SOAP
  3. В поле "Initial WSDL" вписать адрес PayControl Server (например, https://dev.paycontrol.org/ws/PayControlServiceV3?wsdl), указать удобное название, нажать "Ок"
  4. Раскрыть созданный проект
  5. Выбрать запрос registerSystem -> Request 1
  6. В тег request вместо знака ? вставить запрос, полученный от SafeTech
  7. Нажать кнопку "Выполнить запрос"
  8. В области ответа должен появиться ответ от сервиса с указанием systemId, либо ошибка с описанием

Регистрация при помощи curl

Запрос может быть выполнен при помощи программы curl

1. Создайте файл с запросом на регистрацию в файл, например request.xml, следующего содержания:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:pay="http://ws.safetech.ru/PayControlV3/">
   <soapenv:Header/>
   <soapenv:Body>
      <pay:registerSystemRequest>
         <request>[запрос на регистрацию, полученный от SafeTech]</request>
      </pay:registerSystemRequest>
   </soapenv:Body>
</soapenv:Envelope>
2. Выполните команду
curl --header "Content-Type: text/xml;charset=UTF-8" --header "SOAPAction: registerSystem" --data @request.xml  http://<host>:<port>/ws/PayControlServiceV3
3. В ответ должен быть получен XML-ответ от сервиса с указанием systemId, либо ошибка с описанием