Приступая к работе

ВАЖНО! Банк может изменять реквизитный состав возвращаемой информации, добавлять новые необязательные элементы. Партнёр должен это учитывать и в своих имплементациях корректно реагировать на появление новых атрибутов в REST сервисах SberBusinessAPI.

SberBusinessAPI (ранее Fintech API)

• SberBusinessAPI предназначен для работы с данными корпоративных клиентов ПАО Сбербанк.
• SberBusinessAPI реализован на базе протокола авторизации OAuth 2.0.
• Доступ Партнеров/Клиентов к SberBusinessAPI осуществляется после проведения процедур настройки на стороне Банка.
• Для подключения необходимо направить заявку в свободной форме (ИНН и название организации, сайт, если есть, свои контакты или контакты Вашего клиентского менеджера) на адрес электронной почты fintech_API@sberbank.ru или заполнить заявку на сайте.
• Подключение к SberBusinessAPI осуществляется на платной основе, на основе заявки будет рассчитана стоимость подключения.
• Ознакомиться с тарифами вы можете на сайте.

Взаимодействие происходит посредством REST-запросов к определённым методам SberBusinessAPI. Для организации взаимодействия необходимо выполнить доработку Вашей системы в соответствии со спецификацией SberBusinessAPI.

Для доступа к методам SberBusinessAPI требуется использовать TLS-сертификат, изданный банком.

Получение клиентского TLS сертификата

После выпуска сертификат будет добавлен в белый список и привязан к сервису. Запросы, отправленные под иным TLS-сертификатом, не будут валидными.

Формирование запроса на сертификат

Чтобы сформировать запрос на сертификат необходимо:

1. Войти в Windows с правами локального администратора;

2. На рабочем столе Windows нажать кнопку «Пуск».

3. В строке поиска ввести «certmgr.msc».

4. Нажать на найденную программу в верхней части окна, как на рисунке ниже.

5. В открывшейся оснастке перейти в папку «Личное».

6. На элемент «Сертификаты» нажать правой кнопкой мыши.

7. В открывшемся меню выбрать Все задачи/Дополнительные операции/Создать настраиваемый запрос.

8. В окне «Перед началом работы» нажать кнопку Далее.

9. В окне «Выбор политики регистрации сертификатов» необходимо выбрать пункт «Продолжить без политики регистрации» и нажать кнопку Далее.

10. В окне «Пользовательский запрос» выбрать шаблон «Старый ключ (без шаблона)», указать формат запроса «PKCS#10». Нажать кнопку Далее.

11. В окне «Сведения о сертификате» необходимо нажать на рядом с полем «Подробности» (обведено красным кружком).

12. В появившемся блоке необходимо нажать кнопку «Свойства».

13. В окне «Свойства сертификата» необходимо заполнить атрибуты запроса на сертификат согласно требованиям УЦ, предъявляемым к запросам на SSL сертификат. Все атрибуты должны заполняться только латинскими буквами. На вкладке «Общие», в поле «Понятное имя» ввести удобное для пользователя название сертификата.

14. На вкладке «Субъект» требуется заполнить следующие атрибуты:

В блоке «Имя субъекта» необходимо по очереди выбирать названия нужных атрибутов в ниспадающем списке «Тип», вводить значение атрибута в поле «Значение», а затем нажать кнопку Добавить. Ниже представлен пример заполнения атрибутов сертификата:

15. На вкладке «Расширения» необходимо в разделе «Использование ключа» добавить элементы «Шифрование данных» и «Цифровая подпись».

16. В разделе «Расширенное использование ключа (политики применения)» добавить элемент «Проверка подлинности клиента».

17. На вкладке «Закрытый ключ» в разделе «Поставщик службы шифрования» необходимо выбрать элемент «Microsoft RSA SChannel Cryptographic Provider (Шифрование)».

18. В разделе «Параметры ключа» установить «Размер ключа» равный 2048 и параметр «Сделать закрытый ключ экспортируемым».

19. После установки всех параметров нажать кнопку ОК.

20. В окне «Сведения о сертификате» нажать кнопку Далее.

21. В окне «Где вы хотите сохранить автономный запрос?» необходимо:

• В поле «Имя файла» указать имя файла, в который будет сохранен запрос на сертификат.
• Выбрать формат файла «Base64» (выделено красным цветом).
• Нажать кнопку Готово.
  

Окно регистрации сертификата будет закрыто, а система сформирует файл с запросом, с именем файла указанном на предыдущем шаге.

Формирование запроса на сертификат для систем отличных от Windows

Пример формирования через openssl:

$ openssl req -nodes -newkey rsa:2048 -keyout example.key -out example.csr -subj "/C=RU/O=Org/CN=FINTECH01/E=e-mail@example.com/OU=0123456789"

Чтобы получить клиентский TLS-сертификат, пользователю необходимо файл с запросом на сертификат:

• Передать своему куратору в Сбербанке, для отправки в УЦ Сбербанка.
• Направить в УЦ Сбербанка через запрос на supportdbo2@sberbank.ru по шаблону:

Тема: SberBusinessAPI / Наименование организации / Регистрация сертификата
ТЕСТ
Наименование организации
ИНН
ClientID
Просьба зарегистрировать сертификат во вложении для тестирования.

Установка сертификата

После того, как УЦ выпустит TLS сертификат, необходимо:

1. Получить сертификат у своего куратора в Сбербанке.

2. Установить цепочку доверенных сертификатов Сбербанка (если их еще нет) в каталог "Доверенные корневые центры сертификации".

3. Установить TLS сертификат (в каталог "Личные") на том же компьютере и под тем же пользователем, под которыми создавался запрос на этот сертификат.

Примеры тестовых сертификатов.zip

Генерацию запроса на создание сертификата необходимо сделать на одной машине и под одним конкретным пользователем. После издания банком сертификата его необходимо добавить на пк, где формировался запрос.

Изданный ключ и сертификат можно выгрузить в виде файла контейнера, защищенного паролем, и перенести на другой пк.

Для работы на тестовом стенде необходимо установить Цепочка тестовых TLS-сертификатов.zip

Для работы на промышленном стенде необходимо установить Цепочка промышленных TLS-сертификатов.zip

Для OS Linux

В OS Windows файл контейнера сертификата имеет формат .pfx. Для корректной работы в OS Linux конвертировать в более подходящий для системы формат (.pem) с помощью openssl.

Команды openssl для конвертации:

To convert a PFX file to a PEM file that contains both the certificate and private key, the following command needs to be used:

$ openssl pkcs12 -in filename.pfx -out cert.pem -nodes

Conversion to separate PEM files We can extract the private key form a PFX to a PEM file with this command:

$ openssl pkcs12 -in filename.pfx -nocerts -out key.pem

Exporting the certificate only:

$ openssl pkcs12 -in filename.pfx -clcerts -nokeys -out cert.pem

Проверка сертификата

Для проверки TLS сертификата (тест/пром), необходимо перейти по соответствующим ссылкам:

Тестовый swagger:

https://edupirfintech.sberbank.ru:9443/fintech/api/swagger-ui.html

Промышленный swagger:

https://fintech.sberbank.ru:9443/fintech/api/swagger-ui.html

При переходе на ресурс запрашивается TLS сертификат. Если сертификат не установлен или установлен некорректно, то возникнет ошибка.

Памятка по интеграции

1. Введение

Сервис SberBusinessAPI построен на базе современных технологий, которые предоставляют возможность взаимодействия с Банком через сеть Интернет. Посредством вызова программных функций с заранее определенным списком параметров Клиент может производить обмен электронными документами с Банком, в том числе передавать черновики платежных поручений в адрес пользователей системы «Сбербанк Бизнес Онлайн», получать выписки по счетам клиентов-юридических лиц с их согласия, направлять платежные поручения и платежные требования на списание денежных средств со счетов клиентов в рамках заранее данных акцептов за услуги Клиента. Взаимодействие с Сервисом осуществляется через функциональность, встроенную в автоматизированную систему Клиента (далее – АС Клиент), которая должна вызывать функции сервиса и обрабатывать результаты их работы.

Подключение АС Клиента к сети Интернет влечет риски, связанные с несанкционированным доступом к данным, хранящимся на сервере АС.

Соблюдение приведенных ниже рекомендаций позволит Вам максимально безопасно взаимодействовать с сервисом SberBusinessAPI и свести риски работы через сеть Интернет к минимуму.

2. Схема взаимодействия

Взаимодействие АС Клиента с сервисом SberBusinessAPI рекомендуется осуществлять в соответствии со схемой, изображенной на рис.1.
Рис.1. Схема взаимодействия АС Клиента с сервисом SberBusinessAPI.

При реализации схемы следует учесть следующие рекомендации:

2.1. Настройками внутреннего межсетевого экрана (Internal Firewall) доступ к серверу АС Клиента рекомендуется разрешить только для серверов и рабочих станций организации, необходимых для использования в производственном процессе:

• сервера контроллеров домена, обновлений системного и антивирусного ПО;
• АРМ администраторов сервера АС Клиента.

2.2. Для подключения АС Клиента к Шлюзу сервиса SberBusinessAPI Банка на межсетевом экране (External Firewall) необходимо разрешить взаимодействие с интернет-ресурсом fintech.sberbank.ru c использованием протокола HTTPS и передачей ip-пакетов в обоих направлениях для TCP-порта 9443.

2.3. Подписание ЭД с использованием устройств VPN-Key-TLS рекомендуется осуществлять в отдельном сегменте корпоративной сети.

2.4. Доступ рабочего места, предназначенного для подписания ЭД с использованием устройств VPN-Key-TLS, к ресурсам и сервисам сети Интернет должен быть исключен.

3. Меры по защите от вредоносного ПО

На сервере АС Клиента необходимо:

3.1. Использовать современное антивирусное программное обеспечение и следить за его регулярным обновлением.

3.2. Регулярно выполнять антивирусную проверку для своевременного обнаружения вредоносных программ.

3.3. Своевременно устанавливать обновления операционной системы серверов и АРМ администратора, рекомендуемые компанией-производителем в целях устранения выявленных уязвимостей ОС.

3.4. Использовать дополнительное программное обеспечение, позволяющее повысить уровень защиты компьютеров – персональные межсетевые экраны, программы поиска шпионских компонент, программы защиты от «спам»- рассылок и пр.

3.5. Обеспечить отсутствие несанкционированно установленных программ удаленного доступа (TeamViewer, BeTwin, RAdmin и др.), программ работы с вирусоопасными ресурсами и сервисами сети Интернет, включая почтовые клиенты.

3.6. Исключить установку, полученного из не заслуживающих доверия источников, а также нелицензионного и свободно-распространяемого ПО на сервере с системой. Обращаем Ваше внимание, что сотрудники ПАО «Сбербанк» не рассылают дистрибутивы ПО по электронной почте.

4. Меры, направленные на защиту от копирования ключевой и парольной информации

4.1. Client_Secret – это конфиденциальная информация. Ни при каких обстоятельствах не раскрывайте эти данные никому, включая сотрудников Банка.

4.2. При подозрениях на компрометацию постоянного Client_Secret, следует незамедлительно остановить работу с сервисом SberBusinessAPI, направить письмо с запросом о замене Client_Secret и провести смену Client_Secret после его получения от Банка.

4.3. В случае компрометации Client_Secret необходимо незамедлительно выполнить его блокировку в соответствии с п.4.2.3 Соглашения.

4.4. При доступе АС Клиента к функциям SberBusinessAPI хранение Client_Secret необходимо осуществлять в ключевом хранилище. Настройками безопасности ОС доступ к ключевому хранилищу рекомендуется предоставлять только для учетной записи АС.

4.5. Процедуру замены Client_Secret необходимо проводить в автоматизированном режиме средствами АС без вмешательства пользователей.

4.6. При обращении от имени Банка по телефону, электронной почте, через SMS-сообщения лиц с просьбами сообщить или передать конфиденциальную информацию (Client_Secret) ни при каких обстоятельствах не сообщайте данную информацию.

4.7. В период, когда Система не используется, необходимо отключать носители с ключами ЭП от сервера, и убирать в места хранения (сейф, и т.п.).

4.8. Необходимо выполнять незамедлительную блокировку и смену ключей ЭП в случаях их компрометации, а также по истечении срока действия ключей с периодичностью, установленной договорами и документацией.

4.9. ПИН-коды доступа устройств «VPN-Key-TLS» - это конфиденциальная информация. Ни при каких обстоятельствах не раскрывайте эти данные никому, включая сотрудников Банка.

5. Меры, направленные на защиту от выполнения несанкционированных списаний

5.1. Следует регулярно контролировать состояние корреспондентских счетов организации и незамедлительно информировать обслуживающее подразделение Банка обо всех подозрительных или несанкционированных операциях.

5.2. В случае неожиданного выхода из строя серверов с модулем подписания с использованием устройств VPN-Key-TLS необходимо прекратить эксплуатацию данных серверов, отключив их от всех видов сетей, включая локальную корпоративную сеть, срочно запросить выписку по счету непосредственно в Банке. При обнаружении несанкционированных платежных операций написать заявление в Банк, а также обратиться с соответствующим заявлением в правоохранительные органы. Работоспособность скомпрометированных серверов не восстанавливать до проведения технической экспертизы. Подписание электронных документов осуществлять с использованием устройств VPN-Key-TLS на других серверах. При этом обязательно произвести смену ключей ЭП.

6. Меры по поддержанию уровня информационной безопасности

Для обеспечения высокого уровня информационной безопасности при эксплуатации АС Клиента в организации должен быть назначен ответственный, который осуществляет:

6.1. Постоянный контроль соблюдения мер информационной безопасности, предусмотренных настоящей памяткой;

6.2. Выявление, устранение и информирование руководства организации обо всех выявленных нарушениях;

6.3. Контроль устранения выявленных нарушений;

6.4. Документирование результатов проведенных работ и проверок;

6.5. Организацию и проведение мероприятий по усилению безопасности в соответствии с информационными сообщениями, которые направляются Банком официальными письмами, а также публикуются на сайте Банка.

Тестовые и промышленные URL SberBusinessAPI

Адреса для тестирования и работы в промышленном контуре с SberBusinessAPI и Сбер Бизнес ID.

Личный кабинет SberBusinessAPI

В Личном кабинете SberBusinessAPI доступны методы:

• Авторизация Сбер Бизнес ID;
• Заявка на удаленное подключение Зарплатного проекта;
• Запрос на сертификат;
• Рублёвое платёжное поручение;
• Зарплатный договор;
• Валютное платежное поручение;
• Письмо свободного формата (из банка);
• Получение информации о счетах подключенного клиента;
• Получение выписки по счёту клиента;
• Зарплатная ведомость;
• Получение криптоинформации (КУЦ, криптопрофили и т.д.);
• Справочник.

Чтобы получить доступ к Личному кабинету SberBusinessAPI, оставьте заявку на сайте.

В течение 1-3 рабочих дней с вами свяжется менеджер.

Инструкция по подключению

Шаги

1. Подключить услугу через СберБизнес
2. Заполнить и подписать заявление
3. Настройка тестового полигона
4. Настройка промышленного полигона
5. Контакты для связи

Шаг 1. Подключить услугу через СберБизнес

1.1. Авторизуйтесь в СберБизнес.

1.2. Перейдите в раздел меню Все продукты и услуги, выберите SberBusinessAPI.

В появившемся окне с информацией о продукте нажмите Подключить.

Ознакомиться с условиями подключения можно по ссылке https://www.sberbank.ru/ru/legal/finapi?tab=terms .

Шаг 2. Заполнить и подписать заявление

2.1. Заполните заявление и укажите контактный телефон, электронную почту и ответственное лицо за настройку сервиса. Для добавления ответственного лица нажмите кнопку Добавить и из раскрывающегося списка выберите пункт Создать нового сотрудника.

2.2. В открывшемся окне заполните данные ответственного сотрудника и нажмите Добавить.

Ознакомьтесь с условиями предоставления услуг и установите флажок Согласие с условиями предоставления услуг. Нажмите кнопку Создать.

2.3. Отправьте заявление в банк.

Подпишите документ с помощью СМС-кода или токена и отправьте его в банк.

Отследить статус заявления вы можете в разделе Моя организация > Заявления.

Шаг 3. Настройка тестового полигона

3.1. После того, как заявление успешно подписано, откроется личный кабинет SberBusinessAPI.

3.2. Разверните вкладку Параметры тестового полигона.

Учетные данные пользователя:

• Логин и пароль — для авторизации в web Интернет-банк СберБизнес.

Параметры сервиса:

• Redirect_url — маска адреса по которой пользователь будет перенаправлен с кодом авторизации;
• Client_id — банковский идентификатор сервиса полученный от менеджера при регистрации;
• Client_secret — авторизационный ключ сервиса. Генерируется банком в момент заведения сервиса;
• Scope для авторизации v2 — для выполнения авторизации по методу v2/oauth/authorize.

3.3. Отправьте информацию вашим разработчикам.

Нажмите Отправить настройки.

Укажите адрес электронной почты. Нажмите кнопку Отправить.

Нажмите Скопировать в буфер обмена, чтобы скопировать настройки тестового полигона.

Для изменения настроек тестового полигона необходимо направить запрос на supportdbo2@sberbank.ru.

Шаг 4. Настройка промышленного полигона

4.1. Сформируйте TLS-сертификат по инструкции или в Личном кабинете SberBusinessAPI. Направьте с указанием услуги SberBusinessAPI: наименование организации, ИНН, среда ТЕСТ или ПРОМ, client_id на supportdbo2@sberbank.ru.

4.2. Разверните вкладку Параметры промышленного полигона.

Параметры сервиса:

• Redirect_url — маска адреса по которой пользователь будет перенаправлен с кодом авторизации;
• Client_id — банковский идентификатор сервиса полученный от менеджера при регистрации;
• Client_secret — авторизационный ключ сервиса;
• Scope для авторизации v1 — для выполнения авторизации по методу /v1/oauth/authorize;
• Scope для авторизации v2 — для выполнения авторизации по методу v2/oauth/authorize.

4.3. Отправьте информацию вашим разработчикам.

Нажмите Отправить настройки.

В открывшемся окне укажите адрес электронной почты. Нажмите кнопку Отправить.

Нажмите Скопировать в буфер обмена, чтобы скопировать настройки промышленного полигона.

4.4. Укажите Redirect URI.

Redirect URI — ссылка на ресурс вашей компании, на который будет осуществляться возврат после прохождения авторизации.

Нажмите на кнопку:

Введите значение Redirect URI. Нажмите Сохранить.

Экспертная поддержка:

E-mail: supportdbo2@sberbank.ru

Режим работы: Понедельник-Пятница 09:00 - 19:00 (по московскому времени)

Инструкция по работе

• Сменить client-secret
• Сгенерировать TLS-сертификат
• Установить TLS-сертификат
• Отозвать TLS-сертификат
• Получить/обновить/удалить AccessToken
• Просмотреть тарифы
• Просмотреть сумму комиссии банка за конкретный месяц
• Скачать отчет по потреблению сервиса SberBusinessAPI в форматах pdf/xls
• Настроить оповещения
• Отключить сервис
• Назначить сотруднику роль Разработчик SberBusinessAPI

Сменить client-secret

Сменить client-secret могут пользователи, у которых:

• ЭП с полномочиями ЕИО (Единоличный исполнительный орган)
• Единственная подпись
• Первая подпись
• Роль Разработчик SberBusinessAPI

1. Разверните вкладку Параметры промышленного полигона.

2. Сгенерируйте новый client-secret. В поле Client-secret нажмите кнопку:

3. Подтвердите генерацию. Нажмите Подтвердить.

После генерации необходимо скопировать client-secret. Иначе он замаскируется и потребуется повторная генерация.

Сгенерировать TLS-сертификат

1. Разверните вкладку Сертификаты шифрования.

2. Сгенерируйте сертификат. Нажмите кнопку Сгенерировать сертификат. Рядом с кнопкой отображается количество доступных для генерации сертификатов.

В открывшемся окне укажите один или несколько адресов электронной почты.

Придумайте и введите пароль доступа к сертификату.

Требования к паролю:

• Содержит минимум 7 символов.
• Содержит цифры и буквы.
• Не содержит трех одинаковых символов подряд.

Нажмите кнопку Отправить.

Если TLS-сертификат успешно сгенерирован и отправлен на почту, в окне появится подтверждение.

На указанный адрес электронной почты придет письмо с вложенным зашифрованным контейнером PKCS#12.

Сгенерированные сертификаты появятся на вкладке Сертификаты шифрования.

Нажмите кнопку Загрузить, чтобы скачать цепочку доверенных TLS-сертификатов.

Нажмите кнопку Инструкция, чтобы открыть инструкцию по установке сертификатов.

Установить TLS-сертификат

1. Установите Цепочка доверенных TLS-сертификатов.zip(если их еще нет) в каталог "Доверенные корневые центры сертификации".

2. Установите TLS-сертификат в каталог "Личные" на том же компьютере.

Для работы на тестовом стенде необходимо установить Цепочка тестовых TLS-сертификатов.zip.

Отозвать TLS-сертификат

Чтобы отозвать TLS-сертификат, обратитесь к менеджеру или направьте запрос на supportdbo2@sberbank.ru.

Получить/обновить/удалить AccessToken

Для доступа к разделу обратитесь к менеджеру или направьте запрос на supportdbo2@sberbank.ru.

1. Разверните вкладку Ключи доступа.

2. Получите AccessToken.

Нажмите кнопку Создать ключ.

После создания необходимо скопировать AccessToken. Иначе ключ замаскируется и потребуется его повторное создание.

3. Чтобы обновить AccessToken, нажмите кнопку:

4. Чтобы удалить AccessToken, нажмите кнопку:

Подтвердите удаление ключа доступа. Нажмите кнопку Удалить.

В разделе Другие ключи отображаются:

• ФИО сотрудников вашей организации, которые выпустили AccessToken.
• Срок действия AccessToken.

Чтобы удалить AccessToken, нажмите кнопку и подтвердите действие. Удаление AccessToken из раздела Другие ключи доступно только пользователю ЕИО.

Просмотреть тарифы

Нажмите кнопку Показать все тарифы.
Слева в колонке Стоимость Количество запросов отобразятся тарифные ставки.

Просмотреть сумму комиссии банка за конкретный месяц

Наведите курсор на соответствующий столбец графика. Отобразится окно с информацией по выбранному месяцу.

Скачать отчет по потреблению сервиса SberBusinessAPI в форматах pdf/xls

Нажмите кнопку PDF или XLS.

Содержание отчета:

• Дата формирования запросов;
• Наименование запросов;
• Количество выполненных банком запросов;
• Расчетный период;
• Для каждого расчетного месяца указаны: количество запросов, сумма комиссии банка;
• Реквизиты банка для оплаты вознаграждения банка.

Настроить оповещения

1. Нажмите кнопку Настроить оповещения.

2. Выберите необходимые уведомления: при смене тарифных зон, при определенном значении запросов.

Укажите количество запросов.

Нажмите Сохранить.

При достижении указанного количества запросов для уведомления при определенном значении запросов придет письмо на электронную почту.

Отключить сервис

1. В правом верхнем углу нажмите кнопку Отключить сервис.

Отключение сервиса доступно при наличии подключенных незаблокированных сервисов.

2. Заполните заявление.

Укажите контактные данные представителя и дату, с которой необходимо отключить SberBusinessAPI. Нажмите Создать.

Будут отключены все сервисы, подключенные через СберБизнес и отделения банка.

3. Отправьте заявление в банк.

Подпишите документ с помощью СМС-кода или токена и отправьте его в банк.

Отследить статус заявления вы можете в разделе Моя организация > Заявления.

До отключения в Личном кабинете будет отображаться информационное сообщение.

Назначить сотруднику роль Разработчик SberBusinessAPI

Роль Разработчик SberBusinessAPI — роль сотрудника для доступа в ЛК SberBusinessAPI. У такого сотрудника не будет доступа к документам и и разделам ЦКП.

1. Выберите роль.

При заполнении карточки Новый пользователь нажмите кнопку Выбрать роль.

2. Назначьте роль Разработчик SberBusinessAPI.

В строке Полномочия найдите роль Разработчик SberBusinessAPI. Нажмите кнопку Назначить.

3. Внесите данные о сотруднике.

Заполните поля: сотрудник, логин, счета и телефон. Нажмите Создать.

4. Отправьте заявление в банк.

Подпишите документ с помощью СМС-кода или токена и отправьте его в банк.

Отследить статус заявления вы можете в разделе Моя организация > Заявления.

Глоссарий

• Access Token — авторизационный токен к данным организации.
• Refresh Token — токен обмена, который предназначен для получения нового Access Token и Refresh Token в случае компрометации или истечения времени жизни Access Token.
• redirect_uri — маска адреса по которой пользователь будет перенаправлен с кодом авторизации (допускается совпадение redirect_uri с URL сервиса).
• scope — должен содержать обязательный параметр "openid" и через пробел перечисляются scope-ы доступных claim и сервисов, полученных от менеджера партнёра при регистрации приложения (обязательный параметр при обращении к ресурсу).
• Прямая Интеграция Host-2-Host — вы получаете информацию по своей компании через SberBusinessAPI.
  

Прямая интеграция Host-2-Host (Получение и отправка документов по своей организации)

2.1 Сервис авторизации-Сбер Бизнес ID

Общая информация

API сервиса авторизации реализован по Authorization Code Flow. Авторизация и аутентификация выполняется путем переадресации пользователя с запросом /authorize на страницу входа в Сбербанк Бизнес Онлайн и запроса /token для получения Access token.

Возможности сервиса

1. Единая аутентификация.
   SberBusinessAPI позволяет аутентифицированному, в АС Интернет-банке СберБизнес, пользователю получить доступ к сервису без повторной аутентификации.
   
2. Авторизация.
   Пользователь выдает сервису право на совершение операции со своими данными, подписывая электронно оферту. Согласие на передачу данных и документарных операций (оферта) может быть отозвано по инициативе пользователя, по причине окончания срока ее действия.
   
3. Доступ к пользовательским данным.
   SberBusinessAPI позволяет идентифицировать пользователя для его последующей авторизации. Получение данных о пользователе позволяет сервису выполнять упрощённую регистрацию для новых пользователей своих сервисов. Точный набор передаваемых атрибутов пользователя формируется для каждого сервиса индивидуально.

Требования к сервису

• Приложение должно быть реализовано с поддержкой OpenIDConnect/OAuth 2.0 и обеспечивать следующую функциональность:
• Проверка подлинности пользователя (формирование и проверка параметров State и Nonce).
• Формирование запроса кода авторизации (Authorization Code).
• Обработка ответа ресурса /v1/oauth/authorize.
• Формирование запроса на получение авторизационного токена для доступа к данным клиента (Access Token).
• Обработка ответа ресурса /v1/oauth/token (в том числе расшифровка ID Token).
• Формирование запроса на получение нового авторизационного токена для доступа к данным пользователя (с помощью Refresh Token).
• Формирование запроса на получение информации о пользователе.
• Обработка ответа ресурса /v1/oauth/user-info.

В случае возникновения ошибок работы сервиса, для анализа вопроса, Банком будут запрошены логи обмена со стороны сервиса. Рекомендуем реализовать логирование всех взаимодействий с Банком с фиксацией отправляемых/получаемых пакетов.

2.1.1 Авторизация пользователя

GET /v2/oauth/authorize-Код авторизации

POST /v2/oauth/token-Авторизационный токен

GET /v1/oauth/user-info-Информация о пользователе

POST /v1/change-client-secret-Смена авторизационного ключа

Смс пользователь — пользователь, который использует SMS-подтверждение (одноразовый SMS-пароль).

Токен пользователь — пользователь, который использует устройство защиты (токен).

Смс и токен пользователям можно установить три типа подписи:
- Первая.
- Вторая.
- Единственная.

Для авторизации ( /v2/oauth/authorize ) смс пользователя необходимо отправлять запрос на:

• Тестовый контур https://edupir.testsbi.sberbank.ru:9443
• Промышленный контур https://sbi.sberbank.ru:9443

Для авторизации (/v2/oauth/authorize) токен пользователя необходимо отправлять запрос на:

• Тестовый контур http://localhost:28016
• Промышленный контур http://localhost:28016

Для обращения к ресурсам /v2/oauth/token, /v1/oauth/user-info, /v1/change-client-secret необходимо отправлять запрос на:

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

Работа с тестовым токеном

1. Для работы токен пользователей, на тестовом стенде, необходимо получить VPNKeyTLS токен у своего менеджера или написать на fintech_API@sberbank.ru.

2. Авторизация в токене происходит после запуска .exe файла в токене и ввода ПИН-кода. Список ПИН-кодов направляется клиенту, после передачи токена, в электронном виде.

3. После авторизации в интерфейсе токена необходимо выбрать БС EDUPIR (бизнес система тестового стенда EDUPIR) и авторизоваться в Интернет-банке СберБизнес.

4. Для возможности подписывать документы необходимо выпустить сертификат ЭП:
4.1. Через интерфейс Интернет-банка СберБизнес по документации.
4.2. Через SberBusiness API по документации.

5. После создания запроса необходимо отправить информацию в поддержку supportdbo2@sberbank.ru, для регистрации сертификата в УЦ Банка, в формате:

• Стенд:EDUPIR
• ClientId и логин тестового пользователя
• BicryptID (КУЦ + номер сертификата)
• Логин владельца сертификата или название организации
• Дата отправки запроса на сертификат
• Текст/Комментарий: (при необходимости)

6. После регистрации в УЦ поступит ответ от supportdbo2@sberbank.ru о готовности сертификата.

7. Необходимо активировать сертификат:
7.1. Через интерфейс Интернет-банка СберБизнес по документации.
7.2. Через SberBusiness API по документации.

8. Сертификат активирован и готов к работе.

Ресурс /v2/oauth/authorize

Если вы работаете с сервисами авторизации версии v1, нажмите здесь.

Для получения возможности работы пользователя через ваш сервис необходимо получить разрешение на выполнение операции от имени пользователя Интернет-банк СберБизнес - пройти авторизацию. Для этого необходимо перенаправить пользователя на oauth-сервер Сбер Бизнес ID.

При первом переходе пользователя дочерней организации на Сбер Бизнес ID ему будет предложено подписать оферту, дающую право сервису на отправку запросов по организации пользователя.

Пример запроса с экранированием

# You can also use wget
curl -X GET https://edupir.testsbi.sberbank.ru:9443/ic/sso/api/v2/oauth/authorize?scope=openid PAY_DOC_RU inn email&response_type=code&client_id=74617&state=af0ifjsldkj&nonce=n-0S6_WzA2Mj&redirect_uri=https%3A%2F%2example.ru \
  -H 'Accept: */*'

Пример запроса без экранирования

# You can also use wget
curl -X GET https://edupir.testsbi.sberbank.ru:9443/ic/sso/api/v2/oauth/authorize?scope=openid PAY_DOC_RU inn email&response_type=code&client_id=74617&state=af0ifjsldkj&nonce=n-0S6_WzA2Mj&redirect_uri=https://example.ru \
  -H 'Accept: */*'

GET /v2/oauth/authorize

При отправке запроса необходимо экранировать специальные символы, если сформированная ссылка открывается напрямую в браузере, экранирования не требуется.

Parameters

Пример ответа для запроса с экранированием

302 Response

https://example.ru/?code=f710576d-7263-4ec6-a01b-8404aca2850d-1&state=af0ifjsldkj&nonce=n-0S6_WzA2Mj

Пример ответа для запроса без экранирования

302 Response

https://example.ru/?code=f710576d-7263-4ec6-a01b-8404aca2850d-1&state=af0ifjsldkj&nonce=n-0S6_WzA2Mj

Responses

В случае обнаружения ошибок client_id и redirect_uri банк сформирует ответ HTTP 400 с ошибкой invalid_grant и описанием:

• Redirect uri https://example.ru is invalid - неверный redirect_uri
• Invalid client secret for authz code 'хххххххх-хххх-хххх-хххх-хххххххххххх-х'

В случае если банк вернёт ответ с ошибкой авторизации, сервис должен корректно его обработать. Так как первый шаг взаимодействия (аутентификация) осуществляется через браузер пользователя, банк вернёт HTTP ответ 302 Found. Это необходимо для того, чтобы сервис имел возможность обработать ошибку и отобразить пользователю необходимую ему страницу, например, страницу авторизации (рекомендовано).

Список доступных claim

Список доступных сервисов

Формирование параметра State

Параметр служит для защиты от CSRF-атак. Для каждого сервиса в банке указывается ссылка на страницу сервиса, на которую необходимо перенаправить пользователя из банка после успешной авторизации (redirect_uri). При поступлении на redirect_uri запроса с кодом авторизации сервис должен проверять, что обмен данными происходит в рамках инициированного им самим взаимодействия.
Значение State должно быть защищено от подбора и храниться таким образом, чтобы его не мог изменить никто, кроме сервиса. Рекомендуется использовать идентификатор сессии в сервисе или один из его производных (например, хэш этого идентификатора), при этом может использоваться любой другой механизм генерации случайного значения достаточной длины для предотвращения подбора. В общем случае оптимально использовать строку длиной не менее 36 символов с проверкой регистра.

Формирование параметра Nonce

Параметр служит для защиты от replay-атак, то есть для предотвращения обработки одного и того же запроса несколько раз. Значение Nonce должно быть защищено от подбора и храниться таким образом, чтобы его не мог изменить никто, кроме сервиса. Рекомендуется использовать случайное значение, сохраняемое в сессии пользователя в сервисе. Для повторного запроса это значение должно заменяться новым. В общем случае оптимально использовать строку длиной не менее 10 символов с проверкой регистра.

Оферта

Для взаимодействия с сервисами пользователю необходимо подписать оферту, в которой указано к каким данным и на какой срок предоставлен доступ сервису. При подписании Оферты, пользователь в явном виде указывает доступность счетов.
После получения банком запросов со стороны сервиса, касающихся пользовательских данных, выполняется проверка наличия между сервисом и пользователь активной оферты, а при её отсутствии или истечения срока действия сервису возвращается сообщение об ошибке доступа к данным пользователя. Для возобновления работы с данными пользователя необходимо переадресовать пользователя на форму авторизации с запросом /authorize.

Формирование хоста для отправки запроса Authorization Code

В зависимости от типа пользователя алгоритм формирования хоста для запросов авторизации должен быть различным:

• Если SMS-пользователь, то значение хоста будет, например, https://edupir.testsbi.sberbank.ru:9443/ic/sso/api/v2/oauth/authorize?{параметры}
• Если Token-пользователь, то значение хоста будет, например, http://localhost:28016/ic/sso/api/v2/oauth/authorize?{параметры} , где 28016 — значение параметра callbackPort, переданного при первом переходе пользователя из банка на сервис.

Указанные выше значения хостов приведены для примера. Реальные значения сообщаются по не автоматизируемым каналам.

Ресурс /v2/oauth/token

После получения кода авторизации и проверки корректности успешного ответа необходимо запросить авторизационный токен к данным пользователя Access Token, который возвращается вместе с ID Token, содержащим пользовательские идентификационные данные, и ключом Refresh Token.

Шаги

1. Получить код авторизации
2. Отправить запрос
3. Декодировать ID Token
4. Актуализация авторизационного токена

Обмен кода авторизации на Access Token происходит через меж серверные каналы (REST-сервис), поэтому значение хоста не зависит от типа пользователя (userType). В случае возникновения ошибки при попытке получить AccessToken по коду авторизации по каким-либо причинам (например, неправильно передан client_secret) код авторизации удаляется и все дальнейшие попытки получить по нему AccessToken (даже с корректными параметрами) будут приводить к ошибке с текстом "Unknown code = <код_авторизации>". Запрос должен производиться только методом POST с типом данных application/x-www-form-urlencoded.

Code samples

# You can also use wget
curl -X POST https://edupirfintech.sberbank.ru:9443/ic/sso/api/v2/oauth/token?grant_type=string&client_id=string \
  -H 'Accept: application/jose'

POST /v2/oauth/token

При отправке запроса необходимо экранировать специальные символы, если сформированная ссылка открывается напрямую в браузере, экранирования не требуется.

Parameters

Example responses

200 Response

{
  "access_token": "93b1afbd-a9ce-446e-88ce-14f652320001-1",
  "expires_in": 3600,
  "id_token": "eyJhbGciOiJub0.ICAgImlzcyI6Mjg5NzYxMDAxIiwNCiAgICJhdWQiO.",
  "refresh_token": "771e239f-e30d-404f-825a-004314b56011-1",
  "scope": "openid exampleservice exampleclaim",
  "token_type": "Bearer"
}

Responses

В случае обнаружения ошибок client_id и redirect_uri банк сформирует ответ HTTP 400 с ошибкой invalid_grant и описанием:

• Redirect uri https://example.ru is invalid - неверный redirect_uri
• Invalid client secret for authz code 'хххххххх-хххх-хххх-хххх-хххххххххххх-х'

В случае если банк вернёт ответ с ошибкой авторизации, сервис должен корректно его обработать. Так как первый шаг взаимодействия (аутентификация) осуществляется через браузер пользователя, банк вернёт HTTP ответ 302 Found. Это необходимо для того, чтобы сервис имел возможность обработать ошибку и отобразить пользователю необходимую ему страницу, например, страницу авторизации (рекомендовано).

При получении ответа сервис должен проверить его корректность в соответствии со спецификацией. Рекомендации по проверке ответа на запрос Access Token описаны в спецификациях:

• https://tools.ietf.org/html/rfc6749#section-5
• http://openid.net/specs/openid-connect-core-1_0.html#IDTokenValidation
• http://openid.net/specs/openid-connect-core-1_0.html#CodeFlowTokenValidation

Декодирование ID Token

При необходимости декодировать ID Token следует воспользоваться алгоритмом Base64URL Encoding.

Пример ответа Id Token

eyJhbGciOiJnb3N0MzQtMTAuMjAxMiJ9.eyJzdWIiOiJhMWNhOGYyMTQ4MDc1M2IyMzI1MTZiYzk4NmNiZmM4Yjc5MjNiYWI3ODczODQzZWM0ZjQ1MTA4MmI0YTg3NjFjIiwiaXNzIjoiaHR0cDovL3NidC1vYWZzLTYzODo5MDgwL2ljZGsiLCJhdWQiOiIyMDg1IiwiZXhwIjoxNTE4Njg2MDI1LCJpYXQiOjE1MTg2ODU3MjUsImF1dGhfdGltZSI6MTUxODY4NTM4NSwiYWNyIjoibG9hLT
MiLCJhbXIiOiJ7cHdkLCBtY2EsIG1mYSwgb3RwLCBzbXN9IiwiYXpwIjoiMjA4NSIsIm5vbmNlIjoiOTc2MjgwY2ZmZTg5In0=.AGnvv73vv73vv71iFGM977+9We+/vUvvv73vv704Re+/ve+/vWnvv73vv71y77+9dQh+77+9GR1377+9Ml8T77+9ae+/vTbvv73Gle+/vU1t77+977+977+977+97LKk77+9XyQRPFEl77+977+9

Пример декодированного ответа

{

"typ": "JWT",
"alg": "gost34.10-2012"
}
{
"sub": "a1ca8f21480753b232516bc986cbfc8b7923bab7873843ec4f451082b4a8761c",
"iss": "https://edupirfintech.sberbank.ru:9443",
"aud": "2085",
"exp": 1518686025,
"iat": 1518685725,
"auth_time": 1518685385,
"acr": "loa-3",
"amr": "{pwd, mca, mfa, otp, sms}",
"azp": "2085",
"nonce": "976280cffe89"
}
AGnvv73vv73vv71iFGM977+9We+/vUvvv73vv704Re+/ve+/vWnvv73vv71y77+9dQh+77+9
GR1377+9Ml8T77+9ae+/vTbvv73Gle+/vU1t77+977+
977+977+97LKk77+9XyQRPFEl77+977+9

Согласно спецификации JSON Web Token (JWT) ID Token должен быть представлен структурой вида:

• Алгоритм подписи (по сертификату технологического криптопрофиля Банка, который можно получить запросом /crypto), Header(Заголовок);
• ID_token, Payload (Полезная нагрузка);
• Электронная подпись

Каждая часть ответа, разделённая точкой, должна декодироваться отдельно. Для проверки подписи в поле id_token на стороне пользователя, необходимо вычислить подпись публичным ключом Банка, декодировав блок Payload по Base64URL (содержимое между двумя точками). Далее необходимо сравнить полученное значение c блоком Электронная подпись (содержимое после второй точки), декодированным по Base64URL.

Если банку не удаётся предоставить какие-то данные, такой атрибут отсутствует в ответе (не должно быть атрибутов со значением NULL).

Проверка подписи Банка

Согласно стандарту OpenID Connect проверка электронной подписи, полученной в ID Token (содержимое ответа ID Tokena после второй точки), выполняется, используя алгоритм, указанный в параметре заголовка JWT alg . Партнёру необходимо проверить подпись сертификатом Банка.

Актуализация авторизационного токена

Ключ Refresh Token предназначен для получения нового Access Token и Refresh Token в случае компрометации или истечения времени жизни Access Token.

Code samples

# You can also use wget
curl -X POST https://edupirfintech.sberbank.ru:9443/ic/sso/api/v2/oauth/token?grant_type=string&client_id=string \
  -H 'Accept: application/jose'

POST /v2/oauth/token

Parameters

Example responses

200 Response

{
  "access_token": "6e55338d-7a7a-4b66-bc78-248d52eeb1dc-1",
  "expires_in": 3600,
  "refresh_token": "668c708e-865a-42b1-8fe9-846b92b8b14e-1",
  "scope": "openid exampleservice exampleclaim",
  "token_type": "Bearer"
}

Responses

• Рекомендуется обновлять ключи доступа (Access Token/Refresh Token) как минимум один раз за время жизни Refresh Token. В случае если Refresh Token потеряет актуальность (не будет обновлён до истечения времени жизни), сервис сможет получить актуальные ключи доступа только после повторной авторизации пользователя в сервисе через Интернет-банк СберБизнес.

• Если при обновлении ключей доступа по Refresh Token не был получен ответ из банка, то рекомендуется повторно отправить запрос на актуализацию ключей в течение 1 часа от момента отправки первой попытки, используя тот же Refresh Token. Успешное формирование ответа на стороне банка с новой парой ключей (Access Token/Refresh Token) переводит использованный раннее Refresh Token в статус резервного. Срок жизни резервного Refresh Token составляет 2 часа с момента выпуска новой пары ключей (Access Token/Refresh Token). Для последующих обновлений ключей доступа необходимо использовать Refresh Token из новой пары ключей (Access Token/Refresh Token).

Ресурс /v1/oauth/user-info

Ресурс позволяет получать данные о подключенном сервисе (если пользователь "разрешил" сервису доступ к своим данным), которые могут включать в себя информацию об организации пользователя, например:

• идентификатор организации пользователя (hashOrgId)

Каждому сервису при регистрации подключают, одинаковый для всех сервисов, обязательный системный scope, который включает в себя только идентификатор пользователя. Помимо этого для каждого сервиса подключается дополнительный уникальный scope. Перечень данных дополнительного scope определяется индивидуально менеджером.

Шаги

1. Получить код авторизации
2. Получить токен авторизации
3. Отправить запрос

Запрос User Info должен производиться методом GET с использованием заголовка Authorization и передаваемых в нём значения Bearer (всегда должно соответствовать ответу в параметре token_type=) и значения из access_token. При запросе сервисом информации о пользователе своей организации не заполняется claim "accounts".

Code samples

# You can also use wget
curl -X GET https://edupirfintech.sberbank.ru:9443/ic/sso/api/v1/oauth/user-info \
  -H 'Accept: */*' \
  -H 'Authorization: string'

GET /v1/oauth/user-info

Parameters

Example responses

200 Response

Пример ответа

w0Y8g0L_QvtC00L_QuNGB0YwiLCJzdW1tT2ZmZXJTbWFydENyZWRpdCI6MCwib3JnQWN0dWFsQWRkcmVzcyI6ItCg0J7QodCh0JjQmdCh0JrQkNCvINCk0JXQlNCV0KDQkNCm0JjQrywgMTIxMzUxLCDQsy7QnNC-0YHQutCy0LAsINGD0LsuINCa0L7RhtGO0LHQuNC90YHQutC0LPQviwg0LTQvtC8IDQsINGB0YLRgC4gMywg0L7RhC4gMTLQpiIsIkhhc2hPcmdJZCI6ImIzNGI2YTQ1MzM4NjJlNTE2N2U5ODc4NWIxZDIzYWE3ODlkYWMyMTYwYjNjN2M5Y2MzOTIyMWJkMzNmZmM4NWEiLCJpc0lkZW50aWZpZWQiOnRydWUsIm9yZ1BwcmJJZCI6MTE5MzkwMzUwMjcyNTI2MTcxMSwidXNlclBvc2l0aW9uIjoi0JHRg9GF0LPQsNC70YLQtdGAIiwiZW1haWwiOiJtZWRpYSsrQHNidC5ydSIsIm9yZ0d1aWQiOiIxMTFjOWMxMy02NGRhLTQ3OTAtOWM5Mi00YjA1NDk5YjZjNGIiLCJpbm4iOiI3NzMzODEyOTIwIiwib3JnSnVyaWRpY2FsQWRkcmVzcyI6ItCg0J7QodCh0JjQmdCh0JrQkNCvINCk0JXQlNCV0KDQkNCm0JjQrywgMTI1MzY3LCDQsy7QnNC-0YHQutCy0LAsINC_0YDQvtC10LfQtC4g0JLRgNCw0YfQtdCx0L3Ri9C5LCDQtNC-0LwgMTAsINC-0YQuIDEiLCJhY3RpdmUiOjEsIm9yZ0Z1bGxOYW1lIjoi0J7QsdGJ0LXRgdGC0LLQviDRgSDQvtCz0YDQsNC90LjRh9C10L3QvdC-0Lkg0L7RgtCy0LXRgtGB0YLQstC10L3QvdC-0YHRgtG
M0Y4gXCLQnNC10LQg0K3QutGB0L_RgNC10YHRgVwiIiwidGJJZGVudENvZGUiOiIzOCIsInVzZXJHdWlkIjoiOTQ3M2YyMzUtMDljOS00ZmNhLTgxYWUtYzAyZTkyYjNiNWRiIiwidXNlcklkIjo3NjgwNTgsInRlckJhbmsiOiLQnNC-0YHQutC0LLRgdC60LjQuSDQkdCw0L3QuiDQodCx0LXRgNCx0LDQvdC60LAg0KDQpCIsImF1ZCI6Ijc0NjQzIiwidXNlclJvbGVzIjpbImJhbmtDbGllbnQiXSwib3JnQnVzaW5lc3NTZWdtZW50IjoiMDMiLCJ1c2VyQ3J5cHRvVHlwZSI6IlNNUyIsInVzZXJHcm91cHMiOiLQoNGD0LrQvtCy0L7QtNC40YLQtdC70YwiLCJvcmdPa3BvIjoiMTE0MzkyMDciLCJzYmJvbDMiOnRydWUsIm9yZ09ncm4iOiIxMTI3NzQ2NjU5MDQwIiwib2ZmZXJTbWFydENyZWRpdCI6ZmFsc2UsIm5hbWUiOiLQn9Cw0YDRgtC90LXRgCDQn9Cw0YDRgtC90LXRgCDQn9Cw0YDRgtC90LXRgCIsImlucXVpcnlPcmRlciI6dHJ1ZX0.cIDbvnQrmmx1eVCku7OmyL6aUfEHZ0pD7FhNLU1FvAA0Yu454vDHtfgJSAkSxJiOgceUr2VGg40u8dw4sYk2A

Пример декодированного ответа

{

"sub": "7f5e5e42cc66973f31fe8f65bfc4460a808fc197d955582989a01282fac14c9c",
"orgOktmo": "45000000000",
"orgKpp": "773301001",
"iss": "http://edupirfintech.sberbank.ru:9443",
"OrgName": "ООО \"Мед Экспресс\"",
"orgId": 1123234,
"individualExecutiveAgency": 1,
"userSignatureType": "Единственная подпись",
"summOfferSmartCredit": 0,
"orgActualAddress": "РОССИЙСКАЯ ФЕДЕРАЦИЯ, 121351, г.Москва, ул. Коцюбинского, дом 4, стр. 3, оф. 12Ц",
"HashOrgId": "b34b6a4533862e5167e98785b1d23aa789dac2160b3c7c9cc39221bd33ffc85a",
"isIdentified": true,
"orgPprbId": 1193903502725261800,
"userPosition": "Бухгалтер",
"email": "media++@sbt.ru",
"orgGuid": "111c9c13-64da-4790-9c92-4b05499b6c4b",
"inn": "7733812920",
"orgJuridicalAddress": "РОССИЙСКАЯ ФЕДЕРАЦИЯ, 125367, г.Москва, проезд. Врачебный, дом 10, оф. 1",
"active": 1,
"orgFullName": "Общество с ограниченной ответственностью \"Мед Экспресс\"",
"tbIdentCode": "38",
"userGuid": "9473f235-09c9-4fca-81ae-c02e92b3b5db",
"userId": 768058,
"terBank": "Московский Банк Сбербанка РФ",
"aud": "74643",
"userRoles": [
"bankClient"
],
"orgBusinessSegment": "03",
"userCryptoType": "SMS",
"userGroups": "Руководитель",
"orgOkpo": "11439207",
"sbbol3": true,
"orgOgrn": "1127746659040",
"offerSmartCredit": false,
"name": "Партнер Партнер Партнер",
"inquiryOrder": true

}

Responses

Каждая часть ответа, разделённая точкой, должна декодироваться отдельно.

Согласно спецификации JSON Web Token (JWT) User Info должен быть представлен структурой вида:

• Алгоритм подписи (Определяется по сертификату технологического криптопрофиля Банка, который можно получить запросом /crypto), Header (Заголовок);
• User-info, Payload (Полезная нагрузка);
• Электронная подпись;

При получении ответа сервис должен его декодировать и опционально проверить электронную подпись ответа. Система отправит ответ HTTP 200 OK с типом данных jwt.

User-info необходимо декодировать c помощью алгоритма base64url Encoding (по спецификации JWT). Преобразование BASE64URL, отличается от BASE64. Условно алгоритм можно представить следующим образом: Base64Url(x) := Base64(x).Split(‘=’)[0].Replace(‘+’, ’-’).Replace(‘/’, ’_’). Здесь функция Split(x), разбивает строку на части ([i] означает взятие i–ой части), используя символ разделитель x, функция Replace(x,y) заменяет все вхождения символа x на символ y.

В user-info включаются обязательные системные и дополнительные атрибуты пользователя для сервиса. Обязательные системные атрибуты: sub, iss, aud. Если банку не удаётся предоставить какие-то данные, такой атрибут отсутствует в ответе (не должно быть атрибутов со значением NULL). Проверка электронной подписи (3-я часть ответа) является опциональной и может выполняться сервисом при необходимости проверки неизменности данных user-info.

• Список доступных параметров User-info

Ресурс /v1/change-client-secret

Client_secret можно сменить в Личном кабинете SberBusinessAPI. Срок жизни составляет 40 дней.

Начальное значение client_secret генерируется Банком и передаётся вместе со значением client_id при первичной регистрации. После получения требуется сменить client_secret.

Шаги

1. Получить AccessToken
2. Отправить запрос

Для смены client_secret необходимо отправить POST-запрос (/v1/change-client-secret), в заголовке которого передать авторизационный токен к собственным данным (Access Token), старое значение client_secret.

Code samples

# You can also use wget
curl -X POST https://edupirfintech.sberbank.ru:9443/ic/sso/api/v1/change-client-secret?access_token=string&client_secret=string&new_client_secret=string \
  -H 'Accept: */*'

POST /v1/change-client-secret

Parameters

Example responses

200 Response

{

"clientSecretExpiration":40

}

Responses

Дополнительная информация

2.1.2 Опциональные ресурсы

Ресурс /v1/oauth/revoke

Ресурс позволяет отозвать авторизационный токен в случае его компрометации.

Для отзыва оферты необходимо отправить POST-запрос (/v1/oauth/revoke).

Code samples

# You can also use wget
curl -X POST https://edupirfintech.sberbank.ru:9443/ic/sso/api/v1/oauth/revoke?client_id=string&client_secret=string&token=string \
  -H 'Accept: */*'

POST /v1/oauth/revoke

Parameters

Example responses

500 Response

{
  "ex": "string",
  "url": "string"
}

Responses

2.2 Информация об организации

GET /v1/client-info - Получение данных об организации и счетах пользователя

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

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

Ресурс /v1/client-info

Ресурс позволяет получить расширенную информацию об организации пользователя и её счетах (если пользователь дал согласие на доступ к своим данным см. 2.1 Сервис авторизации-Сбер Бизнес ID), которая может включить в себя следующие данные:

• сокращённое наименование организации;
• полное наименование организации пользователя;
• счета организации пользователя, доступные сервису для запроса выписок и создания платёжных документов;
• признак резидента;
• ОГРН;
• ИНН;
• ОКПО;
• ОКАТО;
• полный адрес организации.

Сокращённую информацию о пользователе можно получить через запрос пользовательских данных (ресурс /v1/oauth/user-info в разделе 2.1 Сервис авторизации-Сбер Бизнес ID.Информация по счетам пользователя передаётся только в том в случае, когда при подписании оферты пользователь в явном виде указал номера счетов, по которым разрешает передачу информации.

Шаги

1. Получить AccessToken
2. Отправить запрос

Для получения информации необходимо отправить GET-запрос (/v1/client-info), в котором передать авторизационный токен к данным пользователя (accessToken).

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

В примере указаны валидные данные, которые можно получить на тестовом стенде. Для этого необходимо использовать ключ доступа Access token 8190f687-c916-453b-9d68-0ce22f4f3f9d-1.

Code samples

# You can also use wget
curl -X GET https://edupirfintech.sberbank.ru:9443/fintech/api/v1/client-info \
  -H 'Accept: */*' \
  -H 'Authorization: string'

GET /v1/client-info

Parameters

Example responses

200 Response

{
  "accounts": [
    {
      "bic": "string",
      "blockedQueuesInfo": [
        {
          "beginDate": "2018-12-31",
          "blockedQueues": 0,
          "cause": "string",
          "endDate": "2018-12-31",
          "initiator": "string",
          "sum": 1.01,
          "taxAuthorityCode": "string"
        }
      ],
      "blockedSumQueuesInfo": [
        {
          "beginDate": "2018-12-31",
          "blockedQueues": 0,
          "cause": "string",
          "endDate": "2018-12-31",
          "initiator": "string",
          "sum": 1.01,
          "taxAuthorityCode": "string"
        }
      ],
      "blockedSums": [
        {
          "beginDate": "2018-12-31",
          "blockedQueues": 0,
          "cause": "string",
          "endDate": "2018-12-31",
          "initiator": "string",
          "sum": 1.01,
          "taxAuthorityCode": "string"
        }
      ],
      "business": false,
      "businessNewType": false,
      "cdiAcptDocQnt": 0,
      "cdiAcptDocSum": 0,
      "cdiCart2DocQnt": 0,
      "cdiCart2DocSum": 0,
      "cdiPermDocQnt": 0,
      "cdiPermDocSum": 0,
      "closeDate": "2019-08-24T14:15:22Z",
      "comment": "string",
      "creditBlocked": false,
      "creditBlockedBeginDate": "2019-08-24T14:15:22Z",
      "creditBlockedCause": "string",
      "creditBlockedEndDate": "2019-08-24T14:15:22Z",
      "creditBlockedInitiator": "string",
      "creditBlockedTaxAuthorityCode": "string",
      "currencyCode": "string",
      "dbo": false,
      "debitBlocked": false,
      "debitBlockedBeginDate": "2019-08-24T14:15:22Z",
      "debitBlockedCause": "string",
      "debitBlockedEndDate": "2019-08-24T14:15:22Z",
      "debitBlockedInitiator": "string",
      "debitBlockedTaxAuthorityCode": "string",
      "minBalance": 0,
      "mode": "STANDART",
      "name": "string",
      "notDelay": false,
      "number": "string",
      "openDate": "2019-08-24T14:15:22Z",
      "overdraft": 0,
      "passive": false,
      "state": "OPEN",
      "type": "assuranceRegistration",
      "urgent": false
    }
  ],
  "addresses": [
    {
      "area": "string",
      "building": "string",
      "city": "string",
      "comment": "string",
      "country": "string",
      "flat": "string",
      "fullAddress": "string",
      "house": "string",
      "region": "string",
      "settlement": "string",
      "settlementType": "string",
      "street": "string",
      "type": "string",
      "zip": "string"
    }
  ],
  "branch": {
    "address": "г.Москва, Кутузовский проспект, 34",
    "code": "138592",
    "name": "Доп офис 1654"
  },
  "cardNum": "string",
  "dboContracts": [
    {
      "date": "2018-12-31",
      "financeBlock": true,
      "number": "14/2/000001"
    }
  ],
  "fullName": "string",
  "inn": "string",
  "kpps": [
    "string"
  ],
  "offerSmartCredit": false,
  "ogrn": "string",
  "okato": "string",
  "okpo": "string",
  "orgBusinessSegment": "string",
  "orgBusinessSegmentName": "string",
  "orgCrmId": "string",
  "orgForm": "string",
  "orgGuid": "string",
  "orgId": 0,
  "orgIndustryInfo": {
    "code": 0,
    "name": "string"
  },
  "orgKindActivityInfo": {
    "code": 0,
    "name": "string"
  },
  "orgPprbId": 0,
  "orgRegDateINN": "string",
  "orgRegDateOGRN": "string",
  "resident": false,
  "shortName": "string",
  "summOfferSmartCredit": 0,
  "territorialBank": "string"
}

Responses

2.3 Платежное поручение

POST /v1/payments - Платежное поручение по свободным реквизитам

GET /v1/payments/{externalId}/state - Получение статуса документа

GET /v1/payments/{externalId} - Получение платежного поручения

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

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

Ресурс /v1/payments

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

Шаги

1. Получить AccessToken
2. Сформировать ЭП
3. Отправить запрос
4. Получить статус
5. Получить документ

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

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

Code samples

# You can also use wget
curl -X POST https://edupirfintech.sberbank.ru:9443/fintech/api/v1/payments \
  -H 'Content-Type: application/json' \
  -H 'Accept: */*' \
  -H 'Authorization: string'

POST /v1/payments

Body parameter

{
  "amount": 1.01,
  "crucialFieldsHash": "string",
  "date": "2018-12-31",
  "deliveryKind": "электронно",
  "departmentalInfo": {
    "uip": "0",
    "drawerStatus101": "01",
    "kbk": "18210102010011000110",
    "oktmo": "01701000",
    "reasonCode106": "ТП",
    "taxPeriod107": "ГД.00.2018",
    "docNumber108": "123",
    "docDate109": "0",
    "paymentKind110": "1"
  },
  "digestSignatures": [
    {
      "base64Encoded": "HlaeIHXXEcGT1bFxo1NlpAzpr+kJ2IQrcxVdvDTep6xjsmD1FDb+6NIyLT+/T24S0mPfVCU75sieOMt71TBS7w==",
      "certificateUuid": "22a6dd81-103a-4d3a-8e9b-0ba4b527f5f6"
    }
  ],
  "externalId": "22a6dd81-103a-4d3a-8e9b-0ba4b527f5f6",
  "incomeTypeCode": "2",
  "number": "1",
  "operationCode": "01",
  "payeeAccount": "40802810600000200000",
  "payeeBankBic": "044525225",
  "payeeBankCorrAccount": "30101810400000000225",
  "payeeInn": "7707083893",
  "payeeKpp": "222201001",
  "payeeName": "Общество с ограниченной ответственностью \"Клиент\"",
  "payerAccount": "40802810600000200000",
  "payerBankBic": "044525225",
  "payerBankCorrAccount": "30101810400000000225",
  "payerInn": "7707083893",
  "payerKpp": "222201001",
  "payerName": "Общество с ограниченной ответственностью \"Клиент\"",
  "priority": "5",
  "purpose": "Оплата заказа №123. НДС нет.",
  "urgencyCode": "INTERNAL",
  "vat": {
    "amount": 1.01,
    "rate": "10",
    "type": "NO_VAT"
  },
  "voCode": "61150"
}

Parameters

Example responses

201 Response

{
  "amount": 1.01,
  "crucialFieldsHash": "string",
  "date": "2018-12-31",
  "deliveryKind": "электронно",
  "departmentalInfo": {
    "uip": "0",
    "drawerStatus101": "01",
    "kbk": "18210102010011000110",
    "oktmo": "01701000",
    "reasonCode106": "ТП",
    "taxPeriod107": "ГД.00.2018",
    "docNumber108": "123",
    "docDate109": "0",
    "paymentKind110": "1"
  },
  "digestSignatures": [
    {
      "base64Encoded": "HlaeIHXXEcGT1bFxo1NlpAzpr+kJ2IQrcxVdvDTep6xjsmD1FDb+6NIyLT+/T24S0mPfVCU75sieOMt71TBS7w==",
      "certificateUuid": "22a6dd81-103a-4d3a-8e9b-0ba4b527f5f6"
    }
  ],
  "externalId": "22a6dd81-103a-4d3a-8e9b-0ba4b527f5f6",
  "incomeTypeCode": "2",
  "number": "1",
  "operationCode": "01",
  "payeeAccount": "40802810600000200000",
  "payeeBankBic": "044525225",
  "payeeBankCorrAccount": "30101810400000000225",
  "payeeInn": "7707083893",
  "payeeKpp": "222201001",
  "payeeName": "Общество с ограниченной ответственностью \"Клиент\"",
  "payerAccount": "40802810600000200000",
  "payerBankBic": "044525225",
  "payerBankCorrAccount": "30101810400000000225",
  "payerInn": "7707083893",
  "payerKpp": "222201001",
  "payerName": "Общество с ограниченной ответственностью \"Клиент\"",
  "priority": "5",
  "purpose": "Оплата заказа №123. НДС нет.",
  "urgencyCode": "INTERNAL",
  "vat": {
    "amount": 1.01,
    "rate": "10",
    "type": "NO_VAT"
  },
  "voCode": "61150"
}

Responses

• Если требуется проверить неизменность реквизитов получателя платежа, до получения выписки с информацией о проведенном документе, необходимо сравнить хэш реквизитов получателя(crucialFieldsHash), полученные при создании черновика документа, с crucialFieldsHash полученным при запросе статуса документа. Для вычисления значения хэша ключевых полей формируется строка из реквизитов, соединённых между собой: БИК банка получателя, счёт получателя платежа, сумма платежа, (разделитель-точка).
• Для корректной работы необходимо передавать параметры в следующем сочетании.

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

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

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

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

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

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

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

Формирование электронной подписи (ГОСТ 2012)

Ресурс /v1/payments/{externalId}/state

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

Шаги

1. Получить AccessToken
2. Отправить запрос

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

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

Code samples

# You can also use wget
curl -X GET https://edupirfintech.sberbank.ru:9443/fintech/api/v1/payments/{externalId}/state \
  -H 'Accept: */*' \
  -H 'Authorization: string'

GET /v1/payments/{externalId}/state

Parameters

Example responses

200 Response

{
  "bankComment": "string",
  "bankStatus": "string",
  "channelInfo": "string",
  "crucialFieldsHash": "string"
}

Responses

Ресурс /v1/payments/{externalId}

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

Шаги

1. Получить AccessToken
2. Отправить запрос

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

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

Code samples

# You can also use wget
curl -X GET https://edupirfintech.sberbank.ru:9443/fintech/api/v1/payments/{externalId} \
  -H 'Accept: */*' \
  -H 'Authorization: string'

GET /v1/payments/{externalId}

Parameters

Example responses

200 Response

{
  "amount": 1.01,
  "bankComment": "string",
  "bankStatus": "string",
  "crucialFieldsHash": "string",
  "date": "2018-12-31",
  "deliveryKind": "электронно",
  "departmentalInfo": {
    "uip": "0",
    "drawerStatus101": "01",
    "kbk": "18210102010011000110",
    "oktmo": "01701000",
    "reasonCode106": "ТП",
    "taxPeriod107": "ГД.00.2018",
    "docNumber108": "123",
    "docDate109": "0",
    "paymentKind110": "1"
  },
  "digestSignatures": [
    {
      "base64Encoded": "HlaeIHXXEcGT1bFxo1NlpAzpr+kJ2IQrcxVdvDTep6xjsmD1FDb+6NIyLT+/T24S0mPfVCU75sieOMt71TBS7w==",
      "certificateUuid": "22a6dd81-103a-4d3a-8e9b-0ba4b527f5f6"
    }
  ],
  "externalId": "22a6dd81-103a-4d3a-8e9b-0ba4b527f5f6",
  "incomeTypeCode": "2",
  "number": "1",
  "operationCode": "01",
  "payeeAccount": "40802810600000200000",
  "payeeBankBic": "044525225",
  "payeeBankCorrAccount": "30101810400000000225",
  "payeeInn": "7707083893",
  "payeeKpp": "222201001",
  "payeeName": "Общество с ограниченной ответственностью \"Клиент\"",
  "payerAccount": "40802810600000200000",
  "payerBankBic": "044525225",
  "payerBankCorrAccount": "30101810400000000225",
  "payerInn": "7707083893",
  "payerKpp": "222201001",
  "payerName": "Общество с ограниченной ответственностью \"Клиент\"",
  "priority": "5",
  "purpose": "Оплата заказа №123. НДС нет.",
  "urgencyCode": "INTERNAL",
  "vat": {
    "amount": 1.01,
    "rate": "10",
    "type": "NO_VAT"
  },
  "voCode": "61150"
}

Responses

Дополнительная информация

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

1. Если блок vat не указан, то по умолчанию будут присвоены и придут в ответе на запрос следующие значения :
   "vat": {
   "type": "NO_VAT",
   "rate": "0",
   "amount": "0.00"
   }
   В поле "Назначение платежа" необходимо обязательно отправлять "НДС не облагается".
2. При выбранном "type":"INCLUDED" (НДС включен в сумму платежа) атрибут "amount" указывать не нужно.
   Если же атрибут "amount" указывается в запросе, то должен иметь значение 0 во избежание ошибок. Атрибут "rate" должен принимать только значения 10, 20.
   В поле "Назначение платежа" необходимо обязательно указать посчитанное значение суммы с учетом НДС.
   Пример ПРАВИЛЬНОГО заполнения:
   НДС10%_-_100.63 рублей (" _ " - нижнее подчеркивание является признаком пробела, символ проставлять не нужно).
   Если процентное значение не указано, то дефис перед суммой указывать не нужно: НДС_100.63 рублей.
3. При выбранном "type":"MANUAL" (Ручной ввод НДС) атрибут "amount" указывать не обязательно, но в этом случае по умолчанию сумма НДС примет значение 0 рублей. Если же атрибут "amount" указывается в запросе,
   то в нем нужно указать желаемое значение НДС, соответствующее формату.
   Если процентное значение не указано, то дефис перед суммой указывать не нужно: НДС_100.63 рублей.

Content-Type может содержать одно из двух значений:

1) application/json – запрос без подписи

2) application/jose – запрос, подписанный транспортной подписью

Если Content-Type имеет значение application/jose, то запрос должен содержать данные (реквизитный состав платежного документа) в виде компактной сериализации RFC 7515: JSON Web Signature (JWS).

JWS состоит из:

1. Заголовка (Header)
2. JSON-документа с реквизитным составом платежного поручения (Payload)
3. Подписи запроса (Signature)

Формирование компактной сериализации JWS

JWS формируется из трех составляющих:

Base64Url(Header) || ’.’ || Base64Url(Payload) || ’.’ || Base64Url(Signature)

Signature - это подпись данных приватной частью ключевой пары клиента (используется приватный ключ парный сертификату клиента с UUID, указанному в Заголовке (Header) в параметре kid). Подпись вычисляется по алгоритму указанному в Заголовке (Header) в параметре alg, в данном случае gost34.10-2012, и вычисляется от исходных данных: Base64Url(Header) || ‘.’ || Base64Url(Payload).

Формирование исходных данных для вычисления подписи описано в спецификации RFC 7515: JSON Web Signature (JWS).

Следует отметить, что при кодировании JWS используется преобразование Base64Url, отличающееся от Base64 преобразования. Условно это преобразование можно представить следующим образом:

Base64Url(x) := Base64(x).Split(‘=’)[0].Replace(‘+’, ’-’).Replace(‘/’, ’_’)

здесь функция Split(x), разбивает строку на части ([i] означает взятие i–ой части), используя символ разделитель x, функция Replace(x,y) заменяет все вхождения символа x на символ y.

Преобразование BASE64URL, отличается от BASE64 преобразования:

• Используются другие вспомогательные символы Base 64 Encoding with URL and Filename Safe Alphabet.

• В BASE64URL не используется (опускается) padding, т.е. не добавляются знаки ‘=’ на конце закодированного содержимого Padding of Encoded Data

В ответе на запрос сервер возвращает JSON-документ, который содержит реквизитный состав подготовленного черновика рублевого платежного поручения в статусе Создан.

2.4 Криптографические ресурсы

GET /v1/crypto-Получение криптографической информации

POST /v1/crypto/cert-requests-Создание запроса на новый сертификат

GET /v1/crypto/cert-requests/{externalId}/state-Получение статуса

POST /v1/crypto/cert-requests/{externalId}/activate-Активация сертификата

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

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

Ресурсы предназначены для получения информации и выпуска сертификатов для token-пользователей. Для перехода на token-криптопрофиль необходимо заполнить корректирующее заявление и обратиться в отделение.

Ресурс /v1/crypto

Ресурс позволяет получить информацию по крипто-профилю и сертификатам пользователя, сертификатам удостоверяющих центров, и сертификату технологического криптопрофиля банка. Полученную информацию возможно использовать в криптографических операциях (в операциях с сертификатами и операциях с электронной подписью).

Шаги

1. Получить AccessToken
2. Отправить запрос

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

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

Code samples

# You can also use wget
curl -X GET https://edupirfintech.sberbank.ru:9443/fintech/api/v1/crypto \
  -H 'Accept: */*' \
  -H 'Authorization: string'

GET /v1/crypto

Parameters

Example responses

200 Response

{
  "certBank": "string",
  "certBankUuid": "string",
  "certCenterCode": "А000",
  "certCenterNum": "02",
  "certsCA": [
    "string"
  ],
  "cryptoProfileInfos": [
    {
      "alias": "Profile alias",
      "certificateInfos": [
        {
          "active": false,
          "cert": "string",
          "issuer": "ISSUER",
          "serialNumber": "SN:000F18",
          "uuid": "22a6dd81-103a-4d3a-8e9b-0ba4b527f5f6"
        }
      ],
      "typeName": "Инфокрипт"
    }
  ]
}

Responses

Ресурс /v1/crypto/cert-requests

Ресурс позволяет создавать запросы на выпуск нового сертификата.

Для этого необходимо:

1. Выполнить OAuth-авторизацию, в результате которой получить авторизационный токен.

2. Обратиться к ресурсу /v1/crypto и получить код удостоверяющего центра (КУЦ) - certCenterCode.

3. На основании полученного КУЦ необходимо сгенерировать уникальный тег bicryptId, состоящий из: КУЦ +порядковый номер выпущенного организацией сертификат(нумерация 00..ZZ)+символ «s». Параметр bicryptId должен содержать не менее 9-ти символов, при необходимости дополнить слева нулями порядковый номер сертификата, после чего добавляется фамилия и инициалы владельца сертификата.

Шаги

1. Получить AccessToken
2. Отправить запрос
3. Получить статус
4. Активировать сертификат

Для создания документа на выпуск нового сертификата ЭП необходимо отправить POST-запрос (/v1/crypto/cert-requests), в котором передать авторизационный токен (Access Token) и данные по выпускаемому сертификату. Авторизационный токен передается в параметре Authorization заголовка запроса.

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

В примере параметр cms заполнен для СКЗИ-Инфокрипт VPN-KEY-TLS. Для альтернативной СКЗИ необходимо заполнять следующим образом: "cms": "----- BEGIN CERTIFICATE REQUEST -----\n ... MIIIj ... \n----- END CERTIFICATE REQUEST -----".

Code samples

# You can also use wget
curl -X POST https://edupirfintech.sberbank.ru:9443/fintech/api/v1/crypto/cert-requests \
  -H 'Content-Type: application/json' \
  -H 'Accept: */*' \
  -H 'Authorization: string'

POST /v1/crypto/cert-requests

Body parameter

{
  "bankComment": "string",
  "bankStatus": "string",
  "email": "address@email.ru",
  "externalId": "22a6dd81-103a-4d3a-8e9b-0ba4b527f5f6",
  "number": "1",
  "orgName": "ООО \"Организация\"",
  "pkcs10": {
    "bicryptId": "A001NVA3",
    "cms": "-----BEGIN CMS-----\n ... MIIIj ... \n-----END CMS-----"
  },
  "userName": "Иванов Иван Иванович",
  "userPosition": "Операционист"
}

Parameters

Example responses

201 Response

{
  "bankComment": "string",
  "bankStatus": "string",
  "email": "address@email.ru",
  "externalId": "22a6dd81-103a-4d3a-8e9b-0ba4b527f5f6",
  "number": "1",
  "orgName": "ООО \"Организация\"",
  "pkcs10": {
    "bicryptId": "A001NVA3",
    "cms": "-----BEGIN CMS-----\n ... MIIIj ... \n-----END CMS-----"
  },
  "userName": "Иванов Иван Иванович",
  "userPosition": "Операционист"
}

Responses

Ресурс /v1/crypto/cert-requests/{externalId}/state

Ресурс позволяет получить информацию по статусу запроса на новый сертификат. Полученную информацию возможно использовать для контроля и анализа статуса запроса на новый сертификат.

Шаги

1. Получить AccessToken
2. Отправить запрос

Для получения информации по статусу необходимо отправить GET-запрос (/v1/crypto/cert-requests/{externalId}/state), в котором необходимо передать авторизационный токен (Access Token) и идентификатор запроса на новый сертификат (externalId). Авторизационный токен передается в параметре Authorization заголовка запроса.

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

Code samples

# You can also use wget
curl -X GET https://edupirfintech.sberbank.ru:9443/fintech/api/v1/crypto/cert-requests/{externalId}/state \
  -H 'Accept: */*' \
  -H 'Authorization: string'

GET /v1/crypto/cert-requests/{externalId}/state

Parameters

Example responses

200 Response

{
  "bankComment": "string",
  "bankStatus": "string",
  "channelInfo": "string"
}

Responses

Ресурс /v1/crypto/cert-requests/{externalId}/activate

Ресурс позволяет создавать запросы на активацию выпущенного сертификата, для дальнейшей возможности подписывать документы и запросы.

Шаги

1. Получить AccessToken
2. Отправить запрос

Для активации сертификата ЭП необходимо отправить POST-запрос (/v1/crypto/cert-requests/{externalId}/activate), в котором передать авторизационный токен к данным пользователя (Access Token) и идентификатор документа externalId из запроса cert-requests. авторизационный токен передается в параметре Authorization заголовка запроса.

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

Code samples

# You can also use wget
curl -X POST https://edupirfintech.sberbank.ru:9443/fintech/api/v1/crypto/cert-requests/{externalId}/activate \
  -H 'Accept: */*' \
  -H 'Authorization: string'

POST /v1/crypto/cert-requests/{externalId}/activate

Parameters

Example responses

400 Response

{
  "referenceId": "string",
  "message": "string",
  "checks": [
    {
      "level": "ERROR",
      "message": "string",
      "fields": [
        "string"
      ]
    }
  ],
  "fieldNames": "[\"externalId\", \"paymentNumber\"]"
}

Responses

2.5 Получение операций по счету

GET /v1/statement/transactions - Получение выписки

GET /v1/statement/transactions/{id} - Получение выписки по операции

GET /v1/statement/summary - Суммарная информация об остатках и оборотах за период

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

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

Максимальное количество операций, возвращаемых на одной странице выписки, равно 100. Запросы выписки подсчитываются исходя из количества опрашиваемых счетов и количества заданных обновлений выписки.

Ресурс /v1/statement/transactions

Сервис позволяет получить выписку по счёту собственной/дочерней организации за выбранную дату.

Шаги

1. Получить AccessToken
2. Отправить запрос

Для получения выписки по счету пользователя необходимо отправить GET-запрос (/v1/statement/transactions), в котором передать авторизационный токен к данным собственной/дочерней организации (Access Token), номер счёта (accountNumber), дату выписки (Date) и номер запрашиваемой страницы (Page=1). Авторизационный токен передается в параметре Authorization заголовка запроса.

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

Code samples

# You can also use wget
curl -X GET https://edupirfintech.sberbank.ru:9443/fintech/api/v1/statement/transactions?accountNumber=string&statementDate=2019-08-24T14%3A15%3A22Z&page=1 \
  -H 'Accept: */*' \
  -H 'Authorization: string'

GET /v1/statement/transactions

Parameters

Example responses

200 Response

{
  "_links": [
    {
      "href": "?accountNumber=40702810500006103990&statementDate=2018-03-15&page=3",
      "rel": "next"
    }
  ],
  "transactions": [
    {
      "amount": {
        "amount": 1.01,
        "currencyName": "USD"
      },
      "amountRub": {
        "amount": 1.01,
        "currencyName": "USD"
      },
      "correspondingAccount": "30101810400000000225",
      "curTransfer": {
        "bankOperationCode": "CRED",
        "beneficiaryBankAccount": "LOYDGB21321",
        "beneficiaryBankName": "BANCO DE SABADELL, S.A.                                               1, PLAZA CATALUNYA                 SABADELL ES                        ",
        "beneficiaryBankOption": "D",
        "beneficiaryCustomerAccount": "/FI8850000120266333",
        "beneficiaryCustomerName": "SUN-KING KNITTED BELT PRODUCT LTD. N.39,DONGMEN ROAD                  FUQING CITY,FUJIAN,CHINA",
        "detailsOfCharges": "OUR",
        "exchangeRate": "67,74",
        "instructedAmount": "USD70,",
        "instructionCode": "URGP",
        "intermediaryBankAccount": "COBADEFF",
        "intermediaryBankName": "BANCA POPOLARE DELL'ETRURIA E DEL LAZIO                               (SEDE DI MILANO)                   MILANO                             ",
        "intermediaryBankOption": "D",
        "messageDestinator": "LAPBLV2X",
        "messageIdentifier": "S000013082900014",
        "messageOriginator": "SABRRU2P",
        "messageReceiveTime": "15-05-27 14:01",
        "messageSendTime": "15-05-27 13:21",
        "messageType": "103",
        "orderingCustomerAccount": "/08251801040004813",
        "orderingCustomerName": "DONGNING JIXIN INDUSTRY AND TRADE(GROUP) CO.,LTD.                     NO.98 FANRONG STREET DONGNING      COUNTY",
        "orderingCustomerOption": "K",
        "orderingInstitutionAccount": "ABOCBNBJ080",
        "orderingInstitutionName": "AGRICULTURAL BANK OF CHINA, THE(HEILONGJIANG BRANCH)                  HARBIN",
        "orderingInstitutionOption": "A",
        "payeeAccount": "40802810600000200000",
        "payeeBankBic": "044525225",
        "payeeBankName": "ПАО СБЕРБАНК",
        "payeeInn": "7707083893",
        "payeeName": "Общество с ограниченной ответственностью \"Клиент\"",
        "payerAccount": "40802810600000200000",
        "payerBankBic": "044525225",
        "payerBankName": "ПАО СБЕРБАНК",
        "payerInn": "7707083893",
        "payerName": "Общество с ограниченной ответственностью \"Клиент\"",
        "receiverCharges": "EUR13,19",
        "receiverCorrespondentAccount": "CHASDEFX",
        "receiverCorrespondentName": "THE BANK OF NEW YORK MELLON        NEW YORK,NY                        ",
        "receiverCorrespondentOption": "D",
        "regulatoryReporting": "/N10/NS/N4/12345678901234567890/N5/12345678901/N6/TP/N7/МS.05.2003/N8/123456789012345/N9/12.05.2003",
        "remittanceInformation": "CONTRACT NO SE/00233 DATED 06.03.2012, INVOICE NO 4783",
        "senderCharges": "USD7,03",
        "senderCorrespondentAccount": "BOTKGB2L",
        "senderCorrespondentName": "CITIBANK N.A.                      NEW YORK,NY                        ",
        "senderCorrespondentOption": "D",
        "senderToReceiverInformation": "/NZP/OT 15.03.2009. NDS NE OBLAGAETSYA",
        "transactionReferenceNumber": "S380609091426498",
        "transactionRelatedReference": "S380609091426498",
        "transactionTypeCode": "N1",
        "urgent": "NORMAL",
        "valueDateCurrencyInterbankSettledAmount": "130824EUR5447,34"
      },
      "direction": "CREDIT",
      "documentDate": "2018-12-31",
      "filial": "ОСБ 3",
      "number": "4",
      "operationCode": "01",
      "operationDate": "2018-12-31T23:59:59",
      "paymentPurpose": "Оплата заказа №123. НДС нет.",
      "priority": "5",
      "revaln": "ПК",
      "rurTransfer": {
        "cartInfo": {
          "documentCode": "string",
          "documentContent": "string",
          "documentDate": "2019-08-24T14:15:22Z",
          "documentNumber": "string",
          "paymentNumber": "string",
          "restAmount": 0
        },
        "deliveryKind": "электронно",
        "departmentalInfo": {
          "uip": "0",
          "drawerStatus101": "01",
          "kbk": "18210102010011000110",
          "oktmo": "01701000",
          "reasonCode106": "ТП",
          "taxPeriod107": "ГД.00.2018",
          "docNumber108": "123",
          "docDate109": "0",
          "paymentKind110": "1"
        },
        "payeeAccount": "40802810600000200000",
        "payeeBankBic": "044525225",
        "payeeBankCorrAccount": "30101810400000000225",
        "payeeBankName": "ПАО СБЕРБАНК",
        "payeeInn": "7707083893",
        "payeeKpp": "222201001",
        "payeeName": "Общество с ограниченной ответственностью \"Клиент\"",
        "payerAccount": "40802810600000200000",
        "payerBankBic": "044525225",
        "payerBankCorrAccount": "30101810400000000225",
        "payerBankName": "ПАО СБЕРБАНК",
        "payerInn": "7707083893",
        "payerKpp": "222201001",
        "payerName": "Общество с ограниченной ответственностью \"Клиент\"",
        "payingCondition": "string",
        "purposeCode": "1",
        "receiptDate": "2018-12-31",
        "valueDate": "2018-12-31"
      },
      "swiftTransfer": {
        "bankOperationCode": "CRED",
        "beneficiaryBankAccount": "LOYDGB21321",
        "beneficiaryBankName": "BANCO DE SABADELL, S.A.                                               1, PLAZA CATALUNYA                 SABADELL ES                        ",
        "beneficiaryBankOption": "D",
        "beneficiaryCustomerAccount": "/FI8850000120266333",
        "beneficiaryCustomerName": "SUN-KING KNITTED BELT PRODUCT LTD. N.39,DONGMEN ROAD                  FUQING CITY,FUJIAN,CHINA",
        "detailsOfCharges": "OUR",
        "exchangeRate": "67,74",
        "instructedAmount": "USD70,",
        "instructionCode": "URGP",
        "intermediaryBankAccount": "COBADEFF",
        "intermediaryBankName": "BANCA POPOLARE DELL'ETRURIA E DEL LAZIO                               (SEDE DI MILANO)                   MILANO                             ",
        "intermediaryBankOption": "D",
        "messageDestinator": "LAPBLV2X",
        "messageIdentifier": "S000013082900014",
        "messageOriginator": "SABRRU2P",
        "messageReceiveTime": "15-05-27 14:01",
        "messageSendTime": "15-05-27 13:21",
        "messageType": "103",
        "orderingCustomerAccount": "/08251801040004813",
        "orderingCustomerName": "DONGNING JIXIN INDUSTRY AND TRADE(GROUP) CO.,LTD.                     NO.98 FANRONG STREET DONGNING      COUNTY",
        "orderingCustomerOption": "K",
        "orderingInstitutionAccount": "ABOCBNBJ080",
        "orderingInstitutionName": "AGRICULTURAL BANK OF CHINA, THE(HEILONGJIANG BRANCH)                  HARBIN",
        "orderingInstitutionOption": "A",
        "receiverCharges": "EUR13,19",
        "receiverCorrespondentAccount": "CHASDEFX",
        "receiverCorrespondentName": "THE BANK OF NEW YORK MELLON        NEW YORK,NY                        ",
        "receiverCorrespondentOption": "D",
        "regulatoryReporting": "/N10/NS/N4/12345678901234567890/N5/12345678901/N6/TP/N7/МS.05.2003/N8/123456789012345/N9/12.05.2003",
        "remittanceInformation": "CONTRACT NO SE/00233 DATED 06.03.2012, INVOICE NO 4783",
        "senderCharges": "USD7,03",
        "senderCorrespondentAccount": "BOTKGB2L",
        "senderCorrespondentName": "CITIBANK N.A.                      NEW YORK,NY                        ",
        "senderCorrespondentOption": "D",
        "senderToReceiverInformation": "/NZP/OT 15.03.2009. NDS NE OBLAGAETSYA",
        "transactionReferenceNumber": "S380609091426498",
        "transactionRelatedReference": "S380609091426498",
        "transactionTypeCode": "N1",
        "urgent": "NORMAL",
        "valueDateCurrencyInterbankSettledAmount": "130824EUR5447,34"
      },
      "transactionId": 11111,
      "uuid": "55daccdf-de87-3879-976c-8b8415c8caf9"
    }
  ]
}

Responses

Примечание: Выписка может приходить как по рублевым, так и по валютным счетам. Для рублёвого счёта не заполняется параметр curFormat, данные передаются в обычном формате. Параметр curFormat влияет на формат данных для валютных счетов и принимает следующие значения: curTransfer, swiftTransfer. Если curFormat = swiftTransfer, то данные по счету будут переданы в формате МТ103. Если curFormat = curTransfer, то данные по валютному счёту будут переданы в том же формате, что и данные по рублёвому счету. По умолчанию для валютных счетов curFormat = swiftTransfer.

Необходимо запрашивать постранично данные операции, начиная с первой страницы и опрашивать следующую до того момента, как в полученном ответе перестанет приходить href c признаком "rel": "next", что будет означать, что следующей страницы нет. На запрос первой страницы в ответе вернётся список операций (Если существуют операции за выбранную дату и счёт) и контейнер links с параметром (href) на следующую страницу и признаком "rel": "next". На запрос второй страницы в ответе вернётся список операций и контейнер links с параметром (href) на следующую и предыдущую страницы и признаками: "rel": "prev", "rel": "next". Получение последующих страниц производится по аналогии. Дата запрашиваемой выписки не может быть ранее 1.01.2017. В получаемой выписке внутри каждой операции сначала отображается информация по плательщику, а затем информация по получателю.

В примере указаны валидные данные, которые можно получить на тестовом стенде. Для этого необходимо использовать ключ доступа Access token 9e1efef1-e584-4c6f-9da3-34a04d203308-1.

Ресурс /v1/statement/transactions/{id}

Сервис позволяет Партнеру получить выписку по операции, предварительно получив вебхук с идентификатором операции.

Шаги

1. Получить AccessToken
2. Отправить запрос

Для получения выписки по операции необходимо отправить GET-запрос (/v1/statement/transactions/{id}), в котором передать авторизационный токен к данным собственной организации (Access Token) и идентификатор операций. Авторизационный токен передается в параметре Authorization заголовка запроса.

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

В примере указаны валидные данные, которые можно получить на тестовом стенде. Для этого необходимо использовать ключ доступа Access token 8190f687-c916-453b-9d68-0ce22f4f3f9d-1.

Code samples

# You can also use wget
curl -X GET https://edupirfintech.sberbank.ru:9443/fintech/api/v1/statement/transactions/{id} \
  -H 'Accept: */*' \
  -H 'Authorization: string'

GET /v1/statement/transactions/{id}

Parameters

Example responses

200 Response

{
  "amount": {
    "amount": 1.01,
    "currencyName": "USD"
  },
  "amountRub": {
    "amount": 1.01,
    "currencyName": "USD"
  },
  "correspondingAccount": "30101810400000000225",
  "curTransfer": {
    "bankOperationCode": "CRED",
    "beneficiaryBankAccount": "LOYDGB21321",
    "beneficiaryBankName": "BANCO DE SABADELL, S.A.                                               1, PLAZA CATALUNYA                 SABADELL ES                        ",
    "beneficiaryBankOption": "D",
    "beneficiaryCustomerAccount": "/FI8850000120266333",
    "beneficiaryCustomerName": "SUN-KING KNITTED BELT PRODUCT LTD. N.39,DONGMEN ROAD                  FUQING CITY,FUJIAN,CHINA",
    "detailsOfCharges": "OUR",
    "exchangeRate": "67,74",
    "instructedAmount": "USD70,",
    "instructionCode": "URGP",
    "intermediaryBankAccount": "COBADEFF",
    "intermediaryBankName": "BANCA POPOLARE DELL'ETRURIA E DEL LAZIO                               (SEDE DI MILANO)                   MILANO                             ",
    "intermediaryBankOption": "D",
    "messageDestinator": "LAPBLV2X",
    "messageIdentifier": "S000013082900014",
    "messageOriginator": "SABRRU2P",
    "messageReceiveTime": "15-05-27 14:01",
    "messageSendTime": "15-05-27 13:21",
    "messageType": "103",
    "orderingCustomerAccount": "/08251801040004813",
    "orderingCustomerName": "DONGNING JIXIN INDUSTRY AND TRADE(GROUP) CO.,LTD.                     NO.98 FANRONG STREET DONGNING      COUNTY",
    "orderingCustomerOption": "K",
    "orderingInstitutionAccount": "ABOCBNBJ080",
    "orderingInstitutionName": "AGRICULTURAL BANK OF CHINA, THE(HEILONGJIANG BRANCH)                  HARBIN",
    "orderingInstitutionOption": "A",
    "payeeAccount": "40802810600000200000",
    "payeeBankBic": "044525225",
    "payeeBankName": "ПАО СБЕРБАНК",
    "payeeInn": "7707083893",
    "payeeName": "Общество с ограниченной ответственностью \"Клиент\"",
    "payerAccount": "40802810600000200000",
    "payerBankBic": "044525225",
    "payerBankName": "ПАО СБЕРБАНК",
    "payerInn": "7707083893",
    "payerName": "Общество с ограниченной ответственностью \"Клиент\"",
    "receiverCharges": "EUR13,19",
    "receiverCorrespondentAccount": "CHASDEFX",
    "receiverCorrespondentName": "THE BANK OF NEW YORK MELLON        NEW YORK,NY                        ",
    "receiverCorrespondentOption": "D",
    "regulatoryReporting": "/N10/NS/N4/12345678901234567890/N5/12345678901/N6/TP/N7/МS.05.2003/N8/123456789012345/N9/12.05.2003",
    "remittanceInformation": "CONTRACT NO SE/00233 DATED 06.03.2012, INVOICE NO 4783",
    "senderCharges": "USD7,03",
    "senderCorrespondentAccount": "BOTKGB2L",
    "senderCorrespondentName": "CITIBANK N.A.                      NEW YORK,NY                        ",
    "senderCorrespondentOption": "D",
    "senderToReceiverInformation": "/NZP/OT 15.03.2009. NDS NE OBLAGAETSYA",
    "transactionReferenceNumber": "S380609091426498",
    "transactionRelatedReference": "S380609091426498",
    "transactionTypeCode": "N1",
    "urgent": "NORMAL",
    "valueDateCurrencyInterbankSettledAmount": "130824EUR5447,34"
  },
  "direction": "CREDIT",
  "documentDate": "2018-12-31",
  "filial": "ОСБ 3",
  "number": "4",
  "operationCode": "01",
  "operationDate": "2018-12-31T23:59:59",
  "paymentPurpose": "Оплата заказа №123. НДС нет.",
  "priority": "5",
  "revaln": "ПК",
  "rurTransfer": {
    "cartInfo": {
      "documentCode": "string",
      "documentContent": "string",
      "documentDate": "2019-08-24T14:15:22Z",
      "documentNumber": "string",
      "paymentNumber": "string",
      "restAmount": 0
    },
    "deliveryKind": "электронно",
    "departmentalInfo": {
      "uip": "0",
      "drawerStatus101": "01",
      "kbk": "18210102010011000110",
      "oktmo": "01701000",
      "reasonCode106": "ТП",
      "taxPeriod107": "ГД.00.2018",
      "docNumber108": "123",
      "docDate109": "0",
      "paymentKind110": "1"
    },
    "payeeAccount": "40802810600000200000",
    "payeeBankBic": "044525225",
    "payeeBankCorrAccount": "30101810400000000225",
    "payeeBankName": "ПАО СБЕРБАНК",
    "payeeInn": "7707083893",
    "payeeKpp": "222201001",
    "payeeName": "Общество с ограниченной ответственностью \"Клиент\"",
    "payerAccount": "40802810600000200000",
    "payerBankBic": "044525225",
    "payerBankCorrAccount": "30101810400000000225",
    "payerBankName": "ПАО СБЕРБАНК",
    "payerInn": "7707083893",
    "payerKpp": "222201001",
    "payerName": "Общество с ограниченной ответственностью \"Клиент\"",
    "payingCondition": "string",
    "purposeCode": "1",
    "receiptDate": "2018-12-31",
    "valueDate": "2018-12-31"
  },
  "swiftTransfer": {
    "bankOperationCode": "CRED",
    "beneficiaryBankAccount": "LOYDGB21321",
    "beneficiaryBankName": "BANCO DE SABADELL, S.A.                                               1, PLAZA CATALUNYA                 SABADELL ES                        ",
    "beneficiaryBankOption": "D",
    "beneficiaryCustomerAccount": "/FI8850000120266333",
    "beneficiaryCustomerName": "SUN-KING KNITTED BELT PRODUCT LTD. N.39,DONGMEN ROAD                  FUQING CITY,FUJIAN,CHINA",
    "detailsOfCharges": "OUR",
    "exchangeRate": "67,74",
    "instructedAmount": "USD70,",
    "instructionCode": "URGP",
    "intermediaryBankAccount": "COBADEFF",
    "intermediaryBankName": "BANCA POPOLARE DELL'ETRURIA E DEL LAZIO                               (SEDE DI MILANO)                   MILANO                             ",
    "intermediaryBankOption": "D",
    "messageDestinator": "LAPBLV2X",
    "messageIdentifier": "S000013082900014",
    "messageOriginator": "SABRRU2P",
    "messageReceiveTime": "15-05-27 14:01",
    "messageSendTime": "15-05-27 13:21",
    "messageType": "103",
    "orderingCustomerAccount": "/08251801040004813",
    "orderingCustomerName": "DONGNING JIXIN INDUSTRY AND TRADE(GROUP) CO.,LTD.                     NO.98 FANRONG STREET DONGNING      COUNTY",
    "orderingCustomerOption": "K",
    "orderingInstitutionAccount": "ABOCBNBJ080",
    "orderingInstitutionName": "AGRICULTURAL BANK OF CHINA, THE(HEILONGJIANG BRANCH)                  HARBIN",
    "orderingInstitutionOption": "A",
    "receiverCharges": "EUR13,19",
    "receiverCorrespondentAccount": "CHASDEFX",
    "receiverCorrespondentName": "THE BANK OF NEW YORK MELLON        NEW YORK,NY                        ",
    "receiverCorrespondentOption": "D",
    "regulatoryReporting": "/N10/NS/N4/12345678901234567890/N5/12345678901/N6/TP/N7/МS.05.2003/N8/123456789012345/N9/12.05.2003",
    "remittanceInformation": "CONTRACT NO SE/00233 DATED 06.03.2012, INVOICE NO 4783",
    "senderCharges": "USD7,03",
    "senderCorrespondentAccount": "BOTKGB2L",
    "senderCorrespondentName": "CITIBANK N.A.                      NEW YORK,NY                        ",
    "senderCorrespondentOption": "D",
    "senderToReceiverInformation": "/NZP/OT 15.03.2009. NDS NE OBLAGAETSYA",
    "transactionReferenceNumber": "S380609091426498",
    "transactionRelatedReference": "S380609091426498",
    "transactionTypeCode": "N1",
    "urgent": "NORMAL",
    "valueDateCurrencyInterbankSettledAmount": "130824EUR5447,34"
  },
  "transactionId": 11111,
  "uuid": "55daccdf-de87-3879-976c-8b8415c8caf9"
}