Dompet (Apple & Google)
Keluarkan kad keahlian berjenama terus ke Apple Wallet atau Google Wallet — ditandatangani di bahagian pelayan, tiada aplikasi diperlukan. Kad Apple mengemas kini diri mereka sebaik sahaja mata atau peringkat ahli berubah.
Pengeluaran untuk kedua-dua platform dan perkhidmatan web kemas kini PassKit Apple penuh adalah hidup dalam kod hari ini. Mereka memerlukan kelayakan dompet anda (Apple ID Jenis Pas + sijil tandatangan; Google penerbit + akaun perkhidmatan) yang dikonfigurasikan dengan pasukan SocialHub.
Apa yang anda dapat
Pengeluaran bahagian pelayanLangsung
.pkpass yang ditandatangani dijana dari sisi pelayan dan distrim kepada ahli — tiada kod tandatangan pas asli dalam apl anda dan tiada keluaran apl untuk menukar reka bentuk kad.
Kemas kini kad automatikLangsung
Perubahan mata atau peringkat → kemas kini APN senyap ditolak → peranti mengambil semula pas. Kad keahlian kekal aktif dengan kod aplikasi sifar.
Kitaran hayat bersihLangsung
Siri pas ahli yang dikeluarkan mengembalikan 410 Hilang, jadi Wallet menjatuhkan kad lapuk dengan anggun. Cron memerhatikan tamat tempoh sijil tandatangan anda.
Apple + GoogleLangsung
Kedua-dua platform dikeluarkan hari ini dari satu titik akhir: Apple mengembalikan .pkpass yang ditandatangani; Google mengembalikan pautan simpan. (Kemas kini automatik senyap ialah Apple PassKit; Google kad disegarkan semula apabila dibuka.)
Mengeluarkan kad Langsung
Hubungi ini dari dalam WebView ahli yang telah dilog masuk — lihat panduan Portal Ahli Benamkan untuk aliran sesi.
// 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.Kemas kini berlaku dengan sendirinya Langsung
// 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.Sebelum anda mula beroperasi
Apple ID Jenis Lulus
Daftar ID Jenis Pas dalam akaun Pembangun Apple anda (Pengecam → ID Jenis Pas) dan kongsikannya dengan pasukan SocialHub anda.
Sijil tandatangan pas
Jana sijil tandatangan pas untuk ID Jenis Pas tersebut. Setiap .pkpass ditandatangani dengannya di bahagian pelayan; cron memerhatikan tarikh luputnya supaya ia tidak pernah luput secara senyap.
Kekunci pengesahan APN (.p8)
Sediakan kunci pengesahan APN (ID Kunci + ID Pasukan) supaya SocialHub boleh menghantar pemberitahuan kemas kini senyap yang memastikan kad Apple sentiasa terkini.
Google Wallet penerbit
Untuk kad Google, berikan ID penerbit Google Wallet anda dan kunci akaun perkhidmatan. SocialHub mencetak pautan simpan yang ditandatangani di bahagian pelayan.
Nota: akaun Apple Pembangun pada Program Pembangun Apple berbayar diperlukan untuk membuat ID Jenis Pas dan sijil tandatangan lulus.
Senarai semak penerimaan
Pass .pk sebenar yang dikeluarkan daripada POST /wallet/issue (platform: apple) dipasang pada peranti dan menunjukkan mata/peringkat semasa ahli.
Platform permintaan: google mengembalikan saveUrl yang menambah kad pada Google Wallet.
Menukar mata ahli akan menyegarkan kad Apple yang dipasang dalam beberapa saat — tanpa interaksi aplikasi.
Pengeluaran untuk platform tanpa kelayakan yang dikonfigurasikan mengembalikan WALLET_NOT_CONFIGURED, bukan fail yang rosak.
Siri lulus Apple ahli yang telah dialih keluar mengembalikan 410 Hilang, dan Wallet menjatuhkan kad — tidak pernah 500.
Menyediakan kad Wallet?
Bercakap dengan jurutera tentang Apple ID Jenis Pas, sijil tandatangan, kunci APN atau persediaan penerbit Google Wallet.
Bercakap dengan jurutera