भुगतान और बैलेंस

GetMyBot में दो अलग «भुगतान» प्रवाह हैं: प्लेटफ़ॉर्म का अनुरोध बैलेंस (बॉट के काम के लिए) और बॉट के उपयोगकर्ताओं से Telegram के ज़रिए भुगतान स्वीकार करना। बिलिंग सेक्शन (जिसे «भुगतान स्वीकार» भी कहते हैं) plan और बैलेंस प्रबंधित करता है।

बॉट का तरीफ़ा कैसे होता है

प्लेटफ़ॉर्म काम को अनुरोधों में गिनता है: बॉट द्वारा डिलीवर प्रत्येक संदेश अकाउंट के बैलेंस से एक अनुरोध काटता है। बैलेंस एक integer काउंटर है; credits और debits का अपरिवर्तनीय जर्नल (बोनस पर registration, plan credits, टॉप-अप, खपत) truth का स्रोत है।

Plan और बैलेंस

बिलिंग सेक्शन में वर्तमान बैलेंस और उपलब्ध plan दिखते हैं। Plan में नाम, कीमत और अनुरोधों की मात्रा के साथ-साथ सीमाएँ (जैसे, अधिकतम बॉट) होती हैं। चुनें बटन से plan जुड़ता है।

  • बैलेंस — अनुरोधों का वर्तमान शेष (अवलोकन और आँकड़े स्क्रीन पर भी दिखता है)।
  • आँकड़े स्क्रीन पर पूर्वानुमान, दिन वर्तमान खपत पर बैलेंस कितने दिन चलेगा इसका अनुमान लगाता है।

Credits जर्नल (ledger)

अनुरोध बैलेंस एक integer काउंटर है, लेकिन इसका truth स्रोत — ऑपरेशन का अपरिवर्तनीय जर्नल (ledger) है। इसमें बैलेंस का प्रत्येक परिवर्तन दर्ज होता है:

  • Registration बोनस — नए अकाउंट को अनुरोधों की शुरुआती मात्रा।
  • Plan credit — plan जोड़ने पर दिए गए अनुरोध।
  • टॉप-अप — खरीदे गए अनुरोध।
  • खपत — बॉट द्वारा डिलीवर प्रत्येक संदेश के लिए एक अनुरोध काटना।

जर्नल केवल बढ़ता है (पुराने रिकॉर्ड नहीं बदलते), इसलिए खर्च और credits का इतिहास हमेशा मिलाया जा सकता है। वर्तमान बैलेंस जर्नल का योग है।

टॉप-अप

टॉप-अप आवश्यक अनुरोधों की मात्रा के लिए भुगतान बनाता है; provider से पुष्टि के बाद बैलेंस स्वचालित रूप से और idempotently जुड़ता है (duplicate callback दोबारा credit नहीं करेगा)। विशिष्ट payment provider instance के configuration पर निर्भर करता है।

उपयोगकर्ताओं से भुगतान स्वीकार करना (Telegram Payments)

बॉट Telegram भुगतान स्वीकार और रिकॉर्ड कर सकता है:

  • pre_checkout_query अनुरोध स्वचालित रूप से confirm होता है।
  • सफल भुगतान (successful_payment) रिकॉर्ड होता है (राशि, मुद्रा, ऑपरेशन पहचानकर्ता, payload), और फिर रिएक्शन ट्रिगर हो सकती है — जैसे, एक्सेस दें, «paid» लेबल लगाएँ और संग्रह में ऑर्डर दर्ज करें।

सफल भुगतानों की राशि एनालिटिक्स («भुगतान») में दिखती है।

Invoice भेजना (sendInvoice) और निर्माता में «भुगतान स्वीकार» / «नोटिफ़िकेशन» बटन अभी «जल्द» चिह्नित हैं: बॉट इनकमिंग भुगतान रिकॉर्ड करता है, लेकिन वर्तमान संस्करण में रिएक्शन से invoice शुरू नहीं किया जा सकता।

आगे क्या