एफ़ओपी को रीडायरेक्ट करें
खास जानकारी
Google Standard Payments, रीडायरेक्ट पर आधारित पैसे चुकाने के तरीके (एफ़ओपी) की सुविधा देता है. रीडायरेक्ट एफ़ओपी की मदद से Google के प्रॉडक्ट या सेवाओं के उपयोगकर्ता, किसी बाहरी इकाई के वेब इंटरफ़ेस में इन प्रॉडक्ट या सेवाओं के लिए पैसे चुका सकते हैं. बड़े लेवल पर, जो उपयोगकर्ता सामान के लिए पैसे चुकाना चाहता है उसे शुरुआत में पेमेंट इंटीग्रेटर या पेमेंट इंटिग्रेटर के पास रीडायरेक्ट किया जाता है. अगर उपयोगकर्ता को इंटिग्रेटर पर रीडायरेक्ट किया जाता है, तो इंटिग्रेटर को खरीदारी पूरी करने के लिए, उपयोगकर्ता को उसे जारी करने वाले के वेब इंटरफ़ेस पर भेज देना चाहिए. पेमेंट पूरा होने के बाद, उपयोगकर्ता को इंटिग्रेटर की मदद से, Google पर वापस रीडायरेक्ट किया जाना चाहिए.
Google, रीडायरेक्ट एफ़ओपी पेमेंट पूरा करने के लिए दो मुख्य फ़्लो का इस्तेमाल करता है:
- रीडायरेक्ट शुरू करना: दो अलग-अलग फ़्लो हैं जो रीडायरेक्ट पेमेंट शुरू कर सकते हैं. पेमेंट इंटिग्रेटर को इनमें से सिर्फ़ एक विकल्प लागू करना चाहिए:
- रीडायरेक्ट फ़्लो शुरू करना: उपयोगकर्ता को पेमेंट इंटिग्रेटर पर रीडायरेक्ट करके, पेमेंट की प्रक्रिया शुरू करता है.
- रीडायरेक्ट पेमेंट यूआरएल फ़्लो जनरेट करें: Google, पेमेंट इंटीग्रेटर को एक सर्वर-टू-सर्वर अनुरोध भेजकर पेमेंट करने की प्रक्रिया शुरू करता है, ताकि रीडायरेक्ट पेमेंट यूआरएल जनरेट किया जा सके. जवाब के आधार पर, Google उपयोगकर्ता को सीधे उसे जारी करने वाले के पास रीडायरेक्ट कर देता है.
- रीडायरेक्ट की पूरी प्रोसेस: उपयोगकर्ता की खरीदारी पूरी करने के बाद, इंटिग्रेटर इस फ़्लो का इस्तेमाल, Google से पेमेंट की पुष्टि करने के लिए करता है.
आखिर में, इंटिग्रेटर के बैंक और Google के बैंक के बीच पैसे ट्रांसफ़र करने का काम, रेमिटेंस फ़्लो में होता है.
रीडायरेक्ट एफ़ओपी की खास जानकारी
यहां दिए गए डायग्राम में, फ़्लो के बारे में खास जानकारी दी गई है:
बड़े लेवल पर, Google प्रॉडक्ट के लिए पैसे चुकाने के तरीके के तौर पर अपनी सेवा जोड़ने में ये फ़्लो शामिल हैं:
- रीडायरेक्ट करना शुरू करें:
- रीडायरेक्ट होने की प्रोसेस पूरी करना
- रिफ़ंड फ़्लो
- पेमेंट फ़्लो
सिद्धांत और शब्दावली
प्रतीक और सम्मेलन
इन दस्तावेज़ों में मुख्य शब्दों "करना चाहिए," "नहीं करना है," "ज़रूरी है," "करना चाहिए," "नहीं करना चाहिए", "चाहिए," "नहीं," "सुझाया गया," "किया जा सकता है", और "वैकल्पिक" का मतलब आरएफ़सी 2119 में बताए गए तरीके से समझना है.
टाइमस्टैंप वाले हिस्सों में
सभी टाइमस्टैंप, यूटीसी में Unix epoch (1 जनवरी, 1970) के बाद से मिलीसेकंड के तौर पर दिखाए जाते हैं.
उदाहरण के लिए:
- 23 अप्रैल, 2019 रात 8:23:25 बजे जीएमटी = 1556051005000 मिलीसेकंड
- 16 अगस्त, 2018 को दोपहर 12:28:35 बजे जीएमटी = 1534422515000 मिलीसेकंड
राशियाँ
इस एपीआई में मॉनेटरी वैल्यू, Google के स्टैंडर्ड फ़ॉर्मैट में "माइक्रो" के फ़ॉर्मैट में होती हैं. माइक्रो, पूर्णांक पर आधारित और तय सटीक फ़ॉर्मैट होते हैं. किसी मॉनेटरी वैल्यू को माइक्रो में दिखाने के लिए, स्टैंडर्ड मुद्रा की वैल्यू को 10,00,000 से गुणा करें.
उदाहरण के लिए:
- 1.23 डॉलर = 1,230,000 माइक्रो डॉलर
- 0.01 डॉलर = 10,000 माइक्रो डॉलर
पहचान न कर पाना
इस एपीआई में सभी मेथड कॉल का व्यवहार एक जैसा होना चाहिए. Google यह पक्का करने के लिए कभी-कभी अनुरोध करेगा कि दोनों तरफ़ लेन-देन एक ही स्थिति में हो. इंटिग्रेटर को पहले से ही प्रोसेस हो चुके किसी भी अनुरोध को फिर से प्रोसेस करने की कोशिश नहीं करनी चाहिए. इसके बजाय, प्रोसेस हो जाने के बाद के रिस्पॉन्स की रिपोर्ट की जानी चाहिए. सभी तरीकों में एक समान RequestHeader होता है, जिसमें एक requestId होता है. यह requestId सभी कॉल के लिए पहचान कुंजी है.
कोई भी बिना टर्मिनल वाला रिस्पॉन्स (जो एचटीटीपी 200 के बाद वाला वर्शन नहीं है) सही तरीके से प्रोसेस नहीं किया जाना चाहिए. इसलिए, अगर किसी अनुरोध के लिए 400 कोड (खराब अनुरोध/पहले से तय शर्त पूरी नहीं की गई है) मिला है, जिसे दूसरी बार कॉल किया जाता है, तो उसका फिर से आकलन करना ज़रूरी है. ऐसे में, गलती से 400 कोड वाली गड़बड़ी नहीं होनी चाहिए. फिर से जांचने पर, हो सकता है कि 400 कोड वाली गड़बड़ी दिखे या इसे प्रोसेस किया जा सके.
पहचान के बारे में ज़्यादा जानने के लिए, यह ज़्यादा जानकारी वाली गाइड देखें.
इंटिग्रेटर
वह कंपनी जो अपने कारोबार के लिए Google के पेमेंट प्लैटफ़ॉर्म का इस्तेमाल करती है. यह YouTube या AdWords जैसा कोई इंटरनल (1P) कारोबार हो सकता है. साथ ही, यह बाहरी (3P) कारोबार भी हो सकता है, जो Google के नेटवर्क के साथ काम करने के लिए, अपनी सेवाओं को इंटिग्रेट करना चाहता है.
एफ़ओपी
पैसे चुकाने का तरीका. यह किसी इंस्ट्रुमेंट की तुलना में ज़्यादा सामान्य है. Visa, Mastercard, और PayPal, सभी एफ़ओपी हैं.
भुगतान का माध्यम
किसी ग्राहक की ओर से पैसे चुकाने के तरीके का कोई खास मामला. उदाहरण के लिए, किसी उपयोगकर्ता का क्रेडिट कार्ड या उसका PayPal खाता. किसी ग्राहक के लिए, टोकन वाला एफ़ओपी भी एक इंस्ट्रुमेंट होता है. इसकी वजह यह है कि यह उस ग्राहक के लिए पैसे चुकाने का एक इंस्टेंस होता है, जो हमारे सिस्टम में सुरक्षित तरीके से सेव रहता है.
टोकन
Google के सिस्टम पर, किसी उपयोगकर्ता के पेमेंट के तरीके के बारे में जानकारी. इसमें खरीदारी के लिए ज़रूरी सारी जानकारी शामिल होती है. इसलिए, टोकन भी एक इंस्ट्रुमेंट है. इसमें उपयोगकर्ता के इंटिग्रेटर के पास मौजूद खाता नंबर जैसी जानकारी शामिल हो सकती है.
मुख्य फ़्लो
रीडायरेक्ट फ़्लो शुरू करना
रीडायरेक्ट पेमेंट का पहला चरण 'रीडायरेक्ट करना शुरू करें' फ़्लो है. रीडायरेक्ट फ़्लो शुरू करने का मकसद, इंटिग्रेटर की मदद से, उपयोगकर्ता को उसके चुने हुए वर्शन जारी करने वाले के वेब इंटरफ़ेस पर रीडायरेक्ट करना है, ताकि वे पेमेंट को अनुमति दे सकें. रीडायरेक्ट करने पर, Google, इंटिग्रेटर को लेन-देन की बुनियादी जानकारी देता है और उसे जारी करने वाले को भेज देता है.
ज़्यादा जानकारी के लिए, रीडायरेक्ट फ़्लो शुरू करना सेक्शन देखें.
रीडायरेक्ट पूरा करें
उपयोगकर्ता के वेब इंटरफ़ेस पर पहुंचने के बाद, उसे पेमेंट करने के लिए सभी ज़रूरी चरणों को पूरा करना होगा. पेमेंट जारी करने वाले बैंक या कंपनी के हिसाब से, ये चरण बदल सकते हैं. रीडायरेक्ट होने की पूरी प्रक्रिया के तहत, इसे जारी करने वाले को उपयोगकर्ता को पेमेंट पूरा होने के बारे में जानकारी के साथ इंटिग्रेटर पर वापस रीडायरेक्ट करना चाहिए. इंटिग्रेटर, रीडायरेक्ट करने के दौरान उपयोगकर्ता को वापस Google पर रीडायरेक्ट कर देगा. इसमें पेमेंट के तरीके की जानकारी भी शामिल होगी. पेमेंट की पुष्टि होने के बाद, Google, खरीदे गए सामान या सेवाएं उपयोगकर्ता को देगा.
ज़्यादा जानकारी के लिए, रीडायरेक्ट करने की पूरी प्रक्रिया सेक्शन देखें.