ym88659208ym87991671
Отправка заявления на перевод | Документация для разработчиков

Отправка заявления на перевод

Обновлено 29 ноября 2024
Компаниям

Alt text /fintech/api/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) в теле запроса.

Для подписи необходимо сформировать файл с дайджестом. Дайджест для подписания необходимо формировать строго в соответствии с примером:

В параметре scope ссылки авторизации пользователя должен быть указан сервис BUSINESS_CARDS_TRANSFER для получения доступа к этому запросу.

В ответе вы можете получить следующие статусы заявки:

  • IN PROGRESS Заявка на подтверждении или отправлена на исполнение. Проверьте статус перевода позднее;
  • PROCESSING Заявка в неопределенном статусе. Проверьте статус перевода позднее;
  • END Перевод выполнен успешно. Перевод исполнен, дополнительных действий не требуется;
  • ERROR_EXECUTION Ошибка на этапе исполнения заявки. Сформируйте новую заявку на перевод.

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

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

Request

/fintech/api/v2/corporate-cards/sign-and-approve
НаименованиеТипФорматRegexpОбязательностьОписание
HEADER
Authorizationstringstring^[a-zA-Z0-9]{38}$requiredAccess token пользователя, полученный через SSO.
BODY
{
  externalIdstringUUID^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$requiredУникальный идентификатор заявления на перевод, который был сгенерирован на предыдущем шаге для запроса /fintech/api/v2/сorporate-cards/transfer/commission,
  docTypestringstring^(TRANSFER)$requiredТип документа: TRANSFER
  digestSignaturesarray[Signature]array[object]requiredЭлектронные подписи по дайджесту документа.

Если ЭП передана/ы в API, то они сохраняются вместе с документом, а сам документ продвигается дальше по своему жизненному циклу.

Если ЭП не была/и передана/ы, то документ сохраняется в своем начальном статусе и ожидает дальнейшего подписания в интерфейсе СберБизнес.

О подписании дайджеста платежного документа подробно рассказали в соответствующем разделе документации
}
Signature {
  base64Encodedstringbase64^[a-zA-Z0-9]+$requiredЗначение электронной подписи, закодированное в Base64,
  certificateUuidstringUUID^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$requiredУникальный идентификатор сертификата ключа проверки электронной подписи
}

digestSignatures

Формат дайджеста
Наименование поляОписание поляПример
externalIdВнешний идентификатор документаf8ad3141-b7e8-4924-92de-3de4fd0a464e
transferPurposeНазначение переводаИванов Иван Ильич, 1234 987654; ПСА №123 от 01.01.2020; лом стальной, 123 кг, 15000 руб./т.; без НДС
transferAmount
amountРазмер перевода25.00
сurrencyВалюта переводаRUR
transferCommission
commissionРазмер комиссии2.00
сurrencyВалюта комиссииRUR
senderInfo
senderBusinessCardIdID карты отправителя бизнес-карты31663ef5-7975-4016-b0f3-f1d70a4e9c22
receiverInfo
encryptedCardNumberЗашифрованный номер карты получателя (указывается, если перевод по номеру карты)HlaeIHXXEcGT1bFxo1NlpAzpr+kJ2IQrcxVdvDTep
phoneNumberНомер телефона получателя (указывается, если перевод по номеру телефона)79880098877
lastNameФамилия получателяИ.
firstNameИмя получателяИВАН
lastNameОтчество получателяИВАНОВИЧ
bankNameБанк получателя переводаСбербанк
organizationNameОрганизация получателяПАО ВСПЫШКА

Responses

200 (OK)
НаименованиеТипОбязательностьОписание
statusTransferstringoptionalСтатус документа «Заявление на перевод между бизнес-картами»,
createDateDocstringoptionalДата и время создания документа.
400 (Bad request)
CauseMessageDescription
VALIDATION_ERRORОшибка валидацииДанные не соответствуют требованиям валидации. Подробные требования к атрибутам описаны в request метода, включая типы, форматы и регулярные выражения. Необходимо скорректировать заполнение атрибутов и повторить запрос.
Ошибка валидации запроса. Код ошибки: 428-001.Проверьте данные запроса. Попробуйте скорректировать запрос и отправить его повторно.
НаименованиеТипОбязательностьОписание
{
  errorCodestringoptionalКод ошибки,
  errorNamestringoptionalНазвание ошибки,
  errorDescstringoptionalОписание ошибки.
}
401 (Unauthorized Error)
CauseMessageDescription
UNAUTHORIZEDaccessToken not found by value =хххххххх-хххх-хххх-хххх-хххххххххххх-хУказан некорректный или просроченный access_token. Используйте refresh_token для обновления access_token и повторите запрос.
НаименованиеТипОбязательностьОписание
{
  errorCodestringoptionalКод ошибки,
  errorNamestringoptionalНазвание ошибки,
  errorDescstringoptionalОписание ошибки.
}
403 (Forbidden)
CauseMessageDescription
ACTION_ACCESS_EXCEPTIONОперация не может быть выполнена: доступ к ресурсу запрещенИспользуемый в запросе access_token не имеет разрешения на доступ к нужному сервису Sber API.
В ссылке авторизации СберБизнес ID, в параметре scope, не указана операция BUSINESS_CARDS_TRANSFER. Необходимо добавить эту операцию в scope. Пользователю потребуется пройти авторизацию заново. Вы получите новые токены access_token и refresh_token. Сделайте повторный запрос с новым access_token.
Вы использовали access_token пользователя вашей организации, а не Клиента. Нужно использовать access_token пользователя Клиента.
НаименованиеТипОбязательностьОписание
{
  errorCodestringoptionalКод ошибки,
  errorNamestringoptionalНазвание ошибки,
  errorDescstringoptionalОписание ошибки.
}
429 (Too Many Requests)
CauseMessageDescription
TOO_MANY_REQUESTSПревышен лимит запросов. Повторите операцию позже.Количество запросов к данному методу за ограниченное время превысило допустимое значение. Пользователю необходимо повторить запрос позднее
НаименованиеТипОбязательностьОписание
Notice{
causestringoptionalПричина или основание сообщения,
referenceIdstringoptionalУникальный идентификатор ошибки (UUID),
messagestringoptionalСообщение,
}
500 (Internal Server Error)
CauseMessageDescription
VALIDATION_ERRORОшибка валидацииДанные не соответствуют требованиям валидации. Подробные требования к атрибутам описаны в request метода, включая типы, форматы и регулярные выражения. Необходимо скорректировать заполнение атрибутов и повторить запрос.
Ошибка валидации ответа. Код ошибки: 428-002.Сделайте повторный запрос. Если ошибка повторится, подготовьте логи запроса и направьте в службу Технической поддержки Банка.
Ошибка валидации запроса. Код ошибки: 428-003.Недопустимые символы в теле запроса - сработало правило детектирования SQL-иньекций.
Ошибка валидации запроса. Код ошибки: 428-004.Недопустимые символы в теле запроса - сработало правило детектирования lfI-атаки
UNEXPECTED_SERVER_ERRORВнутренняя ошибка сервераСделайте повторный запрос. Если ошибка повторится, подготовьте логи запроса и направьте в службу Технической поддержки Банка.
GATEWAY_ERRORОшибка подключения к прокси-серверу.Сделайте повторный запрос. Если ошибка повторится, подготовьте логи запроса и направьте в службу Технической поддержки Банка.
Попробуйте позднее. Код ошибки: 428-009 / 428-010 / 428-149.Сделайте повторный запрос. Если ошибка повторится, подготовьте логи запроса и направьте в службу Технической поддержки Банка.
Непредвиденная ошибка. Код ошибки: 428-091.Сделайте повторный запрос. Если ошибка повторится, подготовьте логи запроса и направьте в службу Технической поддержки Банка.
CONTEXT_ERRORОшибка получения сессионных данных.Сделайте повторный запрос. Если ошибка повторится, подготовьте логи запроса и направьте в службу Технической поддержки Банка.
Попробуйте позднее. Код ошибки: 428-006 / 428-007 / 428-008 / 428-142 / 428-150 / 428-151.Сделайте повторный запрос. Если ошибка повторится, подготовьте логи запроса и направьте в службу Технической поддержки Банка.
FORBIDDEN_ERRORОтсутствуют полномочияНедостаточно полномочий для исполнения запроса.
Нет полномочий. Код ошибки: 428-131.Недостаточно полномочий для исполнения запроса.
Попробуйте позднее. Код ошибки: 428-132 / 428-133 / 428-134.Сделайте повторный запрос. Если ошибка повторится, подготовьте логи запроса и направьте в службу Технической поддержки Банка.
INTEGRATION_ERRORИнтеграционная ошибкаОшибка обращения к мастер-системе.
Превышен лимит времени ожидания запроса. Код ошибки: 428-167.Сделайте повторный запрос. Если ошибка повторится, подготовьте логи запроса и направьте в службу Технической поддержки Банка.
Попробуйте позднее. Код ошибки: 428-092 / 428-093 / 428-094 / 428-096 / 428-097 / 428-098 / 428-102 / 428-103 / 428-104 / 428-106 / 428-107 / 428-108 / 428-113 / 428-114 / 428-115 / 428-123 / 428-124 / 428-125 / 428-135 / 428-136 / 428-137 / 428-144 / 428-145 / 428-146 / 428-166.Сделайте повторный запрос. Если ошибка повторится, подготовьте логи запроса и направьте в службу Технической поддержки Банка.
На данный вид карты невозможно совершить перевод. Код ошибки: 428-169.На указанную карту получателя невозможно совершить перевод. Выберите другую карту для перевода.
BUSINESS_LOGIC_ERRORОшибка бизнес-логикиНарушена бизнес-логика запроса. Сведения об ошибке содержатся в атрибуте errorDesc.
Ошибка проверки подписи: Сертификат не является активным в криптопрофиле. Код ошибки: 428-095.Обновите сертификат подписи с помощью refresh_token. Если ошибка повторится, подготовьте логи запроса и направьте в службу Технической поддержки Банка.
Ошибка проверки подписи: Средство подписи не является активным. Код ошибки: 428-099.Обновите токен доступа с помощью refresh_token. Если ошибка повторится, подготовьте логи запроса и направьте в службу Технической поддержки Банка.
Ошибка проверки подписи: Средство подписи не является токеном. Код ошибки: 428-100.Проверьте токен доступа. Если ошибка повторится, подготовьте логи запроса и направьте в службу Технической поддержки Банка.
Ошибка проверки подписи: Пользователь не является владельцем подписи. Код ошибки: 428-101.Авторизуйтесь под пользователем, который является владельцем токена. Если ошибка повторится, подготовьте логи запроса и направьте в службу Технической поддержки Банка.
Ошибка при сохранении документа: Невозможно определить подразделение документа для сохранения. Код ошибки: 428-105.Сделайте повторный запрос. Если ошибка повторится, подготовьте логи запроса и направьте в службу Технической поддержки Банка.
Ошибка проверки подписи: Не удалось получить права подписи. Код ошибки: 428-109.Сделайте повторный запрос. Если ошибка повторится, подготовьте логи запроса и направьте в службу Технической поддержки Банка.
Ошибка проверки подписи: Отсутствуют права подписи. Код ошибки: 428-110.У авторизированного пользователя отсутствует право подписи.
Ошибка проверки подписи: Более одного права подписи. Код ошибки: 428-111.Сделайте повторный запрос. Если ошибка повторится, подготовьте логи запроса и направьте в службу Технической поддержки Банка.
Ошибка проверки подписи: Невалидное право подписи. Код ошибки: 428-112.Проверьте валидность подписи.
Ошибка подписи: Неожиданная ошибка. Код ошибки: 428-116.Сделайте повторный запрос. Если ошибка повторится, подготовьте логи запроса и направьте в службу Технической поддержки Банка.
Ошибка подписи: Ошибка валидации запроса. Код ошибки: 428-117.Сделайте повторный запрос. Если ошибка повторится, подготовьте логи запроса и направьте в службу Технической поддержки Банка.
Ошибка подписи: Ошибка сохранения в аудит. Код ошибки: 428-118.Сделайте повторный запрос. Если ошибка повторится, подготовьте логи запроса и направьте в службу Технической поддержки Банка.
Ошибка подписи: Попробуйте позднее. Код ошибки: 428-119.Сделайте повторный запрос. Если ошибка повторится, подготовьте логи запроса и направьте в службу Технической поддержки Банка.
Ошибка подписи: Ошибки проверки подписи и подписанта. Код ошибки: 428-120.Сделайте повторный запрос. Если ошибка повторится, подготовьте логи запроса и направьте в службу Технической поддержки Банка.
Ошибка подписи: Ошибки сохранения подписи. Код ошибки: 428-121.Сделайте повторный запрос. Если ошибка повторится, подготовьте логи запроса и направьте в службу Технической поддержки Банка.
Ошибка подписи: Попробуйте позднее. Код ошибки: 428-122.Сделайте повторный запрос. Если ошибка повторится, подготовьте логи запроса и направьте в службу Технической поддержки Банка.
Сертификат не найден. Код ошибки: 428-126.Сделайте повторный запрос. Если ошибка повторится, подготовьте логи запроса и направьте в службу Технической поддержки Банка.
Заявка с указанным externalId не найдена. Код ошибки: 428-138.Укажите externalId существующей заявки.
Срок подтверждения заявки на перевод истек. Код ошибки: 428-139.Создайте новую заявку на перевод.
Статус карты получателя не допускает возможность перевода. Код ошибки: 428-140.Сделайте повторный запрос. Если ошибка повторится, подготовьте логи запроса и направьте в службу Технической поддержки Банка.
Ошибка при сохранении документа: Клиент не является держателем карты. Код ошибки: 428-143.Отправитель перевода должен быть держателем карты.
Операция отклонена по итогам проверки лимита. Код ошибки: 428-152.Проверьте доступные лимиты на переводы по указанной карте отправителя.
Перевод в обработке. Код ошибки: 428-153.Заявка на перевод уже находится в обработке.
Истек срок действия карты. Код ошибки: 428-154.Укажите карту отправителя с неистекшим сроком действия.
Превышен лимит по карте. Код ошибки: 428-155.Проверьте доступные лимиты на переводы по указанной карте отправителя.
Пожалуйста, обратитесь в контактный центр банка для проверки карты. Код ошибки: 428-156 / 428-158.Проверьте
Недостаточно средств. Код ошибки: 428-157.Пополните карту до необходимой суммы перевода.
Некорректный номер карты-получателя. Код ошибки: 428-159.Проверьте данные карты получателя платежа.
Операция в данный момент недоступна, попробуйте повторить позднее. Код ошибки: 428-160.Сделайте повторный запрос. Если ошибка повторится, подготовьте логи запроса и направьте в службу Технической поддержки Банка.
После дополнительного контроля вам отказано в проведении операции по причине высокого риска. Если вы считаете, что операция отклонена по ошибке, обратитесь в офис банка с заявлением. Код ошибки: 428-161.Не удалось совершить перевод. Пожалуйста, обратитесь в контактный центр банка.
Запрещен перевод между картами одного счета. Код ошибки: 428-162.Нельзя осуществлять перевод между картами одного счета. Укажите корректные данные перевода.
Данная заявка на перевод уже исполнена. Код ошибки: 428-163.Заявка на перевод с указанным externalId уже была исполнена.
Заявка в процессе обработки. Код ошибки: 428-164.Заявка на перевод с указанным externalId находится в обработке.
Данная заявка на перевод не может быть выполнена. Код ошибки: 428-165.Создайте новую заявку на перевод.
Попробуйте позднее. Код ошибки: 428-141 / 428-147 / 428-148.Сделайте повторный запрос. Если ошибка повторится, подготовьте логи запроса и направьте в службу Технической поддержки Банка.
НаименованиеТипОбязательностьОписание
{
  errorCodestringoptionalКод ошибки,
  errorNamestringoptionalНазвание ошибки,
  errorDescstringoptionalОписание ошибки.
}
503 (Service Temporarily Unavailable)
CauseMessageDescription
UNAVAILABLE_RESOURCE_EXCEPTIONВнутренняя ошибка сервераСделайте повторный запрос. Если ошибка повторится, подготовьте логи запроса и направьте в службу Технической поддержки Банка.
НаименованиеТипОбязательностьОписание
{
  errorCodestringoptionalКод ошибки,
  errorNamestringoptionalНазвание ошибки,
  errorDescstringoptionalОписание ошибки.
}
ПАО Сбербанк использует cookie для персонализации сервисов и удобства пользователей.
Вы можете запретить сохранение cookie в настройках своего браузера.