بوٹس میں Telegram Stars انوائسز (XTR): ڈویلپرز کے لیے ادائیگی کا بہاؤ، قدم بہ قدم
بوٹ میں Stars کے عوض ڈیجیٹل اشیا فروخت کرنا: XTR کے ساتھ sendInvoice، 10 سیکنڈ میں pre_checkout_query کا جواب، successful_payment، چارج ID محفوظ کرنا اور لانچ چیک لسٹ۔
شائع شدہ:

کیا آپ کا بوٹ کچھ ڈیجیٹل فروخت کرتا ہے، جیسے سبسکرپشن، مواد، AI درخواستیں یا گیم کے اندر کی اشیا؟ پھر ادائیگی صرف Telegram Stars میں ہوتی ہے۔ یہ مضمون ڈویلپر کے نقطہ نظر سے Telegram Stars انوائس (XTR) کے بہاؤ کو سرکاری بوٹ API دستاویزات کے مطابق بیان کرتا ہے۔ یہ Stars ہی کیوں ہونا چاہیے، اس کے لیے دیکھیں بوٹس میں ڈیجیٹل اشیا صرف Stars کے ذریعے۔
ایک نظر میں بہاؤ
| قدم | بوٹ کیا کرتا ہے | Telegram کیا بھیجتا ہے |
|---|---|---|
| 1 | currency = XTR کے ساتھ sendInvoice | — |
| 2 | انتظار کرتا ہے | pre_checkout_query |
| 3 | answerPreCheckoutQuery (10 سیکنڈ کے اندر) | — |
| 4 | انتظار کرتا ہے | successful_payment |
| 5 | چارج ID محفوظ کرتا ہے، اشیا فراہم کرتا ہے | — |
قدم 1: انوائس بنائیں
دو طریقے ہیں:
- بوٹ انوائس: sendInvoice طریقہ۔ چونکہ اشیا ڈیجیٹل ہیں، provider_token ایک خالی سٹرنگ ہے اور currency فیلڈ XTR ہے۔ انوائس نجی چیٹ، گروپ یا چینل میں جا سکتی ہے۔
- ان لائن انوائس: اگر آپ کا بوٹ ان لائن موڈ سپورٹ کرتا ہے تو inputInvoiceMessageContent صارفین کو انوائس دوستوں، گروپس اور چینلز کے ساتھ شیئر کرنے دیتا ہے۔ اس کا ادائیگی بٹن کئی بار استعمال ہو سکتا ہے۔
قدم 2: فارورڈنگ کا رویہ منتخب کریں
start_parameter پیرامیٹر اس کو کنٹرول کرتا ہے:
- ملٹی چیٹ انوائس: فارورڈ کی گئی نقول میں ادائیگی کا بٹن رہتا ہے، اس لیے کئی صارفین ادا کر سکتے ہیں۔ ان لائن انوائسز ہمیشہ ملٹی چیٹ ہوتی ہیں۔
- سنگل چیٹ انوائس: صرف اسی چیٹ میں قابل ادائیگی جس میں بھیجی گئی؛ فارورڈ کی گئی نقول میں اس کے بجائے بوٹ کا ڈیپ لنک بٹن دکھتا ہے۔
نوٹ کریں کہ آپ کے بوٹ کے ساتھ نجی چیٹ میں بھیجی گئی سنگل چیٹ انوائس کی ادائیگی صرف ایک بار ہو سکتی ہے۔ دونوں صورتوں میں، آپ کا بوٹ ہمیشہ فیصلہ کرتا ہے کہ نئی ادائیگی قبول کرنی ہے یا نہیں۔
قدم 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 طریقے سے۔
ذرائع
Related pages
USD (USDT) سے Stars اور Premium خریدیں
ویب سائٹ پر درست کل رقم ادائیگی سے پہلے دکھائی جاتی ہے۔ API کلید کے ذریعے: Fragment قیمت، 0% (ویب سائٹ: 5%)۔
More news
اپنے Telegram Stars بوٹ کے لیے ریفنڈ پالیسی لکھنا: سانچہ اور مثالیںTelegram Stars بوٹ کی ریفنڈ پالیسی میں کیا ہونا چاہیے: اہلیت، وقت کی حد، /paysupport اور refundStarPayment، نیز نمونہ الفاظ جنہیں آپ ڈھال سکتے ہیں۔پڑھیں →
اگر آپ اپنے اکاؤنٹ تک رسائی کھو دیں تو آپ کے Telegram Stars کا کیا ہوتا ہےStars آپ کے Telegram اکاؤنٹ کے ہوتے ہیں، فون کے نہیں۔ جانیں کہ رسائی کھونے پر ان کا کیا ہوتا ہے، واپس کیسے داخل ہوں، اور بیلنس کی حفاظت کیسے کریں۔پڑھیں →
تخلیق کار یا کاروبار کے طور پر Telegram Stars کی آمدنی کا ریکارڈ رکھناTelegram Stars کی آمدنی کا صاف ریکارڈ کیسے رکھیں: کیا درج کریں، Fragment سے نکاسی کا حساب، ذاتی اور کاروباری کو الگ کرنا، اور اکاؤنٹنٹ سے کیا پوچھیں۔پڑھیں →