PayPass connects your Telegram community with real-time blockchain monitoring to manage memberships in a fully decentralized and hands-off way.

The PayPass Architecture

The system relies on three core components working in harmony: the Telegram Bot API, the decentralized blockchain networks (Solana, BNB Chain, and Ethereum), and a high-performance background daemon. By orchestrating these layers, PayPass is able to monitor deposits, verify on-chain transaction hashes, and enforce channel membership states automatically.

🌐
Multi-Chain Verification: The bot maintains dedicated listeners for the Solana, Ethereum, and BNB networks, polling for payment confirmations as soon as a user clicks "Approve" in their WebConnect modal.

Step-by-Step Payment and Join Flow

Here is exactly what happens when a subscriber accesses a PayPass project checkout:

  1. Checkout Session Initialization: The user clicks your PayPass link, opening a secure browser-based checkout screen (optimized for both mobile and desktop).
  2. Web3 Handshake: The subscriber connects their Web3 wallet (Phantom, MetaMask, Trust Wallet, etc.) via the Reown AppKit CDN-loaded SDK.
  3. On-Chain Transaction Approval: The checkout modal prompts the user to sign and submit a transaction containing the exact subscription amount in cryptocurrency.
  4. Decentralized Payout Split: The transaction is executed directly on the blockchain, routing the owner's share (97.5%) to the owner's wallet, and the platform fee (2.5%) to the PayPass address.
  5. Real-Time Payment Verification: The PayPass blockchain scanner identifies the transaction, confirms it is finalized, and notifies the Telegram bot.
  6. Access Provisioning: The bot creates a dynamic, single-use invite link for the user's specific Telegram account. The link expires in 1 hour.
  7. Continuous Expiry Checks: The eviction daemon monitors subscription end dates and safely removes users from the group when their paid period expires.

Automated Evictions

To prevent unpaid members from lingering in your group indefinitely, our cron scheduler runs background tasks every 5 minutes. If a member's subscription is found to be past its expiration timestamp and no renewal payment has been detected, the bot sends an automated kick command to the Telegram API, cleanly removing the user.