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).
Prérequis : Lors de la configuration d'un Issuer ID Google Wallet personnalisé, vous devez impérativement inviter l'adresse
client_emaildu compte de service Google Cloud dans Google Pay & Wallet Business Console -> Users avec les droits Developer. Sans cette autorisation IAM, l'API Googlewalletobjectsrenvoie une erreur403 Forbiddenlorsque Passinstance tente de créer des Classes ou des Objets.
Comparatif : mode géré Passinstance vs Issuer personnalisé
| Capacité | Émetteur géré Passinstance | Issuer ID Entreprise personnalisé |
|---|---|---|
| Temps de mise en route | Instantané (0 minute) | ~15 minutes (Google Cloud + Business Console) |
| Nom de marque & logo sur la carte | Personnalisation complète par modèle (issuerName, programLogo) | Personnalisation complète par modèle (issuerName, programLogo) |
| Accès Google Pay & Wallet Console | Géré par Passinstance | Accès direct à votre propre Google Business Console |
Google Smart Tap NFC (NFC_SMART_TAP) | Utilise la configuration espace de travail / lecteur | Prend en charge votre propre smartTapMerchantId & collectorId |
Webhook de rappel (/api/v1/wallet/callback) | Préconfiguré automatiquement | Configuré 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éthode | Chemin du point d'entrée | Permission requise | Description |
|---|---|---|---|
| POST | /api/v1/google-wallet/setup | wallet:manage, certificates:manage | Provisionne un compte émetteur Google Wallet et un collector ID Smart Tap optionnel à partir des informations entreprise de l'espace. |
| GET | /api/v1/google-wallet/status | wallet:read / wallet:manage | Retourne { isConfigured, collectorId } indiquant si Google Wallet et Smart Tap sont opérationnels. |
| POST | /api/v1/google-wallet/repair-callbacks | wallet:manage, certificates:manage | Resynchronise les URLs de rappel /api/v1/wallet/callback manquantes sur les Google Wallet Classes publiées. |
| POST | /api/v1/google-wallet/templates/:templateId/activate | wallet:manage, certificates:manage | Active le provisionnement de classe Google Wallet pour un modèle spécifique. |
| POST | /api/v1/google-wallet/templates/:templateId/deactivate | wallet:manage, certificates:manage | Désactive la prise en charge Google Wallet pour un modèle spécifique. |
| GET | /api/v1/google-wallet/templates/:templateId/status | wallet:manage, certificates:read | Retourne { isEnabled, issuerId } pour le modèle ciblé. |
Exemple : initialiser la configuration Google Wallet
POST /api/v1/google-wallet/setup
X-API-Key: <API_KEY>
Réponse (201 Created) :
{
"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
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
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 (
androidBackgrounden bannière large vs recadrage carré degooglePayLogo) et les règles de troncature de texte diffèrent entre plateformes. -
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.
