Описание структуры запросов
Структура запроса
Реализация процессов инициализации переводов денежных средств и платежей основана на методах API, описанных в электронном формате в https://transfers-openapi.npck.kz/.
Во всех запросах должен быть указан HTTP заголовок end-to-end-id, в котором должен указываться сквозной идентификатор для всей цепочки сообщений, использующийся в рамках данной операции (должен совпадать с соответствующим значением, передаваемым в теле сообщения)
В запросах в методах API, передаются бизнес-сообщения, основанные на соответствующих сообщениях стандарта ISO20022.
Бизнес‑сообщения должны быть представлены в виде XML‑документов и должны соответствовать XSD‑схемам и правилам заполнения документов (см. Форматы сообщений).
Структура бизнес-сообщения:
<?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 (см. Подписание и проверка электронной цифровой подписи бизнес-сообщений).
Last updated