Apple ve Google Wallet
Kupon, sadakat kartı ve bilet oluşturun. Kart telefonun cüzdanında durur, siz değiştirdiğinizde güncellenir. Push izni gerekmez.
Kupon, sadakat kartı ve bilet oluşturun. Kart telefonun cüzdanında durur, siz değiştirdiğinizde güncellenir. Push izni gerekmez.
Panelde Wallet sayfasından veya API ile yönetilir.
1. Kimlik bilgilerini girin
Kimlik bilgileri kayıtta doğrulanır, şifrelenir ve bir daha gösterilmez. Yalnızca kullandığınız platformu yapılandırmanız yeterlidir.
Apple
Apple Developer hesabınızda bir Pass Type ID ve sertifikası oluşturun, ayrıca Apple PKI sayfasından WWDR ara sertifikasını indirin.
Apple .p12 verir. Pushizo PEM ister, şu komutlarla dönüştürün:
openssl pkcs12 -in Sertifikalar.p12 -clcerts -nokeys -out pass.pem -legacyopenssl pkcs12 -in Sertifikalar.p12 -nocerts -nodes -out pass.key -legacyopenssl x509 -inform DER -in AppleWWDRCAG4.cer -out wwdr.pemSertifika süresi panelde görünür. Bitmeden yenileyin: bittiğinde yeni kart üretilemez ve mevcut kartlara güncelleme gitmez.
Google Pay & Wallet Console'dan Issuer ID alın. Google Cloud'da Wallet API'yi açın, servis hesabı oluşturun ve bu hesabı Console'a kullanıcı olarak ekleyin. Servis hesabının JSON anahtarını girin. Yeni sınıflar Google incelemesine kadar yalnızca test kullanıcılarına görünür.
2. Şablon oluşturun
| Alan | Açıklama |
|---|---|
kind | coupon, loyalty, event, generic |
slug | Mesajda kullanılan kısa ad, sonradan değişmez |
design | Başlık, açıklama, kurum, renkler, barkod biçimi, alanlar |
images | icon (Apple için zorunlu), logo, strip. PNG, base64, en fazla 256 KB |
Görseller, Google erişebilsin diye herkese açık adresten sunulur: gizli içerik koymayın. Şablonu değiştirdiğinizde verilmiş kartlar da güncellenir.
3. Kartı dağıtın
Mesajla
Şablona etiket ekleyin. Her alıcı kendi bağlantısını alır, kart gerekirse o anda oluşturulur:
Kuponunuz hazır: {% wallet_pass 'yaz_kuponu' %}Kullanıcısı olmayan abonelikte etiket boş döner. Bağlantı cihaza göre açılır: iOS ve macOS .pkpass indirir, Android Google Wallet'a gider.
API ile
POST /v1/apps/{appId}/wallet/passes
Authorization: Bearer <notifications:write kapsamlı anahtar>
{ "template_id": "wlt_...", "external_id": "musteri-42", "barcode_value": "KOD-9", "values": { "oran": "%20" } }Yanıttaki url kartı açar. Kullanıcılı kart şablon başına tektir: aynı kullanıcı için ikinci istek aynı kartı döndürür. Bağlantı yalnızca o kartı açar, kişisel veri içermez; yine de herkese açık yere koymayın.
4. Güncelleyin veya iptal edin
PATCH /v1/apps/{appId}/wallet/passes/{id}
{ "values": { "puan": "1250" } }Apple'da kayıtlı cihazlara bildirim gider ve cihaz yeni kartı indirir. Google'da kart doğrudan yazılır. POST .../passes/{id}/void kartı geçersiz yapar, geri alınmaz.
Yetkiler
| İşlem | Panel izni | API kapsamı |
|---|---|---|
| Okuma | analytics.read | users:read |
| Kart verme, güncelleme, iptal | campaigns.create | notifications:write |
| Şablon | templates.write | admin |
| Kimlik bilgisi | channels.manage | admin |
Bilinen sınırlar
- Konum ve beacon ile kart önerisi yoktur.
- Toplu kart verme yerine mesajdaki etiket kullanılır.
- Apple web servisi
API_URLadresinden sunulur ve HTTPS olmalıdır: Apple HTTP adresli web servisine bağlanmaz.
Ürün önerileri
Ürün kataloğunuzdan her alıcıya uygun ürünleri seçip kampanya, otomasyon ve e-postalarda gösterin. Öneriler olay verinizden her gün hesaplanır. Karar kaydı: ADR-0063. Önce ürün kataloğu yüklenmiş…
Data Feeds
Data Feeds, mesaj gönderilirken her alıcı için harici bir JSON uç noktasından veri çeker ve şablonda {{ feed.<ad>.alan }} olarak kullanılmasını sağlar (sadakat puanı, stok, sepet, hava durumu…). Karar kaydı:…