Paid Subscription Memberships: Paywall Gating, Webhook Recurring Subscriptions & InviteMember Bot Architecture

Crucial Security Primitive: The Peril of Static Invite Links

Never, under any circumstances, distribute a static or multi-use invite link to paying subscribers. A static link can be copied, forwarded to public Discord or Reddit forums, or resold on black-market forums. The moment 10 freeloaders join through the same link, your paywall economy collapses. Every single paying member must receive a personalized, dynamic single-use invite link with a hard usage limit of 1.

import time
from telegram import Bot
from telegram.error import TelegramError

BOT_TOKEN = "7123456789:AAF_SECRET_TOKEN_HERE"
VIP_CHANNEL_ID = -1001987654321  # Target Private Channel ID

bot = Bot(token=BOT_TOKEN)

async def issue_single_use_invite(user_id: int, plan_tier: str) -> str:
    """
    Generates a cryptographically randomized, single-use invite link.
    - member_limit = 1: The link self-destructs the millisecond 1 user joins.
    - expire_date = now + 900: Hard 15-minute time-to-live (TTL).
    """
    try:
        ttl_seconds = 900  # 15 minutes
        expire_timestamp = int(time.time()) + ttl_seconds
        link_label = f"Sub_{user_id}_{plan_tier}_{int(time.time())}"

        invite_obj = await bot.create_chat_invite_link(
            chat_id=VIP_CHANNEL_ID,
            name=link_label,
            expire_date=expire_timestamp,
            member_limit=1,               # CRUCIAL: Single-use enforcement
            creates_join_request=False    # Instant entry without admin approval queue
        )

        # Dispatch the link directly to the user's private Telegram chat
        welcome_text = (
            f"🎉 Payment Confirmed! Welcome to {plan_tier} Tier.

"
            f"Click the secure single-use invitation link below to join the channel:
"
            f"{invite_obj.invite_link}

"
            f"⚠️ Note: This link is cryptographically tied to your invoice and "
            f"expires in 15 minutes or upon first use. Do not forward it."
        )
        await bot.send_message(
            chat_id=user_id,
            text=welcome_text,
            parse_mode="HTML"
        )
        return invite_obj.invite_link

    except TelegramError as e:
        print(f"[ERROR] Failed to generate single-use invite: {e}")
        raise e

async def evict_churned_subscriber(user_id: int, reason: str = "Subscription Expired"):
    """
    Executes an atomic 'Kick & Unban' operation.
    Calling ban_chat_member immediately evicts the user from the channel.
    Calling unban_chat_member cleanses them from the channel's Banned List.
    If you don't unban, the user will be permanently blocked from ever resubscribing!
    """
    try:
        # Step 1: Ban removes the user instantly from the chat room
        await bot.ban_chat_member(
            chat_id=VIP_CHANNEL_ID,
            user_id=user_id,
            revoke_messages=False  # Do not delete their chat history in discussions
        )
        print(f"[ACTION] Evicted user {user_id} from channel {VIP_CHANNEL_ID}.")

        # Step 2: Unban immediately cleanses the blacklist
        await bot.unban_chat_member(
            chat_id=VIP_CHANNEL_ID,
            user_id=user_id,
            only_if_banned=True
        )
        print(f"[ACTION] Cleansed ban record for user {user_id}. Ready for future re-subscription.")

        # Step 3: Dispatch polite cancellation notification with reactivation discount
        reconnect_msg = (
            f"ℹ️ Membership Expired

"
            f"Your subscription to VIP Research has expired (Reason: {reason}).
"
            f"To regain immediate access, renew anytime using the button below:"
        )
        await bot.send_message(
            chat_id=user_id,
            text=reconnect_msg,
            parse_mode="HTML"
        )
    except TelegramError as e:
        print(f"[WARN] Eviction warning for {user_id}: {e}")

Frequently Asked Technical Questions (FAQ)