Получение статуса запроса на новый сертификат для ЕИО
Ресурс позволяет получить информацию по статусу запроса на новый сертификат. Полученную информацию возможно использовать для контроля и анализа статуса запроса на новый сертификат. Работает с access_token пользователей с признаком единоличный исполнительный орган (ЕИО).
Отправьте GET-запрос /fintech/api/v1/crypto/cert-requests/eio/{externalId}/state с токеном доступа (access_token) пользователя-ЕИО в параметре Authorization заголовка и идентификатором документа (externalId) в path-параметре.
В параметре scope ссылки авторизации пользователя-ЕИО должен быть указан сервис CRYPTO_CERT_REQUEST_EIO для получения доступа к этому ресурсу.
При отправке запроса на получение статуса запроса на новый сертификат для ЕИО, ответ зависит от переданного параметра externalId. Для симуляции различных сценариев используйте следующие тестовые идентификаторы:
Передаваемое значение externalId | Возвращаемое значение bankStatus |
|---|---|
a7f3b1c8-2e5d-4f9a-b6c0-9e8d7a2b5c4e | ACCEPTED_BY_ABS |
| Любое другое значение | AWAITING_CONFIRMATION |
Запрос
Ответы
OK
| bankStatus | Наименование статуса | Назначение кода состояния |
|---|---|---|
| Промежуточный/Продолжать опрашивать | ||
ACCEPTED_BY_ABS | Принят АБС | Электронный документ был принят к обработке в АБС Банка Подписанту необходимо предоставить в Банк заявление на выпуск сертификата. С помощью ресурса GET /fintech/api/v1/crypto/cert-requests/{externalId}/print получите печатную форму заявления, распечатайте и подпишите. Далее Подписанту необходимо предоставить заявление в обслуживающий офис Сбера. |
PUBLISHED_BY_BANK | Издан Банком | Сертификат выпущен, и него необходимо активировать. Активировать сертификат можно с помощью ресурса POST /fintech/api/v1/crypto/cert-requests/{externalId}/activate |
AWAITING_CONFIRMATION | Ожидает подтверждения | Подписант должен подтвердить заявления дистанционно. Дистанционно подтвердить можно с помощью ресурса POST /v1/crypto/cert-requests/{externalId}/confirm |
CONFIRMED | Подтвержден | Подписант успешно подтвердил запрос на выпуск сертификата. |
| Окончательный (Не успешный)/Прекратить опрос | ||
DENIED | Отказано в сертификации | Ошибка в процессе выпуска сертификата либо отказано в сертификации |
| Окончательный (Успешный)/Прекратить опрос | ||
PROCESSED | Обработан | Сертификат активирован |
Bad Request
| Cause | Message | Description |
|---|---|---|
| DESERIALIZATION_FAULT | Неверный формат запроса | Данные в request указаны в неправильном формате. Атрибуты request, в которых найдены ошибки, указаны в response в массиве fields с описанием проблемы. Описание типа, формата и regexp атрибутов находится в request метода. Скорректируйте заполнение атрибутов и повторите запрос. |
Unauthorized
| Cause | Message | Description |
|---|---|---|
| UNAUTHORIZED | accessToken not found by value =хххххххх-хххх-хххх-хххх-хххххххххххх-х | Указан некорректный или просроченный access_token. Используйте refresh_token для обновления access_token и повторите запрос. |
Forbidden
| Cause | Message | Description |
|---|---|---|
| ACTION_ACCESS_EXCEPTION | Операция не может быть выполнена: доступ к ресурсу запрещен | Используемый в запросе access_token не имеет разрешения на доступ к нужному сервису Sber API. В ссылке авторизации СберБизнес ID, в параметре scope, не указана операция CRYPTO_CERT_REQUEST_EIO. Необходимо добавить эту операцию в scope. Пользователю потребуется пройти авторизацию заново. Вы получите новые токены access_token и refresh_token. Сделайте повторный запрос с новым access_token. |
Not Found
Too Many Requests
| Cause | Message | Description |
|---|---|---|
| TOO_MANY_REQUESTS | Превышен лимит запросов. Повторите операцию позже. | Количество запросов к данному методу за ограниченное время превысило допустимое значение. Пользователю необходимо повторить запрос позднее |
Internal Server Error
Service Unavailable