Wallet kartları
Apple Wallet ve Google Wallet'taki sadakat kartı her zaman müşterinin telefonundadır: üzerinde puan bakiyesi, seviye, geçerli promosyon kodu ve kasa için barkod bulunur. OneTrace.pro kartı kendisi günceller: bir siparişten, puan kazanımından veya promosyon kodu verilmesinden sonra müşteri yeni değerleri görür, Apple Wallet ise bir bildirim gösterir. Kart aynı zamanda bir mesaj kanalıdır: kısa bir mesaj bildirim olarak gelir ve kartın arka yüzünde kalır.
Wallet kartları “Büyüme” tarifesinden itibaren kullanılabilir (tarifeler). Bölüm İletişim → Wallet kartları menüsündedir. İstatistikleri ve tasarımı “Müdür”, “Gözlemci” ve üzeri roller görür; tasarımı entegrasyonları yönetme yetkisine sahip roller, yani “Yönetici” ve “Sahip” değiştirebilir.
Bağlantı
Kartları mağazanız kendi adına ve kendi Apple ve Google anahtarlarıyla verir. Platformlardan birini veya ikisini birden bağlayın:
- Entegrasyonlar sayfasını açın, Entegrasyon ekle düğmesine tıklayın ve Wallet kartları seçeneğini seçin (entegrasyonlar).
- Apple Wallet için:
- Apple Developer'da Certificates, Identifiers & Profiles → Identifiers bölümünü açın ve bir Pass Type ID kaydedin, örneğin
pass.com.example.loyalty; - bunun için bir Pass Type ID Certificate oluşturun, Mac'e yükleyin ve “Anahtar Zinciri Erişimi”nden özel anahtarla birlikte bir
.p12dosyasına dışa aktarın; - Pass Type ID sertifikası alanına
.p12içeriğini base64 olarak veya sertifikayı ve anahtarı PEM biçiminde, Anahtar parolası alanına ise dışa aktarma parolasını yapıştırın. Apple WWDR ara sertifikasını OneTrace.pro kendisi ekler.
- Apple Developer'da Certificates, Identifiers & Profiles → Identifiers bölümünü açın ve bir Pass Type ID kaydedin, örneğin
- Google Wallet için:
- Google Pay & Wallet Console'da bir düzenleyici oluşturun ve Issuer ID değerini kopyalayın;
- Google Cloud'da Google Wallet API'yi etkinleştirin, bir hizmet hesabı ve bunun için bir JSON anahtarı oluşturun;
- hizmet hesabının e-posta adresini Google Pay & Wallet Console'a düzenleyici kullanıcısı olarak ekleyin;
- Issuer ID'yi ve JSON anahtarını entegrasyona yapıştırın.
- Kaydet ve Test et düğmelerine tıklayın: Apple için test Pass Type ID'yi, ekibi ve sertifikanın geçerlilik süresini, Google için ise kart sınıfının oluşturulduğunu gösterir.
Google düzenleyicinizi yayın için onaylayana kadar Google kartını yalnızca konsolda eklenen test kullanıcıları kaydedebilir. Apple sertifikası bir yıllığına verilir: süresi dolmadan yenisini oluşturun ve entegrasyonda değiştirin, aksi takdirde kartlar güncellenmez.
Kart tasarımı
Wallet kartları sayfasını açın veya entegrasyondaki Kart tasarımı düğmesine tıklayın. Birden fazla entegrasyon varsa üstten istediğinizi seçin.
| Alan | Neyi belirler |
|---|---|
| Karttaki ad | Kartı veren mağaza. Boşsa entegrasyon adı kullanılır |
| Arka plan, Metin, Etiketler | Kart renkleri. Google Wallet yalnızca arka plan rengini kullanır, metin rengini kendisi seçer |
| Logo | Apple: sol üstte adın yerine. En az 480×150 piksel yükleyin |
| Şerit | Apple: logonun altında, puanların arkasında geniş bir görsel; Google: kartın üst bölümü. Yaklaşık 1125×369 piksel |
| Simge | En az 660×660 piksel kare: Apple bildirim simgesi ve Google Wallet'taki program logosu |
| Barkod | QR kod, Code 128, PDF417 veya Aztec: kasadaki tarayıcının okuduğu tür. Barkodda kart numarası bulunur |
| Özel alanlar | En fazla 4 alan: karttaki etiket ve profil niteliği, örneğin “Şehir” — city. Profilde bu nitelik yoksa kartında da alan görünmez |
Görseller medya kütüphanesinden seçilir; bunun için mesaj şablonlarına erişim gerekir. Kartın kullandığı bir görsel medya kütüphanesinden silinemez. Sağda örnek verilerle Önizleme bulunur; değiştirici, kartın Apple Wallet'ta ve Google Wallet'ta nasıl göründüğünü gösterir. Önizleme yaklaşıktır: kesin görünüm telefona bağlıdır.
Kaydet düğmesine tıklayın. Müşterilerin zaten yüklediği kartlar birkaç dakika içinde güncellenir.


Kartta neler var
- Puan ve Seviye: müşterinin sadakat programındaki hesabından.
- Ad:
first_namevelast_nameniteliklerinden. - Promosyon kodu: müşteriye verilen ve henüz kullanılmamış son kişisel promosyon kodu.
- Kart numarası ve barkod. Profilin zaten bir sadakat kartı numarası varsa (
loyalty_cardkimliği, örneğin mağaza fişlerinden), Wallet kartında da o numara yer alır; yoksa OneTrace.pro 13 haneli yeni bir numara oluşturur. - Tasarımdaki Özel alanlar ve son Mesaj: kartın arka yüzünde.
Kart; puanlar, seviye, ad, özel alanlar veya promosyon kodu değiştiğinde güncellenir. Apple Wallet yeni bakiye, seviye ve promosyon kodu hakkında bildirim gösterir. İki profil tek bir profilde birleştirilirse kartlar kalan profile geçer.
Müşteri kartı nasıl ekler
Kartı kişisel bir bağlantı verir: markanızın alan adında Apple Cüzdan’a Ekle ve Google Cüzdan’a Ekle düğmelerinin bulunduğu bir sayfa. Önce, sayfanın açıldığı platformun düğmesi gösterilir. Bağlantı 90 gün geçerlidir, sayfa profilin dilindedir.
- E-postalarda ve diğer mesajlarda:
{{ wallet_url }}değişkeni (şablonlar), örneğin sadakat programının hoş geldin yolculuğunda. - Tercih merkezinde: Cüzdan’daki sadakat kartı bağlantısı.
- Mağazanın müşteri hesabında: gizli anahtar ve “Profilleri okuma” yetkisiyle
GET /api/v1/profiles/{type}/{value}/walletisteği (API anahtarları); yanıtta bağlantı, geçerlilik süresi, platformlar ve profilin kartları bulunur.
Bağlantı, projede Apple sertifikalı veya Google anahtarlı etkin bir “Wallet kartları” entegrasyonu olduğunda görünür.
Karta mesajlar
Wallet kartları kanalı diğer kanallar gibi şablonlarda, yolculuklarda ve kampanyalarda A/B varyantları ve teslim durumlarıyla çalışır. Şablonda Başlık (arka yüzdeki alanın etiketi), Metin ve isteğe bağlı Bağlantı bulunur; bunlarda değişkenler kullanılabilir.
- Apple Wallet metni bildirim olarak gösterir ve bir sonraki mesaja kadar kartın arka yüzünde tutar. Telefon güncellenmiş kartı aldığında mesaj teslim edilmiş sayılır.
- Google Wallet mesajı karta bildirimle ekler. Google bir kart için günde en fazla 3 bildirim gösterir.
Mesajı yalnızca bu entegrasyonun kartını yüklemiş müşteriler alır. Kart yoksa gönderim “Profilde yüklü bir Wallet kartı yok” hatasıyla sonuçlanır: Wallet'a yalnızca kartı olanlara yazmak için bir koşul veya segment kullanın.
İstatistikler
Kart istatistikleri bloğu her platform için şunları gösterir:
- Oluşturulan: bağlantılarla kaç kart oluşturulduğu;
- Yüklü: şu anda müşterilerin Wallet'ında kaç kart bulunduğu;
- Silinen: kaç müşterinin kartı kaldırdığı.
Aşağıdaki grafik, proje saat diliminde son 30 gün için günlük yüklemeleri ve silmeleri gösterir.

Profil kartındaki Wallet kartları bloğu müşterinin kartlarını gösterir: platform, kart numarası ve tarih; kartın ne zaman yüklendiği, silindiği veya oluşturulup yüklenmediği.