Перейти к основному содержимому
Версия: 2026.09.1

Подписание с гарантированной синхронной отправкой в АБС

Подписывает один или несколько созданных платежей и синхронно выполняет отправку полностью подписанных документов в АБС. Результаты подписания и отправки возвращаются в одном HTTP-ответе. Успешное подписание само по себе не означает успешную отправку или исполнение платежа: проверяйте результат каждого документа.

EndpointPOST /domestic-payment-service/api/v2/signature/sign-and-send-to-abs
Content-Typeapplication/json
АвторизацияOAuth2 / JWT (Bearer token)

Перед подписанием выполните инициализацию. Для уже подписанного платежа повторная инициализация и подпись не нужны: метод выполняет попытку отправки.

Тело запроса​

ПолеТипОбязательностьОписание
authFactorTypeenum (AuthFactorType)Условно, при подписанииСпособ подтверждения подписи, например SMS или ЭЦП
codeStringУсловно, при подписанииКод подтверждения для выбранного фактора
detailsList<DocumentSignData>ДаДокументы для подписания и отправки

Элемент details​

ПолеТипОбязательностьОписание
documentIdLongДаИдентификатор платежа
requestIdStringУсловно, при подписанииИдентификатор запроса из ответа инициализации подписания
certificateSNStringУсловно, при подписанииСерийный номер сертификата для соответствующего способа подписи
signatureStringУсловно, при подписанииПодпись, сформированная клиентом; сервис передаёт её на проверку в EDS

Параметр needToSendToAbs у этого метода отсутствует.

Пример запроса​

{
"authFactorType": "SMS",
"code": "111111",
"details": [
{
"documentId": 1111111,
"requestId": "11111111-1111-1111-1111-11111111111"
}
]
}

Порядок обработки​

  1. Сервис загружает платежи по details[].documentId. Несуществующие, чужие и пришедшие из ядра идентификаторы отфильтровываются и не попадают в ответ.
  2. Платежи в статусе AwaitsSignature направляются на подписание. Для платежей в статусе Signed подпись пропускается. Другие статусы, включая Draft, SentToRBS и Executed, игнорируются и не попадают в ответ.
  3. Сервис проверяет право подписи и подписывает ожидающие подписи документы.
  4. Полностью подписанные документы и документы, уже находившиеся в статусе Signed, направляются на синхронную отправку в АБС.
  5. Сервис возвращает signingResponse и sendToAbsResponses.

При SIGNED_NEED_NEXT требуется ещё одна подпись: документ присутствует только в signingResponse.signingInfoList, без записи в sendToAbsResponses. Отсутствие документа в результате отправки нельзя считать успешной отправкой.

Тело ответа​

ПолеТипОписание
signingResponseSigningResponseРезультат подписания; список signingInfoList содержит результаты по документам
sendToAbsResponsesList<SendToAbsResponse>Результаты по документам, дошедшим до отправки

Поля signingInfoList описаны в разделе Подписание и отправка в АБС (v2).

Статусы подписи​

СтатусЗначение
INITIALIZEDПодписание инициализировано, но не завершено
SIGNEDДокумент полностью подписан и направляется на отправку в АБС
SIGNED_NEED_NEXTТребуется ещё как минимум одна подпись; отправка не выполняется
VALIDATION_FAILEDПодпись не прошла проверку EDS

Элемент sendToAbsResponses​

ПолеТипОписание
paymentIdLongИдентификатор платежа
statusenum (SendToAbsStatus)Результат попытки отправки
headerStringЛокализованный заголовок результата
bodyStringЛокализованный текст результата
iconenum (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/signsignature/sign-and-send-to-abs
needToSendToAbsЕсть, по умолчанию trueОтсутствует
ОтправкаАсинхроннаяСинхронная
ОтветРезультат подписанияРезультаты подписания и отправки
Ошибка отправкиНе возвращается синхронноВозвращается в результате отправки конкретного документа

Ошибки и права доступа​

КодУсловие
401 UnauthorizedОтсутствует или невалиден JWT
409 ConflictХотя бы один ожидающий подписи документ не может быть подписан текущим пользователем по данным EDS. Прерывается весь вызов, включая отправку уже подписанных документов

Право подписи определяется EDS по лимитам и порядку подписания, настроенным для клиента.

Для отправки требуется cp_new_dt_send_to_abs. Если права нет, возвращается NOT_ENOUGH_PRIVILEGE для соответствующего документа, а не общая ошибка всего запроса.