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

Материал из PayControl Wiki
Перейти к: навигация, поиск
(→‎Проверка работы коллбэка)
(→‎Регистрация ключа в приложении PayControl)
 
(не показано 9 промежуточных версий этого же участника)
Строка 1: Строка 1:
−
{{В работе}}
 
 
=Предварительные условия=
 
=Предварительные условия=
  
Строка 7: Строка 6:
 
# Адрес основного сервиса PayControl
 
# Адрес основного сервиса PayControl
 
# Идентификатор системы PayControl
 
# Идентификатор системы PayControl
 +
  
 
=Настройка SOAP UI=
 
=Настройка SOAP UI=
−
После установки SOAP UI необходимо создать проект SOAP:
 
  
 +
*После установки SOAP UI необходимо создать проект SOAP:
  
−
В настройках проекта указать любое имя и адрес основного сервиса PayControl:
+
[[Файл:SOAP Button.png]]
  
−
После нажатия ОК проект должен появиться в SOAP UI:
+
 
 +
*В настройках проекта указать любое имя и адрес основного сервиса PayControl:
 +
 
 +
[[Файл:SOAP WSDL.png]]
 +
 
 +
 
 +
*После нажатия ОК проект должен появиться в SOAP UI:
 +
 
 +
[[Файл:SOAP Request.png]]
  
 
=Создание пользователя=
 
=Создание пользователя=
−
Необходимо открыть запрос createUser и заполнить его в соответствии с примером, после чего нажать кнопку «Выполнить запрос».
+
*Необходимо открыть запрос createUser и заполнить его в соответствии с примером, после чего нажать кнопку «Выполнить запрос».
 +
 
 +
[[Файл:SOAP createUser.png]]
 +
 
  
 +
*Из поля «qrCode» ответа скопировать содержание.
 +
*После этого создать файл «pc-user.html» в любом месте на компьютере, открыть его в текстовом редакторе и вставить в него следующее содержимое:
  
−
Из поля «qrCode» ответа скопировать содержание.
+
<syntaxhighlight lang="html"><html>
−
После этого создать файл «pc-user.html» в любом месте на компьютере, открыть его в текстовом редакторе и вставить в него следующее содержимое:
 
  
 +
UserID: [содержание поля userID ответа из SOAP UI] <br/>
  
−
Сохранить файл и открыть его в любом браузере. Браузер должен отобразить QR-код с ключом пользователя.
+
<img src="data:image/gif;base64,[содержание поля qrCode ответа из SOAP UI]">
 +
 
 +
</html></syntaxhighlight>
 +
 
 +
 
 +
*Сохранить файл и открыть его в любом браузере. Браузер должен отобразить QR-код с ключом пользователя.
 +
 
 +
[[Файл:SOAP QR.png]]
 
==Регистрация ключа в приложении PayControl==
 
==Регистрация ключа в приложении PayControl==
 +
*Откройте приложение PayControl на мобильном телефоне.
 +
*Нажмите кнопку «Сканировать QR-код»
 +
*Отсканируйте QR-код с ключом пользователя.
 +
*Задайте имя ключа и пароль.
 +
*Должна появиться надпись: «Ключ успешно зарегистрирован».
 +
*Если произошла какая-либо ошибка (например, ошибка регистрации push-идентификатора), значит сервер PayControl недоступен или работает с ошибками.
 +
 
=Создание тестовой транзакции=
 
=Создание тестовой транзакции=
−
Скопируйте UserID из ответа на запрос createUser.
+
*Скопируйте UserID из ответа на запрос createUser.
 +
 
 +
[[Файл:SOAP userid.png]]
 +
 
  
−
Необходимо открыть запрос createTransaction и заполнить его в соответствии с примером, после чего нажать кнопку «Выполнить запрос».
+
*Необходимо открыть запрос createTransaction и заполнить его в соответствии с примером, после чего нажать кнопку «Выполнить запрос».
  
 
Ответ должен выглядеть как на примере ниже.
 
Ответ должен выглядеть как на примере ниже.
 +
 +
[[Файл:SOAP createTransaction.png]]
  
  
−
После выполнения запроса на мобильный телефон должно прийти пуш-уведомление.
+
*После выполнения запроса на мобильный телефон должно прийти пуш-уведомление.
  
 
'''(!!!)''' Пуш-уведомление придет только в том случае, если сервер PayControl настроен на отправку пушей в приложение PayControl. Если он настроен на работу с другим приложением, то уведомление в приложение PayControl не придет.
 
'''(!!!)''' Пуш-уведомление придет только в том случае, если сервер PayControl настроен на отправку пушей в приложение PayControl. Если он настроен на работу с другим приложением, то уведомление в приложение PayControl не придет.
Строка 41: Строка 73:
  
 
Ошибок при подтверждении быть не должно.
 
Ошибок при подтверждении быть не должно.
 +
 
=Просмотр логов серверов PayControl=
 
=Просмотр логов серверов PayControl=
 
Команда для просмотра логов серверов PayControl в консоли:
 
Команда для просмотра логов серверов PayControl в консоли:
Строка 52: Строка 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»