खास जानकारी
कार्ड एफ़ओपी (पेमेंट का तरीका) एपीआई, उन पेमेंट का समर्थन करता है जो इनका इस्तेमाल करके किए जाते हैं स्टैंडर्ड कार्ड. ये क्रेडिट और डेबिट कार्ड हो सकते हैं. सिंगल- और पेमेंट के लिए दिया जाने वाला ड्यूअल-मैसेज फ़्लो.
अहम जानकारी
प्रतीक और सम्मेलन
इन दस्तावेज़ों में मुख्य शब्दों "करना चाहिए", "नहीं करना है", "ज़रूरी", "करना चाहिए", "नहीं करना चाहिए", "चाहिए", "नहीं करना चाहिए", "सुझाया गया", "किया जा सकता है", और "वैकल्पिक" का मतलब आरएफ़सी 2119 में बताए गए तरीके से समझा जाना चाहिए.
टाइमस्टैंप वाले हिस्सों में
यूटीसी में Unix epoch के बाद से, सभी टाइमस्टैंप को मिलीसेकंड के तौर पर दिखाया जाता है.
उदाहरण के लिए:
- 14 अगस्त, 2010 16:30:00.00 AM GMT = 1281803400000
- 6 नवंबर, 2007 9:37:00 PM MST = 1194410220000
राशियाँ
इस एपीआई में मॉनेटरी वैल्यू को "माइक्रो" फ़ॉर्मैट का इस्तेमाल करके दिखाया जाता है. यह Google के लिए एक स्टैंडर्ड फ़ॉर्मैट है. माइक्रो, पूर्णांक पर आधारित और तय सटीक फ़ॉर्मैट होते हैं. मॉनेटरी वैल्यू को माइक्रो में दिखाने के लिए, स्टैंडर्ड मुद्रा की वैल्यू को 10,00,000 से गुणा करें.
उदाहरण के लिए:
- 1.23 डॉलर = 1,230,000 माइक्रो डॉलर
- 0.01 डॉलर = 10,000 माइक्रो डॉलर
पहचान न कर पाना
इस एपीआई में सभी मेथड कॉल का व्यवहार एक जैसा होना चाहिए. आसान शब्दों में कहें, तो इंटिग्रेटर को पहले ही प्रोसेस हो चुके किसी भी अनुरोध को फिर से प्रोसेस करने की कोशिश नहीं करनी चाहिए. इसके बजाय, प्रोसेस हो जाने के बाद मिले रिस्पॉन्स की रिपोर्ट की जानी चाहिए. सभी तरीकों का एक सामान्य requestHeader होता है, जिसमें एक requestId होता है. यह requestId सभी कॉल के लिए पहचान कुंजी है.
बिना टर्मिनल वाले जवाब (बिना एचटीटीपी 200) के, बिना किसी जांच के प्रोसेस नहीं किया जाना चाहिए. इसलिए, अगर किसी अनुरोध के लिए पहले 400 का कोड मिला है और दूसरी बार कॉल किया जाता है, तो उसका फिर से आकलन किया जाना चाहिए. फिर से जांचने पर, यह 400 दिखा सकता है या सही तरीके से प्रोसेस हो सकता है.
पहचान की पुष्टि के बारे में ज़्यादा जानने के लिए, ज़्यादा जानकारी वाली गाइड देखें.
कैप्चर फ़्लो रिज़र्व करें
रिज़र्व कैप्चर फ़्लो, दो मैसेज फ़्लो में होता है कौनसी रकम पहले बुक की जाती है और फिर बाद में कैप्चर कर ली जाती है. बुकिंग के दौरान पैसों का कोई लेन-देन नहीं होता. इसके बाद, बुकिंग रद्द की जा सकती है या उसे कैप्चर किया जा सकता है. कॉन्टेंट बनाने कैप्चर या रद्द करने का फ़ाइनल नतीजा, Google को एसिंक्रोनस रूप से लौटाया जाता है क्लिक करें.
पेमेंट इंटिग्रेटर, लागू करता है
Google लागू करता है
captureFundsReservationResultNotification
cancelFundsReservationResultNotification
setAcquirerReferenceNumberForCaptureNotification
रिज़र्व कैप्चर के बारे में ज़्यादा जानकारी के लिए, इसे देखें ज़्यादा जानकारी वाली गाइड.
फ़ंड ट्रांसफ़र फ़्लो
फ़ंड ट्रांसफ़र फ़्लो,
इसके अलावा, कौनसे फ़ंड सीधे तौर पर कैप्चर किए जाते हैं. यह फ़्लो एक ऐसा तरीका होता है जो
इसे Capture
नाम का पेमेंट इंटिग्रेटर लागू करता है. यह तरीका
साथ ही, उपलब्ध फ़ंड की जांच करता है और सफल होने पर फ़ंड को कैप्चर करता है.
पेमेंट इंटिग्रेटर, लागू करता है
Google लागू करता है
फ़ंड ट्रांसफ़र के बारे में ज़्यादा जानकारी के लिए इसे देखें ज़्यादा जानकारी वाली गाइड.
रिफ़ंड फ़्लो
रिफ़ंड फ़्लो का इस्तेमाल करके, पुराने पैसे वापस किए जाते हैं रिज़र्व कैप्चर फ़्लो से कैप्चर किया जाता है या फ़ंड ट्रांसफ़र फ़्लो.
पेमेंट इंटिग्रेटर, लागू करता है
Google लागू करता है
रिफ़ंड के बारे में ज़्यादा जानकारी के लिए, यह ज़्यादा जानकारी वाली गाइड देखें.
डिसप्यूट फ़्लो
विवाद का फ़्लो. का इस्तेमाल Google को विवादों की सूचना देने के लिए किया जाता है. साथ ही, ऐसे चार्जबैक (पैसे खाते में वापस आना) जिनमें ग्राहक पैसे वापस पाने का अनुरोध करता है. हर कॉल नहीं इसका मतलब मुद्रा के लेन-देन से है, लेकिन इस फ़्लो का इस्तेमाल ग्राहक को पैसे लौटाने के लिए किया जा सकता है. या उन्हें वापस Google को वापस भेज सकते हैं. इस फ़्लो का इस्तेमाल इनमें धोखाधड़ी वाली रिपोर्टिंग फ़्लो को शामिल करता है, लेकिन जिसमें धोखाधड़ी शामिल हो.
Google लागू करता है
विवादों के बारे में ज़्यादा जानकारी के लिए, यह ज़्यादा जानकारी वाली गाइड देखें.
धोखाधड़ी की शिकायत करने का फ़्लो
धोखाधड़ी की शिकायत करने का फ़्लो, Google को यह बताने के लिए है कि संभावित धोखाधड़ी हो सकती है. इस जानकारी से किसी तरह का पैसा ट्रांसफ़र नहीं होता है और का इस्तेमाल, Google के Risk Engine को इवेंट की जानकारी देने के लिए किया जाता है. ऐसा इसलिए किया जाता है, ताकि कम किया जा सकता है. इसके साथ विवाद या चार्जबैक (पैसे खाते में वापस आना) भी हो सकता है. विवाद का फ़्लो.
Google लागू करता है
धोखाधड़ी की शिकायत करने से जुड़ी ज़्यादा जानकारी के लिए इसे देखें ज़्यादा जानकारी वाली गाइड.