Ручная проверка работоспособности PayControl v3 — различия между версиями

Материал из PayControl Wiki
Перейти к: навигация, поиск
(→‎Создание пользователя)
(→‎Регистрация ключа в приложении PayControl)
 
(не показано 6 промежуточных версий этого же участника)
Строка 1: Строка 1:
−
{{В работе}}
 
 
=Предварительные условия=
 
=Предварительные условия=
  
Строка 26: Строка 25:
  
 
=Создание пользователя=
 
=Создание пользователя=
−
Необходимо открыть запрос createUser и заполнить его в соответствии с примером, после чего нажать кнопку «Выполнить запрос».
+
*Необходимо открыть запрос createUser и заполнить его в соответствии с примером, после чего нажать кнопку «Выполнить запрос».
  
 
[[Файл:SOAP createUser.png]]
 
[[Файл:SOAP createUser.png]]
  
  
−
Из поля «qrCode» ответа скопировать содержание.
+
*Из поля «qrCode» ответа скопировать содержание.
−
После этого создать файл «pc-user.html» в любом месте на компьютере, открыть его в текстовом редакторе и вставить в него следующее содержимое:
+
*После этого создать файл «pc-user.html» в любом месте на компьютере, открыть его в текстовом редакторе и вставить в него следующее содержимое:
  
 
<syntaxhighlight lang="html"><html>
 
<syntaxhighlight lang="html"><html>
Строка 43: Строка 42:
  
  
−
Сохранить файл и открыть его в любом браузере. Браузер должен отобразить QR-код с ключом пользователя.
+
*Сохранить файл и открыть его в любом браузере. Браузер должен отобразить QR-код с ключом пользователя.
  
 
[[Файл:SOAP QR.png]]
 
[[Файл:SOAP QR.png]]
 
==Регистрация ключа в приложении PayControl==
 
==Регистрация ключа в приложении PayControl==
 
*Откройте приложение PayControl на мобильном телефоне.
 
*Откройте приложение PayControl на мобильном телефоне.
−
*Перейдите в пункт меню Управление ключами.(для Paycontrol Classic)
+
*Нажмите кнопку «Сканировать QR-код»
−
*Нажмите кнопку «Добавить ключ»
 
 
*Отсканируйте QR-код с ключом пользователя.
 
*Отсканируйте QR-код с ключом пользователя.
 
*Задайте имя ключа и пароль.
 
*Задайте имя ключа и пароль.
Строка 56: Строка 54:
  
 
=Создание тестовой транзакции=
 
=Создание тестовой транзакции=
−
Скопируйте UserID из ответа на запрос createUser.
+
*Скопируйте UserID из ответа на запрос createUser.
  
−
Необходимо открыть запрос createTransaction и заполнить его в соответствии с примером, после чего нажать кнопку «Выполнить запрос».
+
[[Файл:SOAP userid.png]]
 +
 
 +
 
 +
*Необходимо открыть запрос createTransaction и заполнить его в соответствии с примером, после чего нажать кнопку «Выполнить запрос».
  
 
Ответ должен выглядеть как на примере ниже.
 
Ответ должен выглядеть как на примере ниже.
 +
 +
[[Файл:SOAP createTransaction.png]]
  
  
−
После выполнения запроса на мобильный телефон должно прийти пуш-уведомление.
+
*После выполнения запроса на мобильный телефон должно прийти пуш-уведомление.
  
 
'''(!!!)''' Пуш-уведомление придет только в том случае, если сервер PayControl настроен на отправку пушей в приложение PayControl. Если он настроен на работу с другим приложением, то уведомление в приложение PayControl не придет.
 
'''(!!!)''' Пуш-уведомление придет только в том случае, если сервер PayControl настроен на отправку пушей в приложение PayControl. Если он настроен на работу с другим приложением, то уведомление в приложение PayControl не придет.
Строка 70: Строка 73:
  
 
Ошибок при подтверждении быть не должно.
 
Ошибок при подтверждении быть не должно.
 +
 
=Просмотр логов серверов PayControl=
 
=Просмотр логов серверов PayControl=
 
Команда для просмотра логов серверов PayControl в консоли:
 
Команда для просмотра логов серверов PayControl в консоли:
Строка 81: Строка 85:
  
 
=Проверка работы коллбэка=
 
=Проверка работы коллбэка=
−
PayControl Server после подтверждения/отмены транзакции отправляет в прикладную систему (ДБО, ЭДО и пр.) коллбэк.
+
*PayControl Server после подтверждения/отмены транзакции отправляет в прикладную систему (ДБО, ЭДО и пр.) коллбэк.
  
−
Адрес коллбэка устанавливается в прикладной системе, его сообщает разработчик прикладной системы.
+
*Адрес коллбэка устанавливается в прикладной системе, его сообщает разработчик прикладной системы.
  
−
Чтобы PayControl Server имел возможность выполнить коллбэк, адрес для него должен быть доступен.
+
*Чтобы PayControl Server имел возможность выполнить коллбэк, адрес для него должен быть доступен.
  
−
Проверка доступности может быть выполнена из консоли PayControl Server, например:
+
*Проверка доступности может быть выполнена из консоли PayControl Server, например:
  
 
<syntaxhighlight lang="bash">
 
<syntaxhighlight lang="bash">

Текущая версия на 11:39, 24 июля 2020

Предварительные условия

  1. Мобильный телефон с установленным приложением PayControl
  2. Установленный PayControl Server
  3. ПО SOAP UI, имеющее доступ к серверу PayControl (PayControl Server) https://www.soapui.org/downloads/soapui.html/
  4. Адрес основного сервиса PayControl
  5. Идентификатор системы PayControl


Настройка SOAP UI

  • После установки SOAP UI необходимо создать проект SOAP:

SOAP Button.png


  • В настройках проекта указать любое имя и адрес основного сервиса PayControl:

SOAP WSDL.png


  • После нажатия ОК проект должен появиться в SOAP UI:

SOAP Request.png

Создание пользователя

  • Необходимо открыть запрос createUser и заполнить его в соответствии с примером, после чего нажать кнопку «Выполнить запрос».

SOAP createUser.png


  • Из поля «qrCode» ответа скопировать содержание.
  • После этого создать файл «pc-user.html» в любом месте на компьютере, открыть его в текстовом редакторе и вставить в него следующее содержимое:
<html>

UserID: [содержание поля userID ответа из SOAP UI] <br/>

<img src="data:image/gif;base64,[содержание поля qrCode ответа из SOAP UI]">

</html>


  • Сохранить файл и открыть его в любом браузере. Браузер должен отобразить QR-код с ключом пользователя.

SOAP QR.png

Регистрация ключа в приложении PayControl

  • Откройте приложение PayControl на мобильном телефоне.
  • Нажмите кнопку «Сканировать QR-код»
  • Отсканируйте QR-код с ключом пользователя.
  • Задайте имя ключа и пароль.
  • Должна появиться надпись: «Ключ успешно зарегистрирован».
  • Если произошла какая-либо ошибка (например, ошибка регистрации push-идентификатора), значит сервер PayControl недоступен или работает с ошибками.

Создание тестовой транзакции

  • Скопируйте UserID из ответа на запрос createUser.

SOAP userid.png


  • Необходимо открыть запрос createTransaction и заполнить его в соответствии с примером, после чего нажать кнопку «Выполнить запрос».

Ответ должен выглядеть как на примере ниже.

SOAP createTransaction.png


  • После выполнения запроса на мобильный телефон должно прийти пуш-уведомление.

(!!!) Пуш-уведомление придет только в том случае, если сервер PayControl настроен на отправку пушей в приложение PayControl. Если он настроен на работу с другим приложением, то уведомление в приложение PayControl не придет.

Подтверждение транзакции в мобильном телефоне

Откройте в мобильном телефоне приложение PayControl и выполните подтверждение операции.

Ошибок при подтверждении быть не должно.

Просмотр логов серверов PayControl

Команда для просмотра логов серверов PayControl в консоли: 

tail -f -n 500 /opt/wildfly/standalone/log/server.log
  • При отсутствии пушей смотреть логи необходимо на сервере PC IS Internal.
  • При ошибках в добавлении ключа в мобильном приложении на сервере PC IS External и PC Server.
  • При ошибках в подтверждении на PC Server.

Проверка работы коллбэка

  • PayControl Server после подтверждения/отмены транзакции отправляет в прикладную систему (ДБО, ЭДО и пр.) коллбэк.
  • Адрес коллбэка устанавливается в прикладной системе, его сообщает разработчик прикладной системы.
  • Чтобы PayControl Server имел возможность выполнить коллбэк, адрес для него должен быть доступен.
  • Проверка доступности может быть выполнена из консоли PayControl Server, например:
curl http://callback-address/test/

Или 

wget http://callback-address/test/

Выполнение этих команд не должно давать сетевой ошибки (например, Connection Refused).

Источник — «https://repo.paycontrol.org/wiki/index.php?title=Ручная_проверка_работоспособности_PayControl_v3&oldid=400»