💎 Инструкция по подключению оплаты Tribute

Полное руководство для гидов TourBot Platform

📋 Содержание

Что такое Tribute

Tribute - это платёжная система для приёма платежей в Telegram, работающая по всему миру.

Для вас это значит:
  • ✅ Туристы оплачивают доступ к туру прямо в боте
  • ✅ Деньги приходят на вашу карту
  • ✅ Автоматическая выдача доступа после оплаты
  • ✅ Комиссия с туриста: 3% (всегда)
  • ✅ Комиссия с гида: первые 30,000₽ БЕЗ комиссии*, потом 10%

*При регистрации по реферальной ссылке

Регистрация в Tribute

Шаг 1: Открыть Tribute бот

Используйте реферальную ссылку для бонуса:

🎁 Регистрация в Tribute с бонусом

Бонус: Первые 30,000₽ платежей БЕЗ комиссии для вас (только 3% с туриста)

Шаг 2: Подключить карту

  1. В @tribute нажмите "Начать"
  2. Следуйте инструкциям для подключения карты
  3. Пройдите верификацию

💡 Важно: После верификации в профиле автора появятся разделы для создания товаров и донатов.

Настройка API ключа и Webhook

⚠️ Делается один раз для всех ваших экскурсий!

API ключ и Webhook настраиваются в мини-аппе TourBot Platform и используются для всех ваших туров.

Шаг 1: Получить API ключ

В Tribute:

  1. Откройте @tribute
  2. Профиль автора → раздел API
  3. Скопируйте API-Ключ

Пример API ключа:

1e46169f-5eac-4480-acd5-95ff5522
⚠️ Не показывайте API ключ никому! Это ваш личный ключ доступа.

Шаг 2: Добавить API ключ в TourBot

В мини-аппе TourBot Platform:

  1. Откройте мини-апп (кнопка "🔧 Настройка" в мастер-боте)
  2. Перейдите в раздел 💎 Tribute
  3. Нажмите 🔄 Заменить ключ
  4. Вставьте скопированный API ключ
  5. Сохраните
✅ Статус изменится на "Подключён" - ключ привязан ко всем вашим турам!

Шаг 3: Настроить Webhook в Tribute

⚠️ КРИТИЧЕСКИ ВАЖНО! Без этого шага платежи не будут обрабатываться.

Что такое Webhook?

Webhook - это адрес, куда Tribute отправляет уведомления о платежах.

Как настроить:

  1. Откройте @tribute
  2. Профиль автора → API
  3. Найдите поле Вебхук
  4. Вставьте этот адрес:
https://tribute-webhook-production-2fa4.up.railway.app/webhook/tribute
  1. Нажмите кнопку копирования или введите вручную
  2. Убедитесь что появилась галочка "✅ Вебхук добавлен в Tribute"
✅ Готово! Теперь все ваши боты будут получать уведомления о платежах.

Создание тарифа в экскурсии

Тариф - это цена и условия доступа к вашему туру. Создаётся отдельно для каждой экскурсии.

Шаг 1: Открыть настройки экскурсии

  1. Откройте мини-апп TourBot Platform
  2. Выберите нужную экскурсию из списка
  3. Перейдите на вкладку 💳 Оплата

Шаг 2: Добавить тариф

Нажмите "+ Добавить тариф" и заполните поля:

1. Цена (число):

  • Пример: 100 для 100₽ или 10€
  • Минимум: 1€ или эквивалент в другой валюте

2. Валюта:

  • RUB (рубли), EUR (евро) или USD (доллары)
  • Выберите кнопкой

3. Уровень доступа:

  • Выберите уровень: 1, 2, 3...
  • Обычно Уровень 1 = основной контент тура

4. Срок доступа (дней):

  • Введите число: 7, 14, 30, 90
  • Этот срок будет указан в описании товара в Tribute
Пример: 
Цена: 100
Валюта: RUB
Уровень: 1
Срок: 15 дней

Результат: Тариф 100₽ → Уровень 1, доступ на 15 дней

После создания тариф появится в списке, но будет неактивен пока не привяжете товар из Tribute.

Создание цифрового товара в Tribute

💡 Важно: Для каждого тарифа создаётся отдельный цифровой товар в Tribute.

Шаг 1: Перейти в раздел товаров

  1. Откройте @tribute
  2. Нажмите Профиль автора
  3. Выберите 📦 Инфопродукты и контент
  4. Нажмите "Создать готовый товар" (синяя кнопка внизу)

Шаг 2: Заполнить данные товара

Валюта и стоимость:

  • Валюта: Та же, что в тарифе (RUB, EUR, USD)
  • Цена: Точно такая же, как в тарифе!
⚠️ Критично: Цена товара должна точно совпадать с ценой тарифа. При различных ценах, турист оплачивает стоимость цифрового товара и получает доступ без проверки совпадения цен.

Название:

  • Пример: Аудиоэкскурсия @avenue_champagne_tour_bot
  • Укажите название бота для понятности

Описание:

  • Пример: Доступ продолжительностью 14 дней
    Экскурсия по улице Avenue de Champagne в городе Эперне, Шампань, Франция.
    Продолжительность около 1 часа.
  • Укажите срок доступа и описание тура

Текст кнопки и обложка:

  • Эти поля не используются при оплате через бота
  • Можете оставить пустыми или заполнить для красоты

Шаг 3: Сохранить и скопировать ссылку

  1. Нажмите "Сохранить"
  2. Товар появится в списке "Готовые"
  3. Откройте созданный товар
  4. Скопируйте веб-ссылку:
https://web.tribute.tg/p/rOS
📋 Скопируйте ссылку целиком! Она понадобится на следующем шаге.

Связывание товара с тарифом

Последний шаг - привязать созданный товар к тарифу в мини-аппе.

В мини-аппе TourBot:

  1. Откройте экскурсию → вкладка 💳 Оплата
  2. Найдите созданный тариф в списке
  3. Нажмите на иконку 💎 Товар напротив тарифа
  4. В открывшемся окне выберите 💳 Оплата картой
  5. Вставьте скопированную веб-ссылку из Tribute:
https://web.tribute.tg/p/rOS
  1. Нажмите "Сохранить"

✅ Готово! Статус тарифа изменится - напротив появится зелёная галочка "Товар".

Теперь туристы могут оплатить доступ через Tribute!

Что видит турист

Процесс покупки доступа:

  1. Запускает бота → /start
  2. Видит публичные блоки (вступление, описание)
  3. Нажимает кнопку "🔓 Получить доступ"
  4. Видит сообщение с ценой: 
    💰 Оплата доступа

Стоимость: 100₽
Доступ: 15 дней

После оплаты доступ появится автоматически.

[Кнопка: 💳 Оплатить]
  5. Нажимает кнопку → открывается страница оплаты Tribute
  6. Вводит данные карты и оплачивает
  7. Получает уведомление в боте: 
    ✅ Оплата получена!

Доступ к туру активирован на 15 дней.
Приятной экскурсии! 🎧
  8. Автоматически получает доступ к защищённым блокам экскурсии

Часто задаваемые вопросы

Q: Сколько стоит подключение?

A: Бесплатно. Комиссии:

Q: Можно ли создать несколько тарифов для одной экскурсии?

A: Да! Например:

Для каждого тарифа создайте отдельный товар в Tribute.

Q: Можно ли использовать один товар Tribute для разных экскурсий?

A: ❌ Нет! Каждой экскурсии - свой товар.

Неправильно:

  • avenue_bot, 100₽ → товар rOS
  • tbilisi_bot, 100₽ → тот же товар rOS ← ❌ Доступ выдастся не туда!

Правильно:

  • avenue_bot, 100₽ → товар rOS
  • tbilisi_bot, 100₽ → товар pXY (отдельный!)

Q: Турист оплатил, но доступ не появился. Что делать?

A: Проверьте:

Если всё верно, но не работает - напишите в поддержку: @natalia_kouz

Q: Как изменить цену тарифа?

A: В мини-аппе:

  1. Откройте экскурсию → 💳 Оплата
  2. Нажмите на иконку ⚙️ (настройки) напротив тарифа
  3. Нажмите ✖️ (удалить)
  4. Создайте новый тариф с нужной ценой
  5. Создайте новый товар в Tribute с новой ценой
  6. Привяжите их

Q: Когда деньги приходят на карту?

A: Согласно правилам Tribute (2 раза в месяц при достижении минимального порога). Подробности: @tribute → Профиль автора → Выплаты.

Q: Что если у меня несколько экскурсий?

A: API ключ и Webhook настраиваются один раз для всех экскурсий. Дальше для каждой экскурсии:

  1. Создаёте тариф в мини-аппе
  2. Создаёте отдельный товар в Tribute
  3. Связываете их

📞 Поддержка

Вопросы по настройке TourBot:

  • Telegram: @natalia_kouz
  • Email: admin@tourbot.online

Вопросы по Tribute (платежи, карты):

  • @tribute → Профиль автора → Поддержка

🎉 Готово!

Теперь ваши экскурсии принимают оплаты через Tribute.

Следующие шаги:

  1. Протестируйте оплату с тестового аккаунта
  2. Проверьте, что доступ выдаётся автоматически
  3. Расскажите туристам о возможности оплаты!

Успешных продаж! 🚀