Conditions préalables

Avant de commencer l'intégration de l'API Google Wallet, vous devez suivre cette procédure :

1. Demander un compte d'émetteur pour l'API Google Wallet

Un compte d'émetteur est nécessaire pour créer et distribuer des cartes pour Google Wallet. Pour obtenir votre compte d'émetteur, inscrivez-vous à Google Pay & Wallet Console. Une fois inscrit, accédez à la page API Google Wallet, puis cliquez sur Créer votre première carte. Une fois que vous avez accepté les conditions d'utilisation, vous pouvez commencer à créer une classe de carte.

Ensuite, vous pouvez également essayer l'atelier de programmation.

2. Se familiariser avec le développement d'applications sur la plate-forme Android

Pour les besoins de ce tutoriel, familiarisez-vous avec les concepts de base et les compétences de développement d'applications pour la plate-forme Android. Si vous souhaitez en savoir plus sur le développement Android avant de commencer, suivez des leçons de la formation pour les développeurs Android.

3. Obtenir des identifiants pour autoriser votre application

Pour pouvoir utiliser l'API Google Wallet pour Android dans votre application Android, vous devez autoriser votre appli. Vous pouvez le faire avec l'empreinte SHA1 de votre clé de développeur et le nom du package.

Pour que votre application soit approuvée, vous devez obtenir l'empreinte SHA1 du certificat. Pour trouver l'empreinte, ouvrez une fenêtre de terminal et exécutez l'utilitaire Keytool :

keytool -alias androiddebugkey -keystore path_to_debug_or_production_keystore -list -v

Le keystore de débogage se trouve généralement dans ~/.android/debug.keystore et son mot de passe est android.

Keytool affiche l'empreinte dans le shell. Exemple :

$ keytool -alias androiddebugkey -keystore ~/.android/debug.keystore -list -v
Enter keystore password: Type "android" if using debug.keystore
Alias name: androiddebugkey
Creation date: Aug 27, 2012
Entry type: PrivateKeyEntry
Certificate chain length: 1
Certificate[1]:
Owner: CN=Android Debug, O=Android, C=US
Issuer: CN=Android Debug, O=Android, C=US
Serial number: 503bd581
Valid from: Mon Aug 27 13:16:01 PDT 2012 until: Wed Aug 20 13:16:01 PDT 2042
Certificate fingerprints:
   MD5:  1B:2B:2D:37:E1:CE:06:8B:A0:F0:73:05:3C:A3:63:DD
   SHA1: D8:AA:43:97:59:EE:C5:95:26:6A:07:EE:1C:37:8E:F4:F0:C8:05:C8
   SHA256: F3:6F:98:51:9A:DF:C3:15:4E:48:4B:0F:91:E3:3C:6A:A0:97:DC:0A:3F:B2:D2:E1:FE:23:57:F5:EB:AC:13:30
   Signature algorithm name: SHA1withRSA
   Version: 3

Copiez l'empreinte SHA1, qui est mise en évidence dans l'exemple précédent. L'empreinte et le nom du package de l'application sont nécessaires pour autoriser l'application. Envoyez votre demande d'autorisation via le widget de contact de l'assistance de la Business Console.

4. Configurer les services Google Play

Téléchargez et installez Android Studio si vous ne l'avez pas encore.

Google Wallet pour Android fait partie des services Google Play. Pour importer des bibliothèques de services Google Play, suivez les instructions pour configurer les services Google Play.

En particulier, pour importer l'API Google Wallet pour Android, ajoutez la ligne suivante au bloc de dépendances dans le fichier build.gradle du module de l'application :

dependencies {
  implementation 'com.google.android.gms:play-services-pay:16.0.3'
}

5. Créer une classe de carte

Avant de pouvoir créer et ajouter un billet pour un événement, vous devez créer une classe EventClass. Pour cela, connectez-vous à la Google Pay & Wallet Console, puis accédez à la page API Google Wallet et créez une classe EventClass.

  1. Vérifiez que vous vous trouvez dans l'onglet Gérer.
  2. Le message Vous êtes en mode démo s'affiche si vous créez une carte pour la première fois.
  3. Toujours en mode démo, cliquez sur Configurer des comptes de test pour ajouter des comptes de test. Seuls ces comptes peuvent enregistrer les cartes lorsque votre compte d'émetteur est en mode démo.
  4. Cliquez sur Créer une classe.
  5. Choisissez un Événement.
  6. Remplissez tous les champs obligatoires marqués d'un astérisque (*).
  7. Cliquez sur Créer une classe.

Répétez les étapes ci-dessus si vous avez besoin de plusieurs billets pour des événements.

Maintenant que vous avez créé une EventClass, vous pouvez ajouter des cartes à Google Wallet.