Skip to content

Метод: banks

Метод служит для получения списка банков, которые могут получать b2C переводы по СБП.

URL

POST https://api.prostodar.ru/partner/tkb/sbp/banks/

Описание

Метод позволяет получить список банков, которые могут получать b2C переводы по СБП.

Для выполнения запроса требуется передать:
- Авторизационные данные — уникальное имя партнера и API пароль.

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

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

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

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

POST https://api.prostodar.ru/partner/tkb/sbp/banks/ ?partnerName=name &partnerPassword=password &useAuthByCert=Y

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

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

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

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

{
  "banks": [
    {
    "name":"bank_name",
    "bic":"bank_bic"
    },
    {
    "name":"bank_name",
    "bic":"bank_bic"
    },
    {
    "name":"bank_name",
    "bic":"bank_bic"
    }
  ]
}

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

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

Параметр Тип Описание
name string Наименование банка
bic string БИК банка

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

{
  "description_status": "Сервис временно недоступен. Повторите операцию позднее."
}

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

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

Параметр Тип Описание
description_status string Текстовое описание ошибки

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

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