Google Wallet propose une API REST qui vous permet de créer et de gérer des cartes en envoyant des requêtes à l'API Google Wallet via HTTP. Cela est utile pour ceux qui souhaitent créer des services côté serveur afin de travailler avec des cartes de manière automatisée.
Pour utiliser l'API REST Google Wallet, vous devez l'activer dans la console Google Cloud, créer un compte de service Google Cloud, puis générer une clé pour le compte de service.
Lorsque vous créez des cartes avec l'API REST, la clé de compte de service utilisée pour signer vos objets Cartes encodées par jeton Web JSON.
Pour d'autres opérations, telles que la mise à jour ou la suppression de cartes, la clé du compte de service est envoyée avec la requête pour vous authentifier en tant qu'émetteur de cartes.
1. Activer l'API REST Google Wallet
Pour activer l'API REST Google Wallet, procédez comme suit:
- Si vous ne possédez pas encore de compte Google Cloud, accédez à la console Google Cloud et suivez les étapes pour en créer un.
- Dans le menu déroulant du projet en haut de la console, sélectionnez le projet Google Cloud que vous souhaitez utiliser ou créez-en un.
- Accédez à la page d'informations détaillées sur le produit de l'API Google Wallet dans Google Cloud Console Marketplace.
- Cliquez sur le bouton "Activer". L'API REST Google Wallet sera disponible après quelques instants pour le projet Google Cloud sélectionné.
2. Générer une clé de compte de service Google Cloud
Pour authentifier les requêtes adressées à l'API REST Google Wallet, vous devez créer un compte de service et générer une clé de compte de service en procédant comme suit:
- Accédez à la page Créer un compte de service dans la console Google Cloud.
- Saisissez les informations du compte de service. Notez l'adresse e-mail du compte de service qui apparaît sous le champ "ID du compte de service". Vous en aurez besoin plus tard lorsque vous utiliserez le compte de service pour authentifier vos requêtes auprès de l'API REST de Google Wallet.
- Cliquez sur le bouton "OK". Il n'est pas nécessaire de suivre les autres étapes de création du compte de service.
- Cliquez sur l'élément de menu "CLÉS" en haut de la page.
- Cliquez sur le menu déroulant "AJOUTER UNE CLÉ", puis sur "Créer une clé".
- Sélectionnez le type de clé "JSON".
- Cliquez sur "CRÉER" pour créer et télécharger la clé du compte de service.
3. Autoriser votre compte de service dans la console Google Wallet
Pour authentifier vos requêtes auprès de l'API REST Google Wallet à l'aide d'une clé de compte de service, vous devez ajouter l'adresse e-mail de votre compte de service en tant qu'utilisateur à votre compte d'émetteur. Pour ajouter votre compte de service en tant qu'utilisateur, procédez comme suit:
- Accédez à la page Comptes de service de la console Google Cloud.
- Copiez l'adresse e-mail du compte de service que vous souhaitez utiliser pour authentifier vos requêtes auprès de l'API Google Wallet.
- Accédez à la console Google Pay et Wallet.
- Dans le menu de navigation de gauche, cliquez sur "Utilisateurs".
- Cliquez sur "Inviter un utilisateur".
- Saisissez l'adresse e-mail de votre compte de service.
- Dans la liste déroulante "Niveau d'accès", sélectionnez "Développeur".
- Cliquez sur le bouton "Inviter".
Une fois votre compte de service ajouté, vous pouvez utiliser n'importe quelle clé de compte de service générée pour l'authentifier afin d'authentifier les requêtes adressées à l'API REST de Google Wallet. Lorsque vous utilisez des clés de compte de service, n'oubliez pas qu'il s'agit d'identifiants très sensibles qui ne doivent être utilisés que dans des environnements sécurisés côté serveur.