Skip to content
Guide du centre d'aide · Certificats & identifiantsPhase d'intégration 2
3 min de lectureVérifié 2026-11-16

Configuration Google Wallet

Comparez l'Issuer ID géré par Passinstance et un Issuer personnalisé avec surcharges de champs Android.

Dans ce guide

Visites interactives de l'interface

Ouvrir dans le guide en 6 phases

Inspectez les écrans exacts du tableau de bord et les zooms annotés liés à ce guide.

Focus interface zoomé
Éléments clés de l'interface

Éditeur — Type de carte & variante visuelle (Zoom)

Sélectionnez la structure sous-jacente (Coupon, Carte de fidélité, Billet, Passe générique, Carte d'embarquement) et sa variante.

Aperçu : émetteur Google Wallet géré vs personnalisé

Contrairement au certificat marchand obligatoire dès le départ chez Apple Wallet, Passinstance intègre une infrastructure d'émetteur Google Wallet gérée prête à l'emploi qui permet de publier et distribuer des cartes Android dès l'onboarding (PUT /api/v1/onboarding/wallet-setup). Pour les marques qui souhaitent exploiter leur propre Issuer ID Google Pay & Wallet Console ou leurs propres clés sans contact Google Smart Tap, Passinstance permet également de connecter un compte de service Google Cloud dédié (POST /api/v1/google-wallet/setup).

FLUX ARCHITECTURE SYSTÈME
ARCHITECTURE INTERACTIVE
CONFIGURATION ÉMETTEUR GOOGLE WALLET & COMPTE DE SERVICE
ÉTAPE 01 OPTION A : ÉMETTEUR GÉRÉ PAR PASSINSTANCE (PAR DÉFAUT)
Aucune configuration Google Cloud nécessaire
Activé automatiquement à l'onboarding (PUT/api/v1/onboarding/wallet-setup)
Passinstance signe les JWT Save & gère les appels REST walletobjects
ÉTAPE 02 OPTION B : CONFIGURATION ÉMETTEUR ENTREPRISE PERSONNALISÉE
1
Console Google Pay & Wallet (pay.google.com/business/console)
Copier l'issuerId numérique à 19 chiffres (ex. 3388000000022194812)
Configurer le collectorId Smart Tap (pour lecture sans contact NFC)
2
Console Google Cloud (console.cloud.google.com)
Activer l'API « Google Wallet API » (walletobjects.googleapis.com)
Créer un compte de service & exporter sa clé JSON (private_key, client_email)
3
Autoriser le compte de service dans Google Pay & Wallet Console
Inviter client_email avec le rôle Developer / Admin
4
Provisionner dans Passinstance (POST/api/v1/google-wallet/setup)
Chiffre le JSON du compte de service dans encrypted storage & teste la connexion API

Prérequis : Lors de la configuration d'un Issuer ID Google Wallet personnalisé, vous devez impérativement inviter l'adresse client_email du compte de service Google Cloud dans Google Pay & Wallet Business Console -> Users avec les droits Developer. Sans cette autorisation IAM, l'API Google walletobjects renvoie une erreur 403 Forbidden lorsque Passinstance tente de créer des Classes ou des Objets.

Comparatif : mode géré Passinstance vs Issuer personnalisé

CapacitéÉmetteur géré PassinstanceIssuer ID Entreprise personnalisé
Temps de mise en routeInstantané (0 minute)~15 minutes (Google Cloud + Business Console)
Nom de marque & logo sur la cartePersonnalisation complète par modèle (issuerName, programLogo)Personnalisation complète par modèle (issuerName, programLogo)
Accès Google Pay & Wallet ConsoleGéré par PassinstanceAccès direct à votre propre Google Business Console
Google Smart Tap NFC (NFC_SMART_TAP)Utilise la configuration espace de travail / lecteurPrend en charge votre propre smartTapMerchantId & collectorId
Webhook de rappel (/api/v1/wallet/callback)Préconfiguré automatiquementConfiguré automatiquement lors de la création de la classe

API de configuration & d'activation Google Wallet (Google Wallet Setup API)

Tous les points d'entrée d'émetteur et d'activation Google Wallet par modèle sont exposés sous /api/v1/google-wallet :

MéthodeChemin du point d'entréePermission requiseDescription
POST/api/v1/google-wallet/setupwallet:manage, certificates:manageProvisionne un compte émetteur Google Wallet et un collector ID Smart Tap optionnel à partir des informations entreprise de l'espace.
GET/api/v1/google-wallet/statuswallet:read / wallet:manageRetourne { isConfigured, collectorId } indiquant si Google Wallet et Smart Tap sont opérationnels.
POST/api/v1/google-wallet/repair-callbackswallet:manage, certificates:manageResynchronise les URLs de rappel /api/v1/wallet/callback manquantes sur les Google Wallet Classes publiées.
POST/api/v1/google-wallet/templates/:templateId/activatewallet:manage, certificates:manageActive le provisionnement de classe Google Wallet pour un modèle spécifique.
POST/api/v1/google-wallet/templates/:templateId/deactivatewallet:manage, certificates:manageDésactive la prise en charge Google Wallet pour un modèle spécifique.
GET/api/v1/google-wallet/templates/:templateId/statuswallet:manage, certificates:readRetourne { isEnabled, issuerId } pour le modèle ciblé.

Exemple : initialiser la configuration Google Wallet

BASH
POST /api/v1/google-wallet/setup
X-API-Key: <API_KEY>

Réponse (201 Created) :

JSON
{
  "issuerId": "3388000000022194812",
  "googlePayAccount": {
    "accountIdentifier": "3388000000022194812",
    "collectorId": "50992104"
  },
  "smartTapMerchantData": {
    "smartTapMerchantId": "50992104"
  }
}

L'interrogation ultérieure via GET /api/v1/google-wallet/status renvoie { "isConfigured": true, "collectorId": "50992104" }, et chaque passe expose googleWalletTypeSource (Google Wallet source type : INITIAL_CREATION | MIGRATION | MANUAL_REGENERATION).

Bonnes pratiques lors du paramétrage des modèles

  1. 1
    Choisir la catégorie Google exacte : Dans Edit Template -> Pass Types, sélectionnez le type correspondant à votre programme — Fidélité (LoyaltyClass), Offre (OfferClass), Carte cadeau (GiftCardClass), Billet d'événement (EventTicketClass) ou Passe générique (GenericClass) — car Google Wallet interdit de modifier le type de ressource d'une classe après publication.
  2. 2
    Contrôler l'aperçu Android explicitement : Basculez systématiquement entre Apple Wallet et Google Wallet dans l'aperçu en direct, car les ratios d'images (androidBackground en bannière large vs recadrage carré de googlePayLogo) et les règles de troncature de texte diffèrent entre plateformes.
  3. 3
    Exploiter les Android Overrides : Renseignez des libellés et valeurs spécifiques à Android dans l'inspecteur dès qu'un emplacement Apple ne correspond pas exactement à l'ergonomie Android.

Consultez Google Wallet et Google Smart Tap pour les spécifications des classes, objets et paiements/lectures sans contact.

Prêt à lancer votre premier programme de cartes Wallet ?

Créez votre espace de travail, configurez votre modèle et testez une vraie carte dans Apple Wallet et Google Wallet avant de déployer à grande échelle.