Dompet (Apple & Google)
Terbitkan kartu keanggotaan bermerek langsung ke Apple Wallet atau Google Wallet — ditandatangani di sisi server, tidak memerlukan aplikasi. Kartu Apple memperbarui diri sendiri saat poin atau tingkatan anggota berubah.
Penerbitan untuk kedua platform dan layanan web pembaruan PassKit Apple lengkap aktif dalam kode hari ini. Mereka memerlukan kredensial dompet Anda (Apple ID Jenis Pass + sertifikat penandatanganan; Google penerbit + akun layanan) yang dikonfigurasi dengan tim SocialHub.
Apa yang Anda dapatkan
Penerbitan sisi serverLangsung
.pkpass yang ditandatangani dibuat di sisi server dan dialirkan ke anggota — tidak ada kode penandatanganan sandi asli di aplikasi Anda, dan tidak ada rilis aplikasi untuk mengubah desain kartu.
Pembaruan kartu otomatisLangsung
Perubahan poin atau tingkatan → pembaruan APNs senyap didorong → perangkat mengambil ulang pass. Kartu keanggotaan tetap aktif tanpa kode aplikasi.
Siklus hidup yang bersihLangsung
Nomor seri kartu anggota yang dihapus mengembalikan 410 Hilang, jadi Wallet menghapus kartu yang sudah kadaluarsa dengan anggun. Sebuah cron memantau masa berlaku sertifikat penandatanganan Anda.
Apple + GoogleLangsung
Kedua platform saat ini menerbitkan dari satu titik akhir: Apple mengembalikan .pkpass yang ditandatangani; Google mengembalikan tautan simpan. (Pembaruan otomatis senyap adalah Apple PassKit; Google kartu diperbarui saat dibuka.)
Terbitkan kartu Langsung
Panggil ini dari dalam WebView anggota yang masuk — lihat panduan Penyematan Portal Anggota untuk alur 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.Pembaruan terjadi secara otomatis. 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 mulai beroperasi
Apple ID Jenis Kartu
Daftarkan ID Tipe Pass di akun Pengembang Apple Anda (Pengidentifikasi → ID Tipe Pass) dan bagikan dengan tim SocialHub Anda.
Sertifikat penandatanganan izin
Menghasilkan sertifikat penandatanganan pass untuk ID Tipe Pass tersebut. Setiap .pkpass ditandatangani dengannya di sisi server; Cron memantau masa berlakunya sehingga tidak pernah berakhir tanpa pemberitahuan.
Kunci otentikasi APNs (.p8)
Berikan kunci otentikasi APNs (ID Kunci + ID Tim) agar SocialHub dapat mengirimkan notifikasi pembaruan senyap yang menjaga kartu Apple tetap terkini.
Google Wallet penerbit
Untuk kartu Google, berikan ID penerbit Google Wallet Anda dan kunci akun layanan. SocialHub membuat tautan simpan yang ditandatangani di sisi server.
Catatan: Akun Pengembang Apple pada Program Pengembang Apple berbayar diperlukan untuk membuat ID Tipe Pass dan sertifikat penandatanganan pass.
Daftar periksa penerimaan
File .pkpass asli yang diterbitkan dari POST /wallet/issue (platform: apple) diinstal pada perangkat dan menampilkan poin/tingkat keanggotaan anggota saat ini.
Platform yang diminta: Google mengembalikan saveUrl yang menambahkan kartu ke Google Wallet.
Mengubah poin anggota akan memperbarui kartu Apple yang terpasang dalam hitungan detik — tanpa interaksi aplikasi.
Menerbitkan untuk platform tanpa kredensial yang dikonfigurasi akan menghasilkan WALLET_NOT_CONFIGURED, bukan file yang rusak.
Nomor seri pass Apple anggota yang dihapus mengembalikan 410 Gone, dan Wallet menghapus kartu tersebut — tidak pernah 500.
Menyiapkan kartu Dompet?
Bicaralah dengan teknisi tentang ID Tipe Pass Apple, sertifikat penandatanganan, kunci APN, atau pengaturan penerbit Google Wallet.
Bicara dengan bagian teknik