Wallet (Apple & Google)
Stellen Sie eine personalisierte Mitgliedskarte direkt an Apple Wallet oder Google Wallet aus – serverseitig signiert, keine App erforderlich. Apple-Karten aktualisieren sich automatisch, sobald sich die Punkte oder der Status eines Mitglieds ändern.
Die Ausstellung für beide Plattformen und den vollständigen ApplePassKit-Update-Webservice sind heute im Code verfügbar. Sie benötigen Ihre Wallet-Zugangsdaten (ApplePass-Typ-ID + Signaturzertifikat; Google Aussteller + Servicekonto), die mit dem SocialHub-Team konfiguriert wurden.
Was Sie erhalten
Serverseitige AusgabeLive
Ein signierter .pkpass wird serverseitig generiert und an das Mitglied gestreamt – kein nativer Pass-Signaturcode in Ihrer App und keine App-Version, um das Kartendesign zu ändern.
Automatische KartenaktualisierungenLive
Punkte- oder Stufenänderung → ein stilles APNs-Update wird durchgeführt → das Gerät ruft den Pass erneut ab. Die Mitgliedskarte bleibt ohne App-Code aktiv.
Sauberer LebenszyklusLive
Die Seriennummer des Zugangs eines entfernten Mitglieds liefert den Fehlercode 410 Gone. Wallet entfernt die veraltete Karte daher ordnungsgemäß. Ein Cronjob überwacht den Ablauf Ihres Signaturzertifikats.
Apple + GoogleLive
Beide Plattformen stellen heute von einem Endpunkt aus: Apple gibt ein signiertes .pkpass zurück; Google gibt einen Speicherlink zurück. (Stille automatische Aktualisierung: Apple PassKit; Google Karten werden beim Öffnen aktualisiert.)
Stelle eine Karte aus Live
Rufen Sie diese Funktion innerhalb der WebView des angemeldeten Mitglieds auf – Informationen zum Sitzungsablauf finden Sie im Mitgliederportal-Einbettungsleitfaden.
// 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.Aktualisierungen erfolgen von selbst. Live
// 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.Vor dem Livegang
Apple Pass-Typ-ID
Registrieren Sie eine Pass-Typ-ID in Ihrem Apple-Entwicklerkonto (Identifikatoren → Pass-Typ-IDs) und teilen Sie sie mit Ihrem SocialHub-Team.
Unterzeichnungszertifikat
Generieren Sie das Passsignaturzertifikat für diese Passtyp-ID. Jeder .pkpass wird serverseitig damit signiert; Ein Cron überwacht seinen Ablauf, sodass er niemals stillschweigend verfällt.
APNs-Authentifizierungsschlüssel (.p8)
Geben Sie einen APNs-Authentifizierungsschlüssel (Schlüssel-ID + Team-ID) an, damit SocialHub die stillen Update-Benachrichtigungen pushen kann, die die Apple-Karte auf dem neuesten Stand halten.
Google Wallet-Aussteller
Geben Sie für Google-Karten Ihre Google Wallet-Aussteller-ID und einen Dienstkontoschlüssel an. SocialHub prägt den signierten Speicherlink serverseitig.
Hinweis: Zum Erstellen einer Pass-Type-ID und eines Pass-Signaturzertifikats ist ein Apple-Entwicklerkonto im kostenpflichtigen Apple-Entwicklerprogramm erforderlich.
Checkliste für die Abnahme
Ein echter .pkpass, ausgestellt von POST /wallet/issue (Plattform: Apple), wird auf einem Gerät installiert und zeigt die aktuellen Punkte/den aktuellen Rang des Mitglieds an.
Anfrageplattform: Google gibt eine Antwort zurück saveUrl Dadurch wird die Karte hinzugefügt zu Google Wallet.
Die Änderung der Punkte des Mitglieds aktualisiert die installierte Apple-Karte innerhalb von Sekunden – ohne App-Interaktion.
Die Ausgabe für eine Plattform ohne konfigurierte Anmeldeinformationen gibt WALLET_NOT_CONFIGURED zurück, nicht etwa eine beschädigte Datei.
Die Apple-Pass-Seriennummer eines entfernten Mitglieds gibt 410 Gone zurück, und Wallet entfernt die Karte – niemals 500.
Wallet-Karten einrichten?
Sprechen Sie mit einem Techniker über Apple Pass-Typ-IDs, Signaturzertifikate, APNs-Schlüssel oder Google Wallet Aussteller-Einrichtung.
Sprechen Sie mit der Technik