नेटिव चेकआउट की खास जानकारी

उपयोगकर्ताओं को चेक आउट करने की सुविधा देने के लिए, आपको नेटिव चेकआउट इंटिग्रेशन लागू करना होगा. इसके लिए, एक स्टैंडर्ड REST API बनाना होगा. इससे Google, आपके सर्वर के साथ चेकआउट प्रोसेस को प्रोग्राम के हिसाब से मैनेज कर पाएगा. इस तरीके से, उपयोगकर्ताओं को सबसे बेहतर अनुभव मिलता है. शुरुआत में, Google खरीदार के लिए यूज़र इंटरफ़ेस रेंडर करेगा. आने वाले समय में, Google का प्लान ज़्यादा एजेंटिक अनुभवों के लिए सहायता उपलब्ध कराने का है.

चेकआउट प्रोसेस

नेटिव इंटिग्रेशन के लिए, आपको एक RESTful API बनाना होगा. इससे Google, चेकआउट सेशन बना और मैनेज कर सकेगा.

पूरी प्रोसेस इस तरह होती है:

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

चेकआउट सेशन की स्थिति का लाइफ़साइकल

जब उपयोगकर्ता चेकआउट फ़्लो में आगे बढ़ता है, तब आपको चेकआउट सेशन status को अपडेट करना होगा, ताकि उसकी मौजूदा स्थिति दिख सके. सेशन का लाइफ़साइकल इस तरह होता है:

  • incomplete: सेशन बनाए जाने पर, यह शुरुआती स्थिति होती है. इससे पता चलता है कि ज़रूरी जानकारी (जैसे कि शिपिंग के तरीके, टैक्स या उपयोगकर्ता की जानकारी) मौजूद नहीं है या उसका हिसाब नहीं लगाया गया है.
  • ready_for_payment: उपयोगकर्ता के शिपिंग पते को अपडेट करने के बाद इस स्टेटस का इस्तेमाल किया जाता है. साथ ही, शिपिंग के विकल्पों और कुल कीमत का हिसाब लगाने से पहले और पेमेंट के तरीके को फ़ाइनल करने से पहले भी इसका इस्तेमाल किया जाता है.
  • ready_for_complete: पेमेंट करने का तरीका चुनने और ऑर्डर की सभी जानकारी की पुष्टि हो जाने के बाद, चेकआउट ऑब्जेक्ट को पूरी तरह से हाइड्रेट करने के दौरान इस्तेमाल किया जाने वाला स्टेटस.
  • completed: यह वह स्टेटस होता है जो पेमेंट प्रोसेस करने और ऑर्डर देने के बाद दिखता है.
  • canceled: चेकआउट सेशन के रद्द होने पर यह स्टेटस दिखता है.
  • error: यह स्टेटस तब दिखता है, जब कारोबार के लॉजिक से जुड़ी ऐसी गड़बड़ी होती है जिसे ठीक नहीं किया जा सकता. इस वजह से, चेकआउट नहीं किया जा सकता. यह स्टेटस, UCP के वर्शन 2026-04-08 और इसके बाद के वर्शन में उपलब्ध है.

एक से ज़्यादा आइटम के लिए चेकआउट प्रोसेस:

Google अब एक ही चेकआउट सेशन में कई अलग-अलग लाइन आइटम के लिए सहायता करता है. सामान्य फ़्लो इस तरह होता है:

  1. उपयोगकर्ता, UCP की सुविधा वाले इंटरफ़ेस से चेकआउट शुरू करता है. जैसे, किसी प्रॉडक्ट पर "अभी खरीदें" पर क्लिक करके.
  2. POST /checkout-sessions कॉल किया जाता है. इसमें line_items कलेक्शन में मौजूद सभी अलग-अलग आइटम शामिल होते हैं. line_items ऐरे में, चेक आउट किए जा रहे हर यूनीक आइटम के लिए एक अलग ऑब्जेक्ट होगा.
  3. उपयोगकर्ता, PUT /checkout-sessions/{id} कॉल का इस्तेमाल करके, पेमेंट करने का तरीका, ऑर्डर पूरा करने की जानकारी अपडेट कर सकता है या छूट लागू कर सकता है.
  4. जब उपयोगकर्ता "GPay से पेमेंट करें" बटन पर क्लिक करता है, तब POST /checkout-sessions/{id}/complete कॉल किया जाता है.

पुष्टि करना

एपीआई पासकोड और OAuth 2.0 जैसे पुष्टि करने के तरीकों के बारे में जानने के लिए, पुष्टि और सुरक्षा गाइड देखें. इसमें Native Checkout API के एंडपॉइंट को सुरक्षित करने के बारे में भी बताया गया है.

डेवलपर टूल

Native Checkout API को लागू करने में आपकी मदद करने के लिए, Universal Commerce Protocol GitHub रिपॉज़िटरी में ये संसाधन उपलब्ध हैं:

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

  • कंफ़ॉर्मेंस टेस्ट: कंफ़ॉर्मेंस टेस्ट सुइट का इस्तेमाल करके, यूसीपी स्पेसिफ़िकेशन के हिसाब से अपने एपीआई एंडपॉइंट की पुष्टि करें

    इससे यह पक्का करने में मदद मिलती है कि आपका लागू किया गया तरीका, ज़रूरी मानकों और व्यवहारों के मुताबिक हो.

हमारा सुझाव है कि आप इन टूल का इस्तेमाल करें, ताकि डेवलपमेंट और टेस्टिंग की प्रोसेस को आसान बनाया जा सके.

सेवा स्तर के उद्देश्य

नेटिव चेकआउट REST API एंडपॉइंट पर, सेवा स्तर के ये उद्देश्य (एसएलओ) लागू होते हैं. Google के साथ इंटिग्रेट करने वाले कारोबारों से उम्मीद की जाती है कि वे एपीआई की परफ़ॉर्मेंस और उपलब्धता के लिए, इन लक्ष्यों को पूरा करें.

एंडपॉइंट उपलब्धता लेटेंसी (50वां पर्सेंटाइल) लेटेंसी (95वां पर्सेंटाइल)
POST /checkout-sessions (बनाएं) >= 95% <= 1 सेकंड 4 सेकंड से कम या इसके बराबर
PUT /checkout-sessions/{id} (अपडेट करें) >= 95% <= 1 सेकंड पांच सेकंड या उससे कम
POST /checkout-sessions/{id}/complete (पूरा हुआ) >= 95% <= 6 सेकंड <= 10 सेकंड

50वें पर्सेंटाइल की लेटेन्सी से पता चलता है कि कम से कम 50% अनुरोधों को इस समय में पूरा किया जा सकता है. 95वें पर्सेंटाइल की लेटेन्सी से पता चलता है कि कम से कम 95% अनुरोधों को इस समय में पूरा किया जा सकता है.

अगले चरण

अपने यूसीपी वर्शन के लिए, Checkout API के पेलोड और तकनीकी तौर पर लागू करने से जुड़ी जानकारी देखें:

पीछे जाएं
Authentication
आगे बढ़ें
ऑर्डर का लाइफ़साइकल (खरीदारी के बाद)