ym88659208ym87991671
Платежное поручение в формате ISO 20022 - прямая интеграциядля холдингов | Документация для разработчиков
Skip to main content

Платежное поручение в формате ISO 20022

Для обращения к ресурсу необходимо отправлять запрос на:

  • Тестовый контур https://edupirfintech.sberbank.ru:9443

  • Промышленный контур https://fintech.sberbank.ru:9443

Ресурс /v1/iso20022/payments

Ресурс позволяет создавать рублевое платежное поручение в формате ISO 20022.

Шаги:

1. Получить AccessToken.

2. Сформировать ЭП.

3. Отправить запрос.

4. Получить статус.

Для создания платежного поручения в формате ISO 20022 необходимо отправить POST-запрос (v1/iso20022/payments), в котором передать авторизационный токен к данным собственной организации (Access Token) и xml файл с платежным поручением. Авторизационный токен передается в параметре Authorization заголовка запроса.

Чтобы получить доступ к ресурсу, необходимо передать в scope сервис PAY_DOC_RU_ISO.

Модель запроса

НаименованиеОписание
Параметры заголовка
Authorization (String)Access token организации клиента, полученный через SSO
Пример: Bearer c76fb018-27c9-43f7-a751-62646eda7e1a-1
Параметры запроса
Объект xml Пример Объект xml 

Пример xsd схемы без подписи

Пример xsd схемы с подписью

danger

Для корректной работы сервиса необходимо использовать только эти xsd схемы. Использовать другие запрещено.

Описание  xsd   схемы

ТегТип данныхОписание
Путь
Пример
MsgIdtext{1,35}Уникальный идентификатор сообщения.Должнен быть равен InstrId
/Document/CstmrCdtTrfInitn/GrpHdr/MsgId
Пример 78177147e0e6414da94c369b9aa32da2
NbOfTxstext [0-9]{1,15}Общее число поручений (секций CdtTrfTxInf) в сообщении. Необходимо передавать только '1'.
/Document/CstmrCdtTrfInitn/GrpHdr/NbOfTxs
Пример 1
Nmtext{1,40}Наименование Плательщика
/Document/CstmrCdtTrfInitn/PmtInf/Dbtr/Nm
Пример ООО "Плательщик"
Idtext{1,35}ИНН/КИО Плательщика
/Document/CstmrCdtTrfInitn/PmtInf/Dbtr/Id/OrgId/Othr/Id
Пример 7701200000
Idtext{1,34}Счет Плательщика
/Document/CstmrCdtTrfInitn/PmtInf/DbtrAcct/Id/Othr/Id
Пример 40702810700010000000
MmbIdtext{1,35}БИК банка Плательщика
/Document/CstmrCdtTrfInitn/PmtInf/DbtrAgt/FinInstnId/ClrSysMmbId/MmbId
Пример 44525000
Idtext{1,34}Счет банка Плательщика
/Document/CstmrCdtTrfInitn/PmtInf/DbtrAgtAcct/Id/Othr/Id
Пример 30101810300000000000
InstrIdtext{1,35}Уникальный номер поручения
/Document/CstmrCdtTrfInitn/PmtInf/CdtTrfTxInf/PmtId/InstrId
Пример 78177147e0e6414da94c369b9aa32da2
EndToEndIdtext{1,35}Номер платежного поручения
/Document/CstmrCdtTrfInitn/PmtInf/CdtTrfTxInf/PmtId/EndToEndId
Пример 12341
InstdAmt0 <= decimal
td = 18
fd = 5
Сумма платежа
/Document/CstmrCdtTrfInitn/PmtInf/CdtTrfTxInf/Amt/InstdAmt
Пример 10000.00
MmbIdtext{1,35}БИК банка Получателя
/Document/CstmrCdtTrfInitn/PmtInf/CdtTrfTxInf/CdtrAgt/FinInstnId/ClrSysMmbId/MmbId
Пример 44525000
Nmtext{1,140}Наименование Получателя
/Document/CstmrCdtTrfInitn/PmtInf/CdtTrfTxInf/Cdtr/Nm
Пример ООО "Получатель"
Idtext{1,35}ИНН/КИО Получателя
/Document/CstmrCdtTrfInitn/PmtInf/CdtTrfTxInf/Cdtr/Id/OrgId/Othr/Id
Пример 7701200000
Idtext{1,34}Счет Получателя
/Document/CstmrCdtTrfInitn/PmtInf/CdtTrfTxInf/CdtrAcct/Id/Othr/Id
Пример 40702810800010000000
Prtrytext{1,35}Очередность платежа
/Document/CstmrCdtTrfInitn/PmtInf/CdtTrfTxInf/Purp/Prtry
Пример 5
TaxTptext{1,35}КПП получателя
/Document/CstmrCdtTrfInitn/PmtInf/CdtTrfTxInf/Tax/Dbtr/TaxTp
Пример 7777777777
Idtext{1,34}Корсчет банка получателя платежа
/Document/CstmrCdtTrfInitn/PmtInf/CdtTrfTxInf/CdtrAgtAcct/Id/Othr/Id
Пример 40702810800010000000
TaxTptext{1,35}КПП плательщика
/Document/CstmrCdtTrfInitn/PmtInf/CdtTrfTxInf/Tax/Dbtr/TaxTp
Пример 8888888888
Ustrdtext{1,140}Назначение платежа
/Document/CstmrCdtTrfInitn/PmtInf/CdtTrfTxInf/RmtInf/Ustrd
Пример Оплата по счету N123 от 01.02.2019
Prtrytext{1,35}Код операции
/Document/CstmrCdtTrfInitn/PmtInf/CdtTrfTxInf/PmtTpInf/LclInstrm/Prtry
Пример 1
RltdDtdateДата составления документа
/Document/CstmrCdtTrfInitn/PmtInf/ReqdExctnDt/Dt
Пример 01.01.2017
EnvlpArrayБлок подписи документа
/Document/CstmrCdtTrfInitn/SplmtryData/Envlp/DigestSignature
Base64EncodedstringЗначение электронной подписи, закодированное в Base64
/Document/CstmrCdtTrfInitn/SplmtryData/Envlp/DigestSignatures/Base64Encodedbb61c3d7-b627-49aa-a1b1-814ca0688a2e
Пример MIIM1mJkx+F/cXluNPM0TnrooXEVXcN
CertificateUuidstringУникальный идентификатор сертификата ключа проверки электронной подписи (UUID)
/Document/CstmrCdtTrfInitn/SplmtryData/Envlp/DigestSignatures/CertificateUuid
Пример bb61c3d7-b627-49aa-a1b1-814ca0688a2e
Ratedecimal
td = 1fd = 10
Ставка НДС
/Document/CstmrCdtTrfInitn/PmtInf/CdtTrfTxInf/Tax/Rcrd/TaxAmt/Rate
Пример 10
AddtlInftext{1,140}Способ расчета НДС
/Document/CstmrCdtTrfInitn/PmtInf/CdtTrfTxInf/Tax/Rcrd/AddtlInf
Пример VTPS
TtlAmt0 <= decimal
td = 18
fd = 5
Сумма НДС
/Document/CstmrCdtTrfInitn/PmtInf/CdtTrfTxInf/Tax/Rcrd/TaxAmt/TtlAmt
Пример 10000.00
DtlsСекция: Нормативные и законодательные требования
/Document/CstmrCdtTrfInitn/PmtInf/CdtTrfTxInf/RgltryRptg/Dtls
Пример -
Cdtext{1,10}Код вида валютной операции
/Document/CstmrCdtTrfInitn/PmtInf/CdtTrfTxInf/RgltryRptg/Dtls/Cd
Пример 1010
Cdtext{1,4}Вид платежа
/Document/CstmrCdtTrfInitn/PmtInf/CdtTrfTxInf/PmtTpInf/SvcLvl/Cd
Пример URGP или NURG
Reftext{1, 25}Уникальный идентификатор платежа
/Document/CstmrCdtTrfInitn/PmtInf/CdtTrfTxInf/RmtInf/Strd/CdtrRefInf/Ref
Пример 23435334354353E+24
DbtrStstext{1,35}Показатель статуса налогоплательщика (реквизит - 101)
/Document/CstmrCdtTrfInitn/PmtInf/CdtTrfTxInf/Tax/Rcrd/DbtrSts
Пример 2
CtgyDtlstext{1,20}Код бюджетной классификации (реквизит - 104)
/Document/CstmrCdtTrfInitn/PmtInf/CdtTrfTxInf/Tax/Rcrd/CtgyDtls
Пример 20202020202020200000
AdmstnZonetext{1,35}Код OKTMO (реквизит - 105)
/Document/CstmrCdtTrfInitn/PmtInf/CdtTrfTxInf/Tax/AdmstnZone
Пример 12345678901
Ctgytext{1,35}Показатель основания платежа (реквизит - 106)
/Document/CstmrCdtTrfInitn/PmtInf/CdtTrfTxInf/Tax/Rcrd/Ctgy
Пример ТП
RefNbtext{1,140}Номер налогового документа (реквизит - 108)
/Document/CstmrCdtTrfInitn/PmtInf/CdtTrfTxInf/Tax/RefNb
Пример 386732
DtdateДата налогового документа (реквизит - 109)
/Document/CstmrCdtTrfInitn/PmtInf/CdtTrfTxInf/Tax/Dt
Пример 42736
Tptext{1,35}Тип налогового платежа (реквизит - 110)
/Document/CstmrCdtTrfInitn/PmtInf/CdtTrfTxInf/Tax/Rcrd/Tp

Пример запроса

Скачать пример запроса в формате XML

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:pain.001.001.09">
<CstmrCdtTrfInitn>
<GrpHdr>
<MsgId>27c8ae5f9b5b4d85bc6de76ac07877c5</MsgId>
<NbOfTxs>1</NbOfTxs>
</GrpHdr>
<PmtInf>
<ReqdExctnDt>
<Dt>2021-09-19</Dt>
</ReqdExctnDt>
<Dbtr>
<Nm>Организация HBrBnhMvHRwFieW</Nm>
<Id>
<OrgId>
<Othr>
<Id>2291550000</Id>
</Othr>
</OrgId>
</Id>
</Dbtr>
<DbtrAcct>
<Id>
<Othr>
<Id>40702810969066665721</Id>
</Othr>
</Id>
</DbtrAcct>
<DbtrAgt>
<FinInstnId>
<ClrSysMmbId>
<MmbId>044525225</MmbId>
</ClrSysMmbId>
</FinInstnId>
</DbtrAgt>
<DbtrAgtAcct>
<Id>
<Othr>
<Id>30101810400000000225</Id>
</Othr>
</Id>
</DbtrAgtAcct>
<CdtTrfTxInf>
<PmtId>
<InstrId>27c8ae5f9b5b4d85bc6de76ac07877c5</InstrId>
<EndToEndId>1</EndToEndId>
</PmtId>
<PmtTpInf>
<SvcLvl>
<Cd>NURG</Cd>
</SvcLvl>
<LclInstrm>
<Prtry>01</Prtry>
</LclInstrm>
</PmtTpInf>
<Amt>
<InstdAmt>122.02</InstdAmt>
</Amt>
<CdtrAgt>
<FinInstnId>
<ClrSysMmbId>
<MmbId>044525225</MmbId>
</ClrSysMmbId>
</FinInstnId>
</CdtrAgt>
<CdtrAgtAcct>
<Id>
<Othr>
<Id>30101810400000000225</Id>
</Othr>
</Id>
</CdtrAgtAcct>
<Cdtr>
<Nm>Организация hLlAYGcAnQExarL</Nm>
<Id>
<OrgId>
<Othr>
<Id>6086632602</Id>
</Othr>
</OrgId>
</Id>
</Cdtr>
<CdtrAcct>
<Id>
<Othr>
<Id>40702810398986880668</Id>
</Othr>
</Id>
</CdtrAcct>
<Purp>
<Prtry>5</Prtry>
</Purp>
<RgltryRptg>
<Dtls>
<Tp>VO</Tp>
<Cd>61150</Cd>
</Dtls>
</RgltryRptg>
<Tax>
<Cdtr>
<TaxTp>070552262</TaxTp>
</Cdtr>
<Dbtr>
<TaxTp>604856353</TaxTp>
</Dbtr>
<Rcrd>
<TaxAmt>
<Rate>18</Rate>
<TtlAmt>45</TtlAmt>
</TaxAmt>
<AddtlInf>VTIN</AddtlInf>
</Rcrd>
</Tax>
<RmtInf>
<Ustrd>Назначение платежа</Ustrd>
<Strd>
<CdtrRefInf>
<Ref>0</Ref>
</CdtrRefInf>
</Strd>
</RmtInf>
</CdtTrfTxInf>
</PmtInf>
<SplmtryData>
<Envlp>
<DigestSignature>
<Base64Encoded>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</Base64Encoded>
<CertificateUuid>c3086978-634c-405e-a875-0e8a82679f6b</CertificateUuid>
<InstrId>a9682481c4e2483eaad4f7952dfd343c</InstrId>
</DigestSignature>
</Envlp>
</SplmtryData>
</CstmrCdtTrfInitn>
</Document>

Модель ответа

Скачать пример xsd схемы

ТегТип данныхОписание
Путь
Пример
GrpHdrЗаголовок
/CstmrPmtStsRpt/GrpHdr
MsgIdtext{1,35}Уникальный идентификатор сообщения
/CstmrPmtStsRpt/GrpHdr/MsgId
Пример 56baf6ab4c2e499cb092115d84ef8608
CreDtTmdateTimeДата-время создания сообщения
/CstmrPmtStsRpt/GrpHdr/CreDtTm
Пример 2013-02-20T14:59:51+03:00
OrgnlMsgIdtext{1,35}Идентификатор исходного сообщения
/CstmrPmtStsRpt/OrgnlGrpInfAndSts/OrgnlMsgId
Пример27c8ae5f9b5b4d85bc6de76ac07877c5
OrgnlMsgNmIdtext{1,35}Тип исходного сообщения
/CstmrPmtStsRpt/OrgnlGrpInfAndSts/OrgnlMsgNmId
Пример pain.001.001.09
GrpStstext{1,4}Статус исходного сообщения
Статусы ISO ниже в таблице
/CstmrPmtStsRpt/OrgnlPmtInfAndSts/TxInfAndSts/TxSts
Пример RCVD
AddtlInftext{1,105}Описание причины присвоения статуса сообщения
Только для статуса RJCT, а также при ошибках валидации json
/CstmrPmtStsRpt/OrgnlPmtInfAndSts/TxInfAndSts/StsRsnInf/AddtlInf
OrgnlInstrIdtext{1,35}Технический идентификатор исходного поручения
/CstmrPmtStsRpt/OrgnlPmtInfAndSts/TxInfAndSts/OrgnlInstrId
Пример 78177147e0e6414da94c369b9aa32da2

Описание статусов ISO

Описание статуса ISOСтатус ISO
Принято к исполнениюACTC
Отклонено Статус также возвращается при ошибке валидации xsd/jsonRJCT
ПроведеноACSC
ОтозванCANC

Передача электронной подписи вместе с документом

Для передачи ЭП под документом используется массив digestSignatures, в котором передаются элементы типа Signature (все поля обязательны):

Наименования поляОписания поляПример
base64Encoded (string)Значение ЭП документаHlaeIHXXEcGT1bFxo1NlpAzpr+kJ2IQrcxVdvDTep6xjsmD1FDb+6NIyLT+/T24S0mPfVCU75sieOMt71TBS7w==
certificateUuid (string)Идентификатор сертификата, использованного при создании ЭП ( можно узнать, обратившись к ресурсу /v1/crypto)22a6dd81-103a-4d3a-8e9b-0ba4b527f5f6

Для платежных поручений, создаваемым по собственным счетам можно передать одну или две электронных подписей (или не передавать при отсутствии ЭП) вместе с реквизитами создаваемого документа. Если ЭП передана/ы в API, то они сохраняются вместе с документом, а сам документ продвигается дальше по своему жизненному циклу. Если ЭП не была/и передана/ы, то документ сохраняется в своем начальном статусе и ожидает дальнейшего подписания в интерфейсе СББОЛ.

Документ может быть подписан следующими наборами подписей:

  • одна (единственная) подпись;
  • первая и вторая подписи.

При этом подписант, обладающий полномочием единственной подписи, не может «сочетаться» с подписантом, владеющим первой или второй подписью.

Очередность наложения ЭП при наложении первой и второй подписей не имеет значения, состав полей дайджеста не изменяется. Тип подписи указывается в настройках криптопрофиля, когда пользователь Партнера создается в Банке.

Формат дайджеста РПП

Наименование тегаНаименование поляОписание, пример
InstdAmt
/Document/CstmrCdtTrfInitn/PmtInf/CdtTrfTxInf/Amt/InstdAmt
amountСумма платежа
100.00
RltdDt
/Document/CstmrCdtTrfInitn/PmtInf/ReqdExctnDt/Dt
dateДата составления документа
43251
RefNb
/Document/CstmrCdtTrfInitn/PmtInf/CdtTrfTxInf/Tax/RefNb386732
departmentalInfo.docNumber108Номер налогового документа(реквизит-108)
123
DbtrSts
/Document/CstmrCdtTrfInitn/PmtInf/CdtTrfTxInf/Tax/Rcrd/DbtrSts
departmentalInfo.drawerStatus101Показатель статуса налогоплательщика(реквизит-101)
1
CtgyDtls
/Document/CstmrCdtTrfInitn/PmtInf/CdtTrfTxInf/Tax/Rcrd/CtgyDtls
departmentalInfo.kbkКод бюджетной классификации(реквизит-104)
18210100000000000000
AdmstnZone
/Document/CstmrCdtTrfInitn/PmtInf/CdtTrfTxInf/Tax/AdmstnZone
departmentalInfo.oktmoКод ОКТМО(реквизит-105)
1701000
Tp
/Document/CstmrCdtTrfInitn/PmtInf/CdtTrfTxInf/Tax/Rcrd/Tp
departmentalInfo.paymentKind110Тип налогового платежа(реквизит-110)
НС
Ctgy
/Document/CstmrCdtTrfInitn/PmtInf/CdtTrfTxInf/Tax/Rcrd/Ctgy
departmentalInfo.reasonCode106Показатель основания платежа(реквизит-106)
ТП
Ref
/Document/CstmrCdtTrfInitn/PmtInf/CdtTrfTxInf/RmtInf/Strd/CdtrRefInf/Ref
departmentalInfo.uipУникальный идентификатор платежа
0
InstrId
/Document/CstmrCdtTrfInitn/PmtInf/CdtTrfTxInf/PmtId/InstrId
externalIdИдентификатор документа, присвоенный сервисом
0000000-0000-0000-0000-00000000000
Prtry
/Document/CstmrCdtTrfInitn/PmtInf/CdtTrfTxInf/PmtTpInf/LclInstrm/Prtry
operationCodeКод операции
1
Id
/Document/CstmrCdtTrfInitn/PmtInf/CdtTrfTxInf/CdtrAcct/Id/Othr/Id
payeeAccountНомер счета получателя
40702800000000000000
MmbId
/Document/CstmrCdtTrfInitn/PmtInf/CdtTrfTxInf/CdtrAgt/FinInstnId/ClrSysMmbId/MmbId
payeeBankBicБИК получателя
44525225
Id
/Document/CstmrCdtTrfInitn/PmtInf/CdtTrfTxInf/CdtrAgtAcct/Id/Othr/Id
payeeBankCorrAccountКорсчет банка получателя
30101800000000000000
Id
/Document/CstmrCdtTrfInitn/PmtInf/CdtTrfTxInf/Cdtr/Id/OrgId/Othr/Id
payeeInnИнн получателя
222201000000
TaxTp
/Document/CstmrCdtTrfInitn/PmtInf/CdtTrfTxInf/Tax/Dbtr/TaxTp
payeeKppКпп получателя
222201001
Nm
/Document/CstmrCdtTrfInitn/PmtInf/CdtTrfTxInf/Cdtr/Nm
payeeNameПолное наименование получателя платежа
Общество с ограниченной ответственностью "Получатель"
Id
/Document/CstmrCdtTrfInitn/PmtInf/DbtrAcct/Id/Othr/Id
payerAccountСчет плательщика
40702800000000000000
MmbId
/Document/CstmrCdtTrfInitn/PmtInf/DbtrAgt/FinInstnId/ClrSysMmbId/MmbId
payerBankBicБИК плательщика
44525225
Id
/Document/CstmrCdtTrfInitn/PmtInf/DbtrAgtAcct/Id/Othr/Id
payerBankCorrAccountКорсчет банка плательщика
30101800000000000000
Id
/Document/CstmrCdtTrfInitn/PmtInf/Dbtr/Id/OrgId/Othr/Id
payerInnИНН плательщика
222201000000
TaxTp
/Document/CstmrCdtTrfInitn/PmtInf/CdtTrfTxInf/Tax/Dbtr/TaxTp
payerKppКПП плательщика
222201001
Nm
/Document/CstmrCdtTrfInitn/PmtInf/Dbtr/Nm
payerNameПолное наименование плательщика
Общество с ограниченной ответственностью "Клиент"
Prtry
/Document/CstmrCdtTrfInitn/PmtInf/CdtTrfTxInf/PmtTpInf/LclInstrm/Prtry
priorityОчередность платежа
5
Ustrd
/Document/CstmrCdtTrfInitn/PmtInf/CdtTrfTxInf/RmtInf/Ustrd
purposeНазначение платежа
Оплата интернет заказа №123. НДС нет
Cd
/Document/CstmrCdtTrfInitn/PmtInf/CdtTrfTxInf/RgltryRptg/Dtls/Cd1010
voCodeКод вида валютной операции
61150
danger

Идентификатор документа, присвоенный сервисом должен быть в формате 0000000-0000-0000-0000-00000000000

Пример дайджеста

amount=100.00
date=2018-05-31
departmentalInfo.docNumber108=123
departmentalInfo.drawerStatus101=01
departmentalInfo.kbk=18210102010011000110
departmentalInfo.oktmo=01701000
departmentalInfo.paymentKind110=НС
departmentalInfo.reasonCode106=ТП
departmentalInfo.uip=0
externalId=a0000000-0000-0000-0000-000000000001
incomeTypeCode=2
operationCode=01
payeeAccount=40702810600100001212
payeeBankBic=044525225
payeeBankCorrAccount=30101810400000000225
payeeInn=222201236445
payeeKpp=222201001
payeeName=Общество с ограниченной ответственностью "Получатель"
payerAccount=40702810500006103990
payerBankBic=044525225
payerBankCorrAccount=30101810400000000225
payerInn=222201236445
payerKpp=222201001
payerName=Общество с ограниченной ответственностью "Клиент"
priority=5
purpose=Оплата интернет заказа №123. НДС нет.
voCode=61150

Ресурс /v1/iso20022/payments/{instrId}/state

Ресурс позволяет получить статус платежного поручения.

Шаги

1. Получить AccessToken.

2. Отправить запрос.

Для получения статуса необходимо отправить GET-запрос (/fintech/api /v1/iso20022/payments/{instrId}/state), в котором передать авторизационный токен к данным собственной организации (Access Token) и идентификатор документа (InstrId). Формат идентификатора хххххххххххххххххххххххххххххххх. Авторизационный токен передается в параметре Authorization заголовка запроса.

Чтобы получить доступ к ресурсу, необходимо передать в scope сервис PAY_DOC_RU_ISO.

Модель запроса

НаименованиеОписание
Параметры заголовка
Authorization (String)Access token, полученный через SSO
Пример: Bearer c76fb018-27c9-43f7-a751-62646eda7e1a-1
Параметры запроса
InstrId (String)Идентификатор документа, присвоенный клиентом.
Пример: 049a825821454935bf4c27de4670795a

Пример запроса

curl -X GET --header "Accept: /" --header "
Authorization: Bearer f8ad3141-b7e8-4924-92de-3de4fd0a464e-1"
"https://edupirfintech.sberbank.ru:9443/fintech/api/v1/iso20022/payments/049a825821454935bf4c27de4670795a/state"

Модель ответа

Соответствует модели запроса и ответа /v1/iso20022/payments.

Коды возврата

Возвращаются в json в случае критической ошибки

Код возврата РасшифровкаОписание кода возвратаПричина возникновения
400
DESERIALIZATION_FAULT
Неверный формат запросаНеверный формат запроса
400
WORKFLOW_FAULT

Не указан идентификатор сертификата подписи
Некорректный формат параметра kid заголовка JWS
Не указан идентификатор сертификата подписи(параметр kid заголовка JWS)

Некорректный формат параметра kid заголовка JWS(ожидается UUID)
400
VALIDATION_FAULT

Ошибка валидации
Доступна отправка только одного платежного поручения.
Ошибка валидации данных запроса с указанием некорректных значений. Значения полей модели или параметров запроса не соответствуют допустимым и определенным в модели, ошибка валидации по xsd.
Ошибка возникает, если в запросе было передано больше 1 блока CdtTrfTxInf
400
SIGN_CHECK_EXCEPTION
Подлинность подписи не установлена/Сертификат не обнаружен или не является активнымОшибка возникает, если не удалось установить подлинность подписи
401
UNAUTHORIZED
accessToken not found by value =хххххххх-хххх-хххх-хххх-хххххххххххх-хУказан некорректный или просроченный access_token.
403
ACTION_ACCESS_EXCEPTION
Операция не может быть выполнена: доступ к ресурсу запрещенУ пользователя нет прав на использование соответствующего сервиса Fintech API, доступ к которому не предусмотрен настройками scope;
У пользователя отсутствует оферта с внешним сервисом.
415
JWS_EXCEPTED
В соответствии с текущими настройками сервиса с clientId=%s необходимо использовать запрос в формате JWS Compact SerializationОшибка возникает, если в настройках внешних сервисов выставлен флаг "Требуется подпись для внешнего сервиса"
500
UNKNOWN_EXCEPTION
Внутренняя ошибка сервера
Обновлено 13 сентября 2022

Заметили ошибку?

Выделите текст и нажмите Ctrl + Enter, чтобы сообщить нам о ней