Botlarda Telegram Stars faturaları (XTR): geliştiriciler için ödeme akışı, adım adım
Bir botta dijital ürünleri Stars karşılığında satmak: XTR ile sendInvoice, 10 saniyelik pre_checkout_query yanıtı, successful_payment, ödeme kimliğini saklama ve yayın kontrol listesi.
Yayınlandı:

Botunuz abonelik, içerik, yapay zeka istekleri veya oyun içi öğeler gibi dijital bir şey mi satıyor? Ödeme yalnızca Telegram Stars ile yapılır. Bu makale, resmi Bot API belgelerini izleyerek Telegram Stars faturası (XTR) akışını geliştirici bakış açısıyla adım adım anlatır. Neden Stars olması gerektiği için botlarda dijital ürünler yalnızca Stars ile yazısına bakın.
Akışa genel bakış
| Adım | Botun yaptığı | Telegram'ın gönderdiği |
|---|---|---|
| 1 | currency = XTR ile sendInvoice | — |
| 2 | Bekler | pre_checkout_query |
| 3 | answerPreCheckoutQuery (10 saniye içinde) | — |
| 4 | Bekler | successful_payment |
| 5 | Ödeme kimliğini saklar, ürünü teslim eder | — |
1. adım: faturayı oluşturun
İki yol vardır:
- Bot faturası: sendInvoice yöntemi. Ürünler dijital olduğu için provider_token boş bir dizedir ve currency alanı XTR'dir. Fatura özel sohbete, gruba veya kanala gidebilir.
- Satır içi fatura: botunuz satır içi modu destekliyorsa, inputInvoiceMessageContent kullanıcıların faturayı arkadaşlarla, gruplarla ve kanallarla paylaşmasını sağlar. Öde düğmesi birçok kez kullanılabilir.
2. adım: iletme davranışını seçin
Bunu start_parameter parametresi belirler:
- Çok sohbetli fatura: iletilen kopyalar Öde düğmesini korur, böylece birçok kullanıcı ödeme yapabilir. Satır içi faturalar her zaman çok sohbetlidir.
- Tek sohbetli fatura: yalnızca gönderildiği sohbette ödenebilir; iletilen kopyalar bunun yerine bota giden bir derin bağlantı düğmesi gösterir.
Botunuzla özel sohbette gönderilen tek sohbetli bir faturanın yalnızca bir kez ödenebileceğini unutmayın. Her iki durumda da yeni bir ödemeyi kabul edip etmemeye her zaman botunuz karar verir.
3. adım: ön ödeme kontrolü
Kullanıcı (gerekirse önce Stars satın alarak) Öde'ye dokunur. Botunuz sipariş ayrıntılarını içeren bir pre_checkout_query alır ve answerPreCheckoutQuery ile 10 saniye içinde yanıt vermelidir; aksi halde işlem iptal edilir. Reddederseniz insan tarafından okunabilir bir neden verin; Telegram bunu kullanıcıya gösterir.
4–5. adımlar: ödeme ve teslimat
Ödeme başarılı olduğunda bir successful_payment mesajı gelir. Teslimatı ancak o zaman yapmalısınız; çünkü pre_checkout_query yanıtı ödemenin gerçekleştiğini garanti etmez. telegram_payment_charge_id değerini saklayın; iadeler için gerekir.
Yayına almadan önce
- Botu yöneten hesap için iki adımlı doğrulamayı açın.
- Koşulları /terms ile, desteği /support ve /paysupport ile sunun.
- refundStarPayment ile itirazlara ve iadelere hazır olun. Daha fazlası: Stars iadeleri ve /paysupport.
- Sunucuyu kararlı tutun ve ödeme verilerini yedekleyin.
Nasıl test edilir
Telegram'ın özel test ortamı, Stars ödemelerini ücretsiz test etmenizi sağlar. Her şey çalışınca üretime geçin.
Stars satın alma tarafı
Kullanıcılarınız Stars'ı uygulamada veya @PremiumBot üzerinden satın alır; PayStars ise onları USDT karşılığında satar. Kendi hizmetiniz Stars'ı otomatik satın alacaksa, PayStars API ve API özeti bunu kapsar.
SSS
Stars yerine kripto veya başka bir para birimi kabul edebilir miyim?
Hayır. Telegram uygulamalarındaki dijital ürün ve hizmetler yalnızca Stars ile ödenir.
Ödemeleri nasıl test ederim?
Botunuzu Telegram'ın özel test ortamına bağlayın; Stars ödemeleri orada ücretsiz test edilebilir.
İadeyi nasıl yaparım?
Bot API'deki refundStarPayment yöntemiyle.
Kaynaklar
Related pages
Stars ve Premium'u USD (USDT) ile satın alın
API anahtarıyla: Fragment fiyatı, 0% (site: 5%). Site ve Mini Uygulama: Fragment + %5.
More news
Telegram Stars botunuz için iade politikası yazmak: şablon ve örneklerBir Telegram Stars botu için iade politikasının neleri kapsaması gerekir: uygunluk, süre aralığı, /paysupport ve refundStarPayment, ayrıca uyarlayabileceğiniz örnek ifadeler.Oku →
Telegram hesabınıza erişiminizi kaybederseniz Telegram Stars bakiyenize ne olurStars bakiyeniz telefonunuza değil Telegram hesabınıza aittir. Erişimi kaybettiğinizde ne olduğunu, nasıl geri gireceğinizi ve bakiyenizi nasıl koruyacağınızı öğrenin.Oku →
İçerik üreticisi veya işletme olarak Telegram Stars gelirinin kaydını tutmakTelegram Stars gelirinin düzenli kaydını nasıl tutarsınız: neyi kaydetmeli, Fragment çekimlerini izleme, kişisel ve ticari ayrımı ve muhasebeciye ne sormalı.Oku →