Ce document liste les termes et concepts courants que vous devez connaître lorsque vous utilisez l'API Google Wallet.
Passes
Réussite
Une carte est une instance d'un objet Cartes envoyée à un utilisateur pour qu'il l'enregistre dans Google Wallet. L'API Google Wallet est compatible avec un certain nombre de types de cartes courants, y compris les cartes d'embarquement, les billets pour des événements, les pièces d'identité et plus encore. L'API Google Wallet fournit également un type de carte générique qui permet de créer des cartes qui ne sont pas spécifiquement compatibles.
Dans la plupart des cas, une carte est créée à l'aide d'une classe Cartes et d'un objet Cartes.
Émetteur de cartes
Un émetteur de cartes est une entité qui crée des cartes et les transmet aux utilisateurs pour qu'ils les enregistrent dans Google Wallet. L'émetteur de cartes est propriétaire des cartes, et peut les créer, les émettre et les mettre à jour. Les émetteurs de cartes peuvent être des développeurs individuels, des entreprises et des organisations, ainsi que des agrégateurs qui créent et émettent des cartes pour le compte de tiers, comme une entreprise spécialisée dans la mise en œuvre de billets pour des événements ou de bons de réduction pour les marchands.
Classe de carte
Une classe Cartes peut être considérée comme un modèle partagé à partir duquel des cartes sont créées. Une classe Cartes définit certaines propriétés qui seront incluses dans toutes les cartes qui l'utilisent. Un émetteur de cartes peut créer plusieurs classes, chacune avec son propre ensemble de propriétés qui définissent des attributs tels que le style et l'apparence, ainsi que des fonctionnalités supplémentaires comme Smart Tap, ainsi que l'enregistrement et la connexion.
Dans la plupart des cas, une carte est créée en fournissant une classe de carte pour définir le modèle de la carte, et un objet Cartes pour définir les spécificités de la carte individuelle émise.
Objet Cartes
Un objet Cartes définit une carte individuelle envoyée à un utilisateur pour qu'il l'enregistre dans Google Wallet. Les objets de carte contiennent souvent des informations spécifiques à l'utilisateur. Par exemple, alors qu'une classe Cartes peut définir l'apparence d'une carte cadeau pour un magasin spécifique, l'objet Cartes fournit des détails spécifiques tels que le solde ou la date d'expiration.
Un objet Cartes doit être créé pour chaque carte émise, contrairement aux classes de carte qui peuvent être partagées entre plusieurs instances de carte.
Cartes privées
Certaines cartes que vous créez avec l'API Google Wallet peuvent contenir des données utilisateur sensibles. Ces cartes nécessitent une protection supplémentaire pour protéger les données de vos utilisateurs. Elles sont gérées différemment dans l'API Google Wallet à l'aide du type de carte privée générique. La carte privée générique doit être utilisée lorsque des données sensibles (telles que définies dans la Politique d'utilisation autorisée de l'API Google Wallet) sont incluses dans votre carte. Elles peuvent faire l'objet de contrôles de confidentialité et d'un examen supplémentaires lors de l'intégration.
Smart Tap
Smart Tap est un protocole de communication en champ proche (technologie NFC) propriétaire de Google qui permet de transmettre des données entre un appareil mobile et un terminal NFC. La technologie Smart Tap permet aux utilisateurs d'utiliser des cartes enregistrées dans Google Wallet en plaçant leur téléphone à proximité d'un terminal NFC compatible.
Pour utiliser le protocole Smart Tap avec vos cartes, vous devez établir une relation avec un fournisseur de terminaux compatibles avec Smart Tap.
API et SDK
API Google Wallet
L'API Google Wallet est un service fourni par Google qui vous permet de créer et d'émettre des cartes que les utilisateurs peuvent enregistrer dans leurs Google Wallet. L'API peut être utilisée de différentes manières, y compris avec l'API REST Google Wallet, le SDK Google Wallet pour Android et la console Google Wallet.
API REST Google Wallet
L'API REST Google Wallet est une interface permettant de créer et de gérer des cartes par programmation en envoyant des requêtes HTTP à l'API Google Wallet.
Pour utiliser l'API REST Google Wallet, vous devez également disposer d'un compte Google Cloud afin de créer un compte de service qui servira à authentifier les requêtes adressées à l'API REST Google Wallet.
SDK Google Wallet pour Android
Le SDK Google Wallet pour Android propose un ensemble de méthodes pratiques pour utiliser l'API Google Wallet dans vos applications Android, telles que la création et l'émission de cartes.
Ajouter à Google Wallet
Bouton "Ajouter à Google Wallet"
Le bouton "Ajouter à Google Wallet" est un composant approuvé par Google permettant de présenter une carte à un utilisateur. Lorsqu'un utilisateur clique ou appuie sur le bouton, un lien "Ajouter à Google Wallet" doit s'afficher pour lancer le flux d'ajout de la carte émise à son compte Google Wallet.
Nous vous recommandons d'utiliser le bouton "Ajouter à Google Wallet" autant que possible, car il s'agit d'un élément d'interface utilisateur familier avec lequel vos utilisateurs savent déjà interagir.
Les éléments et les consignes d'utilisation du bouton sont disponibles dans les Consignes relatives à la marque de l'API Google Wallet.
Lien "Ajouter à Google Wallet"
Un lien "Ajouter à Google Wallet" vous permet de fournir une carte à un utilisateur à l'aide d'un lien hypertexte normal. Vous pouvez l'utiliser partout où vous pouvez utiliser des liens hypertextes, tels que des e-mails, des SMS, des sites Web et des applications mobiles.
Les liens "Ajouter à Google Wallet" sont créés en ajoutant un jeton JWT signé à l'URL https://pay.google.com/gp/v/save/.
Compte d'émetteur
Mode démo
Lorsque vous créez votre compte d'émetteur, il reste en "mode démo" jusqu'à ce que vous obteniez l'autorisation d'accéder en publication. En mode démo, vous pouvez créer des cartes, mais vous ne pouvez les distribuer qu'aux utilisateurs disposant du rôle "Administrateur" ou "Développeur" de votre compte d'émetteur, ou aux utilisateurs qui ont été ajoutés en tant que comptes de test dans la console Google Wallet.
Lorsque vous êtes en mode démo, le titre de toutes les cartes que vous émettez commence automatiquement par "[TEST UNIQUEMENT]" pour indiquer que la carte est utilisée à des fins de test uniquement.
Comptes de test
Lorsque votre compte d'émetteur est en mode démo, si vous souhaitez émettre des cartes à un utilisateur qui ne dispose pas des rôles "Administrateur" ou "Développeur" pour votre compte, vous devez les ajouter en tant que comptes de test dans la console Google Wallet. Les utilisateurs inscrits en tant que comptes de test peuvent ajouter des cartes que vous avez émises à leur compte Google Wallet. Cela permet de tester vos cartes auprès d'une audience plus large en mode démo.
Fiche d'établissement
Afin de créer un compte d'émetteur pour l'API Google Wallet, vous devez configurer une fiche d'établissement lorsque vous vous inscrivez à la console Google Pay & Wallet. Une fiche d'établissement fournit à Google des informations de base sur votre entreprise ou organisation. Elle doit être approuvée pour être autorisée en publication.
Accès en publication
Pour pouvoir émettre des cartes que n'importe quel utilisateur peut enregistrer dans son compte Google Wallet, vous devez disposer d'un accès en publication. Pour obtenir l'accès en publication, vous devez avoir créé au moins une classe de carte et disposer d'un profil d'établissement complet. Les émetteurs qui souhaitent émettre des cartes à l'aide du SDK Google Wallet pour Android doivent également envoyer l'empreinte SHA-1 de leur application.
Pour demander l'accès en publication, accédez à la console Google Wallet et cliquez sur le bouton "Demander l'accès en publication". L'équipe Google Wallet examinera votre demande et vous préviendra lorsque l'accès en publication vous sera accordé.
Authentification
Jeton Web JSON (JWT)
Les jetons Web JSON sont une norme couramment utilisée dans l'industrie pour transférer de manière sécurisée des informations en tant qu'objet JSON. Lorsque vous utilisez l'API Google Wallet, vous encodez les détails de l'objet Cartes que vous voulez utiliser pour créer une instance de carte au format JWT (prononcé "jot"), puis vous envoyez ce JWT dans une requête à l'API Google Wallet.
Les jetons JWT sont sécurisés en les signant avec un secret partagé avant d'être envoyés à l'API Google Wallet. Si vous utilisez l'API REST Google Wallet, la signature secrète est votre clé de compte de service Google Cloud. Si vous utilisez le SDK Google Wallet pour Android, la signature secrète est l'empreinte SHA-1 de votre application Android.
Compte de service
Un compte de service Google Cloud est un type particulier de compte généralement utilisé par une application ou une charge de travail de calcul, et non par une personne. Dans le cas de l'API Google Wallet, un compte de service vous permet d'authentifier les requêtes envoyées à l'API REST Google Wallet.
Les comptes de service sont créés dans la console Google Cloud. Pour utiliser un compte de service, vous devez également activer l'API Google Wallet dans la console Cloud pour lui permettre d'envoyer des requêtes à l'API REST Google Wallet.
Clé de compte de service
Une clé de compte de service est l'identifiant que vous utiliserez pour authentifier les appels à l'API REST Google Wallet. La clé du compte de service est considérée comme très sensible et doit rester privée, car elle donne accès à de nombreuses fonctionnalités d'émetteur de cartes de votre compte à l'aide de l'API REST Google Wallet, y compris la création de classes et d'objets de cartes.
Empreinte SHA-1
L'empreinte SHA-1 de votre certificat de signature d'application Android est l'identifiant que vous utiliserez pour authentifier les appels à l'API Google Wallet lorsque vous utiliserez le SDK Google Wallet pour Android. L'empreinte SHA-1 de votre certificat est générée à l'aide de Gradle ou de keytool. Pour utiliser votre empreinte digitale afin d'authentifier vos demandes, vous devez l'enregistrer dans la console Google Wallet.