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

उपयोगकर्ताओं को चेक आउट करने की सुविधा देने के लिए, आपको नेटिव चेकआउट इंटिग्रेशन लागू करना होगा. इसके लिए, एक स्टैंडर्ड 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 को लागू करने में आपकी मदद करने के लिए, यूनिवर्सल कॉमर्स प्रोटोकॉल के GitHub डेटा स्टोर में ये संसाधन उपलब्ध हैं:

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

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

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

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

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

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

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

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

अगले चरण

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

• वर्शन 2026-04-08 सीधे चेकआउट करने की सुविधा REST API
• 23-01-2026 का वर्शन, सीधे चेकआउट करने की सुविधा REST API

अगर आपको तीसरे पक्ष की सेवा देने वाली कंपनी के तौर पर इंटिग्रेट करना है, तो UCP Checkout service setup पर जाएं. इससे कारोबारी या कंपनी की प्रोफ़ाइल होस्ट की जा सकेंगी और खाते के संबंध को कॉन्फ़िगर किया जा सकेगा.