Описание структуры запросов

Структура запроса

Реализация процессов инициализации переводов денежных средств и платежей основана на методах API, описанных в электронном формате в https://transfers-openapi.npck.kz/.

Во всех запросах должен быть указан HTTP заголовок end-to-end-id, в котором должен указываться сквозной идентификатор для всей цепочки сообщений, использующийся в рамках данной операции (должен совпадать с соответствующим значением, передаваемым в теле сообщения)

В запросах в методах API, передаются бизнес-сообщения, основанные на соответствующих сообщениях стандарта ISO20022.

Используются следующие сообщения стандарта ISO20022:

- acmt.023.001.03 «Запрос на верификацию наличия счета клиента»;

- acmt.024.001.03 «Результат верификации наличия счета клиента»;

- camt.053.001.11 «Выписка по счету»;

- camt.060.001.06 «Запрос выписки по счету»;

- pacs.002.001.13 «Статус обработки финансовой операции»;

- pacs.004.001.12 «Запрос возврата денежных средств»;

- pacs.008.001.11 «Запрос на проведение финансовой операции»;

- pacs.028.001.05 «Запрос статуса обработки операции»;

- admi.009.001.02 «Запрос данных»

- admi.010.001.02 «Результат запроса данных»

Бизнес‑сообщения должны быть представлены в виде XML‑документов и должны соответствовать XSD‑схемам и правилам заполнения документов (см. Форматы сообщений).

XSD‑схемы сообщений доступны для скачивания по ссылке: https://www.iso20022.org/catalogue-messages/iso-20022-messages-archive или https://www.iso20022.org/iso-20022-message-definitions

Структура бизнес-сообщения:

<?xml version="1.0" encoding="utf-8"?>
<ns0:Document xmlns:ns0="urn:iso:std:iso:20022:tech:xsd:xxx.nnn.nnn.nn">
  
   <!-- Содержимое сообщения -->    
  
   <ds:Signature xmlns:ds="http://www.w3.org/2000/09/xmldsig#">
       <!— Подпись сообщения -->
   </ds:Signature>

</ns0:Document>

Корневым тегом бизнес-сообщения является тег «Document», который должен содержать:

• Содержимое сообщения (бизнес часть) – содержит смысловую информацию сообщения, например, информацию о переводе денежных средств или информацию о движении денежных средств по счетам. Формат данного блока индивидуален для каждого метода (описание методов приведено в электронном формате в https://transfers-openapi.npck.kz/) и основан на соответствующих сообщениях стандарта ISO20022.
• Вложенный тег «Signature» – содержит подпись передаваемого сообщения в формате XMLDSIG (см. Подписание и проверка электронной цифровой подписи бизнес-сообщений).

Для корневого элемента «Document» и вложенных в него элементов используется префикс пространства имен ns0, кроме подписи сообщения, передаваемой в элементе «Signature», для которой используется пространство имен ds