कैश FOP

खास जानकारी

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

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

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

Symbols & Conventions

The key words "MUST," "MUST NOT," "REQUIRED," "SHALL," "SHALL NOT," "SHOULD," "SHOULD NOT," "RECOMMENDED," "MAY," and "OPTIONAL" in these documents are to be interpreted as described in RFC 2119.

Timestamps

All timestamps are represented as milliseconds since the Unix epoch (Jan 1, 1970) in UTC.

For example:

  • April 23, 2019 8:23:25 PM GMT = 1556051005000 milliseconds
  • August 16, 2018 12:28:35 PM GMT = 1534422515000 milliseconds

Amounts

Monetary values in this API are in a format called "micros," a standard at Google. Micros are an integer based, fixed precision format. To represent a monetary value in micros, multiply the standard currency value by 1,000,000.

For example:

  • USD$1.23 = 1230000 micro USD
  • USD$0.01 = 10000 micro USD

Idempotency

All method calls within this API must have idempotent behavior. Google will sporadically retry requests to ensure that transactions are in the same state on both sides. Integrators should not attempt to reprocess any request already successfully processed. The response for the successful processing should be reported instead. All methods have a common RequestHeader which contains a requestId. This requestId is the idempotency key for all calls.

Any non terminal response (a non HTTP 200-success), must not be idempotently processed. So a request that previously got a 400 (bad request/failed precondition), when called a second time, must not idempotently return 400, it must be re-evaluated. At re-evaluation, it could return a 400 or be processed successfully.

For more information on idempotency see this detailed guide.

Integrator

A company who uses Google’s Payment Platform for their business. It could be internal (1P), such as Youtube or AdWords, It can also be an external (3P) business wanting to integrate their service to work with Google’s ecosystem.

FOP

Form of Payment. This is more general than an instrument. Visa, MasterCard, and PayPal are all FOPs.

Instrument

A particular instance of a form of payment by a specific customer. For instance, a user’s credit card, or their PayPal account. A tokenized FOP for a particular customer is also an instrument, because it is an instance of a form of payment for that customer, securely stored on our system.

Token

A representation, on Google’s system, of a specific user’s payment method. Since it contains all the information needed to make a purchase, a token is also an instrument. This may include such information as an account number a user has with their integrator.

की फ़्लो

ये रेफ़रंस नंबर बनाने और पेमेंट करने के लिए, 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 रिस्पॉन्स कोड दिखना चाहिए.

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