Google Standard Payments की दुनिया में, कैरियर बिलिंग को टोकन वाला पैसे चुकाने का तरीका (एफ़ओपी) माना जाता है. इसका मतलब है कि टोकन बनाने के लिए, Google और पेमेंट इंटिग्रेटर, खाते की पहचान से जुड़े क्रेडेंशियल का लेन-देन सिर्फ़ एक बार करते हैं. बाद में, यह टोकन पेमेंट इंटिग्रेटर को वापस भेजा जाता है, ताकि शुल्क लिए जाने वाले खाते की पहचान की जा सके.
पैसे चुकाने के दूसरे तरीकों में भी टोकनाइज़ेशन का इस्तेमाल होता है. इसलिए, हमने टोकन वाले एफ़ओपी के बारे में खास जानकारी दी है, जो कैरियर बिलिंग के लिए ज़्यादा काम की है. इस खास जानकारी में, पुष्टि करने, असोसिएशन, खरीदारी, और पेमेंट करने वाले फ़्लो के बारे में ज़्यादा जानकारी दी गई है. इस पेज पर, कैरियर बिलिंग के हिसाब से ज़्यादा जानकारी मिलती है.
मोबाइल और इंटरनेट सेवा देने वाली कंपनियां, नीचे दिए गए फ़्लो बनाने वाले एपीआई को लागू करके Google Standard Payments का इस्तेमाल करती हैं:
| फ़्लो | ब्यौरा | DCB3 की खास जानकारी के बराबर |
|---|---|---|
| पुष्टि करना | यह पेमेंट इंटिग्रेटर के सिस्टम में उपयोगकर्ता के खाते की पहचान करता है और उसकी पुष्टि करता है. इसका इस्तेमाल डीसीबी सेवा से पेमेंट करने के लिए किया जाता है | GoogleUserToken के साथ एसएमएस-MO |
| असोसिएशन | लंबे समय से चल रहे टोकन की अदला-बदली करता है जिससे Google और पेमेंट इंटीग्रेटर Google, उपयोगकर्ता के पेमेंट इंटीग्रेटर खाते से पैसे चुका सकते हैं | OperatorUserToken और Get इंपोर्टिंग() के साथ उपयोगकर्ता के कॉलबैक को मंज़ूरी दें |
| FundsTransfer | सिंक्रोनस तरीके से फ़ंड को उपयोगकर्ता के पेमेंट इंटीग्रेटर खाते से बाहर ले जाता है. पेमेंट इंटिग्रेटर को पेमेंट की ज़िम्मेदारी ट्रांसफ़र करता है | एक साथ कई अनुरोध वाली फ़ाइलों में Auth() और CHARGE लाइनें |
| रिफ़ंड | सिंक्रोनस की मदद से, पहले से जुड़े कुछ या सभी फ़ंड उपयोगकर्ता के पेमेंट इंटीग्रेटर खाते में ट्रांसफ़र किए जा सकते हैं. Google को कानूनी जवाबदेही ट्रांसफ़र करती है | बैच अनुरोध फ़ाइलों में रिफ़ंड लाइन |
| भेजी गई रकम | एपीआई आधारित सेटलमेंट, हर दिन के हिसाब से | मासिक इनवॉइस का PDF, महीने के इनवॉइस की जानकारी वाली फ़ाइल, हर दिन की रिकन फ़ाइल |
| UpdateAssociatedAccount | इससे Google को, उपयोगकर्ता के पेमेंट इंटिग्रेटर खाते में बदलाव की सूचना मिलती है. उदाहरण के लिए, लेन-देन की सीमाएं या प्रावधान की स्थिति | getप्रावधान करना() पोल |
| धोखाधड़ी | इससे Google को उन लेन-देन के बारे में पता चलता है जो उपयोगकर्ता विवाद की वजह से रद्द हो गए थे. इसका इस्तेमाल Google के जोखिम वाले इंजन को बेहतर बनाने के लिए किया जाता है लेकिन इससे पैसे की देनदारी पर असर नहीं पड़ता | कभी नहीं |
DCB3 खास जानकारी से कुल तुलना
Google Standard Payments की खास जानकारी उन ही समस्याओं को हल करती है जिन्हें DCB3 स्पेसिफ़िकेशन ठीक करता है. हालांकि, इसमें अलग-अलग टेक्नोलॉजी और एपीआई डिज़ाइन का इस्तेमाल किया जाता है, जो समाधान को बेहतर बनाते हैं. यहां मुख्य अंतर बताए गए हैं:
स्टैक टेक्नोलॉजी की तुलना
सभी एपीआई कम्यूनिकेशन, PGP से एन्क्रिप्ट किए गए और हस्ताक्षर किए गए JSON फ़ॉर्मैट वाले एचटीटीपीएस POST का इस्तेमाल करके किया जाता है. इसका मतलब है कि Google और पेमेंट इंटिग्रेटर, दोनों के पास बदलने के लिए सिर्फ़ एक PGP कुंजी है. ये टेक्नोलॉजी एसओएपी की तुलना में बेहतर सहायता भी देती हैं. कम्यूनिकेशन स्टैक के बारे में ज़्यादा जानकारी यहां मिल सकती है.
एपीआई दर्शन की तुलना
पेमेंट की स्थिति का मिलान करने के लिए, DCB3 बहुत ज़्यादा फ़ाइलों पर निर्भर रहती है. Google मानक भुगतान में कोई फ़ाइल नहीं होती है. एपीआई कॉल की तब तक कोशिश की जाती है, जब तक कोई आखिरी स्टेटस तय नहीं हो जाता.
किसी खास कुंजी के लिए आखिरी स्थितियां सबसे आखिरी होती हैं. गड़बड़ियों और तय न की गई स्थितियों को, अस्वीकार किए जाने के तौर पर नहीं, बल्कि 200 एचटीटीपी रिस्पॉन्स के तौर पर नहीं माना जाता है. इससे हम गड़बड़ियों को ज़्यादा जल्दी पहचान पाते हैं और उन्हें अस्वीकार होने से बचा पाते हैं.
नई सुविधाएं
Google Standard Payments में नई सुविधाओं का इस्तेमाल किया जा सकता है, जैसे:
- Fraud API की मदद से, Google को धोखाधड़ी के जोखिम के बारे में
- Google को प्रावधान, लेन-देन की सीमाओं, और खाते की स्थिति में होने वाले बदलावों के बारे में जानकारी देने के लिए, Associated Account API को अपडेट करें
- खरीदारी के दौरान, पुष्टि करने की चुनौती से जुड़ी ज़्यादा सुविधाएं, जैसे कि यूएसएसडी पिन
- रोज़ाना के पेमेंट की साइकल
DCB3 से Google स्टैंडर्ड पेमेंट शब्दावली मैप
इस दस्तावेज़ और स्पेसिफ़िकेशन में, आपको ऐसी शब्दावली दिखेंगी जो नई दिखती हैं, लेकिन असल में मौजूदा कॉन्सेप्ट के लिए सिर्फ़ अलग शब्द हैं.
- कैरियर -> पेमेंट इंटिग्रेटर
चेतावनी: डीसीबी इंटिग्रेटर के सिद्धांत से जुड़ी उलझन से बचने के लिए, यह दस्तावेज़ सिर्फ़ "इंटिग्रेटर" के बजाय "पेमेंट इंटीग्रेटर" और "डीसीबी इंटिग्रेटर" का इस्तेमाल करने की कोशिश करता है. हालांकि, Google के स्टैंडर्ड पेमेंट के सामान्य दस्तावेज़ में, "पेमेंट इंटीग्रेटर" के शॉर्टहैंड की तरह, "इंटिग्रेटर" का इस्तेमाल
- बिलिंग कानूनी समझौते का आईडी -> पेमेंट इंटिग्रेटर खाता आईडी
- OperatorUserToken (OUT) -> GooglePaymentToken (GPT)
- कोरिलेशन_id -> अनुरोध आईडी
- आय का बंटवारा -> शुल्क
पुष्टि करने का फ़्लो
टोकन वाले एफ़ओपी के लिए, पुष्टि करने के फ़्लो की सामान्य जानकारी पाने के लिए, यह पेज देखें.
कैरियर बिलिंग की खास बातें
कैरियर बिलिंग के लिए, पुष्टि करने के फ़्लो का मकसद यह साबित करना होता है कि उपयोगकर्ता के पास मोबाइल और इंटरनेट सेवा देने वाली कंपनी के अपने खाते से जुड़े सिम कार्ड का कंट्रोल है. कैरियर बिलिंग उपयोगकर्ताओं की पुष्टि इन तीन तरीकों में से किसी भी तरीके से की जा सकती है:
- मैसेज (एसएमएस)-एमओ से पुष्टि करना (टोकन वाले एफ़ओपी की खास जानकारी में परिभाषा)
- रीडायरेक्ट के लिए पुष्टि करना (टोकन वाले एफ़ओपी की खास जानकारी में परिभाषा)
- एसएमएस-एमटी ओटीपी (टोकन वाले एफ़ओपी में परिभाषा)
पेमेंट इंटिग्रेटर, Google के साथ काम करके पुष्टि करने के ऐसे तरीके चुन सकते हैं जो उनके प्रॉडक्ट के लिए सबसे सही हों.
DCB3 की तुलना
पुष्टि करने का फ़्लो, Google को दिए गए approveuser कॉलबैक को DCB3 स्पेसिफ़िकेशन में से
बदलकर, Google को बदल देता है.
DCB3 में, पुष्टि करने और असोसिएशन को एक ही फ़्लो में जोड़ दिया गया था. Google Standard Payments में, खाता जोड़ने के मुकाबले पुष्टि करना एक अलग चिंता है.
असोसिएशन फ़्लो
टोकन वाले एफ़ओपी के लिए, असोसिएशन फ़्लो की सामान्य जानकारी पाने के लिए, यह पेज देखें.
कैरियर बिलिंग डिवाइसों के लिए इस्तेमाल किए जाने वाले असोसिएशन फ़्लो और सामान्य टोकन वाले एफ़ओपी फ़्लो के बीच मुख्य अंतर यह है कि associateAccount तरीके में दिया गया पुष्टि करने का सबूत, इस बात पर निर्भर करता है कि पेमेंट इंटिग्रेटर ने उपयोगकर्ता के लिए अतिरिक्त चुनौती का अनुरोध किया है या नहीं.
अगर पेमेंट इंटिग्रेटर ने बताया कि वह उपयोगकर्ता को एक और चैलेंज चाहता है, तो पुष्टि करने का सबूत उस पहचान का सबूत होगा जो पुष्टि करने के उस खास तरीके से बनाया गया है जिसे Google ने अतिरिक्त चैलेंज के लिए इस्तेमाल किया था. उदाहरण के लिए, एसएमएस-एमटी ओटीपी तरीके से पुष्टि करने का सबूत, sendOtp तरीके का requestId और ओटीपी होता है.
उपकरण विशेषताएं
सामान्य टोकन वाले एफ़ओपी की खास जानकारी के इंस्ट्रुमेंट एट्रिब्यूट सेक्शन में, accountAlias, accountNickname, और fullAccountNickname के सिद्धांत पर चर्चा की गई है.
कैरियर बिलिंग की खास बातें
accountAlias, उपयोगकर्ता का फ़ोन नंबर होना चाहिए. अगर कोई व्यक्ति अपने खाते के बारे में Google सहायता टीम को कॉल करता है, तो इस जानकारी का इस्तेमाल उस तरीके की पहचान करने के लिए किया जाएगा.accountNicknameऔरfullAccountNickname, डिसप्ले नेम हैं. इनका इस्तेमाल, यूज़र इंटरफ़ेस (यूआई) में इंस्ट्रुमेंट की पहचान करने के लिए किया जाता है.
DCB3 स्पेसिफ़िकेशन की तुलना
असोसिएशन फ़्लो, DCB3 स्पेसिफ़िकेशन के इन कॉम्पोनेंट को बदल देता है:
- एसओएपी कॉल का प्रावधान पाएं
- सदस्यता लेने के लिए एसओएपी कॉल
- मोबाइल और इंटरनेट सेवा देने वाली कंपनी का जनरेट किया गया मॉडल
इसमें एक बड़ा अंतर यह है कि Google, Google पेमेंट टोकन (GPT) को जनरेट करने के बजाय, असोसिएशन फ़्लो के दौरान जनरेट करता है.
इस बात पर भी ध्यान देना ज़रूरी है कि DCB3 के उलट, जहां OUT का दायरा किसी खास Billing एग्रीमेंट के दायरे में आता है, वहां GPT का दायरा किसी भी खास PaymentIntegratorAccountID के दायरे में नहीं आता है.
टोकन फ़्लो रीफ़्रेश करें
टोकन वाले एफ़ओपी के लिए, रीफ़्रेश टोकन फ़्लो की सामान्य जानकारी पाने के लिए, यह पेज देखें.
कैरियर बिलिंग की खास बातें
कैरियर बिलिंग के तरीकों के लिए, हम Google पेमेंट टोकन की समयसीमा खत्म होने की सलाह नहीं देते, क्योंकि इसकी वजह से सदस्यता के ऑर्डर रद्द हो जाते हैं. टोकन की समयसीमा खत्म होने और उन्हें ठीक करने के लिए रीफ़्रेश टोकन फ़्लो पर भरोसा करने के बजाय, आपका इस्तेमाल का उदाहरण, नीचे बताए गए खाता अपडेट करने के फ़्लो का इस्तेमाल करके पूरा किया जा सकता है.
खाता अपडेट करने का फ़्लो
खाता अपडेट करने के फ़्लो की मदद से, पेमेंट इंटीग्रेटर Google को उपयोगकर्ता के इंटिग्रेटर खाते में होने वाले अपडेट के बारे में जानकारी देता है. Google को ये फ़ील्ड मूल रूप से असोसिएशन फ़्लो के दौरान दिए जाते हैं. पेमेंट इंटिग्रेटर को खाते के कुछ ऐसे डेटा के बारे में बताना होगा जिसे अपडेट करना है:
- उपयोगकर्ता की मासिक, दैनिक और हर आइटम के लेन-देन की सीमाएं
- उपयोगकर्ता के इंटिग्रेटर खाते के प्रावधान की स्थिति
- उपयोगकर्ता का इंटिग्रेटर खाता टाइप, जैसे कि प्रीपेड, पोस्ट-पेड, एंटरप्राइज़ वगैरह
- उपयोगकर्ता का 'accountALIAS', 'खाते का दूसरा नाम' या 'fullAccount निकनेम'
- क्या उपयोगकर्ता ने पहले से शेयर किया गया स्टैटिक पिन सेट अप किया है, हटा दिया है या उसे बदल दिया है
- चाहे उपयोगकर्ता ने अपना खाता बंद कर दिया हो या अपना फ़ोन नंबर बदल दिया हो -- Google के सिस्टम में उपयोगकर्ता के इंस्ट्रुमेंट को गलत तरीके से देना.
- टोकन फ़्लो मिटाएं
DCB3 स्पेसिफ़िकेशन की तुलना
खाता अपडेट करने का फ़्लो, DCB3 स्पेसिफ़िकेशन के इन कॉम्पोनेंट को बदल देता है:
- एसओएपी कॉल को पाने के लिए पोल
- समय-समय पर होने वाले टोकन अमान्य होना
परचेज़ फ़्लो
टोकन वाले एफ़ओपी के लिए, परचेज़ फ़्लो के बारे में सामान्य जानकारी पाने के लिए, यह पेज देखें.
कैरियर बिलिंग की खास बातें
मोबाइल और इंटरनेट सेवा देने वाली कुछ कंपनियां, हर खरीदारी के दौरान अपने उपयोगकर्ताओं से पिन इकट्ठा करने के लिए यूएसएसडी या दूसरी टेक्नोलॉजी का इस्तेमाल करती हैं. इन मोबाइल और इंटरनेट सेवा देने वाली कंपनियों के लिए, cache() को कॉल करने के बजाय हम एसिंक्रोनस कैप्चर() को कॉल करते हैं. हम मोबाइल और इंटरनेट सेवा देने वाली कंपनी को 30 सेकंड का समय देते हैं, ताकि वे उपयोगकर्ता को पिन दिखाने का अनुरोध कर सकें और कैप्चर करने की प्रोसेस पूरी कर सकें. जब पेमेंट की आखिरी स्थिति तय हो जाती है, तो मोबाइल और इंटरनेट सेवा देने वाली कंपनी, capture Results जुड़ने() को कॉल करके Google को सूचना देती है.
DCB3 स्पेसिफ़िकेशन की तुलना
यहां बड़े बदलाव हुए हैं.
- सिंगल, सिंक्रोनस मेथड कॉल -- auth() + बैच फ़ाइल के बजाय कैप्चर()
- कोई बैच फ़ाइल नहीं है
- रद्द करने() का कोई तरीका नहीं (पुष्टि करने और रद्द करने के बजाय कैप्चर + रिफ़ंड)
- जवाब में कोई user_message फ़ील्ड नहीं है -- अस्वीकार किए गए कोड Google के मालिकाना हक वाले मैसेज में मैप किए जाते हैं. इन्हें उपयोगकर्ता के खाते की भाषा में स्थानीय भाषा में लिखा जाता है.
- मुख्य शब्दावली में बदलाव:
- कोरिलेशन आईडी -> अनुरोध आईडी
- बिलिंग कानूनी समझौता -> paymentIntegratorAccountId
- OperatorUserToken -> googlePaymentToken
चुनौती भरा परचेज़ फ़्लो
परचेज़ फ़्लो को सपोर्ट करने के लिए डेवलपमेंट जारी है. इसमें हर खरीदारी से पहले, लोगों के लिए पुष्टि करने से जुड़ी एक चुनौती शामिल होती है. पुष्टि करने के ज़्यादातर ऐसे तरीके असोसिएशन फ़्लो से पहले इस्तेमाल किए जा सकते हैं जिन्हें चुनौती पर लगाए गए परचेज़ फ़्लो से पहले इस्तेमाल किया जा सकता है. इससे उपयोगकर्ताओं को ज़्यादा पुष्टि करने में मदद मिलेगी.
रिफ़ंड फ़्लो
टोकन वाले एफ़ओपी के लिए, रिफ़ंड फ़्लो के बारे में सामान्य जानकारी पाने के लिए, यह पेज देखें.
टोकन वाला एफ़ओपी, एक मैसेज रिफ़ंड फ़्लो के साथ काम करता है. रिफ़ंड के इस तरीके में, पूरी खरीदारी के लिए रिफ़ंड या खरीदारी के एक हिस्से का रिफ़ंड दिया जाता है. किसी एक खरीदारी के लिए, एक से ज़्यादा बार किए गए रिफ़ंड का रिफ़ंड मिल सकता है.
कैरियर बिलिंग की खास बातें
रिफ़ंड फ़्लो में, कैरियर बिलिंग के तरीकों के बारे में कोई खास बात नहीं होती है.
DCB3 स्पेसिफ़िकेशन की तुलना
रिफ़ंड, फ़ाइल के बजाय सिंक्रोनस एपीआई कॉल से ट्रिगर होते हैं. साथ ही, किसी एक मूल पेमेंट के लिए, एक से ज़्यादा, कुछ हिस्से के रिफ़ंड बनाए जा सकते हैं.
भेजे गए पैसे का फ़्लो
टोकन वाले एफ़ओपी के लिए, भेजे जाने वाले पैसों के फ़्लो की सामान्य जानकारी पाने के लिए, यह पेज देखें.
रेमिटेंस फ़्लो से पता चलता है कि Google और पेमेंट इंटिग्रेटर किस तरह से पेमेंट करते हैं. Google, रिकॉर्ड का अकाउंटिंग सिस्टम है. साथ ही, Google, पैसों के लेन-देन का हिसाब भी लगाता है. Google समय-समय पर, पेमेंट इंटिग्रेटर को रेमिटेंस स्टेटमेंट भेजता है. इस स्टेटमेंट में, Google को पेमेंट इंटिग्रेटर की बकाया रकम की खास जानकारी के साथ-साथ पेमेंट करने के तरीके से जुड़े निर्देश भी दिए जाते हैं. पेमेंट इंटिग्रेटर से पेमेंट का मिलान करने के लिए, पेमेंट इंटिग्रेटर, Google से लेन-देन के लेवल की जानकारी मांग सकता है. इस जानकारी में, पेमेंट इंटिग्रेटर को शामिल किया जाता है.
कैरियर बिलिंग की खास बातें
कैरियर बिलिंग remittanceStatementDetails में ऐसे अन्य फ़ील्ड शामिल होते हैं जो अभी तक रेमिटेंस फ़्लो की एपीआई परिभाषाओं में शामिल नहीं हैं. इवेंट में ये शामिल हैं:
- revshareCategory
- itemPrice
- tax
- timestamp
मोबाइल और इंटरनेट सेवा देने वाली जिन कंपनियों ने Google के साथ आय के बंटवारे का 50/50 का कानूनी समझौता किया है उनके लिए, remittanceStatementDetails में दिए गए शुल्क, हर इवेंट के हिसाब से नहीं, बल्कि हर revshareCategory के हिसाब से एग्रीगेट किए जाते हैं.
DCB3 स्पेसिफ़िकेशन की तुलना
DCB3 स्पेसिफ़िकेशन में, रेमिटेंस फ़्लो इन सिद्धांतों को बदल देता है:
- हर महीने की शुल्क रिपोर्ट/पेमेंट रिपोर्ट का PDF
- हर महीने के इनवॉइस की जानकारी वाली CSV फ़ाइल
- रोज़ाना इस्तेमाल की जाने वाली CSV फ़ाइलें
यहां सबसे बड़े अंतर किसी भी फ़ाइल को हटा देना और हर दिन पैसे चुकाने की सुविधा में हैं. फ़ाइलों के बजाय, भेजे जाने वाले पैसे को सिंक करने वाले एपीआई के ज़रिए डिलीवर किया जाता है. साथ ही, कोई दूसरा एपीआई पैसे चुकाने के ब्यौरे के बारे में क्वेरी करने की सुविधा देता है.
धोखाधड़ी की रिपोर्ट करने का फ़्लो
धोखाधड़ी की रिपोर्ट करने के फ़्लो की मदद से, पेमेंट इंटिग्रेट करने वाला व्यक्ति, Google को ऐसे लेन-देन के बारे में सूचना दे सकता है जो धोखाधड़ी हो सकता है. इसके लिए, उसे fraudNotification वाले तरीके का इस्तेमाल करके इसकी जानकारी दी जाती है. इस फ़्लो का इस्तेमाल, Google के इंटरनल रिस्क इंजन को अपडेट करने के लिए किया जाता है. इससे, पैसे के लेन-देन की प्रोसेस शुरू नहीं होती है.
कैरियर बिलिंग की खास बातें
पेमेंट वापस करने की सूचना फ़्लो में, कैरियर बिलिंग के इंस्ट्रुमेंट के बारे में कुछ भी खास नहीं होता है.