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

Возвращает список доступных банков для приёма платежей.

Endpoint

GET /v1/banks

Ответ

{
  "banks": [
    {
      "code": "sberbank",
      "name": "Sberbank",
      "is_active": true
    },
    {
      "code": "tinkoff",
      "name": "T-Bank",
      "is_active": true
    }
  ]
}

Поля ответа

Поле	Тип	Описание
code	string	Код банка (используется в параметре bank)
name	string	Название банка
is_active	boolean	Доступен ли банк

Российские банки

Код	Название
sberbank	Сбербанк
tinkoff	Т-Банк
alfabank	Альфа-Банк
vtb	ВТБ
raiffeisen	Райффайзен
ozon	Озон Банк

Cross-Border банки

Таджикистан (TJ)

Код	Название
dcbank	DC Bank
agroinvest	Агроинвестбанк
eskhata	Банк Эсхата

Казахстан (KZ)

Код	Название
halyk	Halyk Bank
kaspi	Kaspi Bank
forte	Forte Bank

Узбекистан (UZ)

Код	Название
uzcard	UzCard
humo	HUMO
kapital	Kapitalbank

Кыргызстан (KG)

Код	Название
optima	Optima Bank
demir	Demir Bank
mbank	MBank

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

curl -X GET https://api.settler.pw/api/v1/banks \
  -H "X-Identity: your-api-key" \
  -H "X-Signature: your-signature"

Использование

Обычный платёж с фильтром по банку

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

Cross-Border с фильтром по стране и банку

{
  "ext_id": "order_456",
  "amount": 10000,
  "method": "CROSS_BORDER",
  "country": "TJ",
  "bank": "dcbank"
}

Если банк или страна не указаны, система выберет оптимальный вариант автоматически.