B2B के लिए Telegram Stars API: Stars व Premium बेचें

यदि आपके उत्पाद के पास पहले से ग्राहक, चेकआउट या Telegram ऑडियंस है, तो Telegram डिजिटल उत्पाद बेचने के लिए आपको अलग fulfilment ऑपरेशन बनाने की आवश्यकता नहीं है। MyStars Fulfilment API आपके बैकएंड को Telegram @username तक पहुंचाए जाने वाले Telegram Stars और Telegram Premium के ऑर्डर बनाने और ट्रैक करने देता है।

इसलिए यह रिसेलर, Telegram बॉट और Mini Apps, क्रिएटर प्लेटफ़ॉर्म, गिफ्टिंग सेवाओं, लॉयल्टी प्रोग्राम, एजेंसियों, मार्केटप्लेस और उन उत्पादों के लिए व्यावहारिक है जो हर ग्राहक को मैन्युअल सपोर्ट फ्लो से गुजारे बिना Telegram खरीद जोड़ना चाहते हैं।

Telegram Stars API किसे इस्तेमाल करनी चाहिए?

Telegram Stars API तब इस्तेमाल करें जब Stars या Premium आपके बेचे जाने वाले उत्पाद का हिस्सा हों — न कि अपनी टीम के लिए एक बार की मैन्युअल खरीद के लिए।

सामान्य B2B इम्प्लीमेंटेशन में शामिल हैं:

• रिसेलर स्टोरफ्रंट जो अन्य डिजिटल वस्तुओं के साथ Stars पैक या Premium अवधि बेचते हैं;
• Telegram बॉट और Mini Apps जो username लेते हैं, मौजूदा कोट दिखाते हैं और ऑर्डर को बैकएंड तक भेजते हैं;
• क्रिएटर और कम्युनिटी प्लेटफ़ॉर्म जो सशुल्क पोस्ट, बॉट ऐक्शन या प्रीमियम अनुभव से पहले ऑडियंस को टॉप-अप करने में मदद करते हैं;
• गिफ्ट और लॉयल्टी उत्पाद जो अभियान के पुरस्कार को नामित प्राप्तकर्ता के लिए Telegram Stars या Premium में बदलते हैं;
• एजेंसियां और मैनेज्ड सेवाएं जिन्हें हर क्लाइंट अनुरोध को मैन्युअल रूप से प्रोसेस करने के बजाय दोहराया जा सकने वाला fulfilment फ्लो चाहिए;
• मार्केटप्लेस जिन्हें ऑडिट करने योग्य ऑर्डर रिकॉर्ड और डिलीवरी पूरी होने पर एक इवेंट चाहिए।

API एक fulfilment लेयर है, फ्रंट-एंड विजेट नहीं। ग्राहक अनुभव, उसका चेकआउट और व्यावसायिक नियम आपके उत्पाद के हैं। आपका सर्वर Telegram fulfilment ऑर्डर को कोट करने, वैलिडेट करने, बनाने, भुगतान करने और मिलान करने के लिए MyStars का उपयोग करता है।

MyStars API के जरिए क्या बेचा जा सकता है?

मौजूदा कैटलॉग दो उत्पाद प्रकारों का समर्थन करता है:

• Telegram Stars — ऑर्डर में Stars की मात्रा होती है;
• Telegram Premium — ऑर्डर में महीनों में Premium अवधि होती है।

Stars और Premium खरीदार की अलग जरूरतें पूरी करते हैं, इसलिए इन्हें अपने UI में अलग दिखाएं। Stars क्रिएटर, चैनल, बॉट और डिजिटल वस्तुओं के लिए खर्च किया जा सकने वाला Telegram बैलेंस हैं। Premium एक Telegram अकाउंट के लिए सब्सक्रिप्शन उपहार है। यदि आपका ग्राहक API इंटीग्रेट करने के बजाय Premium प्लान की तुलना कर रहा है, तो उसे Telegram Premium checkout पर भेजें।

क्लाइंट ऐप में पैक आकार, प्लान अवधि, मुद्राएं या कीमतें हार्डकोड न करें। MyStars API documentation लाइव उत्पाद, मुद्रा और मूल्य डेटा उपलब्ध कराती है ताकि आपका कैटलॉग मौजूदा API नियमों का पालन करे।

API के जरिए Telegram Stars कैसे बेचें: B2B fulfilment फ्लो

एक भरोसेमंद इंटीग्रेशन का क्रम छोटा लेकिन सोच-समझकर बनाया गया होता है। ऑर्डर आपके बैकएंड पर बनाया जाता है; ग्राहक को कभी भी API key नहीं दिखनी चाहिए और न ही उसे आपके सर्विस से जुड़े ऑन-चेन भुगतान निर्देश संभालने चाहिए।

1. मौजूदा कैटलॉग और भुगतान मुद्राएं लोड करें। इंटीग्रेशन शुरू होने पर उपलब्ध उत्पादों और मुद्राओं को पढ़ें और उचित शेड्यूल पर उन्हें रिफ्रेश करें। इससे ऐप का पुराना बिल्ड अनुपलब्ध विकल्प नहीं दिखाएगा।
2. लाइव कोट मांगें। चुने गए उत्पाद, मात्रा या अवधि और भुगतान मुद्रा के लिए प्राइसिंग एंडपॉइंट से पूछें। सेटलमेंट के लिए लौटाई गई राशि का ही उपयोग करें; कैश्ड रेट अनुमानों से कीमत न बनाएं।
3. चार्ज करने या ऑर्डर बनाने से पहले प्राप्तकर्ता की जांच करें। प्राप्तकर्ता का Telegram @username और चुना हुआ उत्पाद recipient-check एंडपॉइंट को भेजें। Stars recipient check और Premium eligibility check को एक-दूसरे के बदले नहीं इस्तेमाल किया जा सकता।
4. एक idempotent ऑर्डर बनाएं। चुना गया उत्पाद, प्राप्तकर्ता, भुगतान मुद्रा, वेबहुक उपयोग करने पर callback URL और अपने आंतरिक ऑर्डर ID से जनरेट की गई स्थिर Idempotency-Key भेजें।
5. लौटाए गए भुगतान निर्देश का ठीक-ठीक निपटान करें। ऑर्डर रिस्पॉन्स में डेस्टिनेशन address, amount, memo, chain और expiry होते हैं। आपकी भुगतान सेवा को एप्लिकेशन कॉन्फ़िगरेशन में रखे वॉलेट address या memo के बजाय इन्हीं मानों का सटीक उपयोग करना चाहिए।
6. अंतिम डिलीवरी स्टेटस का मिलान करें। फॉलबैक के लिए order-status एंडपॉइंट को पोल करें, या वेबहुक से अंतिम स्टेटस प्राप्त करें। अपने ग्राहक के ऑर्डर को तभी पूरा मार्क करें जब आपके मिलान के नियम पूरे हों।

यह क्रम B2B Telegram Stars API इंटीग्रेशन को साधारण खरीद लिंक से अलग करता है: हर चरण को आपके उत्पाद की टीम स्टोर, सुरक्षित रूप से रीट्राई, ऑब्ज़र्व और सपोर्ट कर सकती है।

आपके बैकएंड को कौन-सा डेटा रखना चाहिए

आपका डेटाबेस ग्राहक को दिखने वाले ऑर्डर का source of truth है। इतना डेटा रखें कि सपोर्ट को ऑर्डर समझाया जा सके, सुरक्षित ऑपरेशन को फिर से आजमाया जा सके और रहस्य उजागर किए बिना ब्लॉकचेन भुगतान का मिलान किया जा सके।

न्यूनतम रूप से, यह रखें:

• आपका आंतरिक ऑर्डर ID और MyStars ऑर्डर ID;
• उस ऑर्डर को बनाने के लिए इस्तेमाल की गई idempotency key;
• उत्पाद प्रकार, Stars की मात्रा या Premium अवधि और प्राप्तकर्ता username;
• कोट की गई मुद्रा, राशि, chain, expiry और भुगतान memo;
• सेटलमेंट के बाद ऑन-चेन transaction hash;
• आपकी भुगतान स्थिति, MyStars ऑर्डर स्थिति, वेबहुक payload या polling timestamp और अंतिम fulfilment परिणाम।

Idempotency-Key महत्वपूर्ण है क्योंकि वास्तविक सिस्टम रीट्राई करते हैं। POST /v1/orders के बाद नेटवर्क timeout इस बात का प्रमाण नहीं है कि कुछ नहीं हुआ। उसी स्थिर key के साथ रीट्राई करने से आपका बैकएंड एक ही ग्राहक खरीद के लिए दूसरा fulfilment ऑर्डर बनाए बिना रिकवर कर सकता है।

Webhooks, polling और ऑर्डर lifecycle

आपका ग्राहक पहले आपके उत्पाद को भुगतान कर सकता है, जबकि आपकी सेवा बाद में MyStars निर्देश का निपटान करती है। इससे तीन ऑपरेशनल स्टेट बनते हैं जिन्हें भ्रमित नहीं करना चाहिए:

1. ग्राहक ने आपके उत्पाद के लिए भुगतान किया;
2. आपकी सेवा ने MyStars ऑर्डर के लिए ऑन-चेन भुगतान भेजा;
3. MyStars ने Telegram प्राप्तकर्ता तक Stars या Premium पहुंचाया।

ऑर्डर बनने पर इसे payment block और expiry के साथ awaiting_payment के रूप में लौटाया जा सकता है। सेटलमेंट और fulfilment आगे बढ़ने के बाद, आपके सिस्टम को अंतिम परिणाम पाने का भरोसेमंद तरीका चाहिए।

सामान्य डिलीवरी अपडेट के लिए वेबहुक callback का उपयोग करें और रिकवरी पथ के रूप में status polling बनाए रखें। जांचें कि आने वाले वेबहुक अनुरोध आपका बैकएंड संभाल रहा है, उन्हें MyStars ऑर्डर ID से जोड़ें और वेबहुक प्रोसेसिंग को भी idempotent बनाएं। डुप्लिकेट callback को डुप्लिकेट रिवॉर्ड नहीं देना चाहिए, दूसरी रसीद जारी नहीं करनी चाहिए और दूसरा रिफंड वर्कफ़्लो ट्रिगर नहीं करना चाहिए।

भुगतान सेटलमेंट: GRAM (TON) और USDT on TON

MyStars API ऑर्डर GRAM (TON) या USDT (TON) में सेटल किए जा सकते हैं। ये बैकएंड भुगतान ऑपरेशन हैं, ऐसे फ़ील्ड नहीं जिन्हें बिना सोचे क्लाइंट-साइड चेकआउट में कॉपी किया जाए।

हर ऑर्डर के लिए API response से लौटाई गई currency, chain, address, amount, memo और expiry पढ़ें। पिछले ऑर्डर के भुगतान विवरण दोबारा उपयोग न करें। गलत amount, comment, network या expired instruction वाला भुगतान reconciliation में विफल हो सकता है।

वॉलेट signing और API calls को सर्वर साइड पर रखें। X-Api-Key, वॉलेट seed या automated settlement credentials को कभी भी browser bundle, Telegram Mini App, public repository या client log में शामिल न करें।

खरीदार के लिए KYC नहीं: सटीक B2B अर्थ

“खरीदार के लिए KYC नहीं” एक खोज शब्द है, लेकिन इसके लिए सटीक भाषा जरूरी है। इस फ्लो में MyStars fulfilment checkout खरीदार से पहचान दस्तावेज़ अपलोड करने की मांग नहीं करता। इससे उत्पाद अनुभव में रुकावट कम हो सकती है।

Telegram Stars रिसेलर API इंटीग्रेशन के लिए लॉन्च चेकलिस्ट

फीचर को ग्राहकों के लिए दृश्य बनाने से पहले निम्न की जांच करें:

• API key केवल सर्वर-साइड secret management में स्टोर है और बदली जा सकती है;
• उत्पाद और मुद्रा विकल्प hardcoded values के बजाय लाइव API से आते हैं;
• ऑर्डर बनाने और ग्राहक से अंतिम शुल्क लेने से पहले recipient check चलता है;
• हर ऑर्डर की स्थिर आंतरिक ID और idempotency key है;
• भुगतान में उसी ऑर्डर के लिए लौटाया गया सटीक address, amount, memo, chain और expiry उपयोग होता है;
• USDT जहां भी दिखे, केवल TON के रूप में लेबल किया गया है;
• वेबहुक हैंडलिंग इवेंट को verify, correlate, log और सुरक्षित रूप से deduplicate करती है;
• polling छूटे हुए या विलंबित वेबहुक को कवर करती है;
• आपकी सपोर्ट टीम आपके ID, MyStars ऑर्डर ID, प्राप्तकर्ता और transaction hash से ऑर्डर ढूंढ सकती है;
• लॉन्च से पहले रिफंड, फ्रॉड, compliance और ग्राहक संचार के नियम तय हैं।

रिक्वेस्ट फ़ॉर्मैट, response fields, SDK विकल्पों और लाइव API contract के लिए MyStars API documentation को इम्प्लीमेंटेशन का source of truth मानें।

FAQ

क्या मैं अपनी वेबसाइट, बॉट या Mini App के जरिए Telegram Stars बेच सकता हूं?

हां। आपका उत्पाद ग्राहक की पसंद और प्राप्तकर्ता username ले सकता है, जबकि आपका बैकएंड Stars ऑर्डर बनाने और ट्रैक करने के लिए MyStars Fulfilment API का उपयोग करता है। API key और सेटलमेंट ऑपरेशन सर्वर साइड पर रखें।

क्या मैं उसी API से Telegram Premium बेच सकता हूं?

हां। API, महीनों में Premium अवधि वाले अलग उत्पाद प्रकार के रूप में Telegram Premium fulfilment का समर्थन करती है। ऑर्डर बनने से पहले प्राप्तकर्ता की eligibility जांचें, क्योंकि Premium gift की शर्तें Stars recipient checks से अलग हो सकती हैं।

क्या API Stars और Premium के लिए तय मूल्य सूची देती है?

तय सूची पर निर्भर रहने के बजाय लाइव कोट के लिए pricing endpoint का उपयोग करें। चुने गए ऑर्डर के लिए मौजूदा राशि और settlement currency का उपयुक्त स्रोत API response है।

मैं डुप्लिकेट Telegram Stars ऑर्डर से कैसे बचूं?

हर ऑर्डर को अपनी आंतरिक ऑर्डर ID से जुड़ी स्थिर Idempotency-Key के साथ बनाएं। timeout की वजह से server worker रीट्राई करे, तो नई key बनाने के बजाय उसी key का उपयोग करें।

कौन-सा USDT नेटवर्क समर्थित है?

USDT on TON / The Open Network only. किसी दूसरे नेटवर्क पर USDT न भेजें और न उसे संगत settlement method के रूप में दिखाएं।

क्या खरीदार के लिए KYC नहीं होने का अर्थ है कि मेरे व्यवसाय की कोई compliance जिम्मेदारी नहीं है?

नहीं। यह MyStars buyer checkout अनुभव का वर्णन है, आपकी कंपनी की कानूनी, वित्तीय, फ्रॉड, टैक्स, sanctions, consumer-protection या refund जिम्मेदारियों का नहीं।

अपना B2B Telegram fulfilment इंटीग्रेशन शुरू करें

यदि आपके उत्पाद को बड़े पैमाने पर Telegram Stars या Premium बेचने हैं, तो सत्यापित किए जा सकने वाले ऑर्डर lifecycle के आसपास निर्माण करें: लाइव कोट, recipient check, idempotent order creation, सटीक ऑन-चेन settlement और अंतिम वेबहुक या status reconciliation।

MyStars API documentation खोलें और इंटीग्रेशन शुरू करें →

स्रोत और प्रमाण

• MyStars FaaS — Fulfilment API documentation: उत्पाद कैटलॉग, लाइव मूल्य निर्धारण, recipient checks, order creation, API authentication, settlement instructions, status tracking और webhooks।