Bu sayfada, Akıllı Dokunma protokolü tarafından kullanılan tanımlayıcılar açıklanmaktadır.
Genel bakış
Akıllı Dokunma protokolü, bir kullanıcının Google Cüzdan uygulamasına ve terminal uygulamasına kaydedilen kartlarla ilgili bilgileri iletir. Aşağıdaki grafikte terminal ile Google Cüzdan arasındaki iletişim akışı özetlenmiştir:
Satıcılar kart geliştirmek için birden fazla işletmeden veya yükleniciden yararlanabildiğinden Google, Google Cüzdan ile terminaller arasında bilgi göndermeyi kolaylaştırmak için üç tanımlayıcı kullanır. Bu sayede, belirli bir terminal sağlayıcısı kullanan satıcılar farklı geliştiricilerden gelen kartları kullanabilir. Aşağıdaki kimlikler, Akıllı Dokunma protokolünde kullanılan üç "koleksiyon tanımlayıcısı"dır.
Teklifi Veren Kimliği
Teklif Veren Kimliği, özel bir Veren Kimliği türüdür. Teklifi Veren Kimliği genellikle tek bir satıcıyı temsil eder. Buna karşılık, geçiş kartı geliştiricisine ait Düzenleyen Kimliği ise birçok farklı satıcı için geçiş sınıflarını depolayan bir platformu temsil edebilir. Birden fazla satıcı için geçiş sınıflarını depolayan platformlara Toplayıcı adı da verilir.
Teklif Verenler, Akıllı Ödeme'den daha fazlası için kullanılır. Örneğin, Teklifi Verenler (Redemption Issuers), Teklif Veren'in konumlarına bağlı olarak coğrafi konum tabanlı bildirim hatırlatıcıları oluşturmak için de kullanılır. Bu nedenle, kartta teklifi veren kuruluş olarak listelenen bir kartı veren kuruluş kimliği, Akıllı Dokunma için yapılandırılmamış olabilir.
Teklifi Veren Kimliği ve Teklifi Veren Kimliği
Düzenleyen Kimliği, Google Cüzdan'ı Veren Kuruluş hesabının benzersiz bir tanımlayıcısıdır. Kartı veren kuruluşun kimliği, Google Pay ve Cüzdan Konsolu'nda bulunabilir.
Kartı veren kuruluş; bir satıcı (ör. restoran), teklif sağlayıcı, terminal üreticisi ve daha fazlasını temsil edebilir. Pass sınıfları ve nesneleri geliştirildiğinde belirli bir Sertifikayı Veren Kimliğine bağlanır. Düzenleyen kimliği, hem geçiş sınıfı kimliklerine hem de nesne kimliklerine dahil edilir.
| Kimlik | Biçim | Notlar |
|---|---|---|
| Sınıf Kimliği | issuerId.classSuffix
|
classSuffix, belirli bir geçiş sınıfı (ör.bağlılık katmanı) için geliştirici tarafından tanımlanan benzersiz bir değerdir. |
| Nesne kimliği | issuerId.objectSuffix
|
objectSuffix, belirli bir geçiş nesnesi (kullanıcı kimliği gibi) için geliştirici tarafından tanımlanan benzersiz bir değerdir |
Sertifikayı veren kuruluş, ihtiyaç duyduğu sayıda sınıf oluşturabilir.
Toplayıcı Kimliği
Terminallerinde Akıllı Dokunma'yı destekleyen satıcılar, Teklif Veren Kuruluşun Toplayıcı Kimliğine sahip olur. Toplayıcı Kimliği, terminallerin kendilerini tanımlamak için kullandığı sayısal bir kimliktir (8 basamaklı). Teklifi Veren birden fazla satıcıyı destekleyebildiğinden belirli bir satıcının pasosu istemek için Toplayıcı Kimliği kullanılır.
Kullanıcı, cihazını Akıllı Dokunma özellikli bir terminale dokunduğunda terminal, kullanıcının cihazına Toplayıcı Kimliği'ni gönderir. Cihaz, daha sonra ilgili Toplayıcı Kimliğinin ortak anahtarını kullanarak terminalle kimlik doğrulaması yapar. Daha fazla bilgi edinmek için İletişim akışı bölümüne bakın.
Önemli notlar:
- Bir Düzenleyen Kimliği'ne yalnızca bir Toplayıcı Kimliği atanmış olmalıdır
- Toplayıcı Kimliği, tüm Sertifika Veren Kimlikleri genelinde benzersizdir
Düzenleyen kimliğiniz için Toplayıcı Kimliği edinmek üzere Satıcı yapılandırması sayfasına bakın.
Geçiş sınıfı kimliği
Sınıf kimliği, belirli bir katmanı veya kullanım türünü tanımlar. Sınıf kimliği aşağıdaki biçimi kullanır:
issuerId.classSuffix
Sınıf son eki, bu kart sınıfına özel, geliştirici tarafından tanımlanan bir değerdir. Bu sınıf kimliğini referans alan kart nesnesi, kullanıcının Google Cüzdan uygulamasına kaydedilir.