Метод: remittance
Метод служит для формирования перевода по СБП.
URL
POST https://api-pvk.prostodar.ru/partner/sbp/remittance/
Описание
Метод создает транзацию, затем возвращает идентификатор, созданной транзакции.
Для выполнения запроса необходимо предоставить:
- Авторизационные данные — уникальное имя партнера и API пароль.
- Шифрование данных — использование открытого ключа RSA для безопасной передачи параметров.
Примечание: Убедитесь, что переданные данные корректны и шифруются в соответствии с требованиями API.
Структура запроса
Пример запроса
Формат запроса:
POST https://api-pvk.prostodar.ru/partner/sbp/remittance/ ?id=some_request_id &partnerName=name &partnerPassword=password &useAuthByCert=Y &receiver=79123456789 &sum=100.25 &bic=044525593 &idPerson=idPerson
Параметры запроса
| Параметр | Тип | Описание | Обязательный | Шифрование | |
|---|---|---|---|---|---|
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 | Описание статуса транзакции |
Пример ответа с ошибкой
{
"description_status": "Банк-получатель не может принимать переводы B2C по СБП"
}
Параметры ответа с ошибкой
| Параметр | Тип | Описание |
|---|---|---|
description_status |
string | Описание статуса транзакции |
Возможные ошибки
| Код состояния | Значение description_status |
|---|---|
| 400 | Превышен дневной лимит. |
| 400 | Превышен лимит, установленный для одной операции. |
| 400 | Превышена сумма, доступная на балансе. |
| 400 | Банк-получатель не может принимать переводы B2C по СБП. |
| 400 | Нет идентификатора получателя. Необходимо заполнить person_id. |
| 403 | Пользователь не прошел авторизацию. Доступ к ресурсу ограничен. |
| 422 | При обращении к методу не был указан обязательный реквизит наименование_реквизита, повторите запрос с корректными данными. |
| 422 | Параметр название_параметра ожидается в зашифрованном виде. |
| 422 | Не верный тип данных для ключа sum. |
| 500 | Сервис временно недоступен. Повторите операцию позднее. |