कैश FOP

खास जानकारी

Google Standard Payments, कैश पर आधारित एफ़ओपी (पैसे चुकाने के तरीके) के साथ काम करता है. जैसे, शॉपिंग स्टोर से खरीदारी (जैसे कि 7-Eleven). हाई लेवल पर, जो उपयोगकर्ता सामान के लिए पेमेंट करना चाहता है वह पेमेंट इंटिग्रेटर के ज़रिए रेफ़रंस नंबर जनरेट करता है. इसके बाद उपयोगकर्ता इस रेफ़रंस नंबर को किसी शॉपिंग स्टोर, कीऑस्क या बैंक पर ले जाता है और रेफ़रंस नंबर का पेमेंट करता है.

पेमेंट का तरीका जोड़ें
1) उपयोगकर्ता, पेमेंट का कोई तरीका जोड़े
पेमेंट करने के लिए कोई प्लैटफ़ॉर्म चुनें
2) इसके बाद, वह पेमेंट करने की जगह तय करता है
भुगतान निर्देश
3) आखिर में, उन्हें पेमेंट से जुड़े निर्देश दिए जाते हैं

कॉन्सेप्ट और शब्दावली

प्रतीक और सम्मेलन

कीवर्ड में "ज़रूरी", "नहीं करना चाहिए" "ज़रूरी," "शुरू होगी," "नहीं होना चाहिए," "होना चाहिए," "नहीं होना चाहिए," "सुझाया गया," "मई," और "ज़रूरी नहीं" ये दस्तावेज़, आरएफ़सी 2119 में बताए गए तरीके के मुताबिक स्वीकार किए जाने चाहिए.

टाइमस्टैंप

सभी टाइमस्टैंप, यूटीसी में Unix epoch (1 जनवरी, 1970) से मिलीसेकंड के तौर पर दिखाए जाते हैं.

उदाहरण के लिए:

  • 23 अप्रैल, 2019 8:23:25 PM GMT = 1556051005000 मिलीसेकंड
  • 16 अगस्त, 2018 12:28:35 PM GMT = 1534422515000 मिलीसेकंड

राशियाँ

इस API में आर्थिक मूल्य "माइक्रो" नाम के प्रारूप में होते हैं, बेंचमार्क में जोड़ दिया जाता है. माइक्रो सटीक तौर पर दिखने वाले, पूर्णांक पर आधारित फ़ॉर्मैट होते हैं. माइक्रो में मॉनेटरी वैल्यू दिखाने के लिए, स्टैंडर्ड मुद्रा की वैल्यू को 10,00,000 से गुणा करें.

उदाहरण के लिए:

  • 1.23 डॉलर = 1,230,000 माइक्रो डॉलर
  • USD$0.01 = 10,000 माइक्रो डॉलर

इडेमपोटेंसी

इस एपीआई में शामिल सभी तरीकों से किए जाने वाले कॉल का एक जैसा व्यवहार होना चाहिए. Google समय-समय पर अनुरोधों को फिर से भेजने की कोशिश करेगा, ताकि यह पक्का किया जा सके कि दोनों तरफ़ लेन-देन एक ही स्थिति में हों. इंटिग्रेटर को ऐसे किसी अनुरोध को फिर से प्रोसेस करने की कोशिश नहीं करनी चाहिए जो पहले ही प्रोसेस हो चुका है. इसके बजाय, डेटा प्रोसेसिंग के रिस्पॉन्स की रिपोर्ट दी जानी चाहिए. सभी तरीकों का एक ही RequestHeader होता है, जिसमें एक requestId होता है. यह requestId सभी कॉल के लिए पहचान में न आने वाली कुंजी है.

कोई भी बिना टर्मिनल रिस्पॉन्स (बिना एचटीटीपी 200-सक्सेस) को आसानी से प्रोसेस न किया जाना चाहिए. इसलिए, अगर किसी अनुरोध में पहले 400 (खराब अनुरोध/पहले से तय की गई शर्त) मिली है और दूसरी बार में अनुरोध किया गया है, तो उसे आसानी से 400 नहीं दिखना चाहिए. ऐसे अनुरोध की फिर से जांच की जानी चाहिए. फिर से जांच करने पर, यह 400 कोड दिखा सकती है या प्रोसेस किए जा सकती है.

नशे की लत के बारे में ज़्यादा जानने के लिए, यह ज़्यादा जानकारी वाली गाइड देखें.

इंटिग्रेटर

ऐसी कंपनी जो अपने कारोबार के लिए, Google के पेमेंट प्लैटफ़ॉर्म का इस्तेमाल करती है. यह YouTube या AdWords जैसे अंदरूनी (1P) कारोबार हो सकता है. यह कोई ऐसा बाहरी (3P) कारोबार भी हो सकता है जो अपनी सेवाओं को Google के नेटवर्क के साथ जोड़ने के लिए इंटिग्रेट करना चाहता है.

एफ़ओपी

पेमेंट का तरीका. यह किसी इंस्ट्रुमेंट से ज़्यादा सामान्य है. Visa, MasterCard, और PayPal, सभी एफ़ओपी हैं.

भुगतान का माध्यम

किसी ग्राहक की ओर से किए गए पेमेंट के तरीके की खास स्थिति. उदाहरण के लिए, उपयोगकर्ता का क्रेडिट कार्ड या उनका PayPal खाता. किसी ग्राहक के लिए, टोकन के तौर पर दिया गया एफ़ओपी भी एक इंस्ट्रुमेंट है, क्योंकि यह उस ग्राहक के लिए पैसे चुकाने का एक इंस्टेंस होता है. यह हमारे सिस्टम पर सुरक्षित तरीके से सेव होता है.

टोकन

Google के सिस्टम पर किसी उपयोगकर्ता के पेमेंट के तरीके की जानकारी. इसमें खरीदारी करने के लिए सारी ज़रूरी जानकारी मौजूद होती है. इसलिए, टोकन एक इंस्ट्रुमेंट भी होता है. इसमें ऐसी जानकारी शामिल हो सकती है जो किसी उपयोगकर्ता के पास उसके इंटिग्रेटर के पास मौजूद खाता नंबर हो.

की फ़्लो

ये रेफ़रंस नंबर बनाने और पेमेंट करने के लिए, Google दो बटन इस्तेमाल करता है:

  1. रेफ़रंस नंबर फ़्लो जनरेट करें.
  2. पेमेंट रेफ़रंस नंबर का फ़्लो.

बाद में, खरीदारी से जुड़े समाधान और उनके सेटलमेंट को, पैसे भेजने से जुड़े फ़्लो की मदद से मैनेज किया जाता है.

नीचे दिया गया डायग्राम, इनमें से हर एक फ़्लो को दिखाता है.

कैश एफ़ओपी की खास जानकारी

कैश एफ़ओपी के बारे में खास जानकारी

नीचे दिए गए सेक्शन में, पहले दो फ़्लो के बारे में ज़्यादा जानकारी दी गई है. अगर आपको इस फ़्लो के बारे में ज़्यादा जानकारी चाहिए, तो पैसे भेजने की प्रोसेस पेज पर जाएं.

रेफ़रंस नंबर जनरेट करें

रेफ़रंस नंबर फ़्लो का मकसद एक ऐसा आइडेंटिफ़ायर (रेफ़रंस नंबर) बनाना और उसे एक्सचेंज करना होता है जिसका इस्तेमाल Google और इंटिग्रेटर, दोनों खरीदारी की पहचान करने के लिए कर सकें. इसके बाद, उपयोगकर्ता इस रेफ़रंस नंबर का इस्तेमाल शॉपिंग स्टोर, कीऑस्क या बैंक में खरीदारी पूरी करने के लिए कर सकता है. यह आइडेंटिफ़ायर, Google के अनुरोध पर इंटिग्रेटर की ओर से जनरेट किया जाता है. इसके लिए, generateReferenceNumber तरीके का इस्तेमाल किया जाता है. रेफ़रंस नंबर जनरेट करने के अनुरोध में, रकम और लेन-देन का ब्यौरा शामिल होता है.

यह डायग्राम दिखाता है कि रेफ़रंस नंबर कैसे जनरेट किया जाता है और निर्देशों के साथ ग्राहक को कैसे भेजा जाता है.

रेफ़रंस नंबर फ़्लो जनरेट करें

कैश जनरेट करने का रेफ़रंस नंबर

यहां ऑब्जेक्ट और उनके बारे में जानकारी दी गई है:

  • उपयोगकर्ता: यह वह व्यक्ति है जो पेमेंट के इस तरीके का इस्तेमाल करके किसी चीज़ के लिए पेमेंट करना चाहता है.
  • Google यूज़र इंटरफ़ेस (यूआई): यह वह इंटरफ़ेस है जहां उपयोगकर्ता अपनी खरीदारी करता है. इसके लिए, वेब या किसी ऐप्लिकेशन का इस्तेमाल किया जा सकता है.
  • Google सर्वर: Google का बैकएंड सर्वर, जो रेफ़रंस नंबर जनरेट करने का अनुरोध करता है और उपयोगकर्ता के लिए पैसे चुकाने के निर्देश बनाता है.
  • पेमेंट इंटिग्रेटर सर्वर: पेमेंट इंटिग्रेटर का बैकएंड सर्वर, जो पेमेंट के तरीके की जानकारी को ट्रैक करता है और रेफ़रंस नंबर जनरेट करता है.

यह फ़्लो उस उपयोगकर्ता के साथ शुरू होता है जो पैसे चुकाने के इस तरीके का इस्तेमाल करना चाहता है.

  1. उपयोगकर्ता Google यूज़र इंटरफ़ेस (यूआई) को ऐक्सेस करता है, जो रेफ़रंस नंबर के लिए अनुरोध भेजता है.
  2. Google यूज़र इंटरफ़ेस (यूआई), Google सर्वर को यह मैसेज भेजता है कि उसे रेफ़रंस नंबर (getReferenceNumber) की ज़रूरत है.
  3. Google सर्वर, पेमेंट इंटिग्रेटर सर्वर से रेफ़रंस नंबर (generateReferenceNumber) जनरेट करने के लिए कहता है.
  4. पेमेंट इंटिग्रेटर सर्वर, रेफ़रंस नंबर जनरेट करके उसे Google सर्वर को भेजता है.
  5. Google सर्वर, रेफ़रंस नंबर के साथ पेमेंट से जुड़े निर्देश बनाता है. इसके बाद, यह जानकारी को Google यूज़र इंटरफ़ेस (यूआई) पर भेजता है.
  6. Google का यूज़र इंटरफ़ेस (यूआई), उपयोगकर्ता को ये निर्देश और रेफ़रंस नंबर भेजता है.

रेफ़रंस नंबर के बारे में नोट

रेफ़रंस नंबर के लिए, सिर्फ़ एक बार पेमेंट किया जा सकता है और रेफ़रंस नंबर को रद्द करने के फ़्लो के ज़रिए रद्द किया जा सकता है. साथ ही, रेफ़रंस नंबर में अक्षर और अंक होने चाहिए. साथ ही, वे कई डिसप्ले फ़ॉर्मैट के साथ काम करने चाहिए.

Google के यूज़र इंटरफ़ेस (यूआई), रेफ़रंस नंबर दिखाने के साथ-साथ, कोड 128 फ़ॉर्मैट (बारकोड फ़ॉर्मैट) में रेफ़रंस नंबर दिखा सकते हैं. अन्य बारकोड फ़ॉर्मैट, अनुरोध पर काम करते हैं.

पेमेंट के लिए रेफ़रंस नंबर

उपयोगकर्ता इस रेफ़रंस नंबर का इस्तेमाल किसी शॉपिंग स्टोर, कीऑस्क या बैंक में उस खरीदारी की पहचान करने के लिए करेगा जिसके लिए उपयोगकर्ता पेमेंट करना चाहता है. इंटिग्रेटर को खरीदारी की पुष्टि करने के लिए कहना चाहिए. इसके लिए, खरीदारी से पहले खरीदारी की रकम, तारीख, और लेन-देन की जानकारी दिखाई जानी चाहिए.

उपयोगकर्ता जब पेमेंट करने का विकल्प चुनता है, तो उसे पूरा पेमेंट करना होगा और सिर्फ़ एक बार ही पेमेंट करना होगा. यह एपीआई किसी एक रेफ़रंस नंबर से ज़्यादा या कम पेमेंट के साथ काम नहीं करता. किसी एक रेफ़रंस नंबर पर कई बार पेमेंट करने की सुविधा भी काम नहीं करती.

उपयोगकर्ता के पेमेंट करने के बाद, इंटिग्रेटर को Google को तुरंत बताना होगा कि इस रेफ़रंस नंबर के लिए, referenceNumberPaidNotification तरीके से पेमेंट किया गया है. इंटिग्रेट करने वाला टूल, उपयोगकर्ता को सामान मिलने के कुछ सेकंड में ही इस तरीके को कॉल कर देता है. इससे, उपयोगकर्ता अपना सामान तुरंत पा सकता है. (अगर नेटवर्क बंद है, तो इस कॉल को सूची में जोड़ा जा सकता है.)

पेमेंट होने के बाद, रेफ़रंस नंबर और रकम की जानकारी, T+2 दिनों में भेजे गए पैसे के स्टेटमेंट में शामिल कर दी जाएगी.

यहां एक क्रम वाला डायग्राम दिया गया है, जिसमें रेफ़रंस नंबर के पेमेंट को दिखाया गया है.

पेमेंट रेफ़रंस नंबर फ़्लो

पेमेंट रेफ़रंस नंबर फ़्लो

डायग्राम में मौजूद ऑब्जेक्ट ये दिखाते हैं:

  • उपयोगकर्ता: यह वह व्यक्ति है जो पेमेंट के इस तरीके का इस्तेमाल करके किसी चीज़ के लिए पेमेंट करना चाहता है.
  • सुविधा स्टोर: वह जगह जहां उपयोगकर्ता रेफ़रंस नंबर और निर्देशों का इस्तेमाल करके पेमेंट करता है, जैसे कि शॉपिंग स्टोर.
  • पेमेंट इंटिग्रेटर सर्वर: पेमेंट इंटिग्रेटर का बैकएंड सर्वर, जो पेमेंट के तरीके की जानकारी का ट्रैक रखता है.
  • Google सर्वर: Google का बैकएंड सर्वर, जो रेफ़रंस नंबर जनरेट करने का अनुरोध करता है और उपयोगकर्ता के लिए पैसे चुकाने के निर्देश बनाता है.

यह फ़्लो उस उपयोगकर्ता के साथ शुरू होता है, जो शॉपिंग स्टोर पर जाता है और दिए गए निर्देशों के मुताबिक पेमेंट करता है.

  1. उपयोगकर्ता पेमेंट करने के लिए शॉपिंग स्टोर पर जाता है.
  2. लेन-देन पूरा होने के बाद, शॉपिंग स्टोर पेमेंट इंटिग्रेटर को पेमेंट के बारे में सूचना देता है.
  3. पेमेंट इंटिग्रेटर सर्वर, सुविधा स्टोर को सफल होने का मैसेज भेजता है.
  4. सुविधा स्टोर बताता है कि उपयोगकर्ता के लिए लेन-देन सफल रहा और सामान जल्द ही उपयोगकर्ता को डिलीवर कर दिया जाएगा.
  5. पेमेंट इंटिग्रेटर सर्वर, Google के सर्वर को यह मैसेज भेजता है कि रेफ़रंस नंबर के लिए पेमेंट कर दिया गया है (referenceNumberPaidNotification). इस चरण से चरण 4 को ब्लॉक नहीं करना चाहिए.
  6. Google सर्वर, पेमेंट इंटिग्रेटर सर्वर की सफलता का मैसेज भेजकर जवाब देता है.

रेफ़रंस नंबर रद्द करें

रेफ़रंस नंबर, Google रद्द कर सकता है. अगर Google किसी रेफ़रंस नंबर को रद्द कर देता है, तो cancelReferenceNumber वाला तरीका इस्तेमाल किया जाएगा. इस कॉल के सही तरीके से वापस आने पर, उस रेफ़रंस नंबर के लिए पेमेंट नहीं किया जा सकता. इंटिग्रेटर को इस नंबर के लिए पेमेंट करने से मना कर देना चाहिए. इस कॉल के सफल होने के बाद, referenceNumberPaidNotification पर किए जाने वाले सभी कॉल काम नहीं करेंगे.

अगर पेमेंट की प्रोसेस पहले ही शुरू हो चुकी है. उदाहरण के लिए, अगर उपयोगकर्ता ने कीऑस्क में अपना रेफ़रंस नंबर डाला है, लेकिन अब तक पेमेंट नहीं किया है, तो इंटिग्रेटर को USER_ACTION_IN_PROGRESS वाले errorResponse के साथ एचटीटीपी 423 रिस्पॉन्स कोड दिखना चाहिए.

अगला चरण: पैसे भेजने का फ़्लो