Accept Crypto in Telegram Bots & Mini-Apps

Monetize Telegram bots, TON Mini-Apps (TWA), paid communities, AI assistants, and digital downloads with XPayr Dual Checkout — accepting TON, TRON TRC-20 USDT, Solana USDC, and Base at a flat 0.5% fee.

View Bot API Examples GitHub Source & v1.0.0 Developer Docs

Integration Details

Version 1.0.0
Last Updated 2026-11-11
Compatibility Telegram Bot API & WebApps (Node / Python / PHP)
Open-Source Repo v1.0.0 Release
View Bot API Examples

How to monetize Telegram Bots & Mini-Apps

  1. Create an XPayr merchant account and enable TON, TRON USDT, Solana, and EVM wallets
  2. Call POST /api/v1/payments with metadata.telegram_user_id when a user taps Buy in your bot
  3. Open checkout_url inside a Telegram Inline Keyboard WebApp button or external browser
  4. Receive signed HMAC webhook confirmation and unlock VIP group access or credits automatically

5-Step Telegram Bot & Mini-App Setup

  1. Generate your XPayr API key and Webhook Secret in the Merchant Dashboard.
  2. In your Grammy, Telegraf, python-telegram-bot, or aiogram handler, call POST /api/v1/payments passing telegram_user_id and chat_id in metadata.
  3. Return an InlineKeyboardButton with web_app: { url: session.checkout_url } for seamless in-app Dual Checkout UX.
  4. Let mobile users pay via 1-Click Web3 Wallet or copy/scan the Direct Exchange QR for TON and TRON TRC-20 USDT.
  5. On verified payment.completed webhook delivery, call approveChatJoinRequest or credit the user balance in milliseconds.

Why Telegram builders choose XPayr

TON + TRON USDT + Solana

Don't restrict buyers to a single coin — accept TON alongside the world's #1 TRON TRC-20 USDT and Solana USDC.

0.5% vs 30% app-store tax

Keep 99.5% of digital community, SaaS, and creator revenue settled straight to your own wallet.

Mobile Exchange QR ready

Built-in 1% (max $0.50) underpayment tolerance handles Binance, Bybit, and OKX mobile withdrawals cleanly.

Instant VIP & credit unlock

6-second explorer polling + signed HMAC webhooks deliver real-time bot fulfillment without screenshot checks.

Built for Telegram's 950M+ Global Crypto Audience

Telegram bots and Mini-Apps have become the fastest-growing distribution channel for AI tools, trading communities, gaming ecosystems, VPN bots, and creator memberships. XPayr replaces manual "send TxID screenshot to admin" workflows with automated Dual Checkout sessions, supporting TON, TRON USDT, Solana, and EVM chains with instant webhook fulfillment and zero custody risk.

FAQ

Telegram Bot & Mini-App Crypto FAQ

Yes. Pass the returned XPayr checkout_url into Telegram WebApp inline buttons so mobile users complete QR or wallet payments without leaving Telegram.

TRON TRC-20 USDT, Toncoin (TON), Solana USDC/SOL, and BNB Smart Chain BEP-20 USDT account for the vast majority of mobile Telegram checkouts.

Include telegram_user_id and plan_id inside the metadata object when creating the payment session; XPayr echoes that exact metadata in the signed webhook.

Yes. Use sk_test_ API keys and /tools/testnet-checkout-simulator to test your bot end to end before enabling Mainnet.

Monetize your Telegram Bot or Mini-App at 0.5%.

Automate TON, USDT, and USDC memberships with instant webhook fulfillment.

Get Started View All Plugins