Подпись и подтверждение документа по бизнес-картам
/v2/corporate-cards/sign-and-approve
Запрос позволяет подписывать документ «Заявление на перевод с бизнес-карты». Для подписания документа «Заявление на перевод с бизнес-карты» необходимо отправить POST-запрос /fintech/api/v2/corporate-cards/sign-and-approve
с токеном доступа (access_token) пользователя в параметре Authorization заголовка и уникальным идентификатором заявки (externalId) на перевод, который был сгенерирован Клиентом на предыдущем шаге для запроса /fintech/api/v2/сorporate-cards/transfer/commission, и данными ЭП отправителя перевода (digestSignatures) в теле запроса.
Укажите в параметре docType
тип перевода: TRANSFER
для обычного перевода или SBP_TRANSFER
для СБП перевода. Для подписи необходимо сформировать файл с дайджестом. Дайджест для подписания необходимо формировать строго в соответствии с примером. В параметре scope
ссылки авторизации пользователя должен быть указан сервис BUSINESS_CARDS_TRANSFER
для получения доступа к этому запросу.
В ответе вы можете получить следующие статусы заявки:
IN_PROGRESS
Заявка на подтверждении или отправлена на исполнение. Проверьте статус перевода позднееPROCESSING
Заявка в неопределенном статусе. Проверьте статус перевода позднееEND
Перевод выполнен успешно. Перевод исполнен, дополнительных действий не требуетсяERROR_EXECUTION
Ошибка на этапе исполнения заявки. Сформируйте новую заявку на перевод.
Запрос
- application/json
Body
required
- Array [
- ]
Возможные значения: <= 255 characters
Идентификатор документа, присвоенный сервисом (UUID)
digestSignatures object[]required
Possible values: >= 1
, <= 1
Электронные подписи по дайджесту документа
Возможные значения: <= 50000 characters
Значение электронной подписи, закодированное в Base64
Возможные значения: <= 36 characters
Уникальный идентификатор сертификата ключа проверки электронной подписи (UUID)
Возможные значения: [TRANSFER
, SBP_TRANSFER
]
Успешный ответ
- application/json
- Схема
- Пример из схемы
Schema
Возможные значения: <= 64 characters
Статус документа
Дата и время создания документа
{
"status": "Принят",
"createDate": "2022-07-27T09:32:01Z"
}
Ошибка бизнес-логики
- application/json
- Схема
- Пример из схемы
Schema
Возможные значения: <= 255 characters
Код ошибки
Возможные значения: [VALIDATION_ERROR
, UNEXPECTED_SOWA_ERROR
, CONTEXT_ERROR
, GATEWAY_ERROR
, UNEXPECTED_SERVER_ERROR
, FORBIDDEN_ERROR
, INTEGRATION_ERROR
, BUSINESS_LOGIC_ERROR
, REQUEST_LIMIT_EXCEED
]
Возможные значения: <= 255 characters
Описание ошибки
Возможные значения: <= 36 characters
Уникальный идентификатор запроса
{
"errorCode": "string",
"errorType": "VALIDATION_ERROR",
"errorDesc": "string",
"requestId": "string"
}
Нет доступа к услуге / сервису
- application/json
- Схема
- Пример из схемы
Schema
Возможные значения: <= 255 characters
Код ошибки
Возможные значения: [VALIDATION_ERROR
, UNEXPECTED_SOWA_ERROR
, CONTEXT_ERROR
, GATEWAY_ERROR
, UNEXPECTED_SERVER_ERROR
, FORBIDDEN_ERROR
, INTEGRATION_ERROR
, BUSINESS_LOGIC_ERROR
, REQUEST_LIMIT_EXCEED
]
Возможные значения: <= 255 characters
Описание ошибки
Возможные значения: <= 36 characters
Уникальный идентификатор запроса
{
"errorCode": "string",
"errorType": "VALIDATION_ERROR",
"errorDesc": "string",
"requestId": "string"
}
Внутренняя ошибка сервера
- application/json
- Схема
- Пример из схемы
Schema
Возможные значения: <= 255 characters
Код ошибки
Возможные значения: [VALIDATION_ERROR
, UNEXPECTED_SOWA_ERROR
, CONTEXT_ERROR
, GATEWAY_ERROR
, UNEXPECTED_SERVER_ERROR
, FORBIDDEN_ERROR
, INTEGRATION_ERROR
, BUSINESS_LOGIC_ERROR
, REQUEST_LIMIT_EXCEED
]
Возможные значения: <= 255 characters
Описание ошибки
Возможные значения: <= 36 characters
Уникальный идентификатор запроса
{
"errorCode": "string",
"errorType": "VALIDATION_ERROR",
"errorDesc": "string",
"requestId": "string"
}