Telegram BTCPayments Bot (Starter)

This repository now contains a starter Telegram bot that can:

• Start a chat flow (/start)
• Create an account via external API (/create_account)
• Show balance (/balance)

It is designed for the API flow you described (create account + balance section), but keeps API details configurable so we can safely adapt to the real provider docs.

What I need from you

Please provide these items so I can finish production-ready integration:

1. Telegram bot token from @BotFather
2. Final API documentation link (the exact one to implement)
3. Authentication method for API calls
   • API key header name/value? Basic auth? Bearer token?
4. Exact endpoints + request/response samples for:
   • Create account
   • Get balance
5. Required account fields
   • e.g. username, email, phone, password rules, currency
6. Balance behavior
   • Which balance fields should the bot show? available/current/pending?
7. Security preference
   • Should we store user-account mapping in memory only or database?
8. Deployment target
   • VPS, Docker, Railway, Render, etc.

Quick start

python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
cp .env.example .env
# edit .env
python -m bot.main

Environment variables

See .env.example.

Notes

• This starter uses long polling for simplicity.
• Credentials must be kept in .env and never hardcoded.
• Once you provide final API specs, I can wire all fields exactly and add validation/error handling for your provider.