Платежные системы
Настройка Tribute
Настройте Tribute для управления подписками
Tribute обеспечивает управление повторяющимися подписками через Telegram с автоматическим продлением.
Критические требования
Заголовок раздела «Критические требования»⚠️ У вас должен быть публичный домен с действительным SSL сертификатом (например, bot.example.com). Вебхуки НЕ будут работать на localhost или частных IP адресах.
Инструкции по настройке
Заголовок раздела «Инструкции по настройке»Шаг 1: Создайте канал Tribute
Заголовок раздела «Шаг 1: Создайте канал Tribute»- Откройте приложение Tribute в Telegram
- Создайте канал
- В “Channels and Groups” → Добавьте ваш канал
- Создайте новую подписку
Шаг 2: Получите ссылку подписки
Заголовок раздела «Шаг 2: Получите ссылку подписки»- В Tribute: Subscription → Links
- Скопируйте “Telegram Link”
- Должна выглядеть так:
https://t.me/tribute/app?startapp=...
Шаг 3: Настройте переменные окружения
Заголовок раздела «Шаг 3: Настройте переменные окружения»TRIBUTE_WEBHOOK_URL=/tribute/webhookTRIBUTE_API_KEY=ваш_api_ключ_из_tributeTRIBUTE_PAYMENT_URL=https://t.me/tribute/app?startapp=...HEALTH_CHECK_PORT=8080Шаг 4: Настройте обратный прокси
Заголовок раздела «Шаг 4: Настройте обратный прокси»Настройте Nginx или Traefik для перенаправления HTTPS запросов боту:8080
server { server_name bot.example.com; listen 443 ssl;
ssl_certificate /путь/к/cert.pem; ssl_certificate_key /путь/к/key.pem;
location / { proxy_pass http://localhost:8080; }}Шаг 5: Перезагрузите бота
Заголовок раздела «Шаг 5: Перезагрузите бота»docker compose down && docker compose up -dШаг 6: Протестируйте вебхук
Заголовок раздела «Шаг 6: Протестируйте вебхук»curl https://bot.example.com/tribute/webhookКак это работает
Заголовок раздела «Как это работает»- Пользователь нажимает кнопку платежа
- Перенаправляется на страницу подписки Tribute
- Пользователь завершает подписку в Telegram
- Tribute отправляет вебхук на ваш бот
- Бот активирует подписку для пользователя
Переменные конфигурации
Заголовок раздела «Переменные конфигурации»| Переменная | Описание |
|---|---|
TRIBUTE_WEBHOOK_URL |
Путь вебхука (например, /tribute/webhook) |
TRIBUTE_API_KEY |
API ключ из настроек Tribute |
TRIBUTE_PAYMENT_URL |
Ссылка подписки из Tribute |
HEALTH_CHECK_PORT |
Порт для вебхука (обычно 8080) |
Получение API ключа
Заголовок раздела «Получение API ключа»- Откройте приложение Tribute
- Settings → API Settings
- Создайте новый API ключ
- Скопируйте и вставьте в
.env
Варианты SSL сертификата
Заголовок раздела «Варианты SSL сертификата»Let’s Encrypt (Бесплатно)
Заголовок раздела «Let’s Encrypt (Бесплатно)»# Используя Certbot с Nginxsudo certbot certonly --standalone -d bot.example.comПоддержка
Заголовок раздела «Поддержка»- Справка Tribute: Встроенная поддержка
- Telegram сообщества: Группы платежей криптовалютой