Rehber · Telegram Stars

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ı:

Botlarda Telegram Stars faturaları (XTR): geliştiriciler için ödeme akışı, adım adım

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ımBotun yaptığıTelegram'ın gönderdiği
1currency = XTR ile sendInvoice—
2Beklerpre_checkout_query
3answerPreCheckoutQuery (10 saniye içinde)—
4Beklersuccessful_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:

  1. Ç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.
  2. 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

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.

Başlayın