बॉट्स में Telegram Stars इनवॉइस (XTR): डेवलपर्स के लिए भुगतान प्रवाह, चरण दर चरण
बॉट में Stars के बदले डिजिटल वस्तुएँ बेचना: XTR के साथ sendInvoice, 10 सेकंड में pre_checkout_query का जवाब, successful_payment, चार्ज ID सहेजना और लॉन्च जाँच-सूची।
प्रकाशित:

क्या आपका बॉट कुछ डिजिटल बेचता है, जैसे सदस्यता, सामग्री, एआई अनुरोध या खेल के अंदर की वस्तुएँ? तब भुगतान केवल Telegram Stars में होता है। यह लेख आधिकारिक Bot API दस्तावेज़ के अनुसार डेवलपर के नज़रिए से Telegram Stars इनवॉइस (XTR) प्रवाह को समझाता है। यह 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 उपयोगकर्ताओं को इनवॉइस दोस्तों, समूहों और चैनलों के साथ साझा करने देता है। इसका Pay बटन कई बार इस्तेमाल हो सकता है।
चरण 2: अग्रेषण व्यवहार चुनें
इसे start_parameter पैरामीटर नियंत्रित करता है:
- मल्टी-चैट इनवॉइस: अग्रेषित प्रतियों में Pay बटन बना रहता है, इसलिए कई उपयोगकर्ता भुगतान कर सकते हैं। इनलाइन इनवॉइस हमेशा मल्टी-चैट होते हैं।
- सिंगल-चैट इनवॉइस: भुगतान केवल उसी चैट में हो सकता है जहाँ इसे भेजा गया; अग्रेषित प्रतियों में इसके बजाय बॉट का डीप-लिंक बटन दिखता है।
ध्यान दें कि आपके बॉट के साथ निजी चैट में भेजा गया सिंगल-चैट इनवॉइस केवल एक बार चुकाया जा सकता है। दोनों स्थितियों में, नया भुगतान स्वीकार करना है या नहीं, यह हमेशा आपका बॉट तय करता है।
चरण 3: भुगतान-पूर्व जाँच
उपयोगकर्ता (ज़रूरत हो तो पहले Stars खरीदकर) Pay दबाता है। आपके बॉट को ऑर्डर विवरण के साथ 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 भुगतान मुफ़्त में जाँचे जा सकते हैं।
मैं धनवापसी कैसे जारी करूँ?
Bot 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 निकासी को ट्रैक करना, व्यक्तिगत और बिज़नेस को अलग रखना, और अकाउंटेंट से क्या पूछें।पढ़ें →