ym88659208ym87991671
Платежное поручение в формате ISO 20022 | Документация для разработчиков

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

Обновлено 13 июля 2023

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

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

  • Новый тестовый контур https://iftfintech.testsbi.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 
Пример: c76fb018-27c9-43f7-a751-62646eda7e1a-1 
Параметры запросаПример: Объект xml 
Объект xml 

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

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

Для корректной работы сервиса необходимо использовать только эти 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>

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

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

Скачать пример 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 20022

Описание статуса 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

Идентификатор документа, присвоенный сервисом должен быть в формате 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.
Пример: 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.

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

Код возвратаОписание кода возвратаПричина возникновения
200 (GET-запрос)ОК
201 (POST-запрос)CREATED
Создан
400DESERIALIZATION_FAULT
Неверный формат запросаНеверный формат запроса
WORKFLOW_FAULT
Для внешнего сервиса недоступны операции по счету: 40702810ХХХХХХХХХХХХДля внешнего сервиса недоступны операции по счету:
счет не добавлен в список разрешенных в оферте;
внешний сервис заблокирован в СББОЛ;
счет указан неверно.
Отсутствует доступный открытый рублевый расчетный счет у организации плательщика
Документ с такими реквизитами уже существуетДокумент с такими реквизитами уже существует. Проверка по номер документа в течении года.
Не указан идентификатор сертификата подписиНе указан идентификатор сертификата подписи(параметр kid заголовка JWS)
Некорректный формат параметра kid заголовка JWSНекорректный формат параметра kid заголовка JWS(ожидается UUID)
VALIDATION_FAULT
Ошибка валидацииОшибка валидации данных запроса с указанием некорректных значений. Значения полей модели или параметров запроса не соответствуют допустимым и определенным в модели.
SIGN_CHECK_EXCEPTION
Подлинность подписи не установлена/Сертификат не обнаружен или не является активнымОшибка возникает, если не удалось установить подлинность подписи
401UNAUTHORIZED
accessToken not found by value =хххххххх-хххх-хххх-хххх-хххххххххххх-хУказан некорректный или просроченный access_token.
403ACTION_ACCESS_EXCEPTION
Операция не может быть выполнена: доступ к ресурсу запрещенУ пользователя нет прав на использование соответствующего сервиса SberBusinessAPI (Fintech API), доступ к которому не предусмотрен настройками scope; У пользователя отсутствует оферта с внешним сервисом.
404DATA_NOT_FOUND_EXCEPTION
Платежный документ не найденНеверное значение externalId
415JWS_EXCEPTED
В соответствии с текущими настройками сервиса с clientId=%s необходимо использовать запрос в формате JWS Compact SerializationОшибка возникает, если в настройках внешних сервисов выставлен флаг "Требуется подпись для внешнего сервиса"
500UNKNOWN_EXCEPTION
Внутренняя ошибка сервера
ПАО Сбербанк использует cookie для персонализации сервисов и удобства пользователей.
Вы можете запретить сохранение cookie в настройках своего браузера.
Документация
SberJazzSaluteSpeechSaluteBotВся документация
Наши продукты
Витрина технологийБаза знанийСтань частью IT-команды
Юридические документы
Политика конфиденциальности Политика обработки данныхВсе соглашения и политики
© 1997–2023 ПАО СберБанк. Генеральная лицензия на осуществление банковских операций от 11 августа 2015 года. Регистрационный номер — 1481