गाइड · PayStars

डेवलपर्स के लिए PayStars API: अपने बॉट में Stars और Premium बेचने का पूरा फ़्लो

PayStars REST API शुरू से अंत तक कैसे काम करता है: X-API-Key, यूज़रनेम जाँच, max_usd के साथ USD कोट, आइडेम्पोटेंट ऑर्डर, 409 price_changed त्रुटि और TxId सत्यापन, एक इंटीग्रेशन योजना के रूप में।

प्रकाशित: · अपडेट:

डेवलपर्स के लिए PayStars API: अपने बॉट में Stars और Premium बेचने का पूरा फ़्लो

अपने बॉट, दुकान या ऐप में Telegram Stars और Premium बेचना चाहते हैं? PayStars API आपको एक HTTPS इंटरफ़ेस और वेबसाइट के साथ साझा USD बैलेंस देता है। API संदर्भ दोहराने के बजाय, यह लेख इंटीग्रेशन को शुरू से अंत तक बनाने का तरीका दिखाता है।

एक नज़र में आर्किटेक्चर

आपका सिस्टम तीन काम करता है: USDT से बैलेंस भरता है, कीमत पूछता है और ऑर्डर बनाता है। बाकी सब, Telegram के आधिकारिक खरीद फ़्लो के ज़रिए डिलीवरी सहित, PayStars की ओर होता है।

भागयह क्या करता है
पहुँचX-API-Key हेडर; कुंजियाँ डैशबोर्ड में बनती हैं
बैलेंसUSD, USDT से टॉप-अप (TON, BEP20 या TRC20)
कीमतFragment कीमत × 1.05, सेंट तक ऊपर की ओर पूर्णांकित
सीमाप्रति कुंजी प्रति सेकंड 10 अनुरोध
पारदर्शिताहर पूर्ण ऑर्डर के लिए एक सार्वजनिक TxId

चरण 1: बैलेंस भरें

राशि और चेन ("ton", "bsc" या "trc20") के साथ POST /usd/invoice 30 मिनट तक वैध सटीक राशि लौटाता है। न्यूनतम 0.1 USDT है।

चरण 2: प्राप्तकर्ता की जाँच करें

POST /api/v1/check-username प्राप्तकर्ता की जाँच करता है और अल्पकालिक सत्यापन टोकन लौटाता है। इससे उन यूज़रनेम पर भुगतान रुकता है जो मौजूद नहीं हैं: यदि ग्राहक टाइपो करे, तो कुछ चार्ज होने से पहले आपको पता चल जाता है।

चरण 3: कीमत लें और सीमा लगाएँ

POST /api/v1/usd/quote वर्तमान कीमत (usd) और मार्कअप (markup_percent: 5) लौटाता है। कीमत बाज़ार के अनुसार बदलती है, इसलिए:

  • हर ऑर्डर से पहले नई कोट माँगें;
  • कोट की गई राशि के बराबर max_usd भेजें;
  • हमेशा currency: "USD" भेजें, नहीं तो खाते की सहेजी प्राथमिकता इस्तेमाल होती है।

चरण 4: ऑर्डर बनाएँ

POST /api/v1/stars/buy या /api/v1/premium/buy। हर अनुरोध में Idempotency-Key होना चाहिए, ताकि कनेक्शन टूटने पर दोबारा कोशिश करने से दोहरा चार्ज न हो। कुंजी को ऑर्डर ID के साथ अपने डेटाबेस में सहेजें।

चरण 5: स्थिति ट्रैक करें

GET /api/v1/order/{id} और /api/v1/orders आपको स्थितियाँ और इतिहास देते हैं। ज़्यादातर ऑर्डर मिनटों में डिलीवर हो जाते हैं। पूर्ण ऑर्डर को एक TxId मिलता है, जिसे आप और आपका ग्राहक PayStars के सार्वजनिक लेजर पर जाँच सकते हैं।

त्रुटियों को सही ढंग से संभालना

  • 409 price_changed का मतलब है कि कीमत max_usd से ऊपर चली गई और कुछ भी चार्ज नहीं हुआ। नई कोट लें और ग्राहक को अपडेट कीमत दिखाएँ।
  • रेट सीमा: प्रति सेकंड 10 अनुरोध से ज़्यादा न करें; कतार या बैकऑफ़ जोड़ें।
  • दोबारा कोशिश: हमेशा वही Idempotency-Key दोबारा इस्तेमाल करें।

लाइव करने से पहले

  1. API कुंजी को सर्वर पर्यावरण चर में रखें, कोड में नहीं।
  2. पूरा फ़्लो 50 Stars के छोटे असली ऑर्डर से चलाएँ।
  3. ग्राहकों को उनका TxId दिखाएँ, इससे भरोसा बनता है।

पूरे दस्तावेज़ और त्वरित आरंभ: PayStars Stars API और API के लिए USD कीमत। बॉट में भुगतान के लिए देखें बॉट में डिजिटल सामान का भुगतान केवल Stars में होता है।

सामान्य प्रश्न

क्या कोई सैंडबॉक्स है?

कोई अलग सैंडबॉक्स नहीं है; इंटीग्रेशन के दौरान छोटे असली ऑर्डर (50 Stars) से परीक्षण करें।

कौन सी प्रोग्रामिंग भाषाएँ काम करती हैं?

कोई भी भाषा जो HTTPS अनुरोध कर सके। Python, Node.js और PHP के लिए त्वरित आरंभ उपलब्ध हैं।

बैलेंस कैसे भरें?

TON, BEP20 या TRC20 पर USDT से, न्यूनतम 0.1 USDT; हर इनवॉइस की सटीक राशि 30 मिनट तक वैध रहती है।

स्रोत

USD (USDT) से Stars और Premium खरीदें

API कुंजी से: Fragment मूल्य, 0% (वेबसाइट: 5%)।

शुरू करें

More news

PayStarsउज़्बेकिस्तान में Telegram Stars और Premium: कार्ड से या USDT से भुगतान करेंउज़्बेकिस्तान में Telegram Stars या Premium खरीदना: @StarKerakBot के ज़रिए Uzcard और Humo, paystars.uz/uz/ पर USDT, आधिकारिक ऐप के रास्ते और जानने लायक स्थानीय नियम।पढ़ें →PayStarsप्रतियोगिता के विजेताओं को Telegram Stars या Premium से कैसे पुरस्कृत करें: आयोजक की मार्गदर्शिकाअपने क्विज़, प्रतियोगिता या हैकाथॉन के विजेताओं को Telegram Stars या Premium पहुँचाना: बजट, @usernames जुटाना, PayStars के ज़रिए वितरण, और अनुवर्ती रिपोर्ट।पढ़ें →PayStarsPayStars के आम सवाल: साइन-इन, USDT टॉप-अप, और Stars तथा Premium ऑर्डर के बारे मेंएक पेज पर PayStars के सबसे आम सवाल: Telegram से साइन-इन, USDT (TON, BEP20 या TRC20) से टॉप-अप, Stars और Premium ऑर्डर, डिलीवरी समय, सुरक्षा और API।पढ़ें →