Telegram Web App with payment systems, referral program, and personal account

Technical specification for Telegram Web App with subscription system, referral program, and personal account

1. General information:

• Platform: Telegram Web App

• Main goal: Providing access to a closed community through subscription

• Payment system: Lava.top, Apple Pay

• Referral system: 33% reward for a new user

• Trial period: Enter card details and charge after 3 days

2. Main functions:

2.1 Subscription:

• Monthly subscription for access to a closed community

• Integration with Lava.top for payment processing

• Support for Apple Pay for payment through the web app

2.2 Trial period:

• Ability to sign up for a 3-day trial period

• Enter card details or pay with Apple Pay without immediate charge

• Charge after 3 days if the user has not canceled the subscription

2.3 Referral system:

• User receives a 33% reward for each invited new user

• Generation of unique referral links for each user

• Tracking invited users and accrued rewards

2.4 Personal account:

• Display of the number of invited users

• Information about accumulated rewards

• Display of unique referral link

• Ability to ask a question to support

• Withdrawal of funds

• View history of requests and responses from support

2.5 Admin panel:

• User management

• View and process questions from users

• Tracking referral payouts and rewards

2.6 Withdrawal function:

• User can submit a withdrawal request through the personal account. 

• Minimum withdrawal amount: $100

• Withdrawal options: PayPal or USDT

• Request is sent to the administrator for verification and confirmation. Text(Your withdrawal request has been sent. Please wait for a response from support)

Bot structure:

/start

Greeting text (Welcome to Space369. It's a hub where your mind, body and spirit connect, getting top-notch guidance in mindfulness, nutrition, psychology, biohacking, relationships and more, from courses, experts, hanging out with supportive community, all to help you become the best you possible.)

Button “Pay for access” - opens web app with further payment options.

Button “More about the platform” - a presentation of the platform appears in the bot as a file( https://docs.google.com/presentation/d/1sgoOSOR0F6Kr8vfq0_x7xO016xPNUYm-flzfXzynIhI/edit?usp=sharing) 

Button “Personal account”.

Personal Account

Text - Your referral link - ...

Text - Amount of referrals - x

Button - Withdrawal Request:

• Available amount for withdrawal - x

  • Type the amount to withdraw, minimum $100

    • User enters amount

      • If insufficient funds:

        • Insufficient funds for withdrawal

        • [Back to the main menu]

      • If sufficient funds (≥ $100):

        • Select a withdrawal method:

          • [USDT]

          • [PayPal]

        • User selects method

          • Confirmation:

            • The amount of withdrawal - x

            • Withdrawal method - x

            • [Approve withdrawal]

            • [Change info] - (Back to the point when user clicks Withdraw funds button)

            • [Cancel]

    • 
      

  • If approved:

    • Text - “Support will contact you shortly”

    • If canceled Button - [Back to the main menu]

  • Admin receives request:

    • Username

    • Amount

    • Withdrawal method

  Button - Support - transition to private messages (temporarily @sokolov369)  

  - Referral program:

  • Number of invited users

  • Total amount of accumulated rewards. Each month adds $3.30 to the personal account from each invited referral who has not canceled the subscription.

  • Generation and copying of referral link

  
  

  Implementation and support:

  1. Payment integration:

     • Integration with Lava.top and Apple Pay to ensure secure and convenient payments.

  2. Referral system:

     • Reliable system for tracking referral users and automated reward accrual.

  3. Admin bot:

     • Requests from users for fund withdrawals

  4. Deploy

     • Set up deployment on fly.io (account will be provided)

  5. Providing GitHub code for review, followed by confirmation of the deal

  Additional requirements:

  Integration with Firebase

  • Storing user data and requests in Firebase Realtime Database or Firebase Cloud Firestore.

  • All data must be transmitted over secure channels. (rules for firebase database are written)

  Performance

  • Fast bot response (no more than 1 second for main operations).

  • High availability and resilience to loads.

  Scalability

  • Ability to easily scale to increase the number of users and requests.

   Platform

  • Telegram Bot API for bot development.

  • Firebase for data storage.

  Technologies

  • Python for bot development.

  • Firebase Realtime Database or Firebase Cloud Firestore for data storage.

  • Aiogram (highly desirable)

  Figma design, link provided after work begins, photo - https://postimg.cc/QVckyfV3

  
  

  
  

Техническое задание для Telegram Web App с системой подписки, реферальной программой и личным кабинетом

1. Общая информация:

• Платформа: Telegram Web App

• Основная цель: Предоставление доступа к закрытому сообществу через подписку

• Платёжная система: Lava.top, Apple Pay

• Реферальная система: 33% вознаграждение за нового пользователя

• Пробный период: Ввод данных карты и списанием через 3 дня

2. Основные функции:

2.1 Подписка:

• Ежемесячная подписка для доступа к закрытому сообществу

• Интеграция с Lava.top для обработки платежей

• Поддержка Apple Pay для оплаты через веб-приложение

2.2 Пробный период:

• Возможность оформить пробный период на 3 дня

• Ввод данных карты или оплата apple pay без мгновенного списания

• Списание через 3 дня, если пользователь не отменил подписку

2.3 Реферальная система:

• Пользователь получает 33% вознаграждение за каждого привлеченного нового пользователя

• Генерация уникальных реферальных ссылок для каждого пользователя

• Ведение учёта приглашённых пользователей и начисленных вознаграждений

2.4 Личный кабинет:

• Отображение количества приглашённых пользователей

• Информация о накопленных вознаграждениях

• Отображение уникальной реферальной ссылки

• Возможность задать вопрос в поддержку

• Вывод денег

• Просмотр истории запросов и ответов от поддержки

2.5 Админ-панель:

• Управление пользователями

• Просмотр и обработка вопросов от пользователей

• Ведение учёта реферальных выплат и вознаграждений

2.6 Функция вывода денег:

• Пользователь может подать заявку на вывод средств через личный кабинет. 

• Минимальная сумма вывода: $100

• Варианты вывода: PayPal или USDT

• Заявка отправляется администратору для проверки и подтверждения. Текст(Your withdrawal request has been sent. Please wait for a response from support)

Структура бота:

/start

Приветствие текстом (Welcome to Space369. It's a hub where your mind, body and spirit connect, getting top-notch guidance in mindfulness, nutrition, psychology, biohacking, relationships and more, from courses, experts, hanging out with supportive community, all to help you become the best you possible.)

Кнопка “Pay for access” - открывается webapp с дальнейший выбором оплаты.

Кнопка “More about the platform” - в боте появляется презентация платформы файлом( https://docs.google.com/presentation/d/1sgoOSOR0F6Kr8vfq0_x7xO016xPNUYm-flzfXzynIhI/edit?usp=sharing) 

Кнопка “Personal account”.

Personal Account

Text - Your referral link - ...

Text - Amount of referrals - x

Button - Withdrawal Request:

• Available amount for withdrawal - x

  • Type the amount to withdraw, minimum $100

    • User enters amount

      • If insufficient funds:

        • Insufficient funds for withdrawal

        • [Back to the main menu]

      • If sufficient funds (≥ $100):

        • Select a withdrawal method:

          • [USDT]

          • [PayPal]

        • User selects method

          • Confirmation:

            • The amount of withdrawal - x

            • Withdrawal method - x

            • [Approve withdrawal]

            • [Change info] - (Back to the point when user clicks Withdraw funds button)

            • [Cancel]

  • 
    

• If approved:

  • Text - “Support will contact you shortly”

  • If canceled Button - [Back to the main menu]

• Admin receives request:

  • Username

  • Amount

  • Withdrawal method

Button - Support - переход в лс (временно@sokolov369)  

- Реферальная программа:

• Количество приглашённых пользователей

• Общая сумма накопленных вознаграждений. Каждый месяц прибавляет в личный кабинет $3,30, от каждого приглашенного реферала кто не отменил подписку.

• Генерация и копирование реферальной ссылки

Реализация и поддержка:

1. Платёжная интеграция:

   • Интеграция с Lava.top и Apple Pay для обеспечения безопасных и удобных платежей.

2. Реферальная система:

   • Надёжная система учёта реферальных пользователей и автоматизированное начисление вознаграждений.

3. Админ-бот:

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

4. Деплой

   • Настроить деплой на fly.io(аккаунт выдам)

5. Предоставление кода github для проверки, с последующим подтверждением сделки

Дополнительные требования:

Интеграция с Firebase

• Хранение данных пользователей и заявок в Firebase Realtime Database или Firebase Cloud Firestore.

• Все данные должны передаваться по защищенным каналам. (написаны правила для firebase database)

Производительность

• Быстрый отклик бота (не более 1 секунды на основные операции).

• Высокая доступность и устойчивость к нагрузкам.

Масштабируемость

• Возможность легкого масштабирования для увеличения числа пользователей и заявок.

 Платформа

• Telegram Bot API для разработки бота.

• Firebase для хранения данных.

Технологии

• Python для разработки бота.

• Firebase Realtime Database или Firebase Cloud Firestore для хранения данных.

• Aiogram (очень желательно)

Дизайн Figma, ссылку предоставляю после начала работы, фото - https://postimg.cc/QVckyfV3