Справочник банков

GET /masterdata/bank/list

Возвращает справочник банков, поддерживаемых платформой. Применяется для формирования значения bankName в запросах POST /host2host/payout.

Запрос

curl https://api.menu.casino/masterdata/bank/list \
  -H "Authorization: Bearer $MENU_API_TOKEN"

Ответ

{
  "status": "Success",
  "data": [
    { "name": "<наименование банка 1>" },
    { "name": "<наименование банка 2>" },
    { "name": "<наименование банка 3>" }
  ],
  "traceID": "0c4a1b8e-3f7d-44e2-9b6c-1d5f8a2e7c11"
}

Фактический состав справочника определяется конфигурацией платформы и доступен по результату вызова эндпойнта в боевой или тестовой среде.

Применение в Pay Out

# Получение справочника и выборка требуемого банка по имени
BANK_NAME=$(curl -s https://api.menu.casino/masterdata/bank/list \
  -H "Authorization: Bearer $MENU_API_TOKEN" \
  | jq -r '.data[] | select(.name == "<наименование из справочника>") | .name')
 
# Использование значения в Pay Out
curl -X POST https://api.menu.casino/host2host/payout \
  -H "Authorization: Bearer $MENU_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d "{
    \"paymentMethod\": \"sbp\",
    \"idTransactionMerchant\": \"withdraw-101\",
    \"amount\": 5000,
    \"number\": \"+79991234567\",
    \"bankName\": \"$BANK_NAME\",
    \"nameMediator\": \"Иван Иванов\",
    \"clientID\": \"user-7af3\",
    \"clientIP\": \"203.0.113.5\",
    \"clientDateCreated\": \"2026-05-16T12:00:00Z\"
  }"

Состав справочника определяется конфигурацией платформы. Отдельные служебные значения исключаются из выдачи на стороне сервера.

Применение

Поле bankName обязательно для операций POST /host2host/payout. Значение должно быть взято из справочника. Передача значения, отсутствующего в справочнике, приводит к одному из двух последствий:

• применение тарифа межбанковского перевода вместо внутрибанковского;
• отклонение операции на стороне провайдера.

Для отдельных банков платформа поддерживает обратную совместимость с устаревшими значениями bankName (синонимами). Перечень действующих синонимов раскрывается через ответственного менеджера. В новых интеграциях применяются только канонические значения из справочника.

Кэширование

Состав справочника изменяется редко. Допускается локальное кэширование результата на стороне мерчанта с периодом обновления до 24 часов.

Состав возвращаемых данных

Справочник содержит только наименования банков. Следующие сведения в составе ответа не возвращаются:

• диапазоны BIN банковских карт;
• графические идентификаторы (логотипы, цвета);
• признаки поддержки конкретных методов оплаты.

Сопоставление BIN банковской карты с банком выполняется на стороне мерчанта.