Portefeuille (Apple et Google)
Émettez une carte de membre personnalisée directement sur Apple Wallet ou Google Wallet : signée côté serveur, sans application requise. Les cartes Apple se mettent à jour automatiquement dès que le solde de points ou le niveau du membre change.
L'émission pour les deux plateformes et le service web complet de mise à jour PassKit Apple sont disponibles dès aujourd'hui. Ils nécessitent vos identifiants de portefeuille (Apple ID du type de carte + certificat de signature ; Google émetteur + compte de service) configurés avec l'équipe SocialHub.
Ce que vous obtenez
Émission côté serveurEn direct
Un .pkpass signé est généré côté serveur et diffusé au membre : aucun code de signature de passe natif dans votre application et aucune version d'application pour modifier la conception de la carte.
Mises à jour automatiques des cartesEn direct
Changement de points ou de niveau → une mise à jour APNs silencieuse est envoyée → l'appareil récupère à nouveau le pass. La carte de membre reste active sans code d'application.
Cycle de vie propreEn direct
Le numéro de série du badge d'un membre supprimé renvoie l'erreur 410 (Invalide). Wallet supprime donc la carte obsolète. Une tâche cron surveille l'expiration de votre certificat de signature.
Apple + GoogleEn direct
Les deux plateformes émettent aujourd'hui depuis un seul point de terminaison : Apple renvoie un fichier .pkpass signé ; Google renvoie un lien de sauvegarde. (La mise à jour automatique silencieuse est assurée par Apple PassKit ; les cartes Google s'actualisent à l'ouverture.)
Émettre une carte En direct
Appelez cette fonction depuis l'interface Web des membres connectés. Consultez le guide Intégration du portail membre pour connaître le déroulement de la session.
// The signed-in member's app requests their card. teamId + memberId come from the
// consumer SESSION (never the body) — the body only selects the platform.
POST https://flash.socialhub.ai/api/consumer/wallet/issue
Content-Type: application/json
{ "platform": "apple" } // "apple" | "google"
// Apple → 200 Content-Type: application/vnd.apple.pkpass
// Content-Disposition: attachment; filename="loyalty-<serial>.pkpass"
// (the response body IS the signed .pkpass — hand it to "Add to Apple Wallet")
// Google → 200 { "saveUrl": "https://pay.google.com/gp/v/save/…" }
// (redirect the member to saveUrl → "Save to Google Wallet")
//
// Wallet not configured for that platform → DomainError WALLET_NOT_CONFIGURED.Les mises à jour se font automatiquement. En direct
// You do NOT write update code. SocialHub hosts the standard Apple PassKit update
// web service, so the card stays current on its own:
//
// 1. The pass registers the device when added to Wallet
// POST /api/wallet/apple/v1/devices/{deviceId}/registrations/{passTypeId}/{serial}
// 2. A points / tier change enqueues a silent APNs push to the device
// 3. The device re-fetches the latest pass
// GET /api/wallet/apple/v1/passes/{passTypeId}/{serial}
//
// These endpoints are called by Apple's device, not by your app — listed here for
// transparency. A removed / unenrolled member's serial returns 410 Gone (not 500),
// so Wallet cleanly drops a stale card.Avant la mise en service
Apple Identifiant du type de laissez-passer
Enregistrez un Pass Type ID dans votre compte de développeur Apple (Identifiants → Pass Type ID) et partagez-le avec votre équipe SocialHub.
Certificat de signature
Générez le certificat de signature du mot de passe pour cet identifiant de type de mot de passe. Chaque fichier .pkpass est signé côté serveur avec ce certificat ; une tâche cron surveille son expiration afin qu'il ne devienne jamais inopérant sans que vous vous en rendiez compte.
Clé d'authentification APNs (.p8)
Fournissez une clé d'authentification APNs (ID de clé + ID d'équipe) afin que SocialHub puisse envoyer les notifications de mise à jour silencieuses qui maintiennent la carte Apple à jour.
Google Wallet émetteur
Pour les cartes Google, fournissez votre identifiant d'émetteur Google Wallet et une clé de compte de service. SocialHub crée le lien de sauvegarde signé côté serveur.
Remarque : un compte de développeur Apple sur le programme pour développeurs Apple payant est requis pour créer un ID de type de passe et un certificat de signature de réussite.
Liste de contrôle d'acceptation
Un véritable fichier .pkpass émis par POST /wallet/issue (plateforme : Apple) s’installe sur un appareil et affiche le nombre de points/niveau actuel du membre.
Plateforme requérante : Google renvoie un saveUrl qui ajoute la carte à Google Wallet.
La modification du solde de points d'un membre actualise sa carte Apple installée en quelques secondes, sans aucune interaction avec l'application.
L'émission d'un certificat pour une plateforme sans identifiants configurés renvoie WALLET_NOT_CONFIGURED, et non un fichier corrompu.
Le numéro de série du pass Apple d'un membre supprimé renvoie 410 (Disparu), et Wallet supprime la carte — jamais 500.
Configuration des cartes Wallet ?
Contactez un ingénieur concernant les identifiants de type de carte Apple, les certificats de signature, les clés APN ou la configuration de l'émetteur Google Wallet.
Parlez à l'ingénierie