Skip to content

Шаг 2: Развертывание платежного шлюза Cloudflare Workers

FastTMA следует модели полной безопасности нулевого доверия: клиентская среда WebGL никогда не хранит и не передает токен бота. Формирование счетов на оплату и проверка транзакций производятся через официальный бессерверный шлюз.


Этап 1: Создание Worker в Cloudflare

  1. Войдите в панель Cloudflare Dashboard. В левой панели выберите Compute (Workers & Pages). Меню Workers в Cloudflare

  2. Нажмите Create application, выберите Create Worker и нажмите "Let's start with Hello World!". Создание Worker

  3. Имя и публикация: Введите название воркера (например, fasttma-payment-gateway) и нажмите Deploy в правом нижнем углу. Начальное развертывание


Этап 2: Развертывание исходного кода шлюза

  1. На странице воркера нажмите кнопку Edit code в верхнем правом углу, чтобы открыть Web IDE. Редактирование кода

  2. В проекте Unity найдите и откройте файл Packages/com.fasttma.core/Serverless/cloudflare-worker.js, скопировав весь его исходный код. Копирование worker.js в Unity

  3. В редакторе Cloudflare замените весь код внутри worker.js скопированным содержимым и нажмите Deploy в правом верхнем углу. Вставка кода и Deploy


Этап 3: Настройка секретной переменной BOT_TOKEN

  1. Вернитесь в панель управления воркером, перейдите на вкладку Settings и выберите слева раздел Runtime variables and secrets. Раздел переменных окружения

  2. Нажмите Add variable и заполните параметры:

    • Key: Введите BOT_TOKEN (только заглавными буквами).
    • Value: Вставьте токен Bot API, полученный от @BotFather на шаге 1.
    • Тип: Установите галочку Secret (для шифрования значения). Привязка токена BOT_TOKEN
  3. Нажмите Add 1 variable (или Save and Deploy), чтобы зафиксировать переменную.


Этап 4: Настройка в Unity и проверка соединения

  1. Копирование адреса шлюза: На главной странице воркера скопируйте публичный URL (вида https://fasttma-payment-gateway.<поддомен>.workers.dev). Копирование публичного адреса

Требование к формату

URL-адрес не должен заканчиваться косой чертой (/).

  1. Открытие настроек в Unity: В верхнем меню Unity выберите Edit $\rightarrow$ Project Settings $\rightarrow$ FastTMA (или Tools $\rightarrow$ FastTMA $\rightarrow$ Settings). Настройки FastTMA в Unity

  2. Самовосстановление ассета: Если индикатор Asset Status отображает красный статус Error, нажмите кнопку Create / Rebuild Settings Asset.

  3. Указание адреса шлюза: Вставьте скопированный URL в поле Telegram Pay Url (адрес должен обязательно начинаться с https://).

  4. Тест соединения: Нажмите кнопку Apply справа. Unity выполнит проверочный запрос к шлюзу с 2-секундным жестким тайм-аутом. Проверка подключения

  5. После появления всплывающего окна:

    ✅ Success! The Telegram Pay Gateway is online and reachable.

    Индикатор Asset Status загорится зеленым цветом (Success), подтверждая готовность платежной системы.