Skip to content

Метод: transfer

Метод служит для формирования перевода на счет по номеру телефона(СБП).

URL

POST https://api.prostodar.ru/partner/tkb/sbp/transfer/

Описание

Метод создает транзацию, затем возвращает идентификатор, созданной транзакции.

Для выполнения запроса необходимо предоставить:
- Авторизационные данные — уникальное имя партнера и API пароль.
- Шифрование данных — использование открытого ключа RSA для безопасной передачи параметров.

Примечание: Убедитесь, что переданные данные корректны и шифруются в соответствии с требованиями API.

Структура запроса

Пример запроса

Формат запроса:

POST https://api.prostodar.ru/partner/tkb/sbp/transfer/ ?partnerName=name &partnerPassword=password &requestId=some_request_id &receiver=79123456789 &sum=1000 &idPerson=idPerson &useAuthByCert=Y &bic=000000000

Параметры запроса

Параметр Тип Описание Обязательный Шифрование
partnerName string Уникальное имя партнера Да Нет
partnerPassword string Уникальный API пароль партнера Да Да
id string Уникальный идентификатор транзакции на стороне партнера Да Да
receiver string(11) Номер телефона получателя в международном формате Да Да
sum float Сумма перевода в рублях Да Да
idPerson string Уникальный идентификатор лица, в адрес которого осуществлен выпуск вознаграждения Да, если используется совместно с сервисом верификации ПД Да
useAuthByCert string Указывает на использование шифрования данных Да Нет
bic string(9) БИК банка, на счет которого, будет отправлен перевод Да Да

Структура ответа

Пример успешного ответа

{
  "id": "smth id",
  "status": "new",
  "description_status": "Обработка операции. Требуется уточнение статуса перевода методом https://api.prostodar.ru/partner/tkb/sbp/status/."
}

Примечание: Код состояния 202

Параметры успешного ответа

Параметр Тип Описание
id string Идентификатор транзакции в системе партнера
status string Статус транзакции
description_status string Описание статуса транзакции

Пример ответа с ошибкой

{
  "id": "smth id",
  "status": "error",
  "description_status": "Параметр наименование _параметра ожидается в зашифрованном виде."
}

Примечание: Код состояния 422

Параметры ответа с ошибкой

Параметр Тип Описание
id string Идентификатор транзакции в системе партнера
status string Статус транзакции
description_status string Описание статуса транзакции

Возможные ошибки

Код состояния status description_status
400 error Превышен дневной лимит.
400 error Превышен лимит, установленный для одной операции.
400 error Превышена сумма, доступная на балансе.
400 error Транзакция с таким id уже зарегистрирована в системе
400 error Банк-получатель не может принимать переводы B2C по СБП.
401 error Пользователь не прошел авторизацию. Доступ к ресурсу ограничен.
403 error Доступ в систему заблокирован. Обратитесь к сопровождающему вас менеджеру.
403 error Доступ с данного IP адреса заблокирован. Обратитесь к сопровождающему вас менеджеру.
403 error Для данного партнера не доступен данный вид вознаграждения. Обратитесь к сопровождающему вас менеджеру.
422 error При обращении к методу не был указан обязательный параметр наименование_параметра, повторите запрос с корректными данными.
422 error Параметр наименование _параметра ожидается в зашифрованном виде.
422 error Нет идентификатора получателя. Необходимо заполнить idPerson.
422 error Не верный тип данных для ключа sum.
422 error Номер телефона получателя не соответствует формату 79**.
500 error Сервис временно недоступен. Повторите операцию позднее.