Перейти к содержанию

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

Материал из PayControl Wiki
Новая страница: «=Предварительные условия= 1. Мобильный телефон с установленным приложением PayControl 2. У…»
 
 
(не показано 14 промежуточных версий этого же участника)
Строка 1: Строка 1:
=Предварительные условия=
=Предварительные условия=
    1. Мобильный телефон с установленным приложением PayControl
 
    2. Установленный PayControl Server
# Мобильный телефон с установленным приложением PayControl
    3. ПО SOAP UI, имеющее доступ к серверу PayControl (PayControl Server) https://www.soapui.org/downloads/soapui.html/
# Установленный PayControl Server
    4. Адрес основного сервиса PayControl
# ПО SOAP UI, имеющее доступ к серверу PayControl (PayControl Server) https://www.soapui.org/downloads/soapui.html/
    5. Идентификатор системы PayControl
# Адрес основного сервиса PayControl
# Идентификатор системы PayControl
 
 
=Настройка SOAP UI=
=Настройка 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» в любом месте на компьютере, открыть его в текстовом редакторе и вставить в него следующее содержимое:
<syntaxhighlight lang="html"><html>
UserID: [содержание поля userID ответа из SOAP UI] <br/>
<img src="data:image/gif;base64,[содержание поля qrCode ответа из SOAP UI]">
</html></syntaxhighlight>


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


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


=Создание тестовой транзакции=
=Создание тестовой транзакции=
*Скопируйте UserID из ответа на запрос createUser.
[[Файл:SOAP userid.png]]
*Необходимо открыть запрос createTransaction и заполнить его в соответствии с примером, после чего нажать кнопку «Выполнить запрос».
Ответ должен выглядеть как на примере ниже.
[[Файл:SOAP createTransaction.png]]
*После выполнения запроса на мобильный телефон должно прийти пуш-уведомление.


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


=Просмотр логов серверов PayControl=
=Просмотр логов серверов PayControl=
Команда для просмотра логов серверов PayControl в консоли:
<syntaxhighlight lang="bash">
tail -f -n 500 /opt/wildfly/standalone/log/server.log
</syntaxhighlight>
* При отсутствии пушей смотреть логи необходимо на сервере PC IS Internal.
* При ошибках в добавлении ключа в мобильном приложении на сервере PC IS External и PC Server.
* При ошибках в подтверждении на PC Server.


=Проверка работы коллбэка=
=Проверка работы коллбэка=
*PayControl Server после подтверждения/отмены транзакции отправляет в прикладную систему (ДБО, ЭДО и пр.) коллбэк.
*Адрес коллбэка устанавливается в прикладной системе, его сообщает разработчик прикладной системы.
*Чтобы PayControl Server имел возможность выполнить коллбэк, адрес для него должен быть доступен.
*Проверка доступности может быть выполнена из консоли PayControl Server, например:
<syntaxhighlight lang="bash">
curl http://callback-address/test/
</syntaxhighlight>
Или
<syntaxhighlight lang="bash">
wget http://callback-address/test/
</syntaxhighlight>
Выполнение этих команд не должно давать сетевой ошибки (например, Connection Refused).

Текущая версия от 08: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:


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


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

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

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


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

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

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

</html>


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

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

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

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

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


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

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


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

(!!!) Пуш-уведомление придет только в том случае, если сервер 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).