उपयोगकर्ता के उपहार कार्ड का रजिस्ट्रेशन

उपहार कार्ड रजिस्टर करने (साइन इन करने) की सुविधा से, लोग उपहार कार्ड जोड़ें और उसे Google Wallet में जोड़ें. उपयोगकर्ताओं को आपकी मोबाइल-फ़्रेंडली वेबसाइट पर भेज दिया जाएगा, ताकि वे प्रक्रिया के बाद, वे अपने कार्ड की जानकारी को Google Wallet में जोड़ सकते हैं.

इस गाइड में, लागू करने के ज़रूरी चरणों की खास जानकारी दी गई है इस सुविधा के लिए अपने उपहार कार्ड प्रोग्राम को चालू करें.

खास जानकारी

शुरू करने के लिए, पक्का करें कि आपने अपना प्रोजेक्ट पहले से सेट अप कर लिया हो और आपके पास Google Wallet API.

साइन-इन की सुविधा को लागू करने के लिए, आपको इन चार चरणों का पालन करना होगा के लिए:

  1. अपने साइन-इन फ़्लो की जांच करने के लिए, Google Wallet में टेस्ट क्लास सेट अप करें.
  2. Google वॉलेट SharedDataType का उपयोग करने वाले साइन-इन पेज डेवलप करें.
  3. साइन-इन के बाद Google वॉलेट में उपहार कार्ड का पुश बैक लागू करें.
  4. पुष्टि और चालू करने का अनुरोध करें.

Google Wallet में टेस्ट क्लास सेट अप करना

अपने प्रोग्राम का लोगो, साइन इन यूआरएल तय करें. इसके बाद, इसमें discoverableProgram नेस्ट किए गए फ़ील्ड का इस्तेमाल giftcardclass उचित मान का इस्तेमाल करें.

अपना ड्राफ़्ट वर्शन बनाने के लिए discoverableProgram में मान सेट करें साइन-इन सक्षम उपहार कार्ड प्रोग्राम. यह पक्का करने के लिए कि यह टेस्टर को दिखे, पुष्टि करें टेस्टर के पास आपके Google Pay और Wallet Console का ऐक्सेस होता है. अपनी रिपोर्ट कैसे शेयर करें अन्य लोगों के साथ Google Pay और Wallet Console का ऐक्सेस, देखें उपयोगकर्ताओं की जानकारी वाले पेज के बारे में जानें.

डेवलपमेंट के दौरान, लागू करने के तरीकों की पुष्टि करने के लिए प्रोसेस पूरी करने के लिए, Google Pay और Wallet Console में संपर्क सहायता विजेट का इस्तेमाल करके हमसे संपर्क करें. घर में रहने के दौरान कंसोल में जाकर, विषय में Google Wallet API चुनें. इसके बाद, उपहार कार्ड से साइन इन करना चुनें उप-विषय.

Google Wallet के उपयोगकर्ता के डेटा का इस्तेमाल करने वाला साइन-इन पेज डेवलप करें

जब कोई उपयोगकर्ता आपका उपहार कार्ड जोड़ने का विकल्प चुनता है, उन्हें आपकी वेबसाइट के खास पेज पर भेजा जाता है, ताकि साइन-इन प्रोसेस पर कर सकते हैं.

आपको ऐसा साइन-इन यूआरएल देना होगा जहां उपयोगकर्ता साइन इन कर सके खाते में जोड़ा जा सकता है.

आपके साइन इन पेज को नीचे दी गई ज़रूरी शर्तें पूरी करनी होंगी:

  • मोबाइल-फ़्रेंडली उपयोगकर्ता अनुभव उपलब्ध कराएं.
  • उपयोगकर्ता को एक ही पेज पर साइन इन करने की प्रोसेस पूरी करने दें.
  • मान्य सर्टिफ़िकेट के साथ HTTPS के एन्क्रिप्ट (सुरक्षित) करने के तरीके का इस्तेमाल करें, ताकि यह पक्का किया जा सके कि उपयोगकर्ता का डेटा सुरक्षित रूप से ट्रांसमिट किया जा सकता है.
  • पक्का करें कि आपके साइन इन पेज का अपटाइम, कम से कम 99.9% हो.

साइन-इन पेज प्रज़ेंट करते समय, Google Wallet, एक Android वेबव्यू और आपके दिए गए क्रेडेंशियल पर POST का अनुरोध किया जाता है यूआरएल. उपयोगकर्ता का डेटा पैरामीटर SharedDataType में दिया गया है जो इसका इस्तेमाल करके POST अनुरोध में शामिल है app/x-www-form-urlencoded कॉन्टेंट टाइप और UTF-8 एन्कोडिंग. SharedDataType की वैल्यू पैरामीटर, Base64 कोड में बदला गया JSON ऑब्जेक्ट है.

Google Wallet में उपहार कार्ड को तुरंत वापस पाने की सुविधा लागू करना

पुष्टि होने (साइन इन) होने के बाद, आपके पेज की को तुरंत उपयोगकर्ता का उपहार कार्ड Google वॉलेट में वापस भेज देना चाहिए.

आप लिंक जो स्ट्रक्चर का पालन करता है

https://pay.google.com/gp/v/save/{jwt_generated}

किसी भी यूआरएल में ज़्यादा से ज़्यादा 2,000 वर्ण इस्तेमाल किए जा सकते हैं. आपके लिंक को इस सीमा के अंदर रहे. JWT में एन्कोड किए गए ऑब्जेक्ट छोटे होने चाहिए. इनमें सिर्फ़ शामिल हैं उपयोगकर्ता का खास डेटा होता है. ज़्यादातर डेटा को ऑब्जेक्ट की क्लास में रखने की कोशिश करें, तो हम इसे JWT बनाने से पहले बनाते हैं. सीमा से फ़िट न आने वाले बड़े ऑब्जेक्ट के लिए, पहले इसमें ऑब्जेक्ट बनाया जा रहा है, Google Wallet API और JWT में सिर्फ़ ऑब्जेक्ट आईडी भेजा जा रहा है.

सामान्य कम्यूनिकेशन फ़्लो

साइन-इन पूरा करने वाले उपयोगकर्ता के लिए कम्यूनिकेशन फ़्लो को नीचे दी गई इमेज है. "आपका सर्वर" के बीच की सभी कार्रवाइयां उन्हें लागू करना आपकी ज़िम्मेदारी है.

साइन-इन फ़्लो

पुष्टि और चालू करने का अनुरोध करें

डेवलपमेंट का काम पूरा करने और अपने साइन-इन फ़्लो की जांच करने के बाद, एक अनुरोध सबमिट करें से Google Pay और Wallet Console के लिए, सहायता टीम से संपर्क करना विजेट.

लागू करने की पूरी समीक्षा के बाद, जो जोड़ रहे हैं, तो उपहार कार्ड से साइन-इन करने की सुविधा आपके उपहार कार्ड प्रोग्राम के लिए सार्वजनिक रूप से लॉन्च किया गया हो. इससे कोई भी उपयोगकर्ता प्रोग्राम और इस सुविधा का इस्तेमाल करें.

उपयोगकर्ताओं को बेहतर अनुभव देने के लिए, आपके साइन इन क्रेडेंशियल की बार-बार जांच की जाती है को लागू किया जाएगा, ताकि यह पक्का किया जा सके कि सुविधा की ज़रूरी शर्तों का पालन हो रहा है. साइन-इन करने की सुविधा और अंतर होने पर आपको सूचना दी जाएगी तब तक अक्षम किया जा सकता है, जब तक कि समस्या हल नहीं हो जाती.

अक्सर पूछे जाने वाले सवाल

  • क्या मेरे उपहार कार्ड प्रोग्राम में इस्तेमाल की गई इमेज के लिए कोई ज़रूरी शर्त है?
    • हां, आपकी इमेज HTTPS जगह पर होस्ट की जानी चाहिए क्योंकि वे Google Wallet में नहीं दिखेंगे.
  • क्या कोई ऐसा टूल है जिससे JWT को आसानी से लागू और डीबग किया जा सकता है?
    • हां, प्लैटफ़ॉर्म जैसे www.jwt.io की मदद से और अपनी डेवलपमेंट प्रोसेस के दौरान अपने टोकन को डीबग करें, ताकि आप आपके द्वारा सबमिट की जा रही सामग्री. ध्यान दें कि Google का कोई संबंध नहीं है और न ही ख़ास तौर पर ऐसे किसी तीसरे पक्ष के सुझाव दे सकते हैं.
  • हम Base64 से कोड में बदले गए SharedDataType डेटा को सही तरीके से कैसे मैनेज करते हैं?
    • पक्का करें कि पूरी प्रोसेस के दौरान, कोड में UTF-8 एन्कोडिंग का इस्तेमाल किया जा रहा हो. JSON स्ट्रिंग पहले UTF-8 से एन्कोड किया गया है और बाद में इसका इस्तेमाल करके एन्कोड किया गया है android.util.Base64, जिसमें NO_WRAP और URL_SAFE विकल्प हैं. यह इससे मेल खाता है आरएफ़सी 3548 सेक्शन 4.