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

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

C помощью данного API Клиент может настроить в ERP получение статуса приема к исполнению Распоряжения, в том числе пакетного, по MsgId.

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

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

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

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

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

Параметры	Описание
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 Форматы финансовых сообщений перечислены здесь

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

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

Тип запроса GET

GET https://api.sberbank.ru:8443/prod/sberconnect/v1/payments/init/status/01C33E0D9024CE01113A2D771096DD96
 
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 OK
Server: nginx/1.20.1
Date: Thu, 12 Aug 2021 14:46:19 GMT
Content-Type: application/xml;charset=UTF-8
Content-Length: 4570
Connection: keep-alive
X-Gravitee-Transaction-Id: e946e80c-e22f-4c77-86e8-0ce22fcc7782
X-Gravitee-Request-Id: e946e80c-e22f-4c77-86e8-0ce22fcc7782
X-Rate-Limit-Limit: 8
X-Rate-Limit-Remaining: 7
X-Rate-Limit-Reset: 1628779580048
 
 
<?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>e1dde201cc2e4afbb7c48c8d3526f1fe</MsgId>
            <CreDtTm>2021-08-12T17:45:29+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>01C33E0D9024CE01113A2D771096DD96</OrgnlMsgId>
            <OrgnlMsgNmId>pain.001.001.09</OrgnlMsgNmId>
            <OrgnlCreDtTm>2021-08-12T12:32:47+03:00</OrgnlCreDtTm>
            <OrgnlNbOfTxs>1</OrgnlNbOfTxs>
            <OrgnlCtrlSum>60.0</OrgnlCtrlSum>
            <GrpSts>АСТС</GrpSts>
            <StsRsnInf>
            </StsRsnInf>
        </OrgnlGrpInfAndSts>
        <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>rCIioAKIgl11pRYEyd7Gdzea2VNbWFAiebsg8oojcuk=</ds:DigestValue></ds:Reference></ds:SignedInfo><ds:SignatureValue>AKHV/fCbkxgbMZNIZZXAExilXk5FV7Yy+nkqhLc4Ld0O4ALso8pplgWj9QSzMRoihVQK80S7t60I+eIZyANlMg==</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>