Skip to content

Метод: transfer

Метод служит для формирования перевода на карту по номеру карты.

URL

POST https://api.prostodar.ru/partner/tkb/2card/transfer/

Описание

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

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

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

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

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

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

POST https://api.prostodar.ru/partner/tkb/2card/transfer/ ?partnerName=name &partnerPassword=password &requestId=some_request_id &account=5555555555554444 &sum=1000 &idPerson=idPerson &useAuthByCert=Y

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

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

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

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

{
  "id": "smth id",
  "status": "new",
  "description_status": "Обработка операции. Требуется уточнение статуса перевода методом https://api.prostodar.ru/partner/tkb/2card/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 уже зарегистрирована в системе
401 error Пользователь не прошел авторизацию. Доступ к ресурсу ограничен.
403 error Доступ в систему заблокирован. Обратитесь к сопровождающему вас менеджеру.
403 error Доступ с данного IP адреса заблокирован. Обратитесь к сопровождающему вас менеджеру.
403 error Для данного партнера не доступен данный вид вознаграждения. Обратитесь к сопровождающему вас менеджеру.
422 error Не верный тип данных для ключа sum.
422 error При обращении к методу не был указан обязательный параметр наименование_параметра, повторите запрос с корректными данными.
422 error Параметр наименование _параметра ожидается в зашифрованном виде.
422 error Нет идентификатора получателя. Необходимо заполнить idPerson.
500 error Сервис временно недоступен. Повторите операцию позднее.