PayControl3.x Регистрация прикладной системы — различия между версиями
(→Регистрация при помощи curl) |
м |
||
(не показана 1 промежуточная версия этого же участника) | |||
Строка 1: | Строка 1: | ||
− | PayControl в своей работе оперирует понятием Прикладная система.<br> | + | PayControl в своей работе оперирует понятием Прикладная система. Это внешняя, по отношению к PayControl система, использующая PayControl в качестве средства электронной подписи и/или подтверждения транзакций.<br> |
− | + | Для каждой подключённой прикладной системы формируется её уникальный идентификатор в формате UUID.<br> | |
К Прикладной системе привязаны пользователи, к ним, в свою очередь, ключи, транзакции и прочее.<br> | К Прикладной системе привязаны пользователи, к ним, в свою очередь, ключи, транзакции и прочее.<br> | ||
К свойствам Прикладной системы относятся URL-ы для взаимодействия с сервером, различные настройки и пр. | К свойствам Прикладной системы относятся URL-ы для взаимодействия с сервером, различные настройки и пр. | ||
=Запрос на регистрацию= | =Запрос на регистрацию= | ||
− | Запрос на регистрацию Прикладной системы формируется | + | Запрос на регистрацию Прикладной системы формируется компанией SafeTech и, при необходимости, передаётся Заказчику в текстовом виде. |
Для формирования запроса необходимы следующие параметры: | Для формирования запроса необходимы следующие параметры: | ||
# Название системы | # Название системы | ||
Строка 15: | Строка 15: | ||
# Биллинговый период | # Биллинговый период | ||
− | =Регистрация | + | =Регистрация прикладной системы на сервере PayControl= |
+ | ==При помощи SOAP UI== | ||
Для выполнения запроса через графический интерфейс SOAP UI необходимо | Для выполнения запроса через графический интерфейс SOAP UI необходимо | ||
# Скачать и установить SOAP UI https://www.soapui.org/downloads/soapui.html | # Скачать и установить SOAP UI https://www.soapui.org/downloads/soapui.html | ||
Строка 26: | Строка 27: | ||
# В области ответа должен появиться ответ от сервиса с указанием '''systemId''', либо ошибка с описанием | # В области ответа должен появиться ответ от сервиса с указанием '''systemId''', либо ошибка с описанием | ||
− | = | + | ==При помощи curl== |
Запрос может быть выполнен при помощи программы curl | Запрос может быть выполнен при помощи программы curl | ||
− | + | # Создайте файл с запросом на регистрацию, например request.xml, следующего содержания: | |
− | + | #:<syntaxhighlight lang="xml"><soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:pay="http://ws.safetech.ru/PayControlV3/"> | |
<soapenv:Header/> | <soapenv:Header/> | ||
<soapenv:Body> | <soapenv:Body> | ||
Строка 37: | Строка 38: | ||
</soapenv:Body> | </soapenv:Body> | ||
</soapenv:Envelope></syntaxhighlight> | </soapenv:Envelope></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> | |
− | + | # В ответ должен быть получен XML-ответ от сервиса с указанием '''systemId''', либо ошибка с описанием |
Текущая версия на 12:22, 7 декабря 2018
PayControl в своей работе оперирует понятием Прикладная система. Это внешняя, по отношению к PayControl система, использующая PayControl в качестве средства электронной подписи и/или подтверждения транзакций.
Для каждой подключённой прикладной системы формируется её уникальный идентификатор в формате UUID.
К Прикладной системе привязаны пользователи, к ним, в свою очередь, ключи, транзакции и прочее.
К свойствам Прикладной системы относятся URL-ы для взаимодействия с сервером, различные настройки и пр.
Содержание
Запрос на регистрацию
Запрос на регистрацию Прикладной системы формируется компанией SafeTech и, при необходимости, передаётся Заказчику в текстовом виде. Для формирования запроса необходимы следующие параметры:
- Название системы
- Описание системы (произвольное)
- URL PayControl Interaction Server (External) - адрес, на который будут обращаться мобильные устройства
- URL PayControl Interaction Server (Internal) - адрес сервиса отправки пуш-уведомлений (может быть PC Inform)
- Срок жизни ключей
- Тип биллинга (Pre-pay, Post-pay)
- Биллинговый период
Регистрация прикладной системы на сервере PayControl
При помощи SOAP UI
Для выполнения запроса через графический интерфейс SOAP UI необходимо
- Скачать и установить SOAP UI https://www.soapui.org/downloads/soapui.html
- Добавить новый проект SOAP
- В поле "Initial WSDL" вписать адрес PayControl Server (например, https://dev.paycontrol.org/ws/PayControlServiceV3?wsdl), указать удобное название, нажать "Ок"
- Раскрыть созданный проект
- Выбрать запрос registerSystem -> Request 1
- В тег request вместо знака ? вставить запрос, полученный от SafeTech
- Нажать кнопку "Выполнить запрос"
- В области ответа должен появиться ответ от сервиса с указанием systemId, либо ошибка с описанием
При помощи curl
Запрос может быть выполнен при помощи программы curl
- Создайте файл с запросом на регистрацию, например 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>
- Выполните команду
curl --header "Content-Type: text/xml;charset=UTF-8" --header "SOAPAction: registerSystem" --data @request.xml http://<host>:<port>/ws/PayControlServiceV3
- В ответ должен быть получен XML-ответ от сервиса с указанием systemId, либо ошибка с описанием