Инструкция по подключению поставщиков услуг к епш по форматам взаимодействия версии 5 Лист изменений 3

Лист изменений

1. Введение

1.1Цель документа

1.2Термины и сокращения

1.3Перечень исходных документов

ID	Название документа	Версия, Дата	Автор	Документ
1	Запрос на сертификат и пример сертификата
2	Заявка ЕПШ
3	ЕПШ_Форматы_взаимодействия	1.6.5.	Быковский С.	https://www.mos.ru/upload/documents/files/4111/FormativzaimodeistviyaISEPSh(versiya165).docx

2. Общий порядок подключения ППУ к ИС ЕПШ

1. 
   ППУ формирует запрос на выпуск сертификата:
   
   1. 
      (для подключения к промышленному стенду ЕПШ) ППУ формирует пару закрытого и открытого ключей.
      

• 
  пара закрытого и открытого ключей;
  
• 
  запрос на выпуск сертификата: файл формата .csr, содержащий открытый ключ.
  

• 
  пара закрытого и открытого ключей;
  
• 
  запрос на выпуск сертификата: файл формата .csr, содержащий открытый ключ.
  

2. 
   ППУ отправляет письмо с запросом получения сертификата на адрес: [email protected], в копию: [email protected], [email protected], [email protected], [email protected].
   

• 
  Cформированные ранее csr-файлы (см. [1], Перечень исходных документов);
  
• 
  Заявку на подключение ППУ к ЕПШ (см. [2], Перечень исходных документов).
  

3. 
   Оператор ИС ЕПШ обеспечивает рассмотрение заявки на выдачу сертификата и подключение к ИС ЕПШ.
   

4. 
   Оператор ИС ЕПШ отправляет заявителю письмо, которое содержит:
   

• 
  сертификат для организации защищенного SSL канала (тестовый стенд с двусторонней аутентификацией).
  

5. 
   ППУ, используя полученный сертификат, интегрируется с тестовым стендом ИС ЕПШ (см. Порядок тестирования при интеграции ППУ с ИС ЕПШ).
   

6. 
   Оператор ИС ЕПШ подтверждает регистрацию заявителя в ИС ЕПШ, отправляя заявителю письмо, которое содержит:
   

• 
  сертификат для организации защищенного SSL канала (промышленный стенд);
  

7. 
   ППУ, используя полученный сертификат, интегрируется с промышленным стендом ИС ЕПШ (см. Порядок тестирования при интеграции ППУ с ИС ЕПШ).
   

2Сетевые взаимодействия ИС ЕПШ и ППУ

3. Подпись сообщений, отправляемых в ИС ЕПШ/из ИС ЕПШ

• 
  registerPaymentRequest, элемент paymentDetails;
  
• 
  registerPaymentsRequest, элемент listPaymentDetails;
  
• 
  checkPaymentStatusRequest, элемент checkPaymentStatusRequest;
  
• 
  confirmPaymentResponse, элемент confirmPaymentResponse.
  

• 
  registerPaymentResponse, элемент registerPaymentResponse;
  
• 
  registerPaymentsResponse, элемент registerPaymentsResponse;
  
• 
  checkPaymentStatusResponse, элемент checkPaymentStatusResponse;
  
• 
  confirmPaymentRequest, элемент FinalPayment, элемент confirmPaymentRequest.
  

2.1Порядок формирования подписи запросов и ответов ИС ЕПШ

1. 
   Формирование шаблона документа:
   
   1. 
      Создается элемент Signature;
      
   2. 
      К элементу Signature добавляется дочерний элемент SignedInfo;
      
   3. 
      К элементу SignedInfo добавляется дочерний элемент CanonicalizationMethod;
      
   4. 
      К элементу SignedInfo добавляется дочерний элемент SignatureMethod;
      
   5. 
      К элементу SignedInfo добавляется первый дочерний элемент Reference;
      
   6. 
      К элементу Reference добавляется дочерний элемент Transforms;
      
   7. 
      К элементу Transforms элемента Reference добавляется дочерний элемент Transform (два элемента);
      
   8. 
      К элементу Reference добавляется элемент DigestMethod;
      
   9. 
      К элементу Reference добавляется элемент DigestValue;
      
   10. 
       К элементу Signature добавляется дочерний элемент SignatureValue;
       
   11. 
       К элементу Signature добавляется дочерний элемент KeyInfo;
       
   12. 
       К элементу KeyInfo добавляется дочерний элемент X509Data;
       
   13. 
       К элементу X509Data добавляется дочерний элемент X509Certificate.
       
2. 
   Установка предопределенных значений
   
   1. 
      Для элемента CanonicalizationMethod и для второго элемента Transform элемента Reference значения атрибута Algorithm устанавливается в «http://www.w3.org/2001/10/xml-exc-c14n#».
      
   2. 
      Для первого элемента Transform алгоритм выставляется значение "http://www.w3.org/2000/09/xmldsig#enveloped-signature".
      
   3. 
      Для элементов DigestMethod первого значения атрибута Algorithm устанавливается в "http://www.w3.org/2001/04/xmldsig-more#gostr3411".
      
   4. 
      Для элемента SignatureMethod значение атрибута Algorithm устанавливается в "http://www.w3.org/2001/04/xmldsig-more#gostr34102001-gostr3411".
      
   5. 
      Атрибут URI элемента Reference должен быть заполнен пустым значением.
      
3. 
   Установка подписи
   
   1. 
      Открытый ключ подписи, закодированный по алгоритму «http://www.w3.org/2000/09/xmldsig#base64», добавляется к элементу X509Certificate как дочерний текстовый узел.
      
   2. 
      Подписываются элементы документа, выбранные посредством XPATH выражения на основе значения атрибута URI элемента Reference (если элемент URI имеет пустое значение, то подписывается полностью весь тег сущности). Полученное значение кодируется по алгоритму «http://www.w3.org/2000/09/xmldsig#base64» и добавляется как дочерний текстовый узел к элементу DigestValue первого элемента Reference.
      
   3. 
      Элемент SignedInfo трансформируется в соответствии с алгоритмом «http://www.w3.org/2001/10/xml-exc-c14n#». Затем на основании полученной строки и ключа подписи формируется значение ЭП в соответствии с алгоритмом «http://www.w3.org/2001/04/xmldsig-more#gostr34102001-gostr3411». Полученное значение ЭП кодируется в соответствии с алгоритмом «http://www.w3.org/2000/09/xmldsig#base64» и значение добавляется как дочерний текстовый узел к элементу SignatureValue.
      

3Порядок тестирования при интеграции ППУ с ИС ЕПШ

• 
  Тестовый стенд;
  
• 
  Тестовый стенд (двусторонняя аутентификация) - осуществляется после получения от ИС ЕПШ сертификата для организации защищенного SSL канала (тестовый стенд с двусторонней аутентификацией), см. Общий порядок подключения ППУ к ИС ЕПШ.
  
• 
  Промышленный стенд - осуществляется после получения от ИС ЕПШ сертификата для организации защищенного SSL канала (промышленный стенд), см. Общий порядок подключения ППУ к ИС ЕПШ.
  

• 
  Запрос к Web-сервису ИС ЕПШ по методу registerPayment;
  
• 
  Запрос к Web-сервису ИС ЕПШ по методу registerPayments;
  
• 
  Запрос к Web-сервису ППУ по методу confirmPayment;
  
• 
  Запрос к Web-сервису ИС ЕПШ по методу checkPaymentStatus.
  

Статус	Описание сценария
APRP	Платеж успешно завершен
DECL	Платеж отклонен банком-эквайером
PROC, затем APRP	Платеж передан в банк, но от банка не поступило подтверждение в регистрации платежа по причине коммуникационной ошибки. После - платеж успешно завершен
PROC, затем DECL	Платеж передан в банк, но от банка не поступило подтверждение в регистрации платежа по причине коммуникационной ошибки. После - платеж отклонен банком-эквайером
TOUT Статус тестируется, если он был указан в заявке на подключение к ЕПШ, см. [2], Перечень исходных документов	Отправляется если после получения от ППУ registerPayment/registerPayments Клиент не перешел к оплате за установленное время
UDECL Статус тестируется, если он был указан в заявке на подключение к ЕПШ, см. [2], Перечень исходных документов	Клиент вернулся на страницу ППУ
	Клиент выбрал не все платежи для оплаты. Статус UDECL отправляется по тем платежам, которые не были выбраны Клиентом при старте платежа

3.1Порядок тестирования статусов транзакций

1. 
   ППУ отправляет запрос registerPaymentRequest/registerPaymentsRequest в ИС ЕПШ (URL получателя см. в Сетевые взаимодействия ИС ЕПШ и ППУ).
   
2. 
   ППУ получает от ИС ЕПШ registerPaymentResponse/registerPaymentsResponse.
   
3. 
   ППУ получает от ИС ЕПШ confirmPaymentRequest, содержащий статус транзакции.
   
4. 
   ППУ отправляет в ИС ЕПШ confirmPaymentResponse.
   
5. 
   ППУ отправляет письмо на адрес [email protected], в копию: [email protected].
   

• 
  paymentUUID из проведенной транзакции;
  
• 
  статус, который будет проверяться следующим.
  

6. 
   В ответ оператор техподдержки ЕПШ отправляет письмо о готовности провести тестирование следующего статуса.
   
7. 
   Повторить шаги 1-6 для тестируемого статуса.
   

3.2Запрос к Web-сервису ИС ЕПШ по методу registerPayment

1. 
   ППУ формирует сообщение registerPaymentRequest;
   
2. 
   ППУ отправляет сообщение registerPaymentRequest в ИС ЕПШ (URL получателя см. в Сетевые взаимодействия ИС ЕПШ и ППУ);
   
3. 
   ИС ЕПШ формирует ответ registerPaymentResponse;
   
4. 
   ИС ЕПШ отправляет ППУ сообщение registerPaymentResponse.
   

3.3Запрос к Web-сервису ИС ЕПШ по методу registerPayments

1. 
   ППУ формирует сообщение registerPaymentsRequest;
   
2. 
   ППУ отправляет сообщение registerPaymentsRequest в ИС ЕПШ (URL получателя см. в Сетевые взаимодействия ИС ЕПШ и ППУ);
   
3. 
   ИС ЕПШ формирует ответ registerPaymentsResponse;
   
4. 
   ИС ЕПШ отправляет ППУ сообщение registerPaymentsResponse.
   

3.4Запрос к Web-сервису ППУ по методу confirmPayment

1. 
   После получения от ППУ registerPaymentRequest/registerPaymentsRequest ИС ЕПШ формирует сообщение confirmPaymentRequest, содержащий статус транзакции (см. Таблица ).
   

2. 
   ИС ЕПШ отправляет сообщение confirmPaymentRequest ППУ (URL получателя указывает ППУ при регистрации, см. Общий порядок подключения ППУ к ИС ЕПШ);
   
3. 
   ППУ формирует ответ confirmPaymentResponse;
   
4. 
   ППУ отправляет в ИС ЕПШ сообщение confirmPaymentResponse.
   

3.5Запрос к Web-сервису ИС ЕПШ по методу checkPaymentStatus

1. 
   ППУ формирует сообщение checkPaymentStatusRequest;
   
2. 
   ППУ отправляет сообщение checkPaymentStatusRequest в ИС ЕПШ (URL получателя см. в Сетевые взаимодействия ИС ЕПШ и ППУ);
   
3. 
   ИС ЕПШ формирует ответ checkPaymentStatusResponse, содержащий статус транзакции (см. Таблица ).
   

4. 
   ИС ЕПШ отправляет ППУ сообщение checkPaymentStatusResponse.
   

4. Коды сообщений от ЕПШ