La fonctionnalité d'enregistrement (connexion) de carte cadeau permet aux utilisateurs de rechercher un et l'ajouter à Google Wallet. Les utilisateurs seront redirigés vers votre site Web adapté aux mobiles afin d'effectuer la après quoi ils pourront ajouter leur carte à Google Wallet.
Ce guide présente les étapes d'implémentation requises pour activer votre programme de cartes cadeaux pour cette fonctionnalité.
Présentation
Pour commencer, assurez-vous d'avoir configuré votre projet au préalable et d'avoir accès à API Google Wallet.
Pour implémenter la fonctionnalité de connexion, vous devez suivre les quatre étapes ci-dessous. pour votre programme de cartes cadeaux:
- Configurez une classe de test dans Google Wallet pour tester votre flux de connexion.
- Développez des pages de connexion qui utilisent Google Wallet
SharedDataType. - Implémenter le transfert de la carte cadeau vers Google Wallet après la connexion
- Demandez la vérification et l'activation.
Configurer une classe de test dans Google Wallet
Déterminez l'URL de connexion, le logo de votre programme. Ensuite,
utilisez les champs imbriqués discoverableProgram dans la
giftcardclass pour définir
les valeurs appropriées.
Définissez les valeurs dans le discoverableProgram pour créer une version brouillon de votre
Programme de cartes cadeaux avec connexion activée. Pour vous assurer que cela est visible par les testeurs, vérifiez que
les testeurs ont accès à Google Pay & Wallet Console. Pour savoir comment partager vos
l'accès de Google Pay and Wallet Console à d'autres personnes, consultez
En savoir plus sur la page "Utilisateurs"
Pour terminer la vérification des fonctionnalités de votre mise en œuvre au cours du développement contactez-nous à l'aide du widget d'assistance disponible dans Google Pay & Wallet Console. À l'intérieur la console, sélectionnez API Google Wallet dans le sujet, puis Connexion à une carte cadeau dans le sous-sujet.
Développer une page de connexion qui utilise les données utilisateur de Google Wallet
Lorsqu'un utilisateur choisit d'ajouter votre carte cadeau, il est redirigé vers une page personnalisée de votre site Web afin de terminer le processus de connexion.
Vous devez fournir une URL permettant à l'utilisateur de se connecter à un compte existant.
Votre page de connexion doit remplir les conditions suivantes:
- Proposez une expérience utilisateur adaptée aux mobiles.
- Permettez à l'utilisateur de se connecter sur une seule page.
- Utilisez le chiffrement
HTTPSavec un certificat valide pour vous assurer que les données utilisateur sont transmises de manière sécurisée. - Assurer une disponibilité d'au moins 99,9% de votre page de connexion
Lors de la présentation de la page de connexion, Google Wallet crée
une WebView Android et une requête POST est envoyée à votre
URL. Les données utilisateur sont fournies dans le paramètre SharedDataType
qui est incluse dans la requête POST en utilisant
le
application/x-www-form-urlcoded type de contenu et
Encodage UTF-8. La valeur de SharedDataType
est un objet JSON encodé en base64.
Implémenter le transfert immédiat de la carte cadeau vers Google Wallet
Une fois authentifiée (connexion), votre page doit immédiatement renvoyer la carte cadeau de l'utilisateur vers Google Wallet.
Vous pouvez la retransférer vers Google Wallet en la redirigeant vers un qui suit la structure
https://pay.google.com/gp/v/save/{jwt_generated}
La longueur d'une URL ne doit pas dépasser 2 000 caractères. Vos liens doivent ne dépassent pas cette limite. Les objets encodés dans des jetons JWT doivent être de petite taille et ne contenir que des données spécifiques à l’utilisateur. Essayez de conserver la plupart des données dans la classe de l'objet, avant de le créer. Pour les objets plus volumineux qui ne respectent pas la limite, envisagez commencez par créer l'objet dans API Google Wallet et en envoyant uniquement l'ID d'objet dans le JWT.
Flux de communication typique
Le flux de communication pour un utilisateur final qui se connecte est illustré dans les l'image suivante. Toutes les actions entre "Votre serveur" qu'il vous incombe de mettre en œuvre.
Vérification et activation de la requête
Après avoir terminé le développement et testé votre flux de connexion, envoyez une demande via le Contacter l'assistance pour Google Pay and Wallet Console .
Après un examen complet de votre implémentation qui confirme la bonne fonctionnalité dans l'association à l'application Google Wallet, la fonctionnalité de connexion aux cartes cadeaux pour votre programme de cartes cadeaux. Tout utilisateur pourra ainsi voir programme et utiliser cette fonctionnalité.
Vérifications récurrentes de votre connexion afin de garantir une expérience utilisateur optimale mise en œuvre sera effectuée afin d'assurer la conformité continue avec les exigences de cette fonctionnalité. En cas de divergence, vous serez averti si la fonctionnalité de connexion peuvent être désactivées jusqu'à ce que le problème soit résolu.
Questions fréquentes
- Existe-t-il des exigences concernant les images utilisées dans mon programme de cartes cadeaux ?
- Oui, vos images doivent être hébergées sur un emplacement
HTTPScar ils ne seront pas visibles dans Google Wallet.
- Oui, vos images doivent être hébergées sur un emplacement
- Existe-t-il des outils permettant de simplifier l'implémentation et le débogage des jetons JWT ?
- Oui, des plates-formes telles que www.jwt.io vous permettent de décoder et déboguer vos jetons au cours du processus de développement, ce qui vous permet de vérifier que vous envoyez. Notez que Google n'a aucun lien avec recommandent spécifiquement l'un de ces tiers.
- Comment traiter correctement les données SharedDataType encodées en base64 ?
- Veillez à utiliser l'encodage UTF-8 tout au long de la procédure. Chaîne JSON est d'abord encodée en UTF-8, puis en utilisant <ph type="x-smartling-placeholder"></ph> android.util.Base64 avec les options NO_WRAP et URL_SAFE. Cela correspond à RFC 3548, section 4.