Cüzdan (Apple ve Google)
Markalı bir üyelik kartını doğrudan Apple Wallet veya Google Wallet'e gönderin - sunucu tarafında imzalanır, uygulama gerekmez. Apple kartları, bir üyenin puanları veya kademesi değiştiği anda kendilerini günceller.
her iki platform ve tam Apple PassKit güncelleme web hizmeti için yayın bugün kodda canlı. Bunlar, SocialHub ekibiyle yapılandırılmış cüzdan kimlik bilgilerinizi (Apple Geçiş Türü Kimliği + imzalama sertifikası; Google veren + hizmet hesabı) gerektirir.
Ne elde edersiniz?
Sunucu tarafı düzenlemeCanlı
İmzalı bir .pkpass, sunucu tarafında oluşturulur ve üyeye aktarılır; uygulamanızda yerel geçiş imzalama kodu yoktur ve kart tasarımını değiştirecek uygulama sürümü yoktur.
Otomatik kart güncellemeleriCanlı
Puan veya kademe değişikliği → sessiz bir APNs güncellemesi gönderilir → cihaz şifreyi yeniden alır. Üyelik kartı, sıfır uygulama koduyla aktif kalır.
Temiz yaşam döngüsüCanlı
Kaldırılan bir üyenin geçiş seri numarası 410 Gone hatası veriyor, bu nedenle Wallet eski kartı sorunsuz bir şekilde bırakıyor. Bir cron, imza sertifikanızın süresinin dolmasını izliyor.
Apple + GoogleCanlı
Her iki platform da bugün tek bir uç noktadan işlem yapıyor: Apple imzalı bir .pkpass döndürüyor; Google bir kaydetme bağlantısı döndürüyor. (Sessiz otomatik güncelleme Apple PassKit'tir; Google kartlar açıldığında yenilenir.)
Bir kart çıkarın Canlı
Bunu oturum açmış üye WebView'ından çağırın — oturum akışı için Üye Portalı Gömme kılavuzuna bakın.
// 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.Güncellemeler kendiliğinden gerçekleşir. Canlı
// 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.Canlıya geçmeden önce
Apple Şifre Türü Kimliği
Apple Geliştirici hesabınıza bir Geçiş Türü Kimliği kaydedin (Tanımlayıcılar → Geçiş Türü Kimlikleri) ve onu SocialHub ekibinizle paylaşın.
İmza sertifikasını geçmek
Söz konusu Geçiş Türü Kimliği için geçiş imzalama sertifikasını oluşturun. Her .pkpass sunucu tarafında onunla imzalanır; Bir cron, hiçbir zaman sessizce sona ermemesi için vadesinin dolmasını izler.
APNs yetkilendirme anahtarı (.p8)
SocialHub'ın Apple kartını güncel tutan sessiz güncelleme bildirimlerini iletebilmesi için bir APN kimlik doğrulama anahtarı (Anahtar Kimliği + Ekip Kimliği) sağlayın.
Google Wallet veren kuruluş
Google kartları için Google Wallet veren kuruluş kimliğinizi ve bir hizmet hesabı anahtarınızı sağlayın. SocialHub, imzalı kaydetme bağlantısını sunucu tarafında basar.
Not: Geçiş Türü Kimliği oluşturmak ve imzalama sertifikasını geçmek için ücretli Apple Geliştirici Programında bir Apple Geliştirici hesabı gereklidir.
Kabul kontrol listesi
POST /wallet/issue (platform: apple) tarafından verilen gerçek bir .pkpass, cihaza yüklenir ve üyenin mevcut puanlarını/seviyesini gösterir.
İstek gönderen platform: Google, kartı Google Wallet'a ekleyen bir saveUrl döndürür.
Üyenin puanlarını değiştirmek, yüklü Apple kartını saniyeler içinde yeniler - uygulama etkileşimi olmadan.
Yapılandırılmış kimlik bilgileri olmayan bir platform için işlem yapıldığında, bozuk dosya değil, WALLET_NOT_CONFIGURED hatası döndürülür.
Kaldırılan bir üyenin Apple geçiş seri numarası 410 Gone döndürür ve Cüzdan kartı düşürür — asla 500 olmaz.
Cüzdan kartları mı kuruyorsunuz?
Bir mühendisle Apple Geçiş Türü Kimlikleri, imzalama sertifikaları, APN anahtarları veya Google Wallet veren kuruluş kurulumu hakkında konuşun.
Mühendislikle konuş