How to Build a Telegram Bot That Accepts Crypto Payments in Python

Telegram bots are a powerful way to provide instant services to users, while crypto payments open up a new revenue model with low fees and instant settlement. In this tutorial we’ll show you how to combine Python, the python‑telegram‑bot library, and a popular payment gateway (*CoinPayments* in this example) to build a bot that can accept Bitcoin, Ethereum, and many other coins right inside a chat.

**Why this guide?**

The keyword *python telegram bot crypto payments* appears naturally across the article, and we’ll dive into best‑practice code, security tips, and practical deployment advice that will help you create a production‑ready bot in under two hours.

---

1. Prerequisites

| Skill | Explanation |

|-------|-------------|

| Python 3.10+ | We’ll use asyncio and typed annotations |

| Basic Linux shell | For running the bot locally or on a VPS |

| Git (optional) | Version control |

| A Telegram account | To create a bot & get the token |

| An account with a crypto gateway | CoinPayments, Coinbase Commerce, or similar |

**Python Telegram Bot**: Install the official library with `pip install python-telegram-bot --upgrade`. We use the new `v20` release that supports asynchronous handlers out of the box.

---

2. Create Your Telegram Bot

1. Open Telegram → search for BotFather.

2. Send /newbot and follow the prompts.

3. Copy the bot token – you’ll use it in your code.

4. (Optional) Enable privacy mode to restrict commands to group chats only.

**Tip:** Keep the token in a **`.env`** file and load it with `python-dotenv` to avoid hard‑coding secrets.

# .env
TELEGRAM_TOKEN="123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11"

Example of loading the token:

import os
from dotenv import load_dotenv

load_dotenv()
TOKEN = os.getenv("TELEGRAM_TOKEN")

---

3. Choose a Crypto Payment Gateway

Several providers support instant payment notifications (IPN), which your bot can listen to:

| Provider | Supported Coins | Fees | API Docs |

|----------|-----------------|------|----------|

| CoinPayments | 200+ | 0.5‑1% | https://www.coinpayments.net/_documentation |

| Coinbase Commerce | 30+ | 0.50% | https://commerce.coinbase.com/docs |

| BitPay | 25+ | 1% | https://bitpay.com/docs |

For this tutorial we’ll use CoinPayments because it offers a simple PHP‑style IPN webhook that we’ll emulate with Python.

Requirements for CoinPayments

• Create an account → Go to *API* → Create a new API key with “IPN” and “Allow withdrawals” disabled.
• Set your IPN URL to the endpoint that will validate payments (we’ll build this with Flask, see later).
• Save *Public Key* & *Private Key* – you’ll need them to sign requests and verify incoming IPNs.

---

4. Project Structure

crypto-telegram-bot/
├─ .env
├─ main.py              
├─ handlers.py
├─ payment.py
├─ utils.py
├─ requirements.txt
├─ Dockerfile      (optional)

• main.py starts the bot.
• handlers.py contains command handlers.
• payment.py talks to CoinPayments.
• utils.py centralizes helpers (e.g., IPN signature verification).

---

5. The Bot Logic – Code Walkthrough

5.1. Setting Up the Async Bot

# main.py
from telegram.ext import ApplicationBuilder, CommandHandler
from handlers import start, deposit
from payment import create_payment_request

import logging
import os

logging.basicConfig(
    format="%(asctime)s - %(name)s - %(levelname)s - %(message)s",
    level=logging.INFO,
)

TOKEN = os.getenv("TELEGRAM_TOKEN")

app = (
    ApplicationBuilder()
    .token(TOKEN)
    .read_timeout(10)
    .connect_timeout(10)
    .build()
)

# Commands
app.add_handler(CommandHandler("start", start))
app.add_handler(CommandHandler("deposit", deposit))

# Optional: add a message handler for payment replies
# app.add_handler(MessageHandler(filters.TEXT & ~filters.COMMAND, echo))

app.run_polling()

5.2. Handlers – `start` & `deposit`

# handlers.py
from telegram import Update, InlineKeyboardButton, InlineKeyboardMarkup
from telegram.ext import ContextTypes
from payment import create_payment_request
import datetime

async def start(update: Update, context: ContextTypes.DEFAULT_TYPE):
    await update.message.reply_text(
        "Welcome! I can accept crypto payments. "
        "Send `/deposit` to see how to pay with Bitcoin or Ethereum."
    )

async def deposit(update: Update, context: ContextTypes.DEFAULT_TYPE):
    user = update.effective_user

    # Create a unique order ID per user
    order_id = f"{user.id}-{datetime.datetime.utcnow().timestamp()}"

    # Create a payment request via CoinPayments
    payload = await create_payment_request(
        amount=0.01,  # USD equivalent
        currency="BTC",
        item_name="Telegram Bot Service",
        ipn_url="https://yourdomain.com/ip

---

## Get the Production-Ready Version

Don't want to build it yourself? We have production-ready versions of these tools at [https://petroleum-board-hawaii-lol.trycloudflare.com](https://petroleum-board-hawaii-lol.trycloudflare.com).

**What you get:**
- Complete, tested Python code
- Documentation and setup guides
- Instant delivery after crypto payment
- Free updates

[Browse the collection →](https://petroleum-board-hawaii-lol.trycloudflare.com)