> For the complete documentation index, see [llms.txt](https://docs.npck.kz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.npck.kz/mezhbankovskaya-mobilnykh-platezhei-msmp/mezhbankovskaya-sistema-mobilnykh-platezhei-msmp/opisanie-struktury-zaprosov.md).

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

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

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

{% hint style="warning" %}
Во всех запросах должен быть указан **HTTP заголовок end-to-end-id**, в котором должен указываться сквозной идентификатор для всей цепочки сообщений, использующийся в рамках данной операции *(должен совпадать с соответствующим значением, передаваемым в теле сообщения)*
{% endhint %}

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

{% hint style="info" %}
Используются следующие сообщения стандарта 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
{% endhint %}

Бизнес‑сообщения должны быть представлены в виде XML‑документов и должны соответствовать XSD‑схемам и правилам заполнения документов (см. [Форматы сообщений](/mezhbankovskaya-mobilnykh-platezhei-msmp/mezhbankovskaya-sistema-mobilnykh-platezhei-msmp/opisanie-struktury-zaprosov/formaty-soobshenii.md)).

{% hint style="info" %}
XSD‑схемы сообщений доступны для скачивания по ссылке: [https://www.iso20022.org/catalogue-messages/iso-20022-messages-archive](https://www.google.com/url?q=https://www.iso20022.org/catalogue-messages/iso-20022-messages-archive\&sa=D\&source=docs\&ust=1716958801626628\&usg=AOvVaw3Ynu37Xj9GSDrJtNPQDNU_)  или <https://www.iso20022.org/iso-20022-message-definitions>
{% endhint %}

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

```xml
<?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 (см. [Подписание и проверка электронной цифровой подписи бизнес-сообщений](/mezhbankovskaya-mobilnykh-platezhei-msmp/mezhbankovskaya-sistema-mobilnykh-platezhei-msmp/podpisanie-i-proverka-elektronnoi-cifrovoi-podpisi-biznes-soobshenii.md)).

{% hint style="info" %}
Для корневого элемента «Document» и вложенных в него элементов используется  префикс пространства имен **ns0**, кроме подписи сообщения, передаваемой в элементе «Signature», для которой используется пространство имен **ds**
{% endhint %}