PushizoDocs
Mesajlaşma & kampanyalar

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 -legacy
openssl pkcs12 -in Sertifikalar.p12 -nocerts -nodes -out pass.key -legacy
openssl x509 -inform DER -in AppleWWDRCAG4.cer -out wwdr.pem

Sertifika süresi panelde görünür. Bitmeden yenileyin: bittiğinde yeni kart üretilemez ve mevcut kartlara güncelleme gitmez.

Google

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

AlanAçıklama
kindcoupon, loyalty, event, generic
slugMesajda kullanılan kısa ad, sonradan değişmez
designBaşlık, açıklama, kurum, renkler, barkod biçimi, alanlar
imagesicon (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

İşlemPanel izniAPI kapsamı
Okumaanalytics.readusers:read
Kart verme, güncelleme, iptalcampaigns.createnotifications:write
Şablontemplates.writeadmin
Kimlik bilgisichannels.manageadmin

Bilinen sınırlar

  • Konum ve beacon ile kart önerisi yoktur.
  • Toplu kart verme yerine mesajdaki etiket kullanılır.
  • Apple web servisi API_URL adresinden sunulur ve HTTPS olmalıdır: Apple HTTP adresli web servisine bağlanmaz.

Bu sayfada