PayControl3.x Регистрация прикладной системы

Материал из PayControl Wiki
Перейти к: навигация, поиск

PayControl в своей работе оперирует понятием Прикладная система. Это внешняя, по отношению к PayControl система, использующая PayControl в качестве средства электронной подписи и/или подтверждения транзакций.
Для каждой подключённой прикладной системы формируется её уникальный идентификатор в формате UUID.
К Прикладной системе привязаны пользователи, к ним, в свою очередь, ключи, транзакции и прочее.
К свойствам Прикладной системы относятся 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. Биллинговый период

Регистрация прикладной системы на сервере PayControl

При помощи 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, либо ошибка с описанием