Создание заявки на СБП перевод и получение комиссии

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

POST

/v2/corporate-cards/sbp-transfer/commission

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

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

Запрос

• application/json

Body

required

amount

number

required

Возможные значения: >= 1.01

Сумма перевода

externalId

string

required

Возможные значения: <= 255 characters

Идентификатор документа, присвоенный сервисом (UUID)

transferPurpose

string

Возможные значения: <= 100 characters, Value must match regular expression ^[А-Яа-яA-Za-z0-9 -/№:-@\[-{-~]+$`

Назначение платежа

senderInfo objectrequired

Информация об отправителе перевода

businessCardId

string

required

Возможные значения: <= 36 characters

Идентификатор бизнес-карты отправителя

receiverInfo objectrequired

Информация о получателе перевода в запросе

phoneNumber

string

required

Возможные значения: Value must match regular expression ^(79)\d{9}$

Номер телефона

bankName

string

required

Возможные значения: <= 255 characters

Банк получателя

Ответы

• 200
• 400
• 403
• 500

Успешный ответ

• application/json

• Схема
• Пример из схемы

Schema

externalId

string

required

Возможные значения: <= 255 characters

Идентификатор документа, присвоенный сервисом (UUID)

statusTransfer

string

Статус заявки на перевод

transferPurpose

string

Возможные значения: <= 100 characters, Value must match regular expression ^[А-Яа-яA-Za-z0-9 -/№:-@\[-{-~]+$`

Назначение платежа

transferAmount objectrequired

Данные о сумме и валюте

amount

number

required

Сумма перевода

currency

string

required

Возможные значения: [RUR]

transferCommission objectrequired

Данные о сумме и валюте

amount

number

required

Сумма перевода

currency

string

required

Возможные значения: [RUR]

senderInfo objectrequired

Информация об отправителе перевода

cardType

string

Название карты

businessCardId

string

required

Возможные значения: <= 36 characters

Идентификатор бизнес-карты отправителя

account

string

required

Возможные значения: <= 20 characters, Value must match regular expression [0-9]{20}

Номер счета (20-зн.)

receiverInfo objectrequired

Информация о получателе перевода в ответе

phoneNumber

string

required

Возможные значения: Value must match regular expression ^(79)\d{9}$

Номер телефона

lastName

string

Возможные значения: <= 255 characters

Фамилия

firstName

string

Возможные значения: <= 255 characters

Имя

middleName

string

Возможные значения: <= 255 characters

Отчество

bankName

string

required

Возможные значения: <= 255 characters

Банк получателя

{
  "externalId": "9b9f1b57-425e-4aff-9856-21fc4951f1e8",
  "statusTransfer": "string",
  "transferPurpose": "string",
  "transferAmount": {
    "amount": 1000.22,
    "currency": "RUR"
  },
  "transferCommission": {
    "amount": 1000.22,
    "currency": "RUR"
  },
  "senderInfo": {
    "cardType": "string",
    "businessCardId": "string",
    "account": "string"
  },
  "receiverInfo": {
    "phoneNumber": "79268889767",
    "lastName": "string",
    "firstName": "string",
    "middleName": "string",
    "bankName": "СБЕРБАНК"
  }
}

Ошибка бизнес-логики

• application/json

• Схема
• Пример из схемы

Schema

errorCode

string

required

Возможные значения: <= 255 characters

Код ошибки

errorType

string

required

Возможные значения: [VALIDATION_ERROR, UNEXPECTED_SOWA_ERROR, CONTEXT_ERROR, GATEWAY_ERROR, UNEXPECTED_SERVER_ERROR, FORBIDDEN_ERROR, INTEGRATION_ERROR, BUSINESS_LOGIC_ERROR, REQUEST_LIMIT_EXCEED]

errorDesc

string

required

Возможные значения: <= 255 characters

Описание ошибки

requestId

string

Возможные значения: <= 36 characters

Уникальный идентификатор запроса

{
  "errorCode": "string",
  "errorType": "VALIDATION_ERROR",
  "errorDesc": "string",
  "requestId": "string"
}

Нет доступа к услуге / сервису

• application/json

• Схема
• Пример из схемы

Schema

errorCode

string

required

Возможные значения: <= 255 characters

Код ошибки

errorType

string

required

Возможные значения: [VALIDATION_ERROR, UNEXPECTED_SOWA_ERROR, CONTEXT_ERROR, GATEWAY_ERROR, UNEXPECTED_SERVER_ERROR, FORBIDDEN_ERROR, INTEGRATION_ERROR, BUSINESS_LOGIC_ERROR, REQUEST_LIMIT_EXCEED]

errorDesc

string

required

Возможные значения: <= 255 characters

Описание ошибки

requestId

string

Возможные значения: <= 36 characters

Уникальный идентификатор запроса

{
  "errorCode": "string",
  "errorType": "VALIDATION_ERROR",
  "errorDesc": "string",
  "requestId": "string"
}

Внутренняя ошибка сервера

• application/json

• Схема
• Пример из схемы

Schema

errorCode

string

required

Возможные значения: <= 255 characters

Код ошибки

errorType

string

required

Возможные значения: [VALIDATION_ERROR, UNEXPECTED_SOWA_ERROR, CONTEXT_ERROR, GATEWAY_ERROR, UNEXPECTED_SERVER_ERROR, FORBIDDEN_ERROR, INTEGRATION_ERROR, BUSINESS_LOGIC_ERROR, REQUEST_LIMIT_EXCEED]

errorDesc

string

required

Возможные значения: <= 255 characters

Описание ошибки

requestId

string

Возможные значения: <= 36 characters

Уникальный идентификатор запроса

{
  "errorCode": "string",
  "errorType": "VALIDATION_ERROR",
  "errorDesc": "string",
  "requestId": "string"
}

Loading...

Loading...