Enregistrement d'une carte cadeau utilisateur

La fonctionnalité d'inscription (connexion) aux cartes cadeaux permet aux utilisateurs de rechercher une carte cadeau et de l'ajouter à Google Wallet. Les utilisateurs sont redirigés vers votre site Web mobile pour terminer la procédure. Ils peuvent ensuite ajouter leur carte dans Google Wallet.

Ce guide décrit la procédure d'implémentation requise pour activer votre programme de cartes cadeaux dans Google Wallet.

Présentation

Pour commencer, assurez-vous d'avoir préalablement configuré votre projet et d'avoir accès à l'API Google Wallet.

Pour implémenter la fonctionnalité de connexion à votre programme de cartes cadeaux, suivez les quatre étapes ci-dessous:

  1. Configurez une classe de test dans Google Wallet pour tester votre procédure de connexion.
  2. Développez des pages de connexion qui utilisent Google Wallet SharedDataType.
  3. Implémentez le transfert des informations de la carte cadeau dans Google Wallet après la connexion.
  4. Validez et activez la requête.

Configurer une classe de test dans Google Wallet

Déterminez l'URL de connexion et le logo de votre programme. Utilisez ensuite les champs imbriqués discoverableProgram dans le 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 la fonctionnalité de connexion activée. Pour vous assurer que ces éléments sont bien visibles par les testeurs, vérifiez qu'ils ont accès à Google Pay and Wallet Console. Pour savoir comment partager l'accès à Google Pay and Wallet Console à d'autres personnes, consultez la page En savoir plus sur la page Utilisateurs.

Pour terminer la validation des fonctionnalités de votre implémentation au cours du processus de développement, contactez-nous à l'aide du widget d'assistance dans Google Pay & Wallet Console. Dans la console, sélectionnez le thème API Google Wallet, puis le sous-thème Connexion avec une carte cadeau.

Développer une page de connexion qui utilise les données utilisateur de Google Wallet

Lorsqu'un utilisateur choisit d'ajouter votre carte, il est redirigé vers une page dédiée de votre site Web afin de terminer le processus de connexion.

Vous devez fournir une URL de connexion permettant à un utilisateur de se connecter à un compte existant.

Votre page de connexion doit répondre aux exigences suivantes:

  • Proposez une expérience utilisateur adaptée aux mobiles.
  • Permettre à l'utilisateur de se connecter sur une seule page
  • Utiliser le chiffrement HTTPS avec un certificat valide afin de s'assurer que les données utilisateur sont transmises de manière sécurisée
  • Assurez-vous que votre page de connexion est disponible au moins 99,9% du temps.

Lors de l'affichage de la page de connexion, Google Wallet crée une WebView Android, et une requête POST est envoyée à l'URL fournie. Les données utilisateur sont fournies dans le paramètre SharedDataType, qui est inclus dans la requête POST à l'aide du type de contenu application/x-www-form-urlencoded et de l'encodage UTF-8. La valeur du paramètre SharedDataType est un objet JSON encodé en base64.

Implémenter le transfert immédiat de la carte cadeau dans Google Wallet

Une fois l'authentification effectuée (connexion), votre page doit immédiatement renvoyer la carte cadeau de l'utilisateur à Google Wallet.

Vous pouvez transmettre la carte cadeau à Google Wallet en la redirigeant vers un lien qui respecte 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 ne doivent pas excéder 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, en les créant avant de créer le jeton JWT. Pour les objets plus volumineux qui ne respectent pas cette limite, vous devez d'abord créer l'objet dans l'API Google Wallet, puis envoyer uniquement l'ID de l'objet dans le jeton JWT.

Flux de communication typique

L'image ci-dessous illustre le flux de communication pour un utilisateur finalisant sa connexion. Toutes les implémentations du côté de "Votre serveur" relèvent de votre responsabilité.

Flux de connexion

Validation et activation de la requête

Une fois que vous avez terminé le développement et testé votre flux de connexion, envoyez une demande via le widget d'assistance de Google Pay and Wallet Console.

Après un examen complet de votre implémentation qui confirme que la fonctionnalité fonctionne en association avec l'application Google Wallet, la fonctionnalité de connexion à la carte cadeau sera disponible pour votre programme de cartes cadeaux. Tous les utilisateurs peuvent ainsi accéder au programme et utiliser cette fonctionnalité.

Pour une expérience utilisateur optimale, des vérifications de la fonctionnalité de connexion seront effectuées de manière récurrente afin d'assurer la maintenance de la conformité avec les exigences de cette fonctionnalité. Si des incohérences sont constatées, une notification vous est envoyée et la fonctionnalité de connexion est susceptible d'être désactivée 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 HTTPS, faute de quoi elles ne seront pas visibles dans Google Wallet.
  • 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 de déboguer vos jetons au cours du processus de développement. Vous pouvez ainsi vérifier le contenu que vous envoyez. Notez que Google n'a aucun lien avec ces plates-formes tierces et n'en recommande aucune en particulier.
  • Comment traiter correctement les données SharedDataType encodées en base64 ?