/fintech/api/v2/сorporate-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]{1,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\d{10}$ | 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 | Сообщение, |
| } |
json 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": "Внутренняя ошибка сервера"
}