Метод: banks

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

---

URL

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

---

Описание

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

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

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

---

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

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

Формат запроса: POST https://api.prostodar.ru/partner/sbp/banks

Тело запроса:

{
  "partnerName": "Smth name",
  "partnerPassword": "Smth password",
  "useAuthByCert": "Y"
}

---

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

Параметр	Тип	Описание	Обязательный	Шифрование
partnerName	string	Уникальное имя партнера	Да	Нет
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": "Сервис временно недоступен. Повторите операцию позднее.",
}

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

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

---

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

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