कस्टम बिलिंग एकीकरण¶

यह विषय समझाएगा कि WHMCS (उदाहरण के लिए, ब्लेस्टा, होस्टबिल, उबरस्मिथ, या अन्य) को छोड़कर किसी भी बिलिंग प्रणाली के साथ पोस्टपेड बिलिंग एकीकरण कैसे स्थापित किया जाए।

चरण 1 - टोकन और मुद्राओं के बीच अपनी रूपांतरण दर निर्धारित करें¶

SolusVM 2 प्रति घंटा और मासिक बिलिंग प्रदान करता है। तय करें कि एक टोकन की कीमत कितनी वास्तविक मुद्रा (वांछित मुद्राओं में) है।

Note

टोकन केवल पूर्णांक हो सकते हैं.

हमारा सुझाव है कि आप एक विस्तृत रूपांतरण तालिका तैयार करें, उदाहरण के लिए:

टोकन	USD में टोकन मूल्य	EUR में टोकन मूल्य
1	$0.00100	€0.00091
10	$0.01000	€0.00910
100	$0.10000	€0.09100
1,000	$1.00000	€0.91000
10,000	$10.00000	€9.10000

चरण 2 - अपनी प्रति घंटा और मासिक कीमतों की गणना करें¶

आवश्यकताएँ: मान लें कि आपने पहले ही योजनाएँ जोड़ ली हैं। यदि नहीं, तो अब ऐसा करने का समय आ गया है।

अब आपको यह तय करना होगा कि अपनी योजनाओं के लिए कितना शुल्क लेना है। SolusVM 2 में प्रत्येक योजना की प्रति घंटा और मासिक कीमत टोकन में हो सकती है:

"टोकन प्रति घंटा" प्रत्येक घंटे के लिए संसाधन का उपयोग करने के लिए टोकन में कीमत है।

उदाहरण के लिए, यदि आप एक सर्वर शुरू करते हैं और इसे पांच मिनट के बाद समाप्त कर देते हैं, तो सर्वर के उपयोगकर्ता को एक घंटे के लिए कीमत चुकानी होगी।

"टोकन प्रति माह" लगभग पूरे महीने के लिए संसाधन का उपयोग करने के लिए टोकन में कीमत है।

महीनों की लंबाई अलग-अलग होती है लेकिन मासिक कीमत तय होती है। इसे प्राप्त करने के लिए, आप मासिक कैप की गणना करके मासिक मूल्य निर्धारित करते हैं। आइए एक उदाहरण देखें.

हमारे पास 7 टोकन की प्रति घंटा कीमत ($0.007/घंटा के बराबर) है। पूरे 31 दिन के महीने की लागत निम्नलिखित होगी:

7 टोकन × 24 घंटे × 31 दिन = 7 × 744 घंटे = 5208 टोकन ($5.21 के बराबर)

लोगों को गोल संख्याएं पसंद हैं. हम 208 टोकन ($0.21) काट सकते हैं और 5000 टोकन ($5.00) की कीमत प्राप्त कर सकते हैं। यह एक ही समय में हमारी मासिक कैप और मासिक कीमत होगी। SolusVM 2 मासिक कीमत के आधार पर यह चुनेगा कि कौन सी कीमत (प्रति घंटा या मासिक) ली जाए।

उदाहरण के लिए, एक उपयोगकर्ता ने एक सर्वर को 700 घंटे तक चलाया, जिसकी लागत 4900 टोकन है। यह मासिक सीमा के 5000 टोकन से कम है इसलिए उपयोगकर्ता से प्रति घंटा शुल्क लिया जाएगा। अगले महीने, उपयोगकर्ता ने 730 घंटों तक सर्वर चलाया, जिसकी लागत 5110 टोकन थी। यह मासिक सीमा के 5000 टोकन से अधिक है इसलिए उपयोगकर्ता से मासिक शुल्क लिया जाएगा ($5.00)।

हम अनुशंसा करते हैं कि आप वास्तव में उन्हें SolusVM 2 में सेट करने से पहले अपनी प्रति घंटा और मासिक कीमतों की गणना करें। नीचे आप एक उदाहरण देख सकते हैं कि हमने चरण 1 में दिखाई गई रूपांतरण तालिका का उपयोग करके कीमतों की गणना कैसे की।

योजनाओं	प्रति घंटे टोकन	प्रति माह एकत्रित टोकन (टोकन प्रति घंटा × 24 घंटे × 31 दिन)	USD में प्रति माह कुल मूल्य	प्रति माह टोकन (निर्धारित मूल्य के रूप में)	यदि "प्रति माह टोकन" लागू किया गया था तो यूएसडी में प्रति माह मूल्य
1 कोर, 1 जीबी रैम	7	5,208	$5.21	5,000	$5.00
1 कोर, 2 जीबी रैम	14	10,416	$10.42	10,000	$10.00
2 कोर, 2 जीबी रैम	21	15,624	$15.62	15,000	$15.00
2 कोर, 4 जीबी रैम	28	20,832	$20.83	20,000	$20.00

Note

उपरोक्त उदाहरण में, हमने मासिक कीमतों (अंतिम दो कॉलम) को पूर्णांकित किया है। यह ग्राहकों के लिए अधिक सुविधाजनक है और यह मासिक छूट के रूप में काम कर सकता है। यह आप पर निर्भर करता है कि आप भी वैसा ही करते हैं या नहीं।

चरण 3 - SolusVM 2 में योजनाओं के लिए टोकन में कीमतें निर्धारित करें¶

पिछले चरण के दौरान, आपने विस्तृत मूल्य निर्धारण तालिका बनाई है। अब आपको SolusVM 2 में योजनाओं के लिए प्रति घंटा और मासिक कीमतें (मूल्य निर्धारण तालिका में क्रमशः दूसरा और पांचवां कॉलम) निर्धारित करने की आवश्यकता है:

SolusVM 2 में लॉग इन करें।
संसाधनों की गणना > योजनाएँ पर जाएँ।

आप मौजूदा योजना को संपादित करते समय या नई योजना बनाते समय टोकन मान निर्दिष्ट कर सकते हैं:
किसी मौजूदा योजना को संपादित करने के लिए, योजना की पंक्ति पर आइकन पर क्लिक करें।
नई योजना बनाने के लिए, योजना जोड़ें पर क्लिक करें।
टोकन में प्रति घंटा और मासिक मूल्य क्रमशः "टोकन प्रति घंटा" और "टोकन प्रति माह" निर्दिष्ट करें।
यदि आप कोई योजना बना रहे हैं, तो भी आवश्यक फ़ील्ड भरें।

!!! note

     यदि आप "टोकन प्रति माह" को "0" पर सेट करते हैं, तो केवल प्रति घंटा बिलिंग उपलब्ध होगी।
     यदि आप "टोकन प्रति घंटा" को "0" पर सेट करते हैं लेकिन आप "टोकन (प्रति माह)" के लिए मान निर्दिष्ट करते हैं,
     तो प्रति घंटा बिलिंग उपलब्ध नहीं होगी।
     ग्राहकों से हमेशा "टोकन प्रति माह" द्वारा परिभाषित निश्चित मासिक मूल्य लिया जाएगा।

सहेजें पर क्लिक करें।

चरण 4 - SolusVM 2 उपयोगकर्ता क्षेत्र में पंजीकरण अक्षम करें¶

SolusVM 2 के साथ कॉन्फ़िगर किया गया बिलिंग सिस्टम SolusVM 2 उपयोगकर्ताओं के लिए मुख्य डेटाबेस होना चाहिए। केवल बिलिंग सिस्टम डेटाबेस को नियंत्रित करना चाहिए कि किन उपयोगकर्ताओं के पास सर्वर बनाने की अनुमति है या नहीं।

हालाँकि, SolusVM 2 के इंटरफ़ेस का एक हिस्सा है जिसे "उपयोगकर्ता क्षेत्र" कहा जाता है जहां उपयोगकर्ता सर्वर बनाते हैं। उपयोगकर्ता क्षेत्र में सीधे उपयोगकर्ता बनाकर बिलिंग सिस्टम डेटाबेस को बायपास करना संभव है। इसे रोकने के लिए, आपको उपयोगकर्ता क्षेत्र में पंजीकरण अक्षम करना होगा:

SolusVM 2 में लॉग इन करें।
सेटिंग्स > उपयोगकर्ता क्षेत्र पर जाएं और "पंजीकरण सक्षम करें" चेकबॉक्स साफ़ करें।
सहेजें पर क्लिक करें।

आपने उपयोगकर्ता क्षेत्र में पंजीकरण अक्षम कर दिया है. बिलिंग सिस्टम डेटाबेस अब SolusVM 2 उपयोगकर्ताओं के लिए मुख्य डेटाबेस है।

चरण 5 - सीमा समूह बनाएं¶

सीमा समूह आपको उन सर्वरों की संख्या पर सीमा निर्धारित करने में मदद करते हैं जिन्हें एक विशिष्ट उपयोगकर्ता बना सकता है और चालू स्थिति में रख सकता है। हम अनुशंसा करते हैं कि आप सीमा समूह बनाएं और नए उपयोगकर्ताओं के लिए डिफ़ॉल्ट सीमा समूह चुनें। ऐसा करना सीखें.

चरण 6 - बिलिंग सिस्टम साइड पर एपीआई एंडपॉइंट कॉन्फ़िगर करें¶

अब आपको बिलिंग सिस्टम साइड पर GetTokenPricing एंडपॉइंट को कॉन्फ़िगर करने की आवश्यकता है। आप इसे अपनी पसंद की कोडिंग भाषा में आसानी से कॉन्फ़िगर कर सकते हैं।

आपको इस समापन बिंदु की आवश्यकता है ताकि SolusVM 2 ग्राहकों को कीमतें दिखा सके।

Note

फिलहाल, आपको केवल GetTokenPricing एंडपॉइंट को कॉन्फ़िगर करने की आवश्यकता है। लेकिन हम भविष्य में एपीआई एंडपॉइंट की सूची का विस्तार कर सकते हैं।

GetTokenPricing समापन बिंदु में निम्नलिखित अनुरोध और प्रतिक्रिया पैरामीटर हैं:

पैरामीटर का अनुरोध करें¶

पैरामीटर	प्रकार	विवरण	आवश्यक
`टोकन`	डोरी	प्राधिकरण टोकन	नहीं
`userid`	int	बिलिंग प्रणाली में उपयोगकर्ता आईडी	हाँ

प्रतिक्रिया पैरामीटर¶

पैरामीटर	प्रकार	विवरण
`base_token_unit_cost`	तैरना	किसी भी छूट और/या कर से पहले एक टोकन की कीमत।
`user_token_unit_cost`	तैरना	छूट और करों सहित एक टोकन की पूर्ण और अंतिम कीमत।
`currency`	सरणी	मुद्रा स्वरूपण मापदंडों से युक्त सरणी: आईएसओ कोड, उपसर्ग, प्रत्यय, दशमलव की संख्या, हजारों, और दशमलव विभाजक। उदाहरण: ``` "मुद्रा": { "कोड": "GBP", "display_prefix": "\u00a3", "display_suffix": "GBP", "हज़ारों_विभाजक ": ",", "दशमलव_विभाजक": "।", "दशमलव_प्रति_माह": 2, "दशमलव_प्रति_घंटा": 4 } ```
`discounts`	सरणी	लागू छूटों की श्रृंखला जिसमें नाम, विवरण और गुणक शामिल हैं। उदाहरण: `"discounts": [ { "name": "Special Client Group Discount", "description": "5% Recurring Discount", "multipler": 0.95 }`
`taxes`	सरणी	कर प्रकार (मिश्रित या नहीं) और दरें (एक लेबल और दर) सहित कर जानकारी की श्रृंखला। उदाहरण: ``` "कर": { "मिश्रित": सत्य, "दरें": [ { "लेबल": "शहर कर", "दर": 6 }, { " लेबल": "राज्य कर", "दर": 2 } ] } ```

जब SolusVM 2 को किसी ग्राहक को कीमत प्रदर्शित करने की आवश्यकता होती है, तो SolusVM 2 उपयोगकर्ता आईडी के साथ GetTokenPricing समापन बिंदु पर एक एपीआई अनुरोध भेजता है:

curl -X POST "https://www.mybilling.com/solusio/api/"
\ -H "Accept: application/json"
\ -H "Content-Type: application/x-www-form-urlencoded"
\ -d "token=xxxxxxx&action=GetTokenPricing&userid=1"

बिलिंग प्रणाली तब मूल्य-संबंधित जानकारी के साथ एक एपीआई प्रतिक्रिया भेजती है, उदाहरण के लिए:

{
 "base_token_unit_cost": 1.34,
 "user_token_unit_cost": 1.0812,
 "currency": {
         "code": "GBP",
         "display_prefix": "\u00a3",
         "display_suffix": " GBP",
         "thousands_separator": ",",
         "decimals_separator": ".",
         "decimals_per_month": 2,
         "decimals_per_hour": 4
 },
 "discounts": [
         {
                 "name": "Special Client Group Discount",
                 "description": "5% Recurring Discount",
                 "multipler": 0.95
         }
 ],
 "taxes": {
         "compound": true,
         "rates": [
                     {
                             "label": "City Tax",
                             "rate": 6
                     },
                     {
                             "label": "State Tax",
                             "rate": 2
                     }
                 ]
         }
}

प्रतिक्रिया में user_token_unit_cost वह गुणांक है जो प्रतिबिंबित करता है किसी विशेष उपयोगकर्ता के सभी कर, छूट और विशेष ऑफ़र। SolusVM 2 फिर user_token_unit_cost को टोकन में योजना की कीमत से गुणा करता है, मुद्रा में वास्तविक कीमत प्राप्त करता है (हमारे उदाहरण में पाउंड स्टर्लिंग), और उपयोगकर्ता को यह कीमत दिखाता है।

चरण 6 - बिलिंग सिस्टम साइड पर एपीआई एंडपॉइंट कॉन्फ़िगर करें¶

आपने बिलिंग सिस्टम साइड पर एपीआई एंडपॉइंट कॉन्फ़िगर किया है। अब हम इसका उपयोग करेंगे.

SolusVM 2 में लॉग इन करें।
सेटिंग्स > बिलिंग एकीकरण पर जाएँ।
"प्रकार" के अंतर्गत, "कस्टम बिलिंग" चुनें।
बिलिंग सिस्टम साइड पर GetTokenPricing समापन बिंदु का URL निर्दिष्ट करें, उदाहरण के लिए https://www.mybilling.com/solusio/api/
(वैकल्पिक) बिलिंग प्रणाली को प्राधिकरण के लिए टोकन की आवश्यकता हो सकती है। यदि हां, तो अपना बिलिंग सिस्टम प्राधिकरण टोकन चिपकाएँ।
सहेजें पर क्लिक करें।

चरण 8 - बिलिंग सिस्टम पक्ष पर उपयोगकर्ता प्रबंधन को SolusVM 2 के साथ एकीकृत करें¶

आवश्यक होने पर बिलिंग प्रणाली को SolusVM 2 में उपयोगकर्ताओं का प्रबंधन करना चाहिए।

इसे प्राप्त करने के लिए, आपको बिलिंग सिस्टम साइड पर SolusVM 2 के साथ उपयोगकर्ता प्रबंधन एकीकरण सेट करना होगा। जब आप ऐसा करते हैं, तो बिलिंग सिस्टम लॉक, और सस्पेंड SolusVM 2 में उपयोगकर्ता SolusVM 2 API एंडपॉइंट का उपयोग कर रहे हैं।

Note

उपयोगकर्ता प्रबंधन को एकीकृत करते समय, सुनिश्चित करें कि बिलिंग सिस्टम SolusVM 2 को billing_user_id भेजता है। बिलिंग सिस्टम में संग्रहीत उपयोगकर्ताओं से मिलान करने के लिए SolusVM 2 में billing_user_id होना आवश्यक है SolusVM 2 में संग्रहीत लोगों के साथ।

प्रतिक्रिया पैरामीटर¶

बिलिंग प्रणाली उपयोगकर्ताओं को SolusVM 2 उपयोगकर्ता क्षेत्र पर पुनर्निर्देशित करती है। उपयोगकर्ताओं को दूसरी बार लॉग इन किए बिना SolusVM 2 में प्रवेश करने में मदद करने के लिए, स्वचालित लॉग इन कॉन्फ़िगर करें। ऐसा करने के लिए, आपको पहले किसी उपयोगकर्ता के लिए एक एक्सेस टोकन बनाएं बनाना होगा। फिर एक लॉगिन लिंक का उपयोग करें जिसमें एकीकरण स्क्रिप्ट में उपयोगकर्ता को अधिकृत करने के लिए टोकन शामिल है:

GET https://www.solus-user-ui.com/auth/by_token/{access_token}

चरण 10 - बिलिंग सिस्टम साइड पर चालान निर्माण कॉन्फ़िगर करें¶

बिलिंग प्रणाली तब मूल्य-संबंधित जानकारी के साथ एक एपीआई प्रतिक्रिया भेजती है, उदाहरण के लिए:

बिलिंग चक्र के अंत में, बिलिंग प्रणाली उपयोगकर्ताओं को चालान बनाती है और भेजती है। शुल्कों की गणना करने के लिए, बिलिंग प्रणाली को /उपयोग समापन बिंदु पर एपीआई अनुरोध भेजकर उपभोग किए गए संसाधन आँकड़े प्राप्त करने होंगे।

बधाई हो! आपने अपने बिलिंग सिस्टम को SolusVM 2 के साथ एकीकृत करना पूरा कर लिया है। हमें उम्मीद है कि पैसा पहले से ही आ रहा है।