Botda Telegram Stars invoysi (XTR): dasturchilar uchun to'lov oqimi bosqichma-bosqich
Bot orqali raqamli tovarni Stars uchun sotish: sendInvoice va XTR valyutasi, pre_checkout_query'ga 10 soniyada javob, successful_payment, charge_id'ni saqlash, forward rejimlari va live ro'yxati.
Chop etilgan:

Botingiz raqamli tovar sotadimi — obuna, kontent, AI so'rovlari yoki o'yin ichidagi narsa? Unda to'lov faqat Telegram Stars'da bo'ladi. Bu maqola Telegram Stars invoysi (XTR) oqimini dasturchi nigohi bilan, rasmiy Bot API hujjati asosida bosqichma-bosqich ko'rsatadi. Nega aynan Stars ekanini bilmoqchi bo'lsangiz: botlarda raqamli tovarlar faqat Stars orqali.
Oqim bir qarashda
| Bosqich | Bot nima qiladi | Telegram nima yuboradi |
|---|---|---|
| 1 | sendInvoice, currency = XTR | — |
| 2 | Kutadi | pre_checkout_query |
| 3 | answerPreCheckoutQuery (10 soniya ichida) | — |
| 4 | Kutadi | successful_payment |
| 5 | charge_id'ni saqlaydi, tovarni yetkazadi | — |
1-bosqich: invoys yaratish
Ikki yo'l bor:
- Bot invoysi — sendInvoice metodi. Raqamli tovar bo'lgani uchun provider_token bo'sh qatorda qoldiriladi, valyuta maydoniga XTR yoziladi. Invoysni shaxsiy chat, guruh yoki kanalga yuborish mumkin.
- Inline invoys — bot inline rejimni qo'llasa, inputInvoiceMessageContent orqali foydalanuvchilar invoysni do'stlari, guruhlari yoki kanallariga ulasha oladi. Bunday invoysning Pay tugmasi bir necha marta ishlatiladi.
2-bosqich: forward xatti-harakatini tanlash
start_parameter parametri belgilaydi:
- Multi-chat invoys — forward qilingan nusxalarda ham Pay tugmasi bor, ko'p foydalanuvchi to'lay oladi. Inline invoyslar doim shunday.
- Single-chat invoys — faqat yuborilgan chatda to'lanadi; forward nusxalarda botga deep link tugmasi chiqadi.
Muhim: bot bilan shaxsiy chatga yuborilgan single-chat invoys faqat bir marta to'lanadi. Har qanday holatda yangi to'lovni qabul qilish yoki qilmaslikni bot hal qiladi.
3-bosqich: pre-checkout
Foydalanuvchi (kerak bo'lsa Stars sotib olib) Pay'ni bosadi. Bot buyurtma ma'lumotlari bilan pre_checkout_query oladi va 10 soniya ichida answerPreCheckoutQuery bilan javob berishi kerak — aks holda tranzaksiya bekor qilinadi. Rad etsangiz, sababini odam tushunadigan tilda yozing: Telegram uni foydalanuvchiga ko'rsatadi.
4–5-bosqich: checkout va yetkazish
To'lov muvaffaqiyatli bo'lsa, successful_payment xabari keladi. Faqat shundan keyin tovarni yetkazing — pre_checkout_query'ga javob berish to'lov bo'lganini kafolatlamaydi. telegram_payment_charge_idni saqlang: qaytarish uchun kerak.
Live'ga chiqishdan oldin
- Bot egasining akkauntida ikki bosqichli tekshiruvni yoqing.
- /terms buyrug'i bilan shartlar, /support va /paysupport bilan qo'llab-quvvatlash.
- Nizolar va qaytarishlar uchun tayyor bo'ling — refundStarPayment. Qaytarish jarayoni: Stars qaytarish va /paysupport.
- Server barqarorligi va to'lov ma'lumotlarining zaxira nusxasi.
Test qanday qilinadi
Telegram'ning maxsus test muhitida Stars to'lovlarini bepul sinash mumkin. Hammasi ishlagach, production muhitiga o'tasiz.
Stars'ni sotib olish tomoni
Foydalanuvchilaringiz Stars'ni ilova ichida yoki @PremiumBot orqali oladi; PayStars esa ularni USDT bilan sotadi. Agar o'z servisingiz uchun Stars'ni avtomatik xarid qilish kerak bo'lsa, PayStars API va API umumiy ko'rinishi yordam beradi.
Ko‘p beriladigan savollar
Stars o'rniga kripto yoki boshqa valyuta qabul qilsam bo'ladimi?
Yo'q. Telegram ilovalari ichidagi raqamli tovar va xizmatlar uchun faqat Stars ishlatiladi.
To'lovni qanday sinab ko'raman?
Botni Telegram'ning maxsus test muhitiga ulab, Stars to'lovlarini bepul sinashingiz mumkin.
Pulni qanday qaytaraman?
Bot API'dagi refundStarPayment metodi orqali.
Manbalar
Foydali sahifalar
Stars va Premium’ni USD (USDT) bilan oling
API kalit orqali: 0% (Fragment narxi). Sayt orqali: 5%.
Boshqa yangiliklar
Telegram Stars botingiz uchun pulni qaytarish siyosatini yozish: namuna va misollarTelegram Stars boti uchun qaytarish siyosati nimalarni qamrashi kerak: shartlar, muddat, /paysupport va refundStarPayment hamda moslashtirsa bo‘ladigan namuna matn.O‘qish →
Akkauntingizga kirish imkonini yo‘qotsangiz, Telegram Stars’ingiz nima bo‘ladiStars telefoningizga emas, Telegram akkauntingizga tegishli. Kirish yo‘qolganda ular nima bo‘lishi, qanday qayta kirish va balansni qanday himoya qilishni bilib oling.O‘qish →
Ijodkor yoki biznes sifatida Telegram Stars daromadi hisobini yuritishTelegram Stars daromadi hisobini qanday toza yuritish: nimani yozish, Fragment orqali yechib olishlarni kuzatish, shaxsiy va biznesni ajratish hamda buxgalterdan nimani so‘rash.O‘qish →