Создание черновика заявления на перевод

Обновлено 19 февраля 2025

/fintech/api/v2/corporate-cards/transfer/commission

Запрос позволяет создать черновик документа «Заявление на перевод между бизнес-картами» и получить актуальный размер комиссии за перевод между бизнес-картами в ответе. POST-запрос должен содержать токен доступа (access_token) пользователя в параметре Authorization заголовка и реквизиты перевода для расчета комиссии в теле запросе. В блоке receiverInfo укажите либо номер карты получателя, либо номер телефона получателя, в зависимости от способа перевода.

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

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

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

Request

/fintech/api/v2/сorporate-cards/transfer/commission

Модель
Пример

Наименование	Тип	Формат	Regexp	Обязательность	Описание
HEADER
Authorization	string	string	^[a-zA-Z0-9]38$	required	Access token пользователя, полученный через SSO.
BODY
{
amount	number	float	^[0-9]16\.[0-9]2$	required	Сумма перевода в рублях,
externalId	string	UUID	^[0-9a-f]8-[0-9a-f]4-[0-9a-f]4-[0-9a-f]4-[0-9a-f]12$	required	Уникальный идентификатор заявления на перевод, генерируется на стороне Клиента,
transferPurpose	string	string	^[a-zA-Z0-9]+$	required	Назначение перевода,
receiverInfo	array[receiverInfo]	array[object]			Реквизиты получателя,
senderInfo	array[senderInfo]	array[object]			Реквизиты отправителя
}
receiverInfo {
encryptedCardNumber	string	string	^[a-zA-Z0-9]+$	optional	Зашифрованный номер карты получателя перевода (указывается, если перевод по номеру карты),
phoneNumber	string	string	^7\d10$	optional	Номер телефона получателя перевода(указывается, если перевод по номеру телефона).
}
senderInfo {
businessCardId	string	string	^[0-9a-f]8-[0-9a-f]4-[0-9a-f]4-[0-9a-f]4-[0-9a-f]12$	required	ID карты-отправителя. Идентификатор бизнес-карты вы получили на предыдущем шаге с помощью ресурса /fintech/api/v2/corporate-cards/list
}

POST /fintech/api/v2/сorporate-cards/transfer/commission HTTP/1.1
Content-Type: application/json
Authorization: Bearer xbgDF3brf456ghi789jkl012mNKFtEpqr678
 
{   
  "amount": "1000.00",
  "externalId": "293e94c4-ecef-4e4d-a923-9453b16dbddd",
  "transferPurpose": "За товар по договору №2 от 12/01/2024",
  "receiverInfo": [
        {
            "encryptedCardNumber": "HlaeIHXXEcGT1bFxo1NlpAzpr+kJ224S0mPfVCU75sieOMt71TBS7w==",
            "phoneNumber":      
        }
    ],
  "senderInfo": [
        {
            "businessCardId": "8ad3141-b7e8-4924-92de-3de4fd0a464e-1"
        }
    ]    
 }

Responses

200 (OK)

Модель
Пример

Наименование	Тип	Обязательность	Описание
externalId	string	optional	Уникальный идентификатор заявления на перевод,
transferPurpose	string	required	Назначение перевода,
transferAmount {
amount	number	required	Сумма перевода,
currency	string	required	Валюта перевода.
}
transferComission {
amount	number	required	Комиссия за перевод,
currency	string	required	Валюта комиссии за перевод.
}
senderInfo {
businessCardId	string	required	ID карты-отправителя.
}
receiverInfo {
encryptedCardNumber	string	optional	Зашифрованный номер карты получателя,
phoneNumber	string	optional	Номер телефона получателя,
lastName	string	optional	Фамилия получателя,
firstName	string	optional	Имя получателя,
middleName	string	optional	Отчество получателя,
bankName	string	optional	Банк получателя,
organizationName	string	optional	Наименование организации получателя.
}

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
 
{
  "externalId": "293e94c4-ecef-4e4d-a923-9453b16dbddd",
  "transferPurpose": "За товар по договору №2 от 12/01/2024",
  "transferAmount": {
    "amount": 1000.00,
    "сurrency": "RUR"
    },
  "transferComission": {
    "amount": 10.00,
    "сurrency": "RUR"
    },
  "senderInfo": {
     "businessCardId": "8ad3141-b7e8-4924-92de-3de4fd0a464e-1"
    },
  "receiverInfo": {
    "encryptedCardNumber": "HlaeIHXXEcGT1bFxo1NlpAzpr+kJ224S0mPfVCU75sieOMt71TBS7w==",
    "lastName": "Иванов",
    "firstName": "Иван",
    "middleName": "Иванович",
    "bankName": "Сбербанк",
    "organizationName": "ПАО ВСПЫШКА"
  }
}

400 (Bad request)

Cause	Message	Description
VALIDATION_ERROR	Ошибка валидации	Данные не соответствуют требованиям валидации. Подробные требования к атрибутам описаны в request метода, включая типы, форматы и регулярные выражения. Необходимо скорректировать заполнение атрибутов и повторить запрос.
	Ошибка валидации запроса. Код ошибки: 428-001.	Проверьте данные запроса. Попробуйте скорректировать запрос и отправить его повторно.

Модель
Пример

Наименование	Тип	Обязательность	Описание
{
errorCode	string	optional	Код ошибки,
errorName	string	optional	Название ошибки,
errorDesc	string	optional	Описание ошибки.
}

HTTP/1.1 400 Bad Request
Content-Type: application/json;charset=UTF-8
 
{
    "errorCode": "428-001",
    "errorName": "VALIDATION_ERROR",
    "errorDesc": "Ошибка валидации запроса. Код ошибки: 428-001."
}

401 (Unauthorized Error)

Cause	Message	Description
UNAUTHORIZED	accessToken not found by value =хххххххх-хххх-хххх-хххх-хххххххххххх-х	Указан некорректный или просроченный access_token. Используйте refresh_token для обновления access_token и повторите запрос.

Модель
Пример

Наименование	Тип	Обязательность	Описание
{
errorCode	string	optional	Код ошибки,
errorName	string	optional	Название ошибки,
errorDesc	string	optional	Описание ошибки.
}

HTTP/1.1 401 Unauthorized
Content-Type: application/json;charset=UTF-8
 
{
    "cause": "UNAUTHORIZED",
    "referenceId": "014ec3a1-3e41-4805-9e22-d07947b012af",
    "message": "accessToken not found by value = 3513f959-bbd5-490a-9f9f-67fb7380fae5-2"
}

403 (Forbidden)

Cause	Message	Description
ACTION_ACCESS_EXCEPTION	Операция не может быть выполнена: доступ к ресурсу запрещен	Используемый в запросе access_token не имеет разрешения на доступ к нужному сервису Sber API. В ссылке авторизации СберБизнес ID, в параметре scope, не указана операция `BUSINESS_CARDS_TRANSFER`. Необходимо добавить эту операцию в scope. Пользователю потребуется пройти авторизацию заново. Вы получите новые токены access_token и refresh_token. Сделайте повторный запрос с новым access_token.
		Вы использовали access_token пользователя вашей организации, а не Клиента. Нужно использовать access_token пользователя Клиента.

Модель
Пример

Наименование	Тип	Обязательность	Описание
{
errorCode	string	optional	Код ошибки,
errorName	string	optional	Название ошибки,
errorDesc	string	optional	Описание ошибки.
}

HTTP/1.1 403 Forbidden
Content-Type: application/json;charset=UTF-8
 
{
    "cause": "ACTION_ACCESS_EXCEPTION",
    "referenceId": "7535c2bb-7706-4b16-9882-d68aedbf2fef",
    "message": "Операция не может быть выполнена: доступ к ресурсу запрещен"
}

429 (Too Many Requests)

Cause	Message	Description
TOO_MANY_REQUESTS	Превышен лимит запросов. Повторите операцию позже.	Количество запросов к данному методу за ограниченное время превысило допустимое значение. Пользователю необходимо повторить запрос позднее

Модель
Пример

Наименование	Тип	Обязательность	Описание
Notice{
cause	string	optional	Причина или основание сообщения,
referenceId	string	optional	Уникальный идентификатор ошибки (UUID),
message	string	optional	Сообщение,
}

HTTP/1.1 429 Too Many Requests
Content-Type: application/json;charset=UTF-8

{
  "cause": " TOO_MANY_REQUESTS ",
  "referenceId": "5650c1e4-5039-4038-8cad-afab64003f61",
  "message": " Превышен лимит запросов. Повторите операцию позже"
}

500 (Internal Server Error)

Cause	Message	Description
VALIDATION_ERROR	Ошибка валидации	Данные не соответствуют требованиям валидации. Подробные требования к атрибутам описаны в request метода, включая типы, форматы и регулярные выражения. Необходимо скорректировать заполнение атрибутов и повторить запрос.
	Ошибка валидации ответа. Код ошибки: 428-002.	Сделайте повторный запрос. Если ошибка повторится, подготовьте логи запроса и направьте в службу Технической поддержки Банка.
	Ошибка валидации запроса. Код ошибки: 428-003.	Недопустимые символы в теле запроса - сработало правило детектирования SQL-иньекций.
	Ошибка валидации запроса. Код ошибки: 428-004.	Недопустимые символы в теле запроса - сработало правило детектирования lfI-атаки
UNEXPECTED_SERVER_ERROR	Внутренняя ошибка сервера	Сделайте повторный запрос. Если ошибка повторится, подготовьте логи запроса и направьте в службу Технической поддержки Банка.
	Непредвиденная ошибка. Код ошибки: 428-061.	Сделайте повторный запрос. Если ошибка повторится, подготовьте логи запроса и направьте в службу Технической поддержки Банка.
GATEWAY_ERROR	Ошибка подключения к прокси-серверу.	Сделайте повторный запрос. Если ошибка повторится, подготовьте логи запроса и направьте в службу Технической поддержки Банка.
	Попробуйте позднее. Код ошибки: 428-009 / 428-010 / 428-062.	Сделайте повторный запрос. Если ошибка повторится, подготовьте логи запроса и направьте в службу Технической поддержки Банка.
CONTEXT_ERROR	Ошибка получения сессионных данных.	Сделайте повторный запрос. Если ошибка повторится, подготовьте логи запроса и направьте в службу Технической поддержки Банка.
	Попробуйте позднее. Код ошибки: 428-006 / 428-007 / 428-008 / 428-063.	Сделайте повторный запрос. Если ошибка повторится, подготовьте логи запроса и направьте в службу Технической поддержки Банка.
FORBIDDEN_ERROR	Отсутствуют полномочия	Недостаточно полномочий для исполнения запроса.
	Нет полномочий. Код ошибки: 428-064.	Недостаточно полномочий для исполнения запроса.
	Попробуйте позднее. Код ошибки: 428-065 / 428-066 / 428-067.	Сделайте повторный запрос. Если ошибка повторится, подготовьте логи запроса и направьте в службу Технической поддержки Банка.
INTEGRATION_ERROR	Интеграционная ошибка	Ошибка обращения к мастер-системе.
	Попробуйте позднее. Код ошибки: 428-068 / 428-069 / 428-070 / 428-079 / 428-082 / 428-090.	Сделайте повторный запрос. Если ошибка повторится, подготовьте логи запроса и направьте в службу Технической поддержки Банка.
	Не удалось получить информацию об организации. Повторите попытку позднее. Код ошибки: 428-085 / 428-086.
	Некорректный номер карты отправителя/получателя. Код ошибки: 428-087 / 428-088.	Проверьте корректность заполнения карты отправителя/получателя.
	Техническая ошибка. Код ошибки: 428-089.	Сделайте повторный запрос. Если ошибка повторится, подготовьте логи запроса и направьте в службу Технической поддержки Банка.
BUSINESS_LOGIC_ERROR	Ошибка бизнес-логики	Нарушена бизнес-логика запроса. Сведения об ошибке содержатся в атрибуте errorDesc.
	Укажите номер карты или номер телефона получателя перевода. Код ошибки: 428-071.	Для получения размера комиссии необходимо указать данные получателя пмеревода.
	Неверно указана сумма перевода. Код ошибки: 428-072.	Укажите корректную сумму перевода. Она должна быть больше 0.
	Карта получателя совпадает с картой отправителя. Код ошибки: 428-073.	Карта получателя не может совпадать с картой отправителя. Укажите корректные данные перевода.
	Запрещен перевод на карту валютного счета. Код ошибки: 428-074.	Укажите рублевый счет для перевода.
	Не найдены ключи по договору на совершение ERP-переводов. Код ошибки: 428-075.	Сделайте повторный запрос. Если ошибка повторится, подготовьте логи запроса и направьте в службу Технической поддержки Банка.
	Не найден договор на совершение ERP-переводов. Код ошибки: 428-076.	Обратитесь в Банк для заключения договора на совершение ERP-переводов.
	Не удалось определить платформу. Код ошибки: 428-077.	Сделайте повторный запрос. Если ошибка повторится, подготовьте логи запроса и направьте в службу Технической поддержки Банка.
	Проверьте корректность номера телефона. Код ошибки: 428-078.	Указан некорректный номер телефона получателя перевода или клиент с таким номером телефона не найден. Проверьте указанный номер телефона.
	Не удалось определить данные карты отправителя. Код ошибки: 428-080.	Проверьте данные карты, с которой совершается перевод.
	Невозможно произвести зачисление на карту, привязанную к данному номеру телефона. Код ошибки: 428-081.	Невозможно совершить перевод на указанную карту.
	Некорректный номер карты отправителя/получателя. Код ошибки: 428-083.	Проверьте корректность заполнения карты отправителя/получателя.
	Некорректный номер карты отправителя. Код ошибки: 428-084.	Проверьте корректность заполнения карты отправителя.
	Статус карты получателя не допускает возможность перевода. Код ошибки: 428-075.	Невозможно совершить перевод на указанную карту. Возможно, карта закрыта или заблокирована. Уточните данные у получателя.
	Запрещен перевод между картами одного счета. Код ошибки: 428-077.	Нельзя осуществлять перевод между картами одного счета. Укажите корректные данные перевода.
	Не удалось создать заявку на перевод. Код ошибки: 428-080.	Сделайте повторный запрос. Если ошибка повторится, подготовьте логи запроса и направьте в службу Технической поддержки Банка.
	Попробуйте позднее. Код ошибки: 428-081.	Сделайте повторный запрос. Если ошибка повторится, подготовьте логи запроса и направьте в службу Технической поддержки Банка.

Модель
Пример

Наименование	Тип	Обязательность	Описание
{
errorCode	string	optional	Код ошибки,
errorName	string	optional	Название ошибки,
errorDesc	string	optional	Описание ошибки.
}

HTTP/1.1 500 Internal Server Error
Content-Type: application/json;charset=UTF-8
 
{
    "errorCode": "428-073",
    "errorName": "BUSINESS_LOGIC_ERROR",
    "errorDesc": "Карта получателя совпадает с картой отправителя. Код ошибки: 428-073."
}

503 (Service Temporarily Unavailable)

Cause	Message	Description
UNAVAILABLE_RESOURCE_EXCEPTION	Внутренняя ошибка сервера	Сделайте повторный запрос. Если ошибка повторится, подготовьте логи запроса и направьте в службу Технической поддержки Банка.

Модель
Пример

Наименование	Тип	Обязательность	Описание
{
errorCode	string	optional	Код ошибки,
errorName	string	optional	Название ошибки,
errorDesc	string	optional	Описание ошибки.
}

HTTP/1.1 503 Service Temporarily Unavailable
Content-Type: application/json;charset=UTF-8
 
{
  "cause": "UNAVAILABLE_RESOURCE_EXCEPTION",
  "referenceId": "9e209109-4b0d-408c-a2fd-e1983c20a67d",
  "message": "Внутренняя ошибка сервера"
}