PaidSubscriptionBot

Paid subscription bot using Payments api methods

This example shows how to program a Telegram Bot that charges for its services using the api payments methods.

Run

mkdir build && cd build
cmake .. -DCMAKE_BUILD_TYPE=Release
make -j8
./paid_subscription_bot YOUR_BOT_TOKEN YOUR_PAYMENT_PROVIDER_TOKEN

How to create a new Bot and obtain its private token ?

1. Open the Telegram mobile app and search BotFather
2. Send BotFather a command /newbot
3. Follow instructions to create a new Bot
4. After you finish the instructions, you will receive a Bot Token, make sure you keep it secured.

How to obtain a payment provider token ?

1. Open the Telegram mobile app and search BotFather
2. Send BotFather a command /mybots
3. Click your bot
4. Click Payments
5. Choose your payment provider and follow instructions to get your payment provider token, make sure you keep it secured.

How to test an invoice payment ?

Never use real money to test your Bot invoice payments. Telegram has a testing card which you can use to pay for your testing invoices:
see Testing payments
Simply use card info:
Card number 42 42 42 42 42 42 42 42
CVV any
Expiration Date any

Using this testing card will perform an invoice payment callback to your bot and will trigger the Bot::onPreCheckoutQuery, then you will have to answer to the query in less than 10s with Api::answerPreCheckoutQuery to confirm or deny the payment.

Flowchart

flowchart TD
    User -->|/subscribe| Bot
    Bot --> C{User subscribed already?}
    C -->|Yes| D[Bot::Ignore]
    C -->|No| E[Bot::subscribeNewUser]
    E --> Api::sendInvoice --> User
    User --> PaysForInvoice
    PaysForInvoice-->Bot::onPreCheckoutQuery-->Bot
    Bot-->K{Approve or deny payment}
    K--> |Approve| F[Api::answerPreCheckoutQuery OK = TRUE]
    K--> |Deny| G[Api::answerPreCheckoutQuery OK = FALSE]
    F--> Bot::addUserToSubscribersList
    G--> Bot::sendDenialErrorMessage

Loading

Preview