👨🏽‍🎤 🔋 🧑🏻‍🤝‍🧑🏻 वफादारी कार्ड। ASP.NET में पास के लिए Google पे एपीआई 📴 🙌 💃🏻

बैंक कार्ड स्टोरेज एप्लिकेशन ने Apple वॉलेट और Google पे की बदौलत हमारे जीवन में तेजी से प्रवेश किया है। बैंकिंग के अलावा, दोनों प्लेटफ़ॉर्म आपको अन्य प्रकार के कार्ड - लॉयल्टी कार्ड, गिफ्ट कार्ड, ईवेंट टिकट, बोर्डिंग पास इत्यादि के साथ भी काम करने की अनुमति देते हैं।

एक कंपनी के लिए काम करते हुए जो एक बड़े खुदरा नेटवर्क की सेवा करता है, मुझे इस नेटवर्क के लॉयल्टी कार्ड को Apple वॉलेट और Google पे में एकीकृत करना था। और अगर आपको Apple वॉलेट के साथ सिर्फ छेड़छाड़ करनी थी क्योंकि एकीकरण परत काफी बहुक्रियाशील है, तो Google पे के साथ अधिकांश प्रयास और तंत्रिका कोशिकाओं को प्रलेखन का पता लगाने, सही उपकरण खोजने और अवधारणा का पहला प्रमाण विकसित करने में खर्च किया गया था। हालाँकि आम तौर पर बाकी काम Apple Wallet की तुलना में बहुत तेज़ी से हुआ, मैंने एक दिन बिताया है कि कैसे इस सेवा को शुरू किया जाए, इसलिए मुझे कोई आपत्ति नहीं होगी अगर कोई मुझसे पहले इसी तरह का लेख लिखे।

1. मटेरियल

वफादारी कार्ड का प्रतिनिधित्व दो संस्थाओं - लॉयल्टी क्लास और लॉयल्टी ऑब्जेक्ट का उपयोग करके किया जाता है।

वफादारी वर्ग सभी वफादारी कार्ड के लिए एक प्रकार का टेम्पलेट है। इसमें सभी मानचित्रों के क्षेत्र सामान्य हैं, जैसे कि फ़ॉन्ट रंग, आइकन संपत्तियों के लिंक, पृष्ठभूमि, पाठ क्षेत्र, आदि, एक पूर्ण विवरण यहां पाया जा सकता है: लॉयल्टीक्लास
लॉयल्टी ऑब्जेक्ट - लॉयल्टीक्लास का एक उदाहरण। इसमें एक विशेष क्लाइंट के कार्ड के डेटा - कार्ड नंबर, नाम, अतिरिक्त टेक्स्ट फ़ील्ड भी शामिल हैं। यहाँ वर्णन: लॉयल्टीओबजेक्ट

कार्ड प्राप्त करने के लिए, उपयोगकर्ता को प्रारूप लिंक का पालन करना चाहिए
www.android.com/payapp/savetoandroidpay / {JWT} , जहां JWT एक टोकन है जो LSONtyClass डेटा के साथ JSON रखता है। लेकिन चूंकि URL की लंबाई की सीमाएँ हैं, इसलिए यह अनुशंसा की जाती है कि यदि आप इसकी संरचना में कई वर्ण हैं, तो आप पहले Loyalty Class बनाते हैं।

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

2. उपकरण और प्रलेखन

समस्या यह थी कि पास के लिए Google पे एपीआई के लिए प्रलेखन में सभी उदाहरण विशेष रूप से जावा, पीएचपी और पायथन के लिए थे, और दस्तावेज ने एपीआई के साथ काम करने की प्रक्रिया को सरल बनाने के लिए "ग्राहक पुस्तकालयों का उपयोग करने" की जोरदार सिफारिश की थी।

इस सलाह के बाद, मैं ख़ुशी ख़ुशी नगेट चला गया, लेकिन Google पे के लिए लाइब्रेरी नहीं थी। ग्लोरी टू ब्रिन, Google में पहली पंक्ति के लिए "google pay for pass dotnet" ने Google पे एपीआई को पास यूटिलिटी लाइब्रेरीज़ पेज के लिए लौटाया, जिसमें मुझे वह मिला, जो ज़िप संग्रह प्रारूप में था, जिसमें एक .net प्रोजेक्ट था। एक उत्पन्न वर्ग जो Google पे API के लिए एक आवरण है - पासर्स क्लाइंट लाइब्रेरी के लिए Google पे API ।

प्रोजेक्ट में Google.Apis.Walletobjects.v1.1.9.2.00.nuspec फ़ाइल की उपस्थिति को देखते हुए, नगेट पैकेज की तैनाती अभी भी Google टीम की योजनाओं का हिस्सा थी। प्रलेखन की तलाश में इस फ़ाइल को खोलने के बाद, मुझे कुछ भी ठोस नहीं मिला, और कुछ लिंक जो गैर-मौजूद पृष्ठों पर भेजे गए विवरण अनुभाग में थे।

3. टोकन प्राप्त करना

पास के लिए Google पे एपीआई के साथ सीधे काम करना शुरू करने के लिए, आपको एक एक्सेस टोकन प्राप्त करने की आवश्यकता है, इसके लिए आपको आवश्यकता है:

एक Google व्यापारी खाता रखें, जिसे आप यहाँ प्राप्त कर सकते हैं
एक सेवा खाता बनाएँ, इसके लिए क्रेडेंशियल वाली एक फ़ाइल प्राप्त करें - एक सेवा खाते के विवरण के साथ एक json दस्तावेज़, जिसमें पहचानकर्ता, ईमेल, निजी कुंजी, आदि शामिल हैं। जैसा कि प्रलेखन अनुशंसा करता है, आपको इस फ़ाइल को सुरक्षित स्थान पर संग्रहीत करने की आवश्यकता है।
Google Merchant Center पर लिंक मर्चेंट खाता और सेवा खाता

इस फ़ाइल का उपयोग करके, आप Google.Apis.Auth.OAuth2 लाइब्रेरी का उपयोग करके लॉग इन कर सकते हैं:

private await Task<string> GetOAuthToken() {         string serviceAccountFile = string.Empty;         serviceAccountFile = ConfigurationManager.AppSettings["GooglePayServiceAccountConfigPath"];        /*              Credential, GoogleCredential              Service Account,   ,      scopes API,             */         var credential = GoogleCredential.FromFile(serviceAccountFile)                            .CreateScoped(WalletobjectsService.Scope.WalletObjectIssuer);        /*        Access token        ,   GetAccessTokenForRequestAsync         ,               */         var token = async credential.UnderlyingCredential.GetAccessTokenForRequestAsync();         return token; }

4. एक नक्शा बनाएँ

एक वफादारी कार्ड बनाने के लिए, आपको पहले एक वफादारी वर्ग बनाना होगा। Loyalty Class को API का उपयोग करके, और Google Merchant Center वेब इंटरफ़ेस का उपयोग करके बनाया जा सकता है। क्लास नाम पर ध्यान दिया जाना चाहिए, क्योंकि यह नाम Google पे इंफ्रास्ट्रक्चर में अद्वितीय होना चाहिए।

लॉयल्टी क्लास बनाने के बाद, आप लॉयल्टी ऑब्जेक्ट बना सकते हैं। ऐसा करने के लिए, हमें पहले से ही उस लाइब्रेरी की आवश्यकता होगी जिसे हमने पहले प्रोजेक्ट में जोड़ा था: एक अनुरोध ऑब्जेक्ट बनाएं, Outh को निर्दिष्ट करें, बनाई गई LoyaltyObject ऑब्जेक्ट को स्थानांतरित करें, और अनुरोध को निष्पादित करें:

 public GooglePayApiService() { // ,    Merchant Account IssuerId = ConfigurationManager.AppSettings["GooglePayIssuerId"]; _wobService = new WalletobjectsService(); } private async Task<LoyaltyObject> ConvertLoyaltyObjectFromTemplate(GooglePayPassTemplate template) { string id = $"{IssuerId}.{template.SerialNumber}"; string loyaltyClassName = ConfigurationManager.AppSettings["GooglePayStoreCardClassName"];     var loyaltyClass = await GetLoyaltyClass(loyaltyClassName); var result =  new LoyaltyObject { Id = id, AccountName = template.AccountName,          Barcode = new Barcode          {          AlternateText = template.BarcodeText,               Value = template.SerialNumber,               Type = "pdf417"          },          Kind = "walletObject#loyaltyObject",          ClassId = loyaltyClass.Id,          ClassReference = loyaltyClass,          State = "active"     };     return result; } private async Task<LoyaltyObject> CreateLoyaltyObject(LoyaltyObject loyaltyObject) { var saveRequest = _wobService.Loyaltyobject.Insert(loyaltyObject); saveRequest.OauthToken = await GetOAuthToken(); var savedObject = await saveRequest.ExecuteAsync(); return savedObject; }

GooglePayPassTemplate इस उदाहरण में एक डीटीओ है जो एक उपयोगकर्ता के लिए मानचित्र टेम्पलेट संग्रहीत करता है, जो एक अलग विकसित सेवा द्वारा उत्पन्न होता है।

5. मैप अपडेट

यहां सिद्धांत बनाते समय समान है: हम एक अनुरोध उत्पन्न करते हैं, अपडेट किए गए LoyaltyObject ऑब्जेक्ट को स्थानांतरित करते हैं, निष्पादित करते हैं:

 private async Task<LoyaltyObject> UpdateLoyaltyObject(LoyaltyObject loyaltyObject) { var updateRequest = _wobService.Loyaltyobject.Update(loyaltyObject, loyaltyObject.Id);           updateRequest.OauthToken = await GetOAuthToken(); var savedObject = await updateRequest.ExecuteAsync(); return savedObject; }

अनुरोध पूरा करने के बाद, जिन उपयोगकर्ताओं ने इसे इंस्टॉल किया है उनके अनुप्रयोगों में कार्ड कुछ सेकंड के बाद अपडेट किया जाएगा यदि डिवाइस नेटवर्क पर है और इंटरनेट कनेक्शन है।

6. JWT पीढ़ी

कार्ड को स्थापित करने के लिए, आपको उपयोगकर्ता को www.android.com/payapp/savetoandroidpay / {JWF} लिंक पर पुनर्निर्देशित करना होगा। इस लिंक पर टोकन संरचना का विवरण पाया जा सकता है।

RSA-SHA256 द्वारा एक हस्ताक्षर के साथ टोकन पर हस्ताक्षर किए गए हैं जो सेवा खाता क्रेडेंशियल्स के साथ एक ही फ़ाइल का उपयोग करके उत्पन्न किया जा सकता है:

 public static class JwtHelper { public static string CreateJwtForLoyaltyObject(LoyaltyObject loyaltyObject) { /*       credential   ,         */ ServiceAccountCredential credential; var now = DateTime.UtcNow; DateTime unixEpoch = new DateTime(1970, 01, 01); // 1970-01-01 00:00:00 UTC var secondsSinceEpoch = (int)Math.Round((now - unixEpoch).TotalSeconds); string serviceAccountFile = serviceAccountFile = ConfigurationManager.AppSettings["GooglePayServiceAccountConfigPath"]; using (var fs = new FileStream(serviceAccountFile, FileMode.Open, FileAccess.Read, FileShare.Read)) { credential = ServiceAccountCredential.FromServiceAccountData(fs); } /*    JwtPayload,     payload-a  JWT */ var jwtPayload = new JwtPayload { iat = secondsSinceEpoch, iss = credential.Id, payload = new JwtInternalPayload { loyaltyObjects = new[] { new LoyaltyObjectPayload { id = loyaltyObject.Id } } } }; string header = @"{""alg"":""RS256"",""typ"":""JWT""}"; string payload = JsonConverter.SerializeObject(jwtPayload); string base64Header = EscapedBase64(Convert.ToBase64String(Encoding.UTF8.GetBytes(header))); string base64Payload = EscapedBase64(Convert.ToBase64String(Encoding.UTF8.GetBytes(payload))); //        Signature string signature = EscapedBase64(credential.CreateSignature( Encoding.UTF8.GetBytes($"{base64Header}.{base64Payload}") )); var token = $"{base64Header}.{base64Payload}.{signature}"; return token; } private static string EscapedBase64(string base64) { return base64.Replace('+', '-') .Replace('/', '_') .Replace("=", ""); } }

निष्कर्ष

इस लेख में, हम पास के लिए Google पे एपीआई के साथ काम करने की मूल बातें से गुजरे: अकाउंट सेट करना, एपीआई से जुड़ना, लॉयल्टी क्लास और लॉयल्टी ऑब्जेक्ट बनाना।

यदि UFO एहसान करता है, तो मैं आपको अलग से बताऊंगा कि Apple वॉलेट के साथ कैसे काम किया जाए (कार्यान्वयन के मामले में सब कुछ अधिक कठिन है), एक वेब सेवा में Google पे के साथ Apple वॉलेट मित्र कैसे बनाएं और दर्द महसूस न करें।

वफादारी कार्ड। ASP.NET में पास के लिए Google पे एपीआई