Kullanıcı Hediye Kartı kaydı

Hediye kartı kaydı (oturum açma) özelliği, kullanıcıların hediye kartı aramasına ve bu kartı Google Cüzdan'a eklemesine olanak tanır. Kullanıcılar, işlemi tamamlamak için mobil uyumlu web sitenize yönlendirilir. Ardından kartlarını Google Cüzdan'a ekleyebilirler.

Bu kılavuzda, hediye kartı programınızı bu özellik için etkinleştirmek üzere gereken uygulama adımlarına genel bir bakış sunulmaktadır.

Genel Bakış

Başlamadan önce projenizi daha önce oluşturduğunuzdan ve Google Cüzdan API'ye erişiminiz olduğundan emin olun.

Hediye kartı programınızda oturum açma özelliğini uygulamak için aşağıdaki dört adımı uygulamanız gerekir:

1. Oturum açma akışınızı test etmek için Google Cüzdan'da bir test sınıfı oluşturun.
2. Google Cüzdan'ı kullanan oturum açma sayfaları geliştirin SharedDataType.
3. Oturum açtıktan sonra hediye kartının Google Cüzdan'a geri gönderilmesini sağlayın.
4. Doğrulama ve etkinleştirme isteğinde bulunun.

Google Cüzdan'da test sınıfı oluşturma

Oturum açma URL'sini ve program logonuzu belirleyin. Ardından, uygun değerleri ayarlamak için giftcardclass içindeki discoverableProgram iç içe yerleştirilmiş alanlarını kullanın.

Oturum açma özelliği etkin hediye kartı programınızın taslak sürümünü oluşturmak için discoverableProgram bölümündeki değerleri ayarlayın. Bu sayfanın test kullanıcılarına göründüğünden emin olmak için test kullanıcılarının Google Pay ve Cüzdan Console'unuza erişebildiğinden emin olun. Google Pay ve Cüzdan Console'a erişiminizi diğer kullanıcılarla nasıl paylaşacağınızla ilgili ayrıntılar için Kullanıcılar sayfası hakkında bilgi edinin.

Geliştirme sürecinde uygulamanızın işlevselliğinin doğrulamasını tamamlamak için Google Pay ve Cüzdan Console'daki destek iletişimi widget'ını kullanarak bize ulaşın. Konsoldayken, konuda Google Cüzdan API'yi ve alt konuda Hediye kartı oturumu açma'yı seçin.

Google Cüzdan kullanıcı verilerini kullanan oturum açma sayfası geliştirme

Kullanıcılar hediye kartınızı eklemeyi seçtiğinde, oturum açma işlemini tamamlamak için web sitenizde özelleştirilmiş bir sayfaya yönlendirilir.

Kullanıcıların mevcut bir hesapta oturum açabileceği bir oturum açma URL'si sağlamanız gerekir.

Giriş sayfanız aşağıdaki koşulları karşılamalıdır:

• Mobil cihazlara uygun bir kullanıcı deneyimi sunun.
• Kullanıcının oturum açma işlemini tek bir sayfada tamamlamasına izin verin.
• Kullanıcı verilerinin güvenli bir şekilde iletilmesini sağlamak için geçerli bir sertifikayla HTTPS şifrelemeyi kullanın.
• Oturum açma sayfanızın en az% 99,9 çalışma süresine sahip olduğundan emin olun.

Google Cüzdan, oturum açma sayfasını sunarken bir Android WebView oluşturur ve sağladığınız URL'ye bir POST isteği gönderilir. Kullanıcı verileri, POST isteğine application/x-www-form-urlencoded içerik türü ve UTF-8 kodlaması kullanılarak dahil edilen SharedDataType parametresinde sağlanır. SharedDataType parametresinin değeri, Base64 kodlu bir JSON nesnesi olmalıdır.

Not: JSON dizesi önce UTF-8 olarak kodlanır ve ardından NO_WRAP ve URL_SAFE seçenekleriyle android.util.Base64 kullanılarak kodlanır. Bu, RFC 3548 bölüm 4'e karşılık gelir.

Hediye kartının Google Cüzdan'a hemen geri gönderilmesini uygulama

Kimlik doğrulama (oturum açma) işlemi tamamlandıktan sonra sayfanız, kullanıcının hediye kartını hemen Google Cüzdan'a geri göndermelidir.

Not: Kullanıcıların ek kullanıcı etkileşimi olmadan Google Cüzdan'a geri götürülmesi gerektiğinden Google Cüzdan API düğmesi uygulamayın.

Yapıya uygun bir bağlantıya yönlendirerek hediye kartını Google Cüzdan'a geri gönderebilirsiniz.

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

Not: URL'ye JWT'den önce sonuna "/" eklediğinizden emin olun.

Not: JWT'ler şifrelenmez. Derin bağlantıya yalnızca düz metin olarak paylaşılması güvenli veriler ekleyin.

URL'ler en fazla 2.000 karakter uzunluğunda olabilir. Bağlantılarınızda bu sınırı aşmamaya çalışın. JWT'lerde kodlanan nesneler küçük olmalı ve yalnızca kullanıcıya özgü veriler içermelidir. JWT oluşturmadan önce, çoğu veriyi nesnenin sınıfında tutmaya çalışın. Sınıra sığmayan daha büyük nesneler için önce nesneyi Google Cüzdan API'sinde oluşturup JWT'de yalnızca nesne kimliğini gönderebilirsiniz.

Tipik İletişim Akışı

Oturum açma işlemini tamamlayan bir kullanıcının iletişim akışı aşağıdaki resimde gösterilmektedir. "Sunucunuz" ile ilgili tüm işlemleri uygulamak sizin sorumluluğunuzdadır.

Doğrulama ve etkinleştirme isteğinde bulunma

Geliştirme çalışmasını tamamlayıp oturum açma akışınızı test ettikten sonra Google Pay ve Cüzdan Console iletişim desteği widget'ı üzerinden istek gönderin.

Uygulamanızın Google Cüzdan uygulamasıyla birlikte doğru şekilde kullanıldığını doğrulayan tam bir incelemeden sonra hediye kartı oturum açma özelliği, hediye kartı programınız için herkese açık olarak kullanıma sunulur. Bu sayede tüm kullanıcılar programı görebilir ve bu özelliği kullanabilir.

En iyi kullanıcı deneyimini sağlamak amacıyla, oturum açma uygulamanızın özellik şartlarına sürekli olarak uyup uymadığını kontrol etmek için tekrarlanan kontroller yapılır. Tutarsızlık olması durumunda bilgilendirilirsiniz ve sorun çözülene kadar oturum açma özelliği devre dışı bırakılabilir.

Sık Sorulan Sorular

• Hediye kartı programımda kullanılan resimlerle ilgili herhangi bir şart var mı?
  • Evet, resimleriniz HTTPS konumunda barındırılmalıdır. Aksi takdirde Google Cüzdan'da görünmezler.
• JWT'lerin uygulanmasını ve hata ayıklama işlemini kolaylaştıran araçlar var mı?
  • Evet, www.jwt.io gibi platformlar, geliştirme süreciniz sırasında jetonlarınızın kodunu çözmenize ve hata ayıklamanıza olanak tanıyarak gönderdiğiniz içeriği doğrulamanızı sağlar. Google'ın bu üçüncü taraflarla herhangi bir bağlantısı olmadığını ve bu tür üçüncü taraflardan herhangi birini özellikle önermediğini unutmayın.
• Base64 kodlamalı SharedDataType verilerini nasıl doğru şekilde işleyebiliriz?
  • İşleminiz boyunca UTF-8 kodlamasını kullandığınızdan emin olun. JSON dizesi önce UTF-8 olarak kodlanır ve ardından NO_WRAP ve URL_SAFE seçenekleriyle android.util.Base64 kullanılarak kodlanır. Bu, RFC 3548 bölüm 4'e karşılık gelir.