Перейти к содержанию

api/wallet/get-sbp-bank-list - Справочник банков с СБП

  • HTTP‑метод: POST
  • URL: /api/wallet/get-sbp-bank-list
  • Форма взаимодействия: Сервер-сервер
  • Формат тела запроса: application/json
  • Назначение: получение списка банков с кодами НСПК.

URL

1
https://gateway-docs.wallet.kvell.group/api/wallet/get-sbp-bank-list

1
/api/wallet/get-sbp-bank-list

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

Поле Тип Обяз. Описание
terminal str ✔ Уникальный идентификатор учетной записи ТСП в ПЦ.
nonce int ✔ Уникальный номер Запроса. Каждый очередной Запрос должен иметь значение параметра nonce не меньшее, чем в предыдущем Запросе.
signature str ✔ Цифровая подпись запроса. Алгоритм расчёта — см. Формирование подписи.

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

Поле Тип Обяз. Описание
nonce int ✔ Значение nonce из запроса. Пример: 10
data_list DataListResponseDTO ✔ Объект списка банков (см. ниже).
signature str Цифровая подпись ответа. Пример: 8f2a1c9e3b7d4056a1f8c2e9d3b6a70158fce29b4d7a1e6c0938fa2d17bc45e9

Вложенный объект data_list (DataListResponseDTO)

Поле Тип Обяз. Описание
rows list[BankRowResponseDTO] Список банков (см. ниже).

Вложенный объект rows[] (BankRowResponseDTO)

Поле Тип Обяз. Описание
bank_id str ✔ НСПК код банка. Пример: 100000000001
title str ✔ Название банка. Пример: Газпромбанк
latin_title str Название банка на латинице. Пример: Gazprombank

Пример ответов

{
    "nonce": 10,
    "data_list": {
        "rows": [
            {
                "bank_id": "100000000001",
                "title": "Газпромбанк",
                "latin_title": "Gazprombank"
            }
        ]
    },
    "signature": "8f2a1c9e3b7d4056a1f8c2e9d3b6a70158fce29b4d7a1e6c0938fa2d17bc45e9"
}

{
    "error_code": "TERMINAL_NOT_FOUND",
    "technical_message": "Terminal not found",
    "timestamp": 1751976000,
    "details": null,
    "request_id": "b3b3c1f0-4b3a-4f3a-9b1a-1234567890ab"
}

Примечания

  • Параметр nonce не учитывается в логике запроса и не проверяется на валидность последовательности.
  • Поле latin_title может отдаваться пустым — актуальное название следует брать из поля title.