Метод: rollback
Метод служит для отказа от пополнения мобильного телефона путем выпуска карты.
URL
POST https://api-pvk.prostodar.ru/partner/vc/mobile/rollback/
Описание
Метод служит для отказа от пополнения мобильного телефона. Возможен только до отправки запроса подтверждения выпуска карты.
Примечание: Убедитесь, что переданные данные корректны и шифруются в соответствии с требованиями API.
Структура запроса
Пример запроса
Формат запроса: POST https://api-pvk.prostodar.ru/partner/vc/mobile/rollback/ ?requestId=some_unique_request_id &partnerName=name &partnerPassword=some_unique_password &useAuthByCert=Y &walletId=ZmM2NmYxZjAtNDg2NS00MDlmLTgzZDMtYWY5ZGZjMWNiYjEy
Параметры запроса
| Параметр | Тип | Описание | Обязательный | Шифрование |
|---|---|---|---|---|
partnerName |
string | Уникальное имя партнера | Да | Нет |
partnerPassword |
string | Уникальный API пароль партнера | Да | Да |
requestId |
string | Уникальный ID запроса | Да | Да |
walletId |
string | Идентификатор, полученный из успешного запроса create | Да | Да |
useAuthByCert |
string | Параметр, указывающий на шифрование данных | Да | Нет |
Структура ответа
Пример успешного ответа
{
"status": "OK",
"message":"Request successfully completed"
}
Примечание: Код состояния 200
Параметры успешного ответа
| Параметр | Тип | Описание |
|---|---|---|
status |
string | Статус операции |
message |
string | Текстовое описание результата |
Пример ответа с ошибкой
{
"status": "ACCOUNT_IS_BLOCKED",
"message": "Account is blocked"
}
Параметры ответа с ошибкой
| Параметр | Тип | Описание |
|---|---|---|
status |
string | Статус ошибки |
message |
string | Текстовое описание ошибки |
Возможные ошибки
| status | message | Описание |
|---|---|---|
| PARTNER_LOGIN_IS_NOT_CORRECT | Partner login is not correct | Партнер с таким логином и паролем не найден |
| NOT_VALID_IP_PARTNER | Not valid IP partner | IP партнера некорректен |
| ACCOUNT_IS_BLOCKED | Account is blocked | Аккаунт заблокирован |
| REQUEST_INCORRECTLY | Request incorrectly | Ошибка в шифровании сертификатом |
| SERVICE_UNAVAILABLE | Service unavailable | Сервис временно недоступен |
| NOT_FOUND_REQUEST_BY_WALLET_ID_AND_REQUEST_ID | Not found by wallet Id and request id | Запрос с таким walletId и requestId не найден |
| VALIDATION_ERROR | Missing 'Название параметра' parameter | Не заполнено обязательное поле |
| CARD_NOT_ROLLED_BACK | Card rollback error | Ошибка при отказе от проведения платежа |
| BANK_ERROR | Generic error | Внутренняя ошибка банка |
| BANK_ERROR | Bad request | Ошибка при валидации параметров запроса |
| ALREADY_ISSUED_FOR_THIS_REQUEST | Already issued for this request | По данному запросу уже был получен commit/rollback или был отклонён в связи с неполучением commit. |