Подписание с гарантированной синхронной отправкой в АБС
Подписывает один или несколько созданных платежей и синхронно выполняет отправку полностью подписанных документов в АБС. Результаты подписания и отправки возвращаются в одном HTTP-ответе. Успешное подписание само по себе не означает успешную отправку или исполнение платежа: проверяйте результат каждого документа.
| Endpoint | POST /domestic-payment-service/api/v2/signature/sign-and-send-to-abs |
| Content-Type | application/json |
| Авторизация | OAuth2 / JWT (Bearer token) |
Перед подписанием выполните инициализацию. Для уже подписанного платежа повторная инициализация и подпись не нужны: метод выполняет попытку отправки.
Тело запроса
| Поле | Тип | Обязательность | Описание |
|---|---|---|---|
authFactorType | enum (AuthFactorType) | Условно, при подписании | Способ подтверждения подписи, например SMS или ЭЦП |
code | String | Условно, при подписании | Код подтверждения для выбранного фактора |
details | List<DocumentSignData> | Да | Документы для подписания и отправки |
Элемент details
| Поле | Тип | Обязательность | Описание |
|---|---|---|---|
documentId | Long | Да | Идентификатор платежа |
requestId | String | Условно, при подписании | Идентификатор запроса из ответа инициализации подписания |
certificateSN | String | Условно, при подписании | Серийный номер сертификата для соответствующего способа подписи |
signature | String | Условно, при подписании | Подпись, сформированная клиентом; сервис передаёт её на проверку в EDS |
Параметр needToSendToAbs у этого метода отсутствует.
Пример запроса
{
"authFactorType": "SMS",
"code": "111111",
"details": [
{
"documentId": 1111111,
"requestId": "11111111-1111-1111-1111-11111111111"
}
]
}
Порядок обработки
- Сервис загружает платежи по
details[].documentId. Несуществующие, чужие и пришедшие из ядра идентификаторы отфильтровываются и не попадают в ответ. - Платежи в статусе
AwaitsSignatureнаправляются на подписание. Для платежей в статусеSignedподпись пропускается. Другие статусы, включаяDraft,SentToRBSиExecuted, игнорируются и не попадают в ответ. - Сервис проверяет право подписи и подписывает ожидающие подписи документы.
- Полностью подписанные документы и документы, уже находившиеся в статусе
Signed, направляются на синхронную отправку в АБС. - Сервис возвращает
signingResponseиsendToAbsResponses.
При SIGNED_NEED_NEXT требуется ещё одна подпись: документ присутствует только в signingResponse.signingInfoList, без записи в sendToAbsResponses. Отсутствие документа в результате отправки нельзя считать успешной отправкой.
Тело ответа
| Поле | Тип | Описание |
|---|---|---|
signingResponse | SigningResponse | Результат подписания; список signingInfoList содержит результаты по документам |
sendToAbsResponses | List<SendToAbsResponse> | Результаты по документам, дошедшим до отправки |
Поля signingInfoList описаны в разделе Подписание и отправка в АБС (v2).
Статусы подписи
| Статус | Значение |
|---|---|
INITIALIZED | Подписание инициализировано, но не завершено |
SIGNED | Документ полностью подписан и направляется на отправку в АБС |
SIGNED_NEED_NEXT | Требуется ещё как минимум одна подпись; отправка не выполняется |
VALIDATION_FAILED | Подпись не прошла проверку EDS |
Элемент sendToAbsResponses
| Поле | Тип | Описание |
|---|---|---|
paymentId | Long | Идентификатор платежа |
status | enum (SendToAbsStatus) | Результат попытки отправки |
header | String | Локализованный заголовок результата |
body | String | Локализованный текст результата |
icon | enum (SendToAbsIcon) | SUCCESS, ERROR или TIME_WARNING |
Статусы отправки
| Статус | Значение |
|---|---|
SENT | Документ принят АБС, в том числе в промежуточных состояниях SentToRBS, AcceptedInABS, ExpectsFunds |
EXECUTED | Платёж исполнен АБС |
REJECTED | Документ отклонён АБС (NotAcceptedInABS) |
ANTI_FRAUD_SUSPEND | Платёж приостановлен антифрод-системой |
ANTI_FRAUD_REJECTION | Платёж заблокирован антифрод-системой |
NOT_ENOUGH_PRIVILEGE | Нет права cp_new_dt_send_to_abs |
ERROR | Ошибка отправки, например неверный статус, отсутствие платежа или невозможность получить блокировку |
KVO_IS_REQUIRED | Требуется код валютной операции |
EXCHANGE_RATE_IS_REQUIRED | Требуется курс обмена валют |
OPERATION_DAY_CLOSED | Операционный день закрыт |
OPERATION_DAY_LIMIT_EXHAUSTED | Исчерпан лимит операционного дня |
Пример успешного ответа
{
"signingResponse": {
"signingInfoList": [
{
"documentId": "1111111",
"documentType": "DomesticTransfer",
"documentSignStatus": "SIGNED",
"initializedAuthFactor": "SMS",
"requestId": "11111111-1111-1111-1111-11111111111"
}
]
},
"sendToAbsResponses": [
{
"paymentId": 1111111,
"status": "SENT",
"header": "Обрабатываем операцию",
"body": "Деньги скоро поступят на счет",
"icon": "TIME_WARNING"
}
]
}
В этом примере документ подписан (SIGNED) и принят АБС (SENT), но ещё не подтверждён как исполненный.
Повторная отправка
Если подписание завершилось, но отправка не состоялась, например из-за закрытого операционного дня, можно повторить вызов с тем же documentId. Пока платёж находится в статусе Signed, повторная подпись не выполняется — сервис повторяет попытку отправки.
Платежи, перешедшие в другие статусы, обрабатываются по правилам выше. Для проверки актуального состояния используйте получение платежа.
Отличия от асинхронного подписания
| Свойство | signature/sign | signature/sign-and-send-to-abs |
|---|---|---|
needToSendToAbs | Есть, по умолчанию true | Отсутствует |
| Отправка | Асинхронная | Синхронная |
| Ответ | Результат подписания | Результаты подписания и отправки |
| Ошибка отправки | Не возвращается синхронно | Возвращается в результате отправки конкретного документа |
Ошибки и права доступа
| Код | Условие |
|---|---|
401 Unauthorized | Отсутствует или невалиден JWT |
409 Conflict | Хотя бы один ожидающий подписи документ не может быть подписан текущим пользователем по данным EDS. Прерывается весь вызов, включая отправку уже подписанных документов |
Право подписи определяется EDS по лимитам и порядку подписания, настроенным для клиента.
Для отправки требуется cp_new_dt_send_to_abs. Если права нет, возвращается NOT_ENOUGH_PRIVILEGE для соответствующего документа, а не общая ошибка всего запроса.