बिलिंग और उपयोग

बिलिंग संगठन के स्तर पर होती है: आपके प्रोडक्ट प्लान, वॉलेट और इनवॉइस संगठन के होते हैं। यह पेज बताता है कि बिलिंग किसी इंटीग्रेशन को कैसे प्रभावित करती है: उपयोग की मीटरिंग कैसे होती है, मौजूदा स्थिति कैसे पढ़ें, और आपके प्लान परिचालन सीमाओं को कैसे प्रभावित करते हैं। खाते से जुड़े कामों (कीमत का विवरण, भुगतान के तरीके, टैक्स) के लिए नॉलेज बेस देखें: प्लान और कीमतें और उपयोग, खर्च और इनवॉइस।

बिलिंग लोग संभालते हैं, इंटीग्रेशन नहीं। हर बिलिंग कार्रवाई के लिए org:billing स्कोप चाहिए। यह संगठन-भूमिका का स्कोप है, जिसे वर्कस्पेस API कुंजी को नहीं दिया जा सकता, इसलिए कोई भी bk_* कुंजी उपयोग नहीं पढ़ सकती, वॉलेट टॉप अप नहीं कर सकती और प्लान नहीं बदल सकती। यह काम ओनर और बिलिंग एडमिन डैशबोर्ड के Billing and payments सेक्शन में करते हैं; यह भूमिका किसके पास है, यह जानने के लिए उपयोगकर्ता, टीमें और भूमिकाएँ देखें। प्लान, प्रोडक्ट और कीमत के कैटलॉग इसका अपवाद हैं: इनके लिए ऑथेंटिकेशन नहीं चाहिए, इस साइट पर दिखने वाली कीमतें इन्हीं से आती हैं, और CLI और MCP प्लान कैटलॉग को सीधे पढ़ सकते हैं। इसलिए यह गाइड बताती है कि बिलिंग आपके इंटीग्रेशन पर क्या असर डालती है, और हर संख्या दिखाने वाले डैशबोर्ड पेज का नाम बताती है। उन पेजों (Overview, Usage, Invoices, Spend और Settings) की जानकारी पूरे पेज में लिंक किए गए नॉलेज बेस लेखों में है।

प्लान और टियर

हर प्रोडक्ट का अपना प्लान होता है, जिसे अलग से चुना जाता है: कोई संगठन एक ही समय पर पेड SMS प्लान, एक Realtime प्लान और Email Free प्लान रख सकता है, और Voice को पे-एज़-यू-गो पर छोड़ सकता है। हर प्लान का एक टियर होता है (जैसे free, startup, growth या scale) और दो में से एक वित्तीय व्यवहार। फ़ंडिंग प्लान साझा वॉलेट में हर महीने एक राशि जमा करता है और पहले संदेश से ही उपयोग का शुल्क लेता है; कैपेसिटी प्लान शामिल उपयोग खरीदता है और वॉलेट में कुछ नहीं जोड़ता। प्लान और कीमतें में दोनों समझाए गए हैं, और Billing overview पर आपके संगठन के मौजूदा प्लान दिखते हैं।

परिचालन में आपके इंटीग्रेशन पर असर प्लान से ही पड़ता है:

• टियर के साथ दर सीमाएँ बढ़ती हैं। हर प्लान अपने प्रोडक्ट की पॉलिसियों के लिए मान तय करता है, जैसे sms_send या whatsapp_send, और ऊँचे टियर ऊँचे मान तय करते हैं। प्लान न होने पर पॉलिसी का डिफ़ॉल्ट लागू होता है। संगठन का सक्रिय ओवरराइड हर प्लान पर प्राथमिकता रखता है। देखें आपकी सीमा कैसे तय होती है।
• टियर के साथ कोटा बढ़ता है। प्लान Voice की एक साथ चलने वाली कॉल, Realtime कनेक्शन, सेंडिंग डोमेन, डेडिकेटेड IP और वेबहुक एंडपॉइंट जैसी संख्याएँ तय करते हैं। कोटा पूरा होने पर नया संसाधन, कॉल या कनेक्शन अपनी अलग त्रुटि के साथ अस्वीकार हो जाता है; यह 429 दर-सीमा प्रतिक्रिया से अलग है।
• शामिल कोटा प्लान की सीमाओं पर खत्म होता है। Email Free प्लान अपनी मासिक और दैनिक सीमा पर रुक जाता है, और Realtime प्लान अपनी कनेक्शन और दैनिक संदेश सीमाओं पर रुकता है। पेड Email प्लान में कोई शामिल कोटा नहीं होता: हर भेजे गए संदेश का शुल्क वॉलेट से कटता है।

किसी भी प्लान के प्रकाशित मान बिना ऑथेंटिकेशन के पढ़ने के लिए bird billing plans list --commercial-product sms से प्लान कैटलॉग की सूची लें। हर प्लान अपना financial_behavior, rate_limits और quotas लौटाता है। हर प्रोडक्ट के कीमत पेज पर दी गई तुलना तालिका इन मानों को पे-एज़-यू-गो के डिफ़ॉल्ट मानों के साथ दिखाती है, इसलिए क्षमता के लिए अपग्रेड करने से पहले वहीं दोनों की तुलना करें।

अपग्रेड भुगतान सफल होते ही लागू हो जाते हैं, इसलिए नई सीमाएँ अवधि के बीच में ही मिल जाती हैं और नवीनीकरण की तारीख नहीं बदलती। डाउनग्रेड और रद्दीकरण मौजूदा अवधि के अंत में लागू होते हैं, और नवीनीकरण का भुगतान न होने पर वह प्रोडक्ट अपने free प्लान या पे-एज़-यू-गो सीमाओं पर लौट जाता है। समय के नियमों के लिए प्लान में बदलाव और नवीनीकरण देखें। अपने इंटीग्रेशन ऐसे बनाएँ कि प्लान बदलने या शामिल कोटा खत्म होने पर वे सीमा त्रुटियों को संभाल सकें।

उपयोग की मीटरिंग

हर भेजा गया संदेश आपके संगठन की मौजूदा बिलिंग अवधि के हिसाब से मापा जाता है। डैशबोर्ड का Usage पेज हर प्रोडक्ट की लाइव स्थिति उसी अवधि में दिखाता है जिस पर वह प्रोडक्ट मापा जाता है: मीटर किए गए ईमेल के लिए प्लान अवधि, और पे-एज़-यू-गो के लिए कैलेंडर महीना। प्रोडक्ट दो में से एक तरीके से बिल होते हैं, और यही अंतर आपके इंटीग्रेशन पर असर डालता है:

• मीटर किए गए प्रोडक्ट का उपयोग प्लान के शामिल कोटे के मुकाबले गिना जाता है (Email Free प्लान या पुराने Email प्लान पर ईमेल भेजना)। पेज दिखाता है कि आपने कोटे का कितना हिस्सा इस्तेमाल किया है और, ओवरेज वाले पुराने प्लान पर, आप उससे कितना आगे निकल चुके हैं।
• पे-एज़-यू-गो प्रोडक्ट का बिल रेट कार्ड के अनुसार हर इस्तेमाल पर बनता है (SMS, WhatsApp, Voice, और पेड Email प्लान पर ईमेल), और जिस प्लान की अपनी दर है, वहाँ उसी दर पर। एक संदेश वॉलेट से दो बार राशि ले सकता है: संदेश प्रोसेस होने पर Bird का अपना शुल्क, और संदेश डिलीवर होने पर तृतीय-पक्ष शुल्क (SMS पर कैरियर सरचार्ज, WhatsApp पर Meta का हिस्सा)। हर संदेश का यह बँटवारा SMS या WhatsApp संदेश पर cost से पढ़ें: transaction_amount Bird का शुल्क है और passthrough_amount तृतीय-पक्ष शुल्क।

यह पेज मौजूदा अवधि में सब्सक्रिप्शन या उपयोग वाले हर प्रोडक्ट को दिखाता है, और उनमें से किसी एक के लिए प्रति दिन, प्रति देश और प्रति सेंडिंग डोमेन का बँटवारा चार्ट में दिखाता है।

वॉलेट

हर संगठन का एक वॉलेट होता है: एक साझा प्रीपेड बैलेंस, जिससे उपयोग के शुल्क कटते हैं। पे-एज़-यू-गो संदेश, ऐड-ऑन सब्सक्रिप्शन और पुराने Email प्लान के नवीनीकरण की राशि वॉलेट से कटती है। फ़ंडिंग प्लान इसे भरते हैं: भुगतान की गई हर मासिक राशि पूरी जमा होती है और किसी भी प्रोडक्ट के लिए इस्तेमाल हो सकती है। सेव किया गया कार्ड भी टॉप-अप और ऑटो टॉप-अप से इसे भरता है, और प्लान के नवीनीकरण का सीधे भुगतान करता है। डैशबोर्ड का Spend पेज क्रेडिट और शुल्कों का पूरा लेजर है, इसलिए वॉलेट की हर गतिविधि एक ही जगह दर्ज रहती है। सेटल होने वाले हर टॉप-अप भुगतान की एक स्थायी रसीद बनती है, जिसे आप उसी सेक्शन से PDF के रूप में डाउनलोड कर सकते हैं।

संचालन के लिहाज़ से, पे-एज़-यू-गो संदेश भेजना वॉलेट पर निर्भर है: जब बैलेंस शुल्क पूरा नहीं कर पाता, तो SMS और WhatsApp संदेश अस्वीकार कर दिए जाते हैं। SMS को API पर ही 402 के साथ मना कर दिया जाता है। WhatsApp संदेश पहले स्वीकार होता है और फिर Bird के शुल्क काटने की कोशिश करने पर अस्वीकार हो जाता है। डिलीवरी के समय का जो शुल्क बैलेंस पूरा नहीं कर पाता, उसे अस्वीकार करने के बजाय छोड़ दिया जाता है, इसलिए संदेश फिर भी प्राप्तकर्ता तक पहुँचता है। ट्रांज़ैक्शनल वॉल्यूम के लिए Billing overview पर ऑटो टॉप-अप और लो-बैलेंस अलर्ट सेट करें, या अपनी तरफ़ से निगरानी और अलर्ट रखें। भुगतान के तरीके और वॉलेट में डैशबोर्ड के ये दोनों नियंत्रण बताए गए हैं। कम बैलेंस की चेतावनियाँ और भुगतान विफल होने की सूचनाएँ संगठन के मालिकों को जाती हैं। इनवॉइस ईमेल संगठन की बिलिंग सूचना सूची को जाते हैं, अगर वह सेट हो; वरना वे संगठन के मालिक को जाते हैं। यह सूची Settings > Organization में सेट करें। इसके लिए किसी निगरानी वाले टीम एलियस का इस्तेमाल करें, ताकि बिलिंग मेल किसी एक व्यक्ति के इनबॉक्स पर निर्भर न रहे।

इनवॉइस

इनवॉइस हर संगठन के लिए हर कैलेंडर महीने में एक बार जारी होते हैं और डैशबोर्ड के Invoices पेज पर दिखते हैं। वहाँ आप किसी इनवॉइस को खोलकर उसके लाइन आइटम देख सकते हैं या उसे PDF के रूप में डाउनलोड कर सकते हैं। इनवॉइस में वही मीटरिंग दिखती है जो Usage पेज दिखाता है: उस अवधि के कैपेसिटी प्लान शुल्क, लेगेसी प्लान के शुल्क और ओवरेज, और पे-एज़-यू-गो खर्च। फ़ंडिंग प्लान की जमा राशि एक वॉलेट टॉप-अप है, जिसकी अपनी रसीद होती है; उससे चुकाया गया उपयोग इनवॉइस पर दिखता है। इनवॉइस की संरचना, स्थितियों और भुगतान के समय के बारे में नॉलेज बेस में उपयोग, खर्च और इनवॉइस देखें।

आगे के कदम

• अनुरोध दर सीमाएँ: पॉलिसी डिफ़ॉल्ट, प्लान मान, संगठन ओवरराइड और रिस्पॉन्स हेडर
• प्लान और कीमतें: फ़ंडिंग और कैपेसिटी प्लान, हर टियर क्या बढ़ाता है, और पे-एज़-यू-गो कीमतें
• प्लान में बदलाव और नवीनीकरण: अपग्रेड और रद्द करने का समय, और भुगतान विफल होने पर होने वाला क्रम
• उपयोगकर्ता, टीमें और भूमिकाएँ: बिलिंग कौन प्रबंधित कर सकता है (org:billing)