Aller au contenu principal
Wallet

Configurer Google Wallet (Issuer ID, service account)

Guide complet pour activer les passes Google Wallet sur Agora Page : création de l'Issuer ID, service account JSON et variables d'environnement.

Sommaire

Configurer Google Wallet

État au 20 août 2026 : l'émission Google Wallet n'est pas encore ouverte sur Agora Page. Les boutons Google Wallet se cachent automatiquement sur les pages publiées tant qu'elle ne l'est pas, et le site n'annonce qu'Apple Wallet. Cette page décrit la configuration côté plateforme ; elle sera mise à jour à l'ouverture.

Le bloc Google Wallet permettra aux visiteurs Android d'ajouter votre carte de contact dans l'application Google Wallet.

La configuration necessite un compte Google Wallet Business, accessible via wallet.google.com/business.

Etape 1 : creer un compte Issuer

Connectez-vous sur la Google Wallet Business Console. Completez le formulaire d'inscription avec les informations de votre entreprise.

Une fois valide, notez votre Issuer ID (nombre a 15 chiffres). C'est la variable GOOGLE_WALLET_ISSUER_ID.

Etape 2 : creer un compte de service Google

Dans la Google Cloud Console (console.cloud.google.com), selectionnez votre projet et allez dans IAM et administration > Comptes de service.

Creez un nouveau compte de service. Assignez-lui le role Google Wallet Object Issuer.

Generez une cle JSON pour ce compte de service. Telechargez le fichier JSON.

Etape 3 : encoder le service account

Le fichier JSON du service account doit etre encode en base64. Sur la page Admin > Wallet Config, utilisez l'outil de conversion base64 integre.

Deposez le fichier JSON et copiez la valeur base64 generee.

Etape 4 : configurer les variables d'environnement

Dans Vercel, ajoutez :

GOOGLE_WALLET_ISSUER_ID=<votre_issuer_id_15_chiffres>
GOOGLE_WALLET_SERVICE_ACCOUNT_BASE64=<base64_du_json_service_account>

Etape 5 : tester

Apres redeploy, accedez a l'URL /api/wallet/google/votre-slug sur un appareil Android. Vous devriez etre redirige vers pay.google.com avec l'invite d'ajout au Wallet.

Si la variable est absente, l'endpoint retourne un 503 avec un message explicatif (pas d'erreur silencieuse).

Notes importantes

  • Les passes Google Wallet sont signes avec un JWT RS256 genere cote serveur
  • Les passes Apple Wallet sont signes avec le certificat .p12 via la bibliotheque passkit-generator
  • Les deux types de passes se configurent independamment

En savoir plus