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

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

Реализация процессов инициализации переводов денежных средств и платежей основана на методах 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-sistema-perevodov-i-platezhei/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-sistema-perevodov-i-platezhei/podpisanie-i-proverka-elektronnoi-cifrovoi-podpisi-biznes-soobshenii.md)).

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.npck.kz/mezhbankovskaya-sistema-perevodov-i-platezhei/opisanie-struktury-zaprosov.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.