Создание заявки на перевод с карты на карту и расчет комиссии из ERP-системы клиента

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

POST

/v2/corporate-cards/transfer/commission

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

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

Запрос

• application/json

Body

required

amount

number

required

Сумма (перевода, платежа и т.д.)

externalId

string

required

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

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

transferPurpose

string

required

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

Назначение перевода

senderInfo objectrequired

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

businessCardId

string

required

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

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

receiverInfo objectrequired

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

phoneNumber

string

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

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

encryptedCardNumber

string

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

Зашифрованный номер карты

Ответы

• 200
• 400
• 403
• 500

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

• application/json

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

Schema

externalId

string

required

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

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

transferPurpose

string

required

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

Назначение перевода

transferAmount objectrequired

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

amount

number

required

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

currency

string

required

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

transferCommission objectrequired

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

amount

number

required

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

currency

string

required

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

senderInfo objectrequired

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

businessCardId

string

required

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

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

receiverInfo objectrequired

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

phoneNumber

string

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

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

encryptedCardNumber

string

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

Зашифрованный номер карты.

Не допускается передача номера карты получателя в открытом виде, значение номера карты должно быть зашифровано.

Номер карты перед шифрованием не должен содержать пробелов и спецсимволов. Зашифруйте получившуюся строку, используя алгоритм RSA шифрования "RSA/OAEP" с ключом длиной 2048.

Получите публичный ключ методом /fintech/api/v2/corporate-cards/transfer/public-key.

lastName

string

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

Фамилия

firstName

string

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

Имя

middleName

string

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

Отчество

bankName

string

required

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

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

organizationName

string

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

Наименование организации получателя

{
  "externalId": "9b9f1b57-425e-4aff-9856-21fc4951f1e8",
  "transferPurpose": "string",
  "transferAmount": {
    "amount": 1000.22,
    "currency": "RUR"
  },
  "transferCommission": {
    "amount": 1000.22,
    "currency": "RUR"
  },
  "senderInfo": {
    "businessCardId": "string"
  },
  "receiverInfo": {
    "phoneNumber": "79268889767",
    "encryptedCardNumber": "HlaeIHXXEcGT1bFxo1NlpAzpr+kJ2IQrcxVdvDTep6xjsmD1FDb+6NIyLT",
    "lastName": "string",
    "firstName": "string",
    "middleName": "string",
    "bankName": "СБЕРБАНК",
    "organizationName": "ПАО ВСПЫШКА"
  }
}

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

• 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...