Skip to content

Метод: status

Метод служит для получения статуса транзакции.

URL

POST https://api.prostodar.ru/partner/tkb/2card/status/

Описание

Метод позволяет получить текущий статус перевода по СБП. Возвращается идентификатор транзакции и ее статус.

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

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

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

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

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

POST https://api.prostodar.ru/partner/tkb/2card/status/ ?partnerName=name &partnerPassword=password &id=123456 &useAuthByCert=Y

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

Параметр Тип Описание Обязательный Шифрование
partnerName int Уникальное имя партнера Да Нет
partnerPassword string Уникальный API пароль партнера Да Да
id string Уникальный идентификатор платежа в системе партнера Да Да
useAuthByCert string Указывает на использование шифрования данных Да Нет

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

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

{
  "id": "smth id",
  "status": "finished",
  "description_status": "Успешно."
}

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

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

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

Возможные ответы, когда статус транзакции не определен

Код состояния status Значение description_status
202 new Обработка операции. Повторите запрос позже.
202 active Обработка операции. Повторите запрос позже.

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

{
  "id": "smth id",
  "status": "",
  "description_status": "Нет операции с таким id"
}

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

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

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

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

Код состояния status description_status
200 error Превышен дневной лимит.
200 error Превышен лимит, установленный для одной операции.
200 error Превышена сумма, доступная на балансе.
200 error Некорректные реквизиты платежа. Проверьте корректность значения.
200 error Некорректные реквизиты платежа. Платежная система не поддерживает перевод на данные реквизиты.
200 error Некорректные реквизиты платежа. Карта просрочена.
200 error Ошибка на стороне api.prostodar обратитесь в техническую поддержку.
200 error Ошибка на стороне платежной системы. Повторите операцию позднее.
400 error Нет операции с таким id
401 error Пользователь не прошел авторизацию. Доступ к ресурсу ограничен.
403 error Доступ в систему заблокирован. Обратитесь к сопровождающему вас менеджеру.
403 error Доступ с данного IP адреса заблокирован. Обратитесь к сопровождающему вас менеджеру.
403 error Для данного партнера не доступен данный вид вознаграждения. Обратитесь к сопровождающему вас менеджеру.
422 error При обращении к методу не был указан обязательный параметр наименование_параметра, повторите запрос с корректными данными.
422 error Параметр наименование _параметра ожидается в зашифрованном виде.
500 error Сервис временно недоступен. Повторите операцию позднее.