Быстрый старт

Последовательность действий для выполнения первой операции

В разделе приведена минимальная последовательность шагов, достаточная для проверки работоспособности интеграции.

Шаг 1. Получение токена

Платформа выдаёт мерчанту долгоживущий JWT‑токен с ролью BusinessIntegration. Порядок выдачи и форма обращения описаны в разделе Аутентификация.

В примерах далее токен передаётся через переменную окружения:

export MENU_API_TOKEN="<JWT>"

Шаг 2. Проверка доступности API и валидности токена

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

Ожидаемый ответ — JSON со значением "status": "Success" и блоком data, содержащим текущий баланс мерчанта. Структура ответа описана в разделе Баланс.

Признаки неуспешной проверки и их интерпретация приведены в разделе Ошибки.

Шаг 3. Создание операции приёма платежа

curl -X POST https://api.menu.casino/host2host/payin \
  -H "Authorization: Bearer $MENU_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "paymentMethod": "sbp",
    "idTransactionMerchant": "test-001",
    "amount": 100,
    "clientID": "demo-client",
    "clientIP": "203.0.113.10",
    "clientDateCreated": "2026-05-16T12:00:00Z",
    "integrationMerhcnatData": {
      "webHook": "https://example.com/menu/webhook"
    }
  }'

Поле idTransactionMerchant является идентификатором операции в системе мерчанта. Значение должно быть уникальным в пределах одного мерчанта. Повторное использование значения приводит к ошибке duplicateIdentifier (см. Идемпотентность).

Структура запроса и ответа подробно описана в разделе Host‑to‑host.

Шаг 4. Получение результата операции

Финальный статус операции (success или failed) определяется одним из двух способов.

Способ 1 — webhook. На URL, указанный в integrationMerhcnatData.webHook или в настройках личного кабинета, отправляется HTTP POST с телом операции. Детали — раздел Webhooks.

Способ 2 — опрос статуса:

curl https://api.menu.casino/operation/operation/platform/<UUID> \
  -H "Authorization: Bearer $MENU_API_TOKEN"

Структура ответа описана в разделе Операции.

Значения статусов и допустимые переходы между ними перечислены в разделе Статусы.

Шаг 5. Контрольная проверка перед боевым включением

Перечень обязательных проверок приведён в разделе Тестирование.