खास जानकारी
कार्ड एफ़ओपी (पैसे चुकाने का तरीका) एपीआई, स्टैंडर्ड कार्ड से किए जाने वाले पेमेंट में काम करता है. ये क्रेडिट और डेबिट कार्ड हो सकते हैं. पेमेंट के लिए, सिंगल- और ड्यूअल-मैसेज फ़्लो दिया जाता है.
अहम जानकारी
प्रतीक और सम्मेलन
इन दस्तावेज़ों में मुख्य शब्दों "करना चाहिए", "नहीं करना है", "ज़रूरी", "करना चाहिए", "नहीं करना चाहिए", "चाहिए", "नहीं करना चाहिए", "सुझाया गया", "किया जा सकता है", और "वैकल्पिक" का मतलब आरएफ़सी 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 के रिस्क इंजन को इवेंट के बारे में बताने के लिए किया जाता है, ताकि धोखाधड़ी को कम किया जा सके. इसके लिए, विवादित फ़्लो की मदद से, विवाद दर्ज किया जा सकता है या चार्जबैक (पैसे खाते में वापस आना) किया जा सकता है.
Google ने
धोखाधड़ी की शिकायत करने के बारे में ज़्यादा जानने के लिए, यह ज़्यादा जानकारी वाली गाइड देखें.