Une fois que vous avez créé une carte et l'avez encodée dans un jeton JWT signé, vous pouvez l'émettre partout où le lien "Ajouter à Google Wallet" est accepté. Pour ce faire, vous devez présenter à l'utilisateur un bouton ou un lien hypertexte "Ajouter à Google Wallet", qui enregistrera la carte dans son Google Wallet lorsqu'il appuiera dessus. Vous pouvez utiliser cette méthode, par exemple, dans les applications mobiles, les sites Web, les e-mails, les chats et les SMS.
Prérequis
Avant d'essayer d'émettre une carte, assurez-vous d'effectuer les opérations suivantes :
- Suivez toutes les étapes du guide d'intégration.
- Créez au moins une classe de carte.
- Créez au moins un objet Cartes.
- Encodez votre classe de carte et votre objet Cartes dans un jeton JWT.
- Signez votre jeton JWT avec la clé de votre compte de service Google Cloud.
1. Créer un lien "Ajouter à Google Wallet"
L'émission d'une carte avec un lien "Google Wallet" ajoute l'objet Cartes au compte Google Wallet d'un utilisateur et ne peut être initiée que dans le contexte d'une identité Google connectée.
Le lien "Ajouter à Google Wallet" est une URL générée de manière dynamique qui contient un jeton Web JSON (JWT) encodé et signé.
Le lien d'ajout à Google Wallet présente le format suivant :
https://pay.google.com/gp/v/save/<signed_jwt>
Par exemple, un lien "Ajouter à Google Wallet" complet se présente comme suit :
https://pay.google.com/gp/v/save/eyJhbGci6IkpXVCJ9.eyJhdWQiO...6EkC1Ahp6A
Ce lien peut être intégré à des applications mobiles, des sites Web, des e-mails, des chats, des SMS ou tout autre support compatible avec les liens hypertextes.
Pour en savoir plus sur la création de classes et d'objets Cartes, consultez Créer des classes et des objets Cartes.
Pour en savoir plus sur la création du jeton JWT signé nécessaire pour créer un lien "Ajouter à Google Wallet", consultez Utiliser des jetons Web JSON.
2. (Recommandé) Utiliser le bouton "Ajouter à Google Wallet"
Pour toutes les surfaces qui acceptent les images avec lien hypertexte, comme les sites Web et les e-mails, nous vous recommandons de présenter le lien "Ajouter à Google Wallet" à vos utilisateurs avec un bouton "Ajouter à Google Wallet". Pour les utilisateurs de Google Wallet, le bouton est une invite familière qui leur permet d'ajouter une carte à leur compte Google Wallet.
Les composants Image sont disponibles en téléchargement dans différentes orientations et langues pour faciliter l'intégration de l'API Google Wallet.