رہنما · Telegram Stars

بوٹس میں Telegram Stars انوائسز (XTR): ڈویلپرز کے لیے ادائیگی کا بہاؤ، قدم بہ قدم

بوٹ میں Stars کے عوض ڈیجیٹل اشیا فروخت کرنا: XTR کے ساتھ sendInvoice، 10 سیکنڈ میں pre_checkout_query کا جواب، successful_payment، چارج ID محفوظ کرنا اور لانچ چیک لسٹ۔

شائع شدہ:

بوٹس میں Telegram Stars انوائسز (XTR): ڈویلپرز کے لیے ادائیگی کا بہاؤ، قدم بہ قدم

کیا آپ کا بوٹ کچھ ڈیجیٹل فروخت کرتا ہے، جیسے سبسکرپشن، مواد، AI درخواستیں یا گیم کے اندر کی اشیا؟ پھر ادائیگی صرف Telegram Stars میں ہوتی ہے۔ یہ مضمون ڈویلپر کے نقطہ نظر سے Telegram Stars انوائس (XTR) کے بہاؤ کو سرکاری بوٹ API دستاویزات کے مطابق بیان کرتا ہے۔ یہ Stars ہی کیوں ہونا چاہیے، اس کے لیے دیکھیں بوٹس میں ڈیجیٹل اشیا صرف Stars کے ذریعے۔

ایک نظر میں بہاؤ

قدمبوٹ کیا کرتا ہےTelegram کیا بھیجتا ہے
1currency = XTR کے ساتھ sendInvoice—
2انتظار کرتا ہےpre_checkout_query
3answerPreCheckoutQuery (10 سیکنڈ کے اندر)—
4انتظار کرتا ہےsuccessful_payment
5چارج ID محفوظ کرتا ہے، اشیا فراہم کرتا ہے—

قدم 1: انوائس بنائیں

دو طریقے ہیں:

  • بوٹ انوائس: sendInvoice طریقہ۔ چونکہ اشیا ڈیجیٹل ہیں، provider_token ایک خالی سٹرنگ ہے اور currency فیلڈ XTR ہے۔ انوائس نجی چیٹ، گروپ یا چینل میں جا سکتی ہے۔
  • ان لائن انوائس: اگر آپ کا بوٹ ان لائن موڈ سپورٹ کرتا ہے تو inputInvoiceMessageContent صارفین کو انوائس دوستوں، گروپس اور چینلز کے ساتھ شیئر کرنے دیتا ہے۔ اس کا ادائیگی بٹن کئی بار استعمال ہو سکتا ہے۔

قدم 2: فارورڈنگ کا رویہ منتخب کریں

start_parameter پیرامیٹر اس کو کنٹرول کرتا ہے:

  1. ملٹی چیٹ انوائس: فارورڈ کی گئی نقول میں ادائیگی کا بٹن رہتا ہے، اس لیے کئی صارفین ادا کر سکتے ہیں۔ ان لائن انوائسز ہمیشہ ملٹی چیٹ ہوتی ہیں۔
  2. سنگل چیٹ انوائس: صرف اسی چیٹ میں قابل ادائیگی جس میں بھیجی گئی؛ فارورڈ کی گئی نقول میں اس کے بجائے بوٹ کا ڈیپ لنک بٹن دکھتا ہے۔

نوٹ کریں کہ آپ کے بوٹ کے ساتھ نجی چیٹ میں بھیجی گئی سنگل چیٹ انوائس کی ادائیگی صرف ایک بار ہو سکتی ہے۔ دونوں صورتوں میں، آپ کا بوٹ ہمیشہ فیصلہ کرتا ہے کہ نئی ادائیگی قبول کرنی ہے یا نہیں۔

قدم 3: پری چیک آؤٹ

صارف (ضرورت ہو تو پہلے Stars خرید کر) ادائیگی پر ٹیپ کرتا ہے۔ آپ کے بوٹ کو آرڈر کی تفصیلات کے ساتھ pre_checkout_query ملتا ہے اور اسے answerPreCheckoutQuery سے 10 سیکنڈ کے اندر جواب دینا ہوتا ہے، ورنہ لین دین منسوخ ہو جاتا ہے۔ اگر آپ انکار کریں تو انسان کے پڑھنے کے قابل وجہ دیں؛ Telegram اسے صارف کو دکھاتا ہے۔

قدم 4–5: چیک آؤٹ اور فراہمی

جب ادائیگی کامیاب ہو تو successful_payment پیغام آتا ہے۔ تب ہی فراہمی کریں، کیونکہ pre_checkout_query کا جواب دینے سے یہ یقینی نہیں ہوتا کہ ادائیگی مکمل ہو گئی۔ telegram_payment_charge_id محفوظ کریں؛ ریفنڈز کے لیے اس کی ضرورت ہوگی۔

لائیو ہونے سے پہلے

  • بوٹ کو کنٹرول کرنے والے اکاؤنٹ کے لیے دو مرحلہ تصدیق آن کریں۔
  • /terms کے ذریعے شرائط فراہم کریں، اور /support اور /paysupport کے ذریعے سپورٹ۔
  • refundStarPayment کے ساتھ تنازعات اور ریفنڈز کے لیے تیار رہیں۔ مزید Stars ریفنڈز اور /paysupport میں۔
  • سرور مستحکم رکھیں اور ادائیگی کے ڈیٹا کا بیک اپ لیں۔

جانچ کیسے کریں

Telegram کا مخصوص ٹیسٹ ماحول آپ کو Stars کی ادائیگیاں مفت جانچنے دیتا ہے۔ جب سب کچھ کام کرے تو پروڈکشن پر جائیں۔

Stars خریدنے والا پہلو

آپ کے صارفین ایپ میں یا @PremiumBot کے ذریعے Stars خریدتے ہیں، اور PayStars انہیں USDT کے بدلے فروخت کرتا ہے۔ اگر آپ کی اپنی سروس کو خودکار طور پر Stars خریدنے کی ضرورت ہو تو PayStars API اور API کا جائزہ اس کا احاطہ کرتے ہیں۔

عمومی سوالات

کیا میں Stars کے بجائے کرپٹو یا کوئی اور کرنسی قبول کر سکتا ہوں؟

نہیں۔ Telegram ایپس کے اندر ڈیجیٹل اشیا اور خدمات کی ادائیگی صرف Stars میں ہوتی ہے۔

میں ادائیگیوں کی جانچ کیسے کروں؟

اپنے بوٹ کو Telegram کے مخصوص ٹیسٹ ماحول سے جوڑیں، جہاں Stars کی ادائیگیاں مفت جانچی جا سکتی ہیں۔

میں ریفنڈ کیسے جاری کروں؟

بوٹ API میں refundStarPayment طریقے سے۔

ذرائع

USD (USDT) سے Stars اور Premium خریدیں

ویب سائٹ پر درست کل رقم ادائیگی سے پہلے دکھائی جاتی ہے۔ API کلید کے ذریعے: Fragment قیمت، 0% (ویب سائٹ: 5%)۔

شروع کریں