Список банков

Возвращает справочник банков, которые поддерживает агрегатор. Используется чтобы узнать, какой code отправлять в поле bank при создании платежа.

Эндпоинт публичный — авторизация не требуется.

Endpoint

GET /v1/public/banks

Ответ

{
  "banks": [
    {
      "code": "alfabank",
      "name": "Альфа-Банк"
    },
    {
      "code": "sberbank",
      "name": "Сбербанк"
    },
    {
      "code": "tinkoff",
      "name": "Т-Банк"
    }
  ]
}

Поля ответа

Поле	Тип	Описание
code	string	Код банка. Передаётся в поле bank при создании платежа.
name	string	Каноническое русское название банка (для отображения).

Возвращаются только активные банки. Список отсортирован по name.

Популярные коды

sberbank, tinkoff, alfabank, vtb, raiffeisenbank, gazprombank, ozon, sovkom, mts, pochta, rncb, home_bank, ros_bank, uralsib, promsvyaz, bank_open, mkb, rencredit, bspb, ak_bars_bank.

Казахстан: kaspi, halyk_bank, jusan_bank, forte.

Полный актуальный список — в ответе эндпоинта.

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

curl https://api.bopay.io/v1/public/banks

Использование при создании платежа

{
  "ext_id": "order_123",
  "amount": 5000,
  "method": "SBP",
  "bank": "alfabank"
}

Если поле bank не передано, банк подбирается автоматически.