Сервис получения статуса исполнения распоряжения на перевод средств

Обновлено 11 октября 2022

C помощью данного API Клиент может настроить в ERP получении статуса исполнения транзакции(-й) в Распоряжении по MsgId и InstrId.

Запрос статуса исполнения Распоряжения формируется не ранее чем через 2-3 минуты после отправки платежа.

Используемые форматы перечислены здесь Форматы финансовых сообщений.

Описание бизнес-процесса

1. ERP Клиента формирует запрос на получение статуса исполнения Распоряжения:
   • на основании MsgID и InstrID исходного Распоряжения;
   • для получения статуса исполнения по нескольким транзакциям в составе пакетного Распоряжения, необходимо запросить статус каждой транзакции по InstrId отдельно;
2. ERP Клиента вызывает API для аутентификации;
3. API Сбербанка проводит аутентификацию и авторизацию, возвращает Клиенту access token;
4. ERP Клиента вызывает API для отправки запроса на получение статуса исполнения Распоряжения;
5. API проводит форматно-логический контроль запроса;
6. После успешной валидации сообщения осуществляется поиск статуса Распоряжения по значениям MsgID и InstrID;
7. Банк в синхронном режиме возвращает статус исполнения Распоряжения.

Описание атрибутов запроса

Параметры	Описание
X-IBM-Client-Id (header)	Уникальный идентификатор системы партнера, полученный при регистрации на Портале разработчика
Authorization (header)	Получение токена авторизации осуществляется в методе Сервиc получения токена авторизации
RqUID (header)	Уникальный идентификатор сообщения, сгенерированный Клиентом в формате [0-9A-Fa-f]{32}. Для того, чтобы гарантировать уникальность, требуется использовать стандартные библиотеки и классы генерации UUID (https://ru.wikipedia.org/wiki/UUID), убрав из результата символ разделителя «-». Если заголовок отсутствует в запросе, идентификатор будет сгенерирован автоматически и передан клиенту в аналогичном заголовке ответа
msgId (path)	Идентификатор исходного сообщения (значение тега /Document/CstmrCdtTrfInitn/GrpHdr/MsgId), которое передается в формате pain.001.001.09 Форматы финансовых сообщений перечислены здесь
transactId (path)	Идентификатор транзакции в составе исходного сообщения (значение тега /Document/CstmrCdtTrfInitn/PmtInf/CdtTrfTxInf/PmtId/InstrId), которое передается в формате pain.001.001.09 Форматы финансовых сообщений перечислены здесь

Ответы сервиса описаны в разделе Статусная модель сервиса Расчетное обслуживание

Описание примеров сообщений

Отправка запроса на получения статуса исполнения Распоряжения

Тип запроса GET

GET https://api.sberbank.ru:8443/prod/sberconnect/v1/payments/init/status/0E40174AC16520CC8223A87864C5DE58/eC3eBBc865800Ea8B105f1982Ef6A94D
 
Connection: keep-alive
RqUID: 2ed308f20ff2fb4c1d2f8d5fe5caca37
X-IBM-Client-Id: 92253ba6-d9f5-401c-a39e-0f4a68ac92f9
Authorization: Bearer 29453357-7ef1-45bc-b8ab-4f1944fd0b98
Content-Type: application/xml;charset=utf-8
Host: api.sberbank.ru:8443
User-Agent: Apache-HttpClient/4.5.12 (Java/1.8.0_261)

Ответ сервиса

HTTP/1.1 200
RqUID: 2ed308f20ff2fb4c1d2f8d5fe5caca37
Content-Type: application/xml;charset=UTF-8
Content-Length: 1218
Date: Fri, 20 Mar 2020 14:31:52 GMT
 
<?xml version="1.0" encoding="UTF-8"?><Document xmlns="urn:iso:std:iso:20022:tech:xsd:pain.002.001.10" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <CstmrPmtStsRpt>
        <GrpHdr>
            <MsgId>6f5625a208054d6f85a6c345a92c3887</MsgId>
            <CreDtTm>2021-08-13T12:09:35+03:00</CreDtTm>
            <InitgPty>
                <Nm>ПАО СБЕРБАНК</Nm>
                <PstlAdr>
                    <Ctry>RU</Ctry>
                </PstlAdr>
                <Id>
                    <OrgId>
                        <Othr>
                            <Id>044525225</Id>
                            <SchmeNm>
                                <Cd>CBID</Cd>
                            </SchmeNm>
                        </Othr>
                    </OrgId>
                </Id>
            </InitgPty>
        </GrpHdr>
        <OrgnlGrpInfAndSts>
            <OrgnlMsgId>0E40174AC16520CC8223A87864C5DE58</OrgnlMsgId>
            <OrgnlMsgNmId>pain.001.001.09</OrgnlMsgNmId>
            <OrgnlCreDtTm>2021-08-13T10:24:28+03:00</OrgnlCreDtTm>
            <OrgnlNbOfTxs>1</OrgnlNbOfTxs>
            <OrgnlCtrlSum>10000.0</OrgnlCtrlSum>
        </OrgnlGrpInfAndSts>
        <OrgnlPmtInfAndSts>
            <OrgnlPmtInfId>NONREF</OrgnlPmtInfId>
            <TxInfAndSts>
                <OrgnlInstrId>eC3eBBc865800Ea8B105f1982Ef6A94D</OrgnlInstrId>
                <OrgnlEndToEndId>233448</OrgnlEndToEndId>
                <TxSts>ACSC</TxSts>
            </TxInfAndSts>
        </OrgnlPmtInfAndSts>
        <SplmtryData>
            <Envlp>
                <SgntrSt><ds:Signature xmlns:ds="http://www.w3.org/2000/09/xmldsig#" Id="1"><ds:SignedInfo><ds:CanonicalizationMethod Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315#WithComments"/><ds:SignatureMethod Algorithm="urn:ietf:params:xml:ns:cpxmlsec:algorithms:gostr34102012-gostr34112012-256"/><ds:Reference URI=""><ds:Transforms><ds:Transform Algorithm="http://www.w3.org/2002/06/xmldsig-filter2"><dsig-xpath:XPath xmlns:dsig-xpath="http://www.w3.org/2002/06/xmldsig-filter2" Filter="subtract">/node()[name()='Document']/*/*[name()='SplmtryData']/descendant::node()[name()='SgntrSt']/ancestor::node()[name()='SplmtryData']</dsig-xpath:XPath></ds:Transform><ds:Transform Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315#WithComments"/></ds:Transforms><ds:DigestMethod Algorithm="urn:ietf:params:xml:ns:cpxmlsec:algorithms:gostr34112012-256"/><ds:DigestValue>FJ3hDH+F9rx9QbMgad++XrFAbaRxCQH0vinJpX9f3wg=</ds:DigestValue></ds:Reference></ds:SignedInfo><ds:SignatureValue>UHIrIxCPztUWrZYjeOqxI24kinXs5eR7R75z36qcGkdQqOfIfKc5mucvrREQ0bExXN+tfbsPifVpUovEOO1kBg==</ds:SignatureValue><ds:KeyInfo><ds:X509Data><ds:X509Certificate>MIIE2zCCBIigAwIBAgIKeLqmSzNAnvax/DAKBggqhQMHAQEDAjCCAXAxCzAJBgNVBAYTAlJVMRgwFgYDVQQIDA83NyDQnNC+0YHQutCy0LAxGTAXBgNVBAcMENCzLiDQnNC+0YHQutCy0LAxJzAlBgNVBAkMHtGD0LsuINCS0LDQstC40LvQvtCy0LAsINC0LiAxOTE7MDkGA1UEAwwy0J/QkNCeINCh0LHQtdGA0LHQsNC90LogKNCi0LXRgdGCINCT0J7QodCiIDIwMTIgUSkxOzA5BgNVBAoMMtCf0JDQniDQodCx0LXRgNCx0LDQvdC6ICjQotC10YHRgiDQk9Ce0KHQoiAyMDEyIFEpMTAwLgYDVQQLDCfQo9C00L7RgdGC0L7QstC10YDRj9GO0YnQuNC5INGG0LXQvdGC0YAxGjAYBggqhQMDgQMBARIMMDA3NzA3MDgzODkzMRgwFgYFKoUDZAESDTEwMjc3MDAxMzIxOTUxITAfBgkqhkiG9w0BCQEWEmNhc2JyZkBzYmVyYmFuay5ydTAeFw0yMDEyMjEwOTM1MDBaFw0yMjAzMjEwOTM2NDRaMIIBMjEfMB0GA1UECgwW0KHQsdC10YDQotC10YXQotC10YHRgjELMAkGA1UEBhMCUlUxHDAaBgNVBAgMEzc3INCzLiDQnNC+0YHQutCy0LAxGDAWBgNVBAcMD9CzLtCc0L7RgdC60LLQsDEmMCQGA1UECQwd0YPQuy4g0JLQsNCy0LjQu9C+0LLQsCwg0LQuMTkxGjAYBggqhQMDgQMBARIMMDA3NzA3MDgzODkzMRgwFgYFKoUDZAESDTEwMjc3MDAxMzIxOTUxHzAdBgNVBAMMFtCh0LHQtdGA0KLQtdGF0KLQtdGB0YIxSzBJBgNVBAsMQtCi0LXRgdGC0L7QstC+0LUg0L/QvtC00YDQsNC30LTQtdC70LXQvdC40LUg0KHQsdC10YDQotC10YXQotC10YHRgjBmMB8GCCqFAwcBAQEBMBMGByqFAwICIwIGCCqFAwcBAQICA0MABECT+QLkQqwWbqi9AhP2lrOyaM3NcBPh8vtuex4+f+ITA4mzH0IyZ+hyiJE7Xb6b0ZZqbncVtkAWC7mjyo8To4VAo4IBNTCCATEwMwYHKoUDA3sDAQQoDCZTQlRKMzhMTWHQotC10YHRglNiZXJDb25uZWN0XzIwMTLQutCyZDAJBgNVHRMEAjAAMA4GA1UdDwEB/wQEAwIE8DAnBgNVHSUEIDAeBggrBgEFBQcDBAYIKwYBBQUHAwIGCCsGAQUFBwMDMB0GBSqFA2RvBBQMEtCR0LjQutGA0LjQv9GCIDUuMDAdBgNVHSAEFjAUMAgGBiqFA2RxATAIBgYqhQNkcQIwHQYDVR0OBBYEFO4ItZsSOOSmuhUIQqBBmdY6rCTRMDgGA1UdHwQxMC8wLaAroCmGJ2h0dHA6Ly93d3cuc2JyZi5ydS9jYS9URVNUMjAxMng1MDlrLmNybDAfBgNVHSMEGDAWgBShJTspadeXnMLcBgq5tj8BtXfNVDAKBggqhQMHAQEDAgNBABRjFy4+cD2TuBbGMqDCOk0ITh2PXmSBeFImqW/0S5HYd+iMVXe0XXC/MudsYQo3PnhcZYCWpyoqSbJm8DTQ3Cs=</ds:X509Certificate></ds:X509Data></ds:KeyInfo></ds:Signature></SgntrSt>
            </Envlp>
        </SplmtryData>
    </CstmrPmtStsRpt>
</Document>