Telegram Username Phone Mapper Bot

I need a Telegram bot that can take any @username supplied by a user, look up the linked phone number, and return it instantly— but only after the user has enough credits in their balance. Credits are purchased through a UPI payment flow: the user scans a static (or dynamically generated) UPI QR, sends me the payment reference inside the chat, and I approve it manually from an admin panel. Once I mark the transaction as paid, the bot should top-up the user’s balance and let them run further look-ups.

From an operational standpoint I want three core elements built:

• The main lookup engine that securely maps usernames to phone numbers and sends the result back in chat.
• A credit wallet for each user that decrements every time a phone number is revealed and increments only when I approve their UPI payment.
• An admin dashboard that shows pending UPI proofs, lets me click “approve / reject”, and provides a searchable user activity log so I can audit who queried what and when.

All UPI verification will remain manual—there is no need for an automated or third-party integration right now—but the code should keep the hooks modular so I can swap in automation later if desired.

Please build with any mainstream Telegram bot framework (Python + aiogram/pyrogram or Node.js + telegraf are both fine) and keep configuration variables (bot token, database string, UPI details) in a separate .env or config file. Deliver the complete, well-documented source code plus simple setup instructions so I can deploy it on my own VPS.

If this scope is clear and you have prior experience with Telegram bots that handle payments or credit systems, let’s get started.