Ce document répertorie 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 l'enregistrer dans Google Wallet. L'API Google Wallet est compatible avec plusieurs types de cartes courants, y compris les cartes d'embarquement, les billets pour des événements, les cartes d'identité, etc. L'API Google Wallet fournit également un type de carte générique qui peut être utilisé pour créer des cartes qui ne sont pas spécifiquement prises en charge.
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 les enregistrer dans leur compte 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, des entreprises et des organisations individuels, ainsi que des agrégateurs qui créent et émettent des cartes pour le compte de tiers (par exemple, une entreprise spécialisée dans la mise en œuvre de billets pour des événements ou de bons de réduction pour des marchands).
Classe Cartes
Une classe Cartes peut être considérée comme un modèle partagé à partir duquel sont créées des cartes. 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 distinct 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, l'enregistrement et la connexion.
Dans la plupart des cas, une carte est créée en fournissant une classe Cartes pour définir son modèle, et un objet Cartes pour définir ses spécificités.
Objet Cartes
Un objet Cartes définit une carte individuelle délivrée à un utilisateur afin de l'enregistrer dans Google Wallet. Les objets Cartes contiennent souvent des informations spécifiques à l'utilisateur. Par exemple, alors qu'une classe Cartes peut définir à quoi ressemble une carte cadeau destinée à un magasin spécifique, l'objet Cartes fournit des informations spécifiques telles 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 sur 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 et sont gérées différemment dans l'API Google Wallet, via le 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 être soumises à des paramètres de confidentialité supplémentaires et être examinées lors de l'intégration.
Sans contact avancé
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 leur compte 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 compatible 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 leur compte Google Wallet. Vous pouvez utiliser l'API 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 qui permet de créer et de gérer des cartes de manière automatisée 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 pour créer un compte de service, qui permet d'authentifier les requêtes adressées à l'API REST Google Wallet.
SDK Google Wallet pour Android
Le SDK Google Wallet pour Android fournit un ensemble de méthodes pratiques pour utiliser l'API Google Wallet dans vos applications Android, par exemple pour créer et émettre des cartes.
Ajouter à Google Wallet
"Ajouter à Google Wallet" bouton
L'option "Ajouter à Google Wallet" est un asset approuvé par Google permettant de présenter une carte à un utilisateur. Lorsqu'un utilisateur clique ou appuie sur le bouton, un message "Ajouter à Google Wallet" doit être déclenché pour démarrer le processus d'ajout de la carte émise au compte Google Wallet de l'utilisateur.
Nous vous recommandons d'utiliser l'option "Ajouter à Google Wallet" chaque fois que possible, car il s'agit d'un élément d'interface utilisateur familier avec lequel vos utilisateurs savent déjà interagir.
Vous trouverez des éléments et des consignes d'utilisation du bouton dans les consignes relatives à la marque de l'API Google Wallet.
"Ajouter à Google Wallet" lien [link]
Avec un bouton "Ajouter à Google Wallet" vous pouvez envoyer une carte à un utilisateur avec 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.
"Ajouter à Google Wallet" Les liens 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 est en "Mode démo". tant que votre accès en publication n'a pas été approuvé. En mode démo, vous pouvez créer des cartes, mais vous ne pouvez les délivrer qu'aux utilisateurs disposant du rôle "Administrateur" ou "Développeur" de votre compte d'émetteur ou de ceux des utilisateurs qui ont été ajoutés en tant que comptes de test dans la console Google Wallet.
En mode démo, le titre de toutes les cartes que vous émettez commence automatiquement par "[TEST UNIQUEMENT]". pour indiquer que la carte n'est utilisée qu'à des fins de test.
Comptes de test
Lorsque votre compte d'émetteur est en "Mode démo", si vous souhaitez émettre des cartes à tout utilisateur qui ne dispose pas du rôle "Administrateur" ou "Développeur" pour votre compte, vous devez les ajouter en tant que comptes de test dans la console Google Wallet. Les utilisateurs enregistrés en tant que comptes de test pourront ajouter les cartes que vous avez émises à leur compte Google Wallet. Cette fonctionnalité est utile pour tester vos cartes auprès d'une audience plus large lorsque vous êtes 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 à Google Pay & Console Wallet Une fiche d'établissement fournit à Google des informations de base sur votre entreprise ou organisation. Elle doit être approuvée pour l'accès 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 avoir obtenu l'autorisation de publication. Pour que l'accès en publication soit approuvé, vous devez avoir créé au moins une classe de carte et disposer d'une fiche d'établissement complète. 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, puis cliquez sur le bouton "Demander l'accès en publication" . L'équipe Google Wallet examinera votre demande et vous informera une fois que vous aurez obtenu l'accès en publication.
Authentification
Jeton Web JSON (JWT)
JSON Web Tokens est une norme couramment utilisée dans l'industrie pour transférer des informations de manière sécurisée en tant qu'objet JSON. Lorsque vous utilisez l'API Google Wallet, vous encodez les détails de l'objet Cartes que vous souhaitez utiliser pour créer une instance de carte au format JWT (prononcé "jot"), puis envoyez ce JWT dans une requête à l'API Google Wallet.
Les jetons JWT sont sécurisés en les signant avec une clé secrète partagée 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, vous utiliserez un compte de service pour 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 afin d'autoriser le compte de service à 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 de l'émetteur de cartes de votre compte à l'aide de l'API REST de Google Wallet, y compris la création de classes de cartes et d'objets 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 utilisez 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 l'empreinte digitale afin d'authentifier vos requêtes, vous devez l'enregistrer dans la console Google Wallet.