Qo‘llanma · Telegram Stars

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:

Botda Telegram Stars invoysi (XTR): dasturchilar uchun to'lov oqimi bosqichma-bosqich

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

BosqichBot nima qiladiTelegram nima yuboradi
1sendInvoice, currency = XTR—
2Kutadipre_checkout_query
3answerPreCheckoutQuery (10 soniya ichida)—
4Kutadisuccessful_payment
5charge_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:

  1. Multi-chat invoys — forward qilingan nusxalarda ham Pay tugmasi bor, ko'p foydalanuvchi to'lay oladi. Inline invoyslar doim shunday.
  2. 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

Stars va Premium’ni USD (USDT) bilan oling

API kalit orqali: 0% (Fragment narxi). Sayt orqali: 5%.

Boshlash