PayControl Inform - История изменений

A.bursakov: /* Android */

2020-12-08T09:42:07Z

Android

← Предыдущая версия		Версия от 09:42, 8 декабря 2020
Строка 126:		Строка 126:

	Примеры отправки запроса при помощи утилиты [[wikipedia:ru:curl\|cURL]]:		Примеры отправки запроса при помощи утилиты [[wikipedia:ru:curl\|cURL]]:
	====Android====		====Android и iOS через Firebase====
	<syntaxhighlight lang="bash">		<syntaxhighlight lang="bash">
	curl \		curl \
Строка 134:		Строка 134:
	http://<hostname>/api/notification/		http://<hostname>/api/notification/
	</syntaxhighlight>		</syntaxhighlight>

	====iOS====		====iOS====
	<syntaxhighlight lang="bash">		<syntaxhighlight lang="bash">

A.bursakov: /* Настройка */

2020-07-31T14:46:17Z

Настройка

@@ Строка 26: / Строка 26: @@
 |colspan="3" style="text-align: center;"|'''Apple-pusher'''
 |-
-|APNS_CERT||/var/app/configuration/apns/ru.safe-tech.PayControl.v3.pem || Файл сертификата для аутентификации на APNS для отправки push-уведомлений
+|APNS_AUTH_TYPE||key||Тип аутентификации:
 |-
 |APPLE_PUSHER_PREFETCH_COUNT||2500||Количество забираемых сообщений из очереди

A.bursakov: /* Получение полезной нагрузки */

2019-04-23T13:49:50Z

Получение полезной нагрузки

← Предыдущая версия		Версия от 13:49, 23 апреля 2019
Строка 204:		Строка 204:
	</syntaxhighlight>		</syntaxhighlight>
	где:		где:
	* auth_token - авторизационный токен, вычисляемый как HMAC(sha256(<device_token>), <uuid>)		* auth_token - авторизационный токен, вычисляемый как HMAC-SHA256(sha256(<device_token>), <uuid>)
	* uuid - идентификатор запроса на уведомление		* uuid - идентификатор запроса на уведомление
	====Пример расчёта auth_token (Android)====		====Пример расчёта auth_token (Android)====
Строка 216:		Строка 216:
	Например, корректное значение можно сформировать на сайте https://www.freeformatter.com/hmac-generator.html		Например, корректное значение можно сформировать на сайте https://www.freeformatter.com/hmac-generator.html
	====Пример расчёта auth_token (iOS)====		====Пример расчёта auth_token (iOS)====
			[[Файл:PCInform HMAC calculation iOS.png\|мини\|справа\|PCInform HMAC calculation iOS]]
	Например, для идентификатора транзакции:		Например, для идентификатора транзакции:
	<pre>f811fd85-eddc-40fd-ac8d-1bd8f1186a78</pre>		<pre>f811fd85-eddc-40fd-ac8d-1bd8f1186a78</pre>
	и идентификатора для уведомлений:		и идентификатора для уведомлений:
	<pre>3b14bfec592ddc722b1c9f005dcaedfebf03fcc8b92358eb7a0d8b4069f7129c</pre>		<pre>3b14bfec592ddc722b1c9f005dcaedfebf03fcc8b92358eb7a0d8b4069f7129c</pre>для которого HEX-значение SHA-256 будет равным:
			<pre>65dfe2ca14542abad02b859b997858a2da8e85d25b7bb3c12dd93eb6c3a6a5d5</pre>
	должно вычисляться следующее значение HMAC:		должно вычисляться следующее значение HMAC:
	<pre>c3756d24960ce4e33b1a134e5be5a235a55671c4fb0f8a9b5cfb94b7d8726d50</pre>		<pre>c3756d24960ce4e33b1a134e5be5a235a55671c4fb0f8a9b5cfb94b7d8726d50</pre>
	~~Сайт из предыдущего примера формирует некорректное~~ значение ~~для iOS~~.		Например, корректное значение можно сформировать на сайте https://cryptii.com/pipes/hmac

	===Ответ===		===Ответ===
Строка 228:		Строка 230:
	* Если токен корректный, но полезной нагрузки нет, то сервис возвращает 204		* Если токен корректный, но полезной нагрузки нет, то сервис возвращает 204
	* Если токен корректный и полезная нагрузка есть, то сервис возвращает его с кодом 200. Пример:<syntaxhighlight lang="json">{"uuid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx", "payload": "dGVzdA0KdGVzdCBQYXlDb250cm9sIEluZm9ybQ0KUGF5Q29udHJvbCBJbmZvcm0gdGVzdA0KdGVzdA=="}</syntaxhighlight>		* Если токен корректный и полезная нагрузка есть, то сервис возвращает его с кодом 200. Пример:<syntaxhighlight lang="json">{"uuid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx", "payload": "dGVzdA0KdGVzdCBQYXlDb250cm9sIEluZm9ybQ0KUGF5Q29udHJvbCBJbmZvcm0gdGVzdA0KdGVzdA=="}</syntaxhighlight>

	==Callback==		==Callback==
	PC Inform с использованием callback-адреса, указанного при создании задачи, выполняет HTTP POST вызов в Прикладную систему для уведомления о статусе получения уведомления.		PC Inform с использованием callback-адреса, указанного при создании задачи, выполняет HTTP POST вызов в Прикладную систему для уведомления о статусе получения уведомления.

A.bursakov: /* Пример расчёта auth_token (iOS) */

2019-04-22T15:11:14Z

Пример расчёта auth_token (iOS)

← Предыдущая версия		Версия от 15:11, 22 апреля 2019
Строка 222:		Строка 222:
	должно вычисляться следующее значение HMAC:		должно вычисляться следующее значение HMAC:
	<pre>c3756d24960ce4e33b1a134e5be5a235a55671c4fb0f8a9b5cfb94b7d8726d50</pre>		<pre>c3756d24960ce4e33b1a134e5be5a235a55671c4fb0f8a9b5cfb94b7d8726d50</pre>
	Сайт ~~https://www.freeformatter.com/hmac-generator.html~~ формирует некорректное значение.		Сайт из предыдущего примера формирует некорректное значение для iOS.

	===Ответ===		===Ответ===

A.bursakov: /* Пример расчёта auth_token */

2019-04-22T15:08:34Z

Пример расчёта auth_token

← Предыдущая версия		Версия от 15:08, 22 апреля 2019
Строка 206:		Строка 206:
	* auth_token - авторизационный токен, вычисляемый как HMAC(sha256(<device_token>), <uuid>)		* auth_token - авторизационный токен, вычисляемый как HMAC(sha256(<device_token>), <uuid>)
	* uuid - идентификатор запроса на уведомление		* uuid - идентификатор запроса на уведомление
	====Пример расчёта auth_token====		====Пример расчёта auth_token (Android)====
	[[Файл:PCInform HMAC calculation.png\|мини\|справа\|PCInform HMAC calculation]]		[[Файл:PCInform HMAC calculation.png\|мини\|справа\|PCInform HMAC calculation]]
	Например, для идентификатора транзакции:		Например, для идентификатора транзакции:
Строка 215:		Строка 215:
	<pre>4f84bc0f9fffc793aa6a2e6b010737c3a5294fd2853111bcef4728af486f8263</pre>		<pre>4f84bc0f9fffc793aa6a2e6b010737c3a5294fd2853111bcef4728af486f8263</pre>
	Например, корректное значение можно сформировать на сайте https://www.freeformatter.com/hmac-generator.html		Например, корректное значение можно сформировать на сайте https://www.freeformatter.com/hmac-generator.html
			====Пример расчёта auth_token (iOS)====
			Например, для идентификатора транзакции:
			<pre>f811fd85-eddc-40fd-ac8d-1bd8f1186a78</pre>
			и идентификатора для уведомлений:
			<pre>3b14bfec592ddc722b1c9f005dcaedfebf03fcc8b92358eb7a0d8b4069f7129c</pre>
			должно вычисляться следующее значение HMAC:
			<pre>c3756d24960ce4e33b1a134e5be5a235a55671c4fb0f8a9b5cfb94b7d8726d50</pre>
			Сайт https://www.freeformatter.com/hmac-generator.html формирует некорректное значение.

	===Ответ===		===Ответ===
	* Если токен некорректный, то сервис возвращает 401		* Если токен некорректный, то сервис возвращает 401

A.bursakov: /* Передача uuid на мобильное устройство */

2019-04-19T10:17:05Z

Передача uuid на мобильное устройство

@@ Строка 135: / Строка 135: @@
 Идентификатор сообщения (в формате UUID) будет принудительно (с версии apple-pusher 1.0.014 и google-pusher 1.0.009) направляться в Push-уведомлении, в параметре '''pcinform_uuid'''. Примеры:
 ====Android====
 <syntaxhighlight lang="json">{
     "notification":{
@@ Строка 155: / Строка 146: @@
        "pcinform_uuid":"4df3823b-4767-44a9-87e9-d7e722ef5b1d"
+    }
 }</syntaxhighlight>

A.bursakov: /* Отправка уведомления */

2019-04-12T07:57:05Z

Отправка уведомления

@@ Строка 132: / Строка 132: @@
 {"uuid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx"}
 </syntaxhighlight>
 ==Информация о состоянии Push-уведомления==

A.bursakov в 12:56, 11 марта 2019

2019-03-11T12:56:04Z

← Предыдущая версия		Версия от 12:56, 11 марта 2019
Строка 182:		Строка 182:
	* auth_token - авторизационный токен, вычисляемый как HMAC(sha256(<device_token>), <uuid>)		* auth_token - авторизационный токен, вычисляемый как HMAC(sha256(<device_token>), <uuid>)
	* uuid - идентификатор запроса на уведомление		* uuid - идентификатор запроса на уведомление
	====Пример расчёта ~~HMAC~~====		====Пример расчёта auth_token====
			[[Файл:PCInform HMAC calculation.png\|мини\|справа\|PCInform HMAC calculation]]
	Например, для идентификатора транзакции:		Например, для идентификатора транзакции:
	<pre>c03a6d7f-5b5c-49af-be5c-6ea380080cb7</pre>		<pre>c03a6d7f-5b5c-49af-be5c-6ea380080cb7</pre>
Строка 190:		Строка 191:
	<pre>4f84bc0f9fffc793aa6a2e6b010737c3a5294fd2853111bcef4728af486f8263</pre>		<pre>4f84bc0f9fffc793aa6a2e6b010737c3a5294fd2853111bcef4728af486f8263</pre>
	Например, корректное значение можно сформировать на сайте https://www.freeformatter.com/hmac-generator.html		Например, корректное значение можно сформировать на сайте https://www.freeformatter.com/hmac-generator.html
	~~[[Файл:PCInform HMAC calculation.png\|мини\|слева\|PCInform HMAC calculation]]~~

	===Ответ===		===Ответ===
	* Если токен некорректный, то сервис возвращает 401		* Если токен некорректный, то сервис возвращает 401
	* Если токен, корректный, но полезной нагрузки нет, то сервис возвращает 204		* Если токен корректный, но полезной нагрузки нет, то сервис возвращает 204
	* Если токен корректный и полезная нагрузка есть, то сервис возвращает его с кодом 200. Пример:<syntaxhighlight lang="json">{"uuid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx", "payload": "dGVzdA0KdGVzdCBQYXlDb250cm9sIEluZm9ybQ0KUGF5Q29udHJvbCBJbmZvcm0gdGVzdA0KdGVzdA=="}</syntaxhighlight>		* Если токен корректный и полезная нагрузка есть, то сервис возвращает его с кодом 200. Пример:<syntaxhighlight lang="json">{"uuid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx", "payload": "dGVzdA0KdGVzdCBQYXlDb250cm9sIEluZm9ybQ0KUGF5Q29udHJvbCBJbmZvcm0gdGVzdA0KdGVzdA=="}</syntaxhighlight>
	==Callback==		==Callback==

A.bursakov: /* Пример рассчёта HMAC */

2019-03-11T12:51:52Z

Пример рассчёта HMAC

← Предыдущая версия		Версия от 12:51, 11 марта 2019
Строка 182:		Строка 182:
	* auth_token - авторизационный токен, вычисляемый как HMAC(sha256(<device_token>), <uuid>)		* auth_token - авторизационный токен, вычисляемый как HMAC(sha256(<device_token>), <uuid>)
	* uuid - идентификатор запроса на уведомление		* uuid - идентификатор запроса на уведомление
	====Пример ~~рассчёта~~ HMAC====		====Пример расчёта HMAC====
	Например, для идентификатора транзакции:		Например, для идентификатора транзакции:
	<pre>c03a6d7f-5b5c-49af-be5c-6ea380080cb7</pre>		<pre>c03a6d7f-5b5c-49af-be5c-6ea380080cb7</pre>

A.bursakov: /* Запрос */

2019-03-11T12:51:15Z

Запрос

@@ Строка 182: / Строка 182: @@
 * auth_token - авторизационный токен, вычисляемый как HMAC(sha256(<device_token>), <uuid>)
 * uuid - идентификатор запроса на уведомление
 ===Ответ===
 * Если токен некорректный, то сервис возвращает 401