Skip to content

Telegram Stars Setup

Telegram Stars is the native payment system built into Telegram, providing seamless payment experience for users.

  1. Enable Stars in BotFather

    • Open @BotFather
    • Select your bot
    • Bot Settings → Payments → Stars
    • Enable Telegram Stars
  2. Configure Prices

    Terminal window
    TELEGRAM_STARS_ENABLED=true
    STARS_PRICE_1=50
    STARS_PRICE_3=120
    STARS_PRICE_6=200
    STARS_PRICE_12=350
  3. Optional: Require Prior Payment

    Terminal window
    REQUIRE_PAID_PURCHASE_FOR_STARS=true

    Forces users to complete card or crypto payment before using Stars.

  4. Restart Bot

    Terminal window
    docker compose down && docker compose up -d
VariableDescription
TELEGRAM_STARS_ENABLEDEnable Stars payments
STARS_PRICE_1Price in Stars for 1 month
STARS_PRICE_3Price in Stars for 3 months
STARS_PRICE_6Price in Stars for 6 months
STARS_PRICE_12Price in Stars for 12 months
REQUIRE_PAID_PURCHASE_FOR_STARSForce prior payment