Метод: brs_check
Метод служит для уточнения параметра paymentId
. Необходим, если процессинг не отдал ответ при платеже или система партнера не получила его.
URL
POST https://api.prostodar.ru/partner/brs_check/
Описание
Метод возвращает внешний идентификатор транзакции (paymentId
), который был сформирован для запроса с указанным requestId
.
Для выполнения запроса необходимо предоставить:
- Авторизационные данные — уникальное имя партнера и API пароль.
- Шифрование данных — использование открытого ключа RSA для безопасной передачи параметров.
> Примечание: Перед отправкой убедитесь, что ваш IP-адрес добавлен в список доверенных и все параметры корректно зашифрованы.
Структура запроса
Пример запроса
Формат запроса:
POST https://api.prostodar.ru/partner/brs_check/? partnerName=name &partnerPassword=password &requestId=some_request_id &useAuthByCert=Y
Параметры запроса
Параметр | Тип | Описание | Обязательный | Шифрование | |
---|---|---|---|---|---|
partnerName |
string | Уникальное имя партнера | Да | Нет | |
partnerPassword |
string | Уникальный API пароль партнера | Да | Да | |
requestId |
string | Уникальный идентификатор запроса | Да | Да | |
useAuthByCert |
string | Указывает на использование шифрования данных | Да | Нет |
Структура ответа
Пример успешного ответа
{
"status": "OK",
"paymentId": "8654854"
}
Параметры успешного ответа
Параметр | Тип | Описание |
---|---|---|
status |
string | Статус прохождения запроса |
paymentId |
string | Внешний идентификатор транзакции, связанный с requestId |
Пример ответа с ошибкой
{
"status": "REQUEST_INCORRECTLY",
"message": "Invalid authorization is used"
}
Параметры ответа с ошибкой
Параметр | Тип | Описание |
---|---|---|
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 |
Ошибка банка. Подробнее о причинах отмены платежа: Таблица причин отмены платежа |