Abesha Pay — Telegram Top-Up Bot (Val Town Edition)

A serverless Telegram bot for selling Free Fire Diamonds and PUBG Mobile UC to Ethiopian customers via Telebirr/CBE payment with manual admin approval.

Ported from Node.js + Telegraf → Deno + grammY + Val Town's serverless runtime

Quick Setup

1. Set your Telegram Bot Token

You already have TELEGRAM_API_TOKEN set. If not:

👉 Add TELEGRAM_API_TOKEN here: https://www.val.town/x/abeniandela/abesha-pay-bot/environment-variables?key=TELEGRAM_API_TOKEN

Get it from @BotFather.

2. Set your Admin Telegram ID

Your numeric ID (get from @userinfobot):

👉 Add ADMIN_TELEGRAM_ID here: https://www.val.town/x/abeniandela/abesha-pay-bot/environment-variables?key=ADMIN_TELEGRAM_ID

Replace 0 with your actual ID (e.g., 123456789).

3. Set Payment Details

Update these with your actual accounts:

👉 Add TELEBIRR_NUMBER here: https://www.val.town/x/abeniandela/abesha-pay-bot/environment-variables?key=TELEBIRR_NUMBER

👉 Add CBE_ACCOUNT_NUMBER here: https://www.val.town/x/abeniandela/abesha-pay-bot/environment-variables?key=CBE_ACCOUNT_NUMBER

👉 Add ACCOUNT_HOLDER_NAME here: https://www.val.town/x/abeniandela/abesha-pay-bot/environment-variables?key=ACCOUNT_HOLDER_NAME

4. Optional: UID Verification APIs

To auto-verify Free Fire / PUBG UIDs (optional — defaults to manual verification):

👉 Add FREEFIRE_LOOKUP_URL here: https://www.val.town/x/abeniandela/abesha-pay-bot/environment-variables?key=FREEFIRE_LOOKUP_URL

👉 Add PUBG_LOOKUP_URL here: https://www.val.town/x/abeniandela/abesha-pay-bot/environment-variables?key=PUBG_LOOKUP_URL

If you don't set these, the bot will flag UIDs as "⚠️ unverified, please confirm manually" in the admin panel.

How It Works

Customer Flow

Start → pick language (English 🇬🇧 / Amharic 🇪🇹)
Category → Free Fire or PUBG
Catalog → add up to 2 items to cart
Checkout → enter UID for each game → auto-verified or flagged for manual check
Payment info → payer name + phone
Screenshot → upload payment receipt
Order created → customer gets order #, can check status anytime with /status

Admin Flow

Receives every order as a photo with full details: items, UIDs, total, payer name, phone
Two buttons: ✅ Approve & Complete / ❌ Reject
Customer receives notification (in their language) when order is completed or rejected

Database

Val Town's SQLite (project-scoped) stores:

users — Telegram ID, username, language preference
orders — cart, UIDs, payment details, status
sessions — checkout state (persists across serverless invocations)

No persistent in-memory state — all checkout progress is saved to the database so restarts don't interrupt customers.

Differences from Node.js version

Node.js (original)	Val Town (Deno)
Telegraf	grammY
`better-sqlite3` (sync)	`std/sqlite` (async)
Long polling (`bot.launch()`)	Webhook via HTTP handler
In-memory `Map` for sessions	SQLite `sessions` table
`require()`	ES modules + `https://` imports
`.env` file	Deno.env + Val Town UI

Files

index.ts — main HTTP handler, all Telegram callbacks, webhook setup
catalog.ts — Free Fire & PUBG items (prices in ETB)
i18n.ts — English & Amharic strings, templating
lookupService.ts — optional UID lookup (Free Fire / PUBG)
db.ts — SQLite schema + query helpers

Webhook

On first request to the HTTP endpoint, the bot automatically sets the Telegram webhook to your val's URL. No manual setup needed — just save your Telegram token and you're live.

Next Steps

Set ADMIN_TELEGRAM_ID to your numeric ID
Update TELEBIRR_NUMBER, CBE_ACCOUNT_NUMBER, ACCOUNT_HOLDER_NAME
(Optional) Add FREEFIRE_LOOKUP_URL and PUBG_LOOKUP_URL for auto-verification
Test: message your bot /start and go through the flow
Edit prices in catalog.ts anytime (live redeployment)

Docs

grammY — Telegram bot framework for Deno
Val Town SQLite
Telegram Bot API