Метод: remittance

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

URL

POST https://api.prostodar.ru/partner/sbp/remittance

Описание

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

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

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

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

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

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

Тело запроса:

{   
  "id":"Smth id",
  "partnerName": "Smth name",
  "partnerPassword": "Smth password",
  "useAuthByCert": "Y",
  "receiver": "79123456789",
  "sum":"100.20",
  "bic":"044525593",
  "idPerson": "Smth id person"
}

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

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

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

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

{
"id": "smth id",
"description_status": "Обработка операции. Требуется уточнение статуса перевода методом status",
}

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

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

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

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

{
"id": "smth id",
"description_status": "Банк-получатель не может принимать переводы B2C по СБП",
}

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

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

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

Код состояния	Значение description_status
400	Превышен дневной лимит.
400	Превышен лимит, установленный для одной операции.
400	Превышена сумма, доступная на балансе.
400	Банк-получатель не может принимать переводы B2C по СБП.
400	Нет идентификатора получателя. Необходимо заполнить person_id.
403	Пользователь не прошел авторизацию. Доступ к ресурсу ограничен.
422	При обращении к методу не был указан обязательный реквизит наименование_реквизита, повторите запрос с корректными данными.
422	Параметр название_параметра ожидается в зашифрованном виде.
422	Не верный тип данных для ключа sum.
500	Сервис временно недоступен. Повторите операцию позднее.