Метод: brs_pay
Метод служит для осуществления перевода средств на банковскую карту.
URL
POST https://api.prostodar.ru/partner/brs_pay/
Описание
Метод позволяет выполнить перевод средств на банковскую карту.
Для выполнения запроса требуется передать:
- Параметры транзакции — информацию о карте получателя, сумму перевода и идентификатор запроса.
- Авторизационные данные — уникальное имя партнера и API пароль.
Примечание: Убедитесь, что переданные данные корректны и шифруются в соответствии с требованиями API.
Структура запроса
Пример запроса
Формат запроса:
POST https://api.prostodar.ru/partner/brs_pay/ ?partnerName=name &partnerPassword=password &requestId=some_request_id &card=5555555555554444 &sum=1000 &idPerson=idPerson &useAuthByCert=Y
Параметры запроса
Параметр | Тип | Описание | Обязательный | Шифрование | |
---|---|---|---|---|---|
partnerName |
string | Уникальное имя партнера | Да | Нет | |
partnerPassword |
string | Уникальный API пароль партнера | Да | Да | |
requestId |
string | Уникальный идентификатор запроса ( состоящий из четырёхзначного префикса(выдается при заключении договора) и произвольного буквенно-цифрового идентификатора | Да | Да | |
card |
string | Номер карты для перевода | Да | Да | |
sum |
float | Сумма перевода в рублях | Да | Да | |
idPerson |
string | Уникальный идентификатор лица, в адрес которого осуществлен выпуск вознаграждения | Да, если используется совместно с сервисом верификации ПД | Да | |
useAuthByCert |
string | Указывает на использование шифрования данных | Да | Нет |
Структура ответа
Пример успешного ответа
{
"status": "OK",
"message": "request successfully completed",
"paymentId": "8654854"
}
Параметры успешного ответа
Параметр | Тип | Описание |
---|---|---|
status |
string | Статус прохождения запроса |
message |
string | Текстовое описание результата выполнения запроса |
paymentId |
string | Внешний идентификатор транзакции |
Пример ответа с ошибкой
{
"status": "PARTNER_LOGIN_IS_NOT_CORRECT",
"message": "Partner name or password is not correct"
}
Параметры ответа с ошибкой
Параметр | Тип | Описание |
---|---|---|
status | string | Статус ошибки |
message | string | Текстовое описание ошибки |
Возможные ошибки
Статус | Текстовое описание ошибки | Описание |
---|---|---|
PARTNER_LOGIN_IS_NOT_CORRECT |
Partner name or password is not correct | Партнер с таким логином и паролем не найден |
NOT_VALID_IP_PARTNER |
Partner IP is not correct | IP партнера некорректен |
ACCOUNT_IS_BLOCKED |
Account is blocked | Аккаунт заблокирован |
REQUEST_INCORRECTLY |
Invalid authorization is used | Ошибка в шифровании сертификатом |
REQUEST_ID_ALREADY_EXISTS |
Request id already exists | Запрос с таким идентификатором уже существует |
NO_MONEY |
There are no funds on the balance sheet | Недостаточно средств для операции |
SERVICE_UNAVAILABLE |
Service is temporarily unavailable. | Сервис временно недоступен |
BRS_ERROR |
Attempt to exceed the transfer limit | Попытка превышения лимита переводов (месячный лимит на одну карту 250 000 руб) |
BRS_ERROR |
Transaction to this card is prohibited. | Перевод на данную карту запрещен. |
BRS_ERROR |
Not specified or incorrect paymentid | Не указан или некорректный paymentid |
BRS_ERROR |
Transaction amount not specified or incorrect | Не указана или некорректна сумма операции |
BRS_ERROR |
Invalid card number | Неверный номер карты |
BRS_ERROR |
Bank denied | Отказано банком |
FIELD_IDPERSON_IS_NOT_CORRECT |
The field idPerson must be filled in | Поле idPerson должно быть заполнено. Актуально, когда данный сервис используется совместно с сервисом верификации ПД. |