Метод: banks
Метод служит для получения списка банков, которые могут получать b2C переводы по СБП.
URL
POST https://api.prostodar.ru/partner/sbp/banks/
Описание
Метод позволяет получить список банков, которые могут получать b2C переводы по СБП.
Для выполнения запроса требуется передать:
Авторизационные данные — уникальное имя партнера и API пароль.
Примечание: Убедитесь, что переданные данные корректны и шифруются в соответствии с требованиями API.
Структура запроса
Пример запроса
Формат запроса: POST https://api.prostodar.ru/partner/sbp/banks/?partnerName=name &partnerPassword=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 | Сервис временно недоступен. Повторите операцию позднее. |