LS Спецификация API для импорта рублевых платежей в соответствии с международным стандартом ISO 20022.
OpenAPI 0.3.0
## Описание API Это API предназначено для загрузки и проверки пакетов платежей в формате **ISO 20022**, используемом в системе РПП (Рублёвые платежные поручения) Райффайзенбанка.
Варианты
- Паблик
Операции API
GET /v1/reports/pdf/iso20022/messages/{msgId}/payments/{pmtInfId} — Получение печатной формы платежного поручения, импортированного в формате ISO20022
Получение печатной формы одного оперативного платежного поручения в формате PDF. Поддерживаются платежи, импортированные из подписанных и неподписанных ISO20022 сообщений. В `msgId` передается значение `GrpHdr/MsgId`, а в `pmtInfId` — значение `PmtInf/PmtInfId` исходного XML-документа. Для получения печатной формы требуются bearer-токен, Id-Token, право экспорта платежей и доступ к организации и счёту списания. При превышении допустимой частоты запросов возвращается `429`. Повторить запрос можно через количество секунд, указанное в заголовке `Retry-After`.
{
"description": "Получение печатной формы одного оперативного платежного поручения в формате PDF.\nПоддерживаются платежи, импортированные из подписанных и неподписанных ISO20022 сообщений.\nВ `msgId` передается значение `GrpHdr/MsgId`, а в `pmtInfId` — значение `PmtInf/PmtInfId` исходного XML-документа.\nДля получения печатной формы требуются bearer-токен, Id-Token, право экспорта платежей и доступ к организации и счёту списания.\nПри превышении допустимой частоты запросов возвращается `429`. Повторить запрос можно через количество секунд, указанное в заголовке `Retry-After`.\n",
"operationId": "domesticPaymentPrintForm",
"parameters": [
{
"description": "Уникальный идентификатор исходного ISO20022 сообщения — GrpHdr/MsgId",
"example": "ORCRUWIRE0170202229000030",
"in": "path",
"name": "msgId",
"required": true,
"schema": {
"maxLength": 35,
"minLength": 1,
"pattern": "^[A-Za-z0-9_]+$",
"type": "string"
}
},
{
"description": "Идентификатор платежа внутри исходного ISO20022 сообщения — PmtInf/PmtInfId",
"example": "ORCRUWIRE0040203219700010",
"in": "path",
"name": "pmtInfId",
"required": true,
"schema": {
"maxLength": 35,
"minLength": 1,
"pattern": "^[A-Za-z0-9_]+$",
"type": "string"
}
},
{
"$ref": "#/components/parameters/CnumQuery"
},
{
"$ref": "#/components/parameters/AuthorizationHeader"
},
{
"$ref": "#/components/parameters/IdTokenHeader_1"
}
],
"responses": {
"200": {
"content": {
"application/pdf": {
"schema": {
"format": "binary",
"type": "string"
}
}
},
"description": "Печатная форма платежного поручения успешно получена",
"headers": {
"Cache-Control": {
"description": "Запрет хранения ответа в клиентском кэше",
"schema": {
"enum": [
"no-store"
],
"type": "string"
}
},
"Content-Disposition": {
"description": "Имя PDF-файла с номером платежа, ИНН получателя, датой платежа и суммой",
"example": "attachment; filename=\"payment_order_123_7700000000_22.10.2026_100-00_1.pdf\"",
"schema": {
"type": "string"
}
}
}
},
"400": {
"description": "Некорректные или отсутствующие параметры запроса"
},
"401": {
"$ref": "#/components/responses/Unauthorized_1"
},
"403": {
"$ref": "#/components/responses/Forbidden"
},
"404": {
"$ref": "#/components/responses/DocumentNotFound"
},
"409": {
"description": "Идентификаторы соответствуют нескольким платежам или импорт платежа ещё не завершён"
},
"429": {
"description": "Превышена допустимая частота запросов",
"headers": {
"Retry-After": {
"$ref": "#/components/headers/RetryAfter"
}
}
},
"500": {
"$ref": "#/components/responses/InternalError_1"
}
},
"security": [
{
"bearerAuth": []
},
{
"RaifApiAuthorization": [],
"RaifApiIdToken": []
}
],
"servers": [
{
"url": "https://api.raiffeisen.ru/domestic-payments"
}
],
"summary": "Получение печатной формы платежного поручения, импортированного в формате ISO20022",
"tags": [
"domestic-payments"
]
}POST /v2/transfers/iso20022/signed — Импорт подписанного с помощью XmlDSig платежа в формате ISO20022
ВАЖНО: Данный функционал недоступен для клиентов сегмента Финансовые институты! Отправка XML-файла, подписанного с использованием **XmlDSig**. [API Документация на английском](https://cdn.rbo.raiffeisen.ru/fs/cashmanagement/api-eng.pdf), [API Документация на русском](https://cdn.rbo.raiffeisen.ru/fs/cashmanagement/api-rus.pdf), [XSD-схема для валидации](https://cdn.rbo.raiffeisen.ru/fs/cashmanagement/pain.001.001.raifsig.xsd), [Документация API по подписанным ISO XML](https://cdn.rbo.raiffeisen.ru/fs/cashmanagement/Raiffeisen_API_isoxml_signed_V2.xlsx), [Инструкция по подписи (Примеры на Java)](https://cdn.rbo.raiffeisen.ru/fs/cashmanagement/xmldsig_sign_instruction.md), [Инструкция по подписи (Примеры на Java) на английском](https://cdn.rbo.raiffeisen.ru/fs/cashmanagement/xmldsig_sign_instruction.en.md).
{
"description": "ВАЖНО: Данный функционал недоступен для клиентов сегмента Финансовые институты! \nОтправка XML-файла, подписанного с использованием **XmlDSig**. \n[API Документация на английском](https://cdn.rbo.raiffeisen.ru/fs/cashmanagement/api-eng.pdf), \n[API Документация на русском](https://cdn.rbo.raiffeisen.ru/fs/cashmanagement/api-rus.pdf), \n[XSD-схема для валидации](https://cdn.rbo.raiffeisen.ru/fs/cashmanagement/pain.001.001.raifsig.xsd), \n[Документация API по подписанным ISO XML](https://cdn.rbo.raiffeisen.ru/fs/cashmanagement/Raiffeisen_API_isoxml_signed_V2.xlsx), \n[Инструкция по подписи (Примеры на Java)](https://cdn.rbo.raiffeisen.ru/fs/cashmanagement/xmldsig_sign_instruction.md), \n[Инструкция по подписи (Примеры на Java) на английском](https://cdn.rbo.raiffeisen.ru/fs/cashmanagement/xmldsig_sign_instruction.en.md).\n",
"operationId": "signedDomesticPayment",
"parameters": [
{
"$ref": "#/components/parameters/AuthorizationHeader"
},
{
"$ref": "#/components/parameters/IdTokenHeader_1"
}
],
"requestBody": {
"content": {
"application/xml": {
"schema": {
"type": "string"
}
}
},
"description": "XML-документ установленного формата, представляющий данные подписанного платежного поручения\n",
"required": true
},
"responses": {
"202": {
"description": "Задача для рублевого платежа успешно создана"
},
"400": {
"$ref": "#/components/responses/ValidationError"
},
"401": {
"$ref": "#/components/responses/Unauthorized_1"
},
"403": {
"$ref": "#/components/responses/Forbidden"
},
"413": {
"$ref": "#/components/responses/FileIsTooLarge"
},
"500": {
"$ref": "#/components/responses/InternalError_1"
}
},
"security": [
{
"RaifApiAuthorization": [],
"RaifApiIdToken": []
}
],
"servers": [
{
"url": "https://api.raiffeisen.ru/domestic-payments"
}
],
"summary": "Импорт подписанного с помощью XmlDSig платежа в формате ISO20022",
"tags": [
"domestic-payments"
]
}POST /v2/transfers/iso20022/signed/pre-validation — Валидация подписанного с помощью XmlDSig платежа в формате ISO20022 без импорта
ВАЖНО: Данный функционал недоступен для клиентов сегмента Финансовые институты! Проверка XML-файла, подписанного с использованием **XmlDSig**, без создания задачи импорта. Ответ содержит ошибки уровня сообщения отдельно от ошибок, привязанных к конкретным платежам.
{
"description": "ВАЖНО: Данный функционал недоступен для клиентов сегмента Финансовые институты! \nПроверка XML-файла, подписанного с использованием **XmlDSig**, без создания задачи импорта. \nОтвет содержит ошибки уровня сообщения отдельно от ошибок, привязанных к конкретным платежам.\n",
"operationId": "validateSignedDomesticPayment",
"parameters": [
{
"$ref": "#/components/parameters/AuthorizationHeader"
},
{
"$ref": "#/components/parameters/IdTokenHeader_1"
}
],
"requestBody": {
"content": {
"application/xml": {
"schema": {
"type": "string"
}
}
},
"description": "XML-документ установленного формата, представляющий данные подписанного платежного поручения\n",
"required": true
},
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Iso20022ValidationResult"
}
},
"application/xml": {
"schema": {
"type": "string"
}
}
},
"description": "Валидация выполнена"
},
"400": {
"$ref": "#/components/responses/ValidationError"
},
"401": {
"$ref": "#/components/responses/Unauthorized_1"
},
"403": {
"$ref": "#/components/responses/Forbidden"
},
"406": {
"$ref": "#/components/responses/NotAcceptable"
},
"500": {
"$ref": "#/components/responses/InternalError_1"
}
},
"security": [
{
"RaifApiAuthorization": [],
"RaifApiIdToken": []
}
],
"servers": [
{
"url": "https://api.raiffeisen.ru/domestic-payments"
}
],
"summary": "Валидация подписанного с помощью XmlDSig платежа в формате ISO20022 без импорта",
"tags": [
"domestic-payments"
]
}POST /v2/transfers/iso20022/unsigned — Импорт неподписанного платежа в формате ISO20022
ВАЖНО: Данный функционал недоступен для клиентов сегмента Финансовые институты! Отправка XML-файла с неподписанными платежами. [Документация по неподписанным платежам на английском](https://cdn.rbo.raiffeisen.ru/fs/cashmanagement/unsigned-payments-en.pdf), [Документация по неподписанным платежам на русском](https://cdn.rbo.raiffeisen.ru/fs/cashmanagement/unsigned-payments-ru.pdf), [XSD-схема для валидации](https://cdn.rbo.raiffeisen.ru/fs/cashmanagement/pain.001.001.raif.xsd), [Документация API по ISO XML](https://cdn.rbo.raiffeisen.ru/fs/cashmanagement/Raiffeisen_API_isoxml_signed_V2.xlsx).
{
"description": "ВАЖНО: Данный функционал недоступен для клиентов сегмента Финансовые институты! \nОтправка XML-файла с неподписанными платежами. \n[Документация по неподписанным платежам на английском](https://cdn.rbo.raiffeisen.ru/fs/cashmanagement/unsigned-payments-en.pdf), \n[Документация по неподписанным платежам на русском](https://cdn.rbo.raiffeisen.ru/fs/cashmanagement/unsigned-payments-ru.pdf), \n[XSD-схема для валидации](https://cdn.rbo.raiffeisen.ru/fs/cashmanagement/pain.001.001.raif.xsd), \n[Документация API по ISO XML](https://cdn.rbo.raiffeisen.ru/fs/cashmanagement/Raiffeisen_API_isoxml_signed_V2.xlsx).\n",
"operationId": "unsignedDomesticPayment",
"parameters": [
{
"$ref": "#/components/parameters/AuthorizationHeader"
},
{
"$ref": "#/components/parameters/IdTokenHeader_1"
}
],
"requestBody": {
"content": {
"application/xml": {
"schema": {
"type": "string"
}
}
},
"description": "XML-документ установленного формата, представляющий данные неподписанного платежного поручения",
"required": true
},
"responses": {
"202": {
"description": "Задача для рублевого платежа успешно создана"
},
"400": {
"$ref": "#/components/responses/ValidationError"
},
"401": {
"$ref": "#/components/responses/Unauthorized_1"
},
"403": {
"$ref": "#/components/responses/Forbidden"
},
"413": {
"$ref": "#/components/responses/FileIsTooLarge"
},
"500": {
"$ref": "#/components/responses/InternalError_1"
}
},
"security": [
{
"RaifApiAuthorization": [],
"RaifApiIdToken": []
}
],
"servers": [
{
"url": "https://api.raiffeisen.ru/domestic-payments"
}
],
"summary": "Импорт неподписанного платежа в формате ISO20022",
"tags": [
"domestic-payments"
]
}POST /v2/transfers/iso20022/unsigned/pre-validation — Валидация неподписанного платежа в формате ISO20022 без импорта
ВАЖНО: Данный функционал недоступен для клиентов сегмента Финансовые институты! Проверка XML-файла с неподписанными платежами без создания задачи импорта. Ответ содержит ошибки уровня сообщения отдельно от ошибок, привязанных к конкретным платежам.
{
"description": "ВАЖНО: Данный функционал недоступен для клиентов сегмента Финансовые институты! \nПроверка XML-файла с неподписанными платежами без создания задачи импорта. \nОтвет содержит ошибки уровня сообщения отдельно от ошибок, привязанных к конкретным платежам.\n",
"operationId": "validateUnsignedDomesticPayment",
"parameters": [
{
"$ref": "#/components/parameters/AuthorizationHeader"
},
{
"$ref": "#/components/parameters/IdTokenHeader_1"
}
],
"requestBody": {
"content": {
"application/xml": {
"schema": {
"type": "string"
}
}
},
"description": "XML-документ установленного формата, представляющий данные неподписанного платежного поручения",
"required": true
},
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Iso20022ValidationResult"
}
},
"application/xml": {
"schema": {
"type": "string"
}
}
},
"description": "Валидация выполнена"
},
"400": {
"$ref": "#/components/responses/ValidationError"
},
"401": {
"$ref": "#/components/responses/Unauthorized_1"
},
"403": {
"$ref": "#/components/responses/Forbidden"
},
"406": {
"$ref": "#/components/responses/NotAcceptable"
},
"500": {
"$ref": "#/components/responses/InternalError_1"
}
},
"security": [
{
"RaifApiAuthorization": [],
"RaifApiIdToken": []
}
],
"servers": [
{
"url": "https://api.raiffeisen.ru/domestic-payments"
}
],
"summary": "Валидация неподписанного платежа в формате ISO20022 без импорта",
"tags": [
"domestic-payments"
]
}GET /v2/transfers/iso20022/{msgId}/payments/{pmtInfId}/status — Получение статуса конкретного платежа по его идентификатору в рамках ранее загруженного пакета в формате ISO20022
ВАЖНО: Данный функционал недоступен для клиентов сегмента Финансовые институты! Получение статуса конкретного платежа по его идентификатору в рамках ранее загруженного пакета. [API Документация на английском](https://cdn.rbo.raiffeisen.ru/fs/cashmanagement/api-eng.pdf), [API Документация на русском](https://cdn.rbo.raiffeisen.ru/fs/cashmanagement/api-rus.pdf), Примеры ответов: [pain002_001_payments_status](https://cdn.rbo.raiffeisen.ru/fs/cashmanagement/Raiffeisen_pain002_001_payments_status.xlsx).
{
"description": "ВАЖНО: Данный функционал недоступен для клиентов сегмента Финансовые институты! \nПолучение статуса конкретного платежа по его идентификатору в рамках ранее загруженного пакета. \n[API Документация на английском](https://cdn.rbo.raiffeisen.ru/fs/cashmanagement/api-eng.pdf), \n[API Документация на русском](https://cdn.rbo.raiffeisen.ru/fs/cashmanagement/api-rus.pdf), \nПримеры ответов: [pain002_001_payments_status](https://cdn.rbo.raiffeisen.ru/fs/cashmanagement/Raiffeisen_pain002_001_payments_status.xlsx).\n",
"operationId": "domesticPaymentStatus",
"parameters": [
{
"example": "ORCRUWIRE0170202229000030",
"in": "path",
"name": "msgId",
"required": true,
"schema": {
"type": "string"
}
},
{
"example": "ORCRUWIRE0040203219700010",
"in": "path",
"name": "pmtInfId",
"required": true,
"schema": {
"type": "string"
}
},
{
"$ref": "#/components/parameters/AuthorizationHeader"
},
{
"$ref": "#/components/parameters/IdTokenHeader_1"
}
],
"responses": {
"200": {
"content": {
"application/xml": {
"examples": {
"ACSC": {
"summary": "ACSC - Документ исполнен",
"value": "<Document> ... <DtldSts>ACSC</DtldSts> ... </Document>\n"
},
"ACSP": {
"summary": "ACSP - Документ в работе у банка",
"value": "<Document> ... <DtldSts>ACSP</DtldSts> ... </Document>\n"
},
"ATTN": {
"summary": "ATTN - Требует внимания",
"value": "<Document> ... <DtldSts>ATTN</DtldSts> ... </Document>\n"
},
"CANC": {
"summary": "CANC - Документ отозван",
"value": "<Document> ... <DtldSts>CANC</DtldSts> ... </Document>\n"
},
"DBLC": {
"summary": "DBLC - Платеж не был создан так как является дубликатом",
"value": "<Document> ... <DtldSts>DBLC</DtldSts> ... </Document>\n"
},
"FSGN": {
"summary": "FSGN - Документ ждет отправки",
"value": "<Document> ... <DtldSts>FSGN</DtldSts> ... </Document>\n"
},
"PDNG": {
"summary": "PDNG - Документ в очереди на обработку",
"value": "<Document>...<DtldSts>PDNG</DtldSts>...</Document>\n"
},
"RJCT": {
"summary": "RJCT - Документ отклонен",
"value": "<Document> ... <DtldSts>RJCT</DtldSts> ... </Document>\n"
}
},
"schema": {
"type": "string"
}
}
},
"description": "Статус успешно получен"
},
"400": {
"$ref": "#/components/responses/ValidationError"
},
"401": {
"$ref": "#/components/responses/Unauthorized_1"
},
"403": {
"$ref": "#/components/responses/Forbidden"
},
"404": {
"$ref": "#/components/responses/DocumentNotFound"
},
"500": {
"$ref": "#/components/responses/InternalError_1"
}
},
"security": [
{
"RaifApiAuthorization": [],
"RaifApiIdToken": []
}
],
"servers": [
{
"url": "https://api.raiffeisen.ru/domestic-payments"
}
],
"summary": "Получение статуса конкретного платежа по его идентификатору в рамках ранее загруженного пакета в формате ISO20022",
"tags": [
"domestic-payments"
]
}GET /v2/transfers/iso20022/{msgId}/status — Получение краткой квитанции по пакету платежей в формате ISO20022
ВАЖНО: Данный функционал недоступен для клиентов сегмента Финансовые институты! Получение краткой квитанции по пакету платежей в формате ISO20022. [API Документация на английском](https://cdn.rbo.raiffeisen.ru/fs/cashmanagement/api-eng.pdf), [API Документация на русском](https://cdn.rbo.raiffeisen.ru/fs/cashmanagement/api-rus.pdf).
{
"description": "ВАЖНО: Данный функционал недоступен для клиентов сегмента Финансовые институты! \nПолучение краткой квитанции по пакету платежей в формате ISO20022. \n[API Документация на английском](https://cdn.rbo.raiffeisen.ru/fs/cashmanagement/api-eng.pdf), \n[API Документация на русском](https://cdn.rbo.raiffeisen.ru/fs/cashmanagement/api-rus.pdf).\n",
"operationId": "domesticPackageStatus",
"parameters": [
{
"description": "Уникальный идентификатор пакета",
"example": "ORCRUWIRE0170202229000030",
"in": "path",
"name": "msgId",
"required": true,
"schema": {
"type": "string"
}
},
{
"$ref": "#/components/parameters/AuthorizationHeader"
},
{
"$ref": "#/components/parameters/IdTokenHeader_1"
}
],
"responses": {
"200": {
"content": {
"application/xml": {
"examples": {
"ACSC": {
"summary": "ACSC - Документ исполнен",
"value": "<Document> ... <DtldSts>ACSC</DtldSts> ... </Document>\n"
},
"ACSP": {
"summary": "ACSP - Документ в работе у банка",
"value": "<Document> ... <DtldSts>ACSP</DtldSts> ... </Document>\n"
},
"ATTN": {
"summary": "ATTN - Требует внимания",
"value": "<Document> ... <DtldSts>ATTN</DtldSts> ... </Document>\n"
},
"CANC": {
"summary": "CANC - Документ отозван",
"value": "<Document> ... <DtldSts>CANC</DtldSts> ... </Document>\n"
},
"DBLC": {
"summary": "DBLC - Платеж не был создан так как является дубликатом",
"value": "<Document> ... <DtldSts>DBLC</DtldSts> ... </Document>\n"
},
"FSGN": {
"summary": "FSGN - Документ ждет отправки",
"value": "<Document> ... <DtldSts>FSGN</DtldSts> ... </Document>\n"
},
"PDNG": {
"summary": "PDNG - Документ в очереди на обработку",
"value": "<Document>...<DtldSts>PDNG</DtldSts>...</Document>\n"
},
"RJCT": {
"summary": "RJCT - Документ отклонен",
"value": "<Document> ... <DtldSts>RJCT</DtldSts> ... </Document>\n"
}
},
"schema": {
"type": "string"
}
}
},
"description": "Статус успешно получен"
},
"400": {
"$ref": "#/components/responses/ValidationError"
},
"401": {
"$ref": "#/components/responses/Unauthorized_1"
},
"403": {
"$ref": "#/components/responses/Forbidden"
},
"404": {
"$ref": "#/components/responses/DocumentNotFound"
},
"500": {
"$ref": "#/components/responses/InternalError_1"
}
},
"security": [
{
"RaifApiAuthorization": [],
"RaifApiIdToken": []
}
],
"servers": [
{
"url": "https://api.raiffeisen.ru/domestic-payments"
}
],
"summary": "Получение краткой квитанции по пакету платежей в формате ISO20022",
"tags": [
"domestic-payments"
]
}GET /v2/transfers/iso20022/{msgId}/status/full — Получение полной квитанции по пакету и платежам внутри пакета в формате ISO20022
ВАЖНО: Данный функционал недоступен для клиентов сегмента Финансовые институты! Получение полной квитанции по пакету и платежам внутри пакета в формате ISO20022, подробная информация по каждому платежу в пакете. [API Документация на английском](https://cdn.rbo.raiffeisen.ru/fs/cashmanagement/api-eng.pdf), [API Документация на русском](https://cdn.rbo.raiffeisen.ru/fs/cashmanagement/api-rus.pdf).
{
"description": "ВАЖНО: Данный функционал недоступен для клиентов сегмента Финансовые институты! \nПолучение полной квитанции по пакету и платежам внутри пакета в формате ISO20022, подробная информация по каждому платежу в пакете. \n[API Документация на английском](https://cdn.rbo.raiffeisen.ru/fs/cashmanagement/api-eng.pdf), \n[API Документация на русском](https://cdn.rbo.raiffeisen.ru/fs/cashmanagement/api-rus.pdf).\n",
"operationId": "domesticPackageStatusFull",
"parameters": [
{
"description": "Уникальный идентификатор пакета",
"example": "ORCRUWIRE0170202229000030",
"in": "path",
"name": "msgId",
"required": true,
"schema": {
"type": "string"
}
},
{
"$ref": "#/components/parameters/AuthorizationHeader"
},
{
"$ref": "#/components/parameters/IdTokenHeader_1"
}
],
"responses": {
"200": {
"content": {
"application/xml": {
"examples": {
"ACSC": {
"summary": "ACSC - Документ исполнен",
"value": "<Document> ... <DtldSts>ACSC</DtldSts> ... </Document>\n"
},
"ACSP": {
"summary": "ACSP - Документ в работе у банка",
"value": "<Document> ... <DtldSts>ACSP</DtldSts> ... </Document>\n"
},
"ATTN": {
"summary": "ATTN - Требует внимания",
"value": "<Document> ... <DtldSts>ATTN</DtldSts> ... </Document>\n"
},
"CANC": {
"summary": "CANC - Документ отозван",
"value": "<Document> ... <DtldSts>CANC</DtldSts> ... </Document>\n"
},
"DBLC": {
"summary": "DBLC - Платеж не был создан так как является дубликатом",
"value": "<Document> ... <DtldSts>DBLC</DtldSts> ... </Document>\n"
},
"FSGN": {
"summary": "FSGN - Документ ждет отправки",
"value": "<Document> ... <DtldSts>FSGN</DtldSts> ... </Document>\n"
},
"PDNG": {
"summary": "PDNG - Документ в очереди на обработку",
"value": "<Document>...<DtldSts>PDNG</DtldSts>...</Document>\n"
},
"RJCT": {
"summary": "RJCT - Документ отклонен",
"value": "<Document> ... <DtldSts>RJCT</DtldSts> ... </Document>\n"
}
},
"schema": {
"type": "string"
}
}
},
"description": "Статус успешно получен"
},
"400": {
"$ref": "#/components/responses/ValidationError"
},
"401": {
"$ref": "#/components/responses/Unauthorized_1"
},
"403": {
"$ref": "#/components/responses/Forbidden"
},
"404": {
"$ref": "#/components/responses/DocumentNotFound"
},
"500": {
"$ref": "#/components/responses/InternalError_1"
}
},
"security": [
{
"RaifApiAuthorization": [],
"RaifApiIdToken": []
}
],
"servers": [
{
"url": "https://api.raiffeisen.ru/domestic-payments"
}
],
"summary": "Получение полной квитанции по пакету и платежам внутри пакета в формате ISO20022",
"tags": [
"domestic-payments"
]
}Схемы и примеры
{
"headers": {
"RetryAfter": {
"description": "Количество секунд до повторного запроса",
"example": 1,
"schema": {
"format": "int64",
"minimum": 1,
"type": "integer"
}
}
},
"parameters": {
"AuthorizationHeader": {
"description": "Токен доступа",
"in": "header",
"name": "Authorization",
"required": true,
"schema": {
"example": "Bearer QXV0aG9yaXphdGlvbiBIZWFkZXIgRm9yIFRlc3Rpbmc=",
"format": "byte",
"type": "string"
}
},
"CnumQuery": {
"description": "CNUM клиента, в контексте которого выполняется операция",
"example": "0001",
"in": "query",
"name": "cnum",
"required": true,
"schema": {
"type": "string"
}
},
"IdTokenHeader_1": {
"description": "Идентификационный токен пользователя",
"in": "header",
"name": "Id-Token",
"required": true,
"schema": {
"example": "SUQgVE9LRU4gRk9SIFRFU1RJTkc=",
"format": "byte",
"type": "string"
}
}
},
"responses": {
"DocumentNotFound": {
"description": "Документ не найден"
},
"FileIsTooLarge": {
"description": "Размер файла превышает допустимый лимит"
},
"Forbidden": {
"description": "Доступ запрещён"
},
"InternalError_1": {
"description": "Внутренняя ошибка"
},
"NotAcceptable": {
"description": "Запрошенный тип ответа не поддерживается"
},
"Unauthorized_1": {
"description": "Аутентификация не пройдена"
},
"ValidationError": {
"content": {
"application/xml": {
"schema": {
"type": "string"
}
}
},
"description": "Ошибки валидации"
}
},
"schemas": {
"Iso20022PaymentValidationErrors": {
"description": "Ошибки валидации конкретного платежа в ISO20022 сообщении",
"properties": {
"errors": {
"description": "Ошибки валидации платежа",
"items": {
"$ref": "#/components/schemas/Iso20022ValidationError"
},
"type": "array"
},
"paymentId": {
"description": "Значение PmtInfId, если его удалось прочитать",
"example": "0031150319637",
"nullable": true,
"type": "string"
},
"paymentIndex": {
"description": "Порядковый номер блока PmtInf в исходном XML, начиная с 0",
"example": 0,
"format": "int32",
"type": "integer"
}
},
"required": [
"paymentIndex",
"errors"
],
"type": "object"
},
"Iso20022ValidationError": {
"description": "Ошибка валидации поля ISO20022 сообщения",
"properties": {
"field": {
"description": "Путь к полю в XML",
"example": "PmtInf.DbtrAcct.Id.Othr.Id",
"type": "string"
},
"message": {
"description": "Описание ошибки",
"example": "Debtor account number 12817810299910234324 is not found",
"type": "string"
},
"rejectedValue": {
"description": "Отклоненное значение",
"example": "12817810299910234324",
"nullable": true,
"type": "string"
}
},
"required": [
"field",
"message"
],
"type": "object"
},
"Iso20022ValidationResult": {
"description": "Результат валидации ISO20022 сообщения",
"example": {
"messageErrors": [
{
"field": "GrpHdr.MsgId",
"message": "Message identification MsgId invalid-msg-id doesn't match",
"rejectedValue": "invalid-msg-id"
},
{
"field": "GrpHdr.NbOfTxs",
"message": "Number of transactions NbOfTxs doesn't match",
"rejectedValue": "300"
}
],
"paymentErrors": [
{
"errors": [
{
"field": "PmtInf.CdtTrfTxInf.Amt.InstdAmt.Ccy",
"message": "Instructed amount currency Ccy USD doesn't match",
"rejectedValue": "USD"
}
],
"paymentId": "0031150319637",
"paymentIndex": 0
},
{
"errors": [
{
"field": "PmtInf.PmtInfId",
"message": "PmtInfId 0031150319637 is duplicated",
"rejectedValue": "0031150319637"
}
],
"paymentId": "0031150319637",
"paymentIndex": 1
}
]
},
"properties": {
"messageErrors": {
"description": "Ошибки уровня сообщения, заголовка, подписи или межплатежных проверок",
"items": {
"$ref": "#/components/schemas/Iso20022ValidationError"
},
"type": "array"
},
"paymentErrors": {
"description": "Ошибки, сгруппированные по платежам внутри сообщения",
"items": {
"$ref": "#/components/schemas/Iso20022PaymentValidationErrors"
},
"type": "array"
}
},
"required": [
"messageErrors",
"paymentErrors"
],
"type": "object"
}
},
"securitySchemes": {
"RaifApiAuthorization": {
"scheme": "bearer",
"type": "http"
},
"RaifApiIdToken": {
"in": "header",
"name": "Id-Token",
"type": "apiKey"
},
"bearerAuth": {
"bearerFormat": "JWT",
"scheme": "bearer",
"type": "http"
}
}
}