Na tej stronie opisujemy identyfikatory używane przez protokół smart tap.
Przegląd
Protokół smart tap komunikuje informacje o karcie zapisanej w aplikacji Portfel Google użytkownika i w aplikacji terminala. Ta grafika przedstawia przepływ komunikacji między terminalem a Portfelem Google:
Ze względu na to, że sprzedawcy mogą korzystać z usług wielu firm lub kontrahentów, aby tworzyć swoje karty, Google używa 3 identyfikatorów do przesyłania informacji między Portfelem Google a terminalami. Dzięki temu sprzedawcy, którzy używają danego dostawcy terminali, mogą wykorzystywać karty od różnych deweloperów. Poniższe identyfikatory to 3 „identyfikatory kolekcji” używane w protokole smart tap.
Identyfikator wydawcy elementów promocyjnych
Specjalny typ identyfikatora wydawcy to identyfikator wydawcy elementów promocyjnych. Identyfikator wydawcy elementów promocyjnych odpowiada zwykle jednemu sprzedawcy. Z kolei identyfikator wydawcy w przypadku dewelopera karty może reprezentować platformę, na której są przechowywane klasy kart wielu różnych sprzedawców. Platforma, która przechowuje klasy zaliczonych dla różnych sprzedawców, jest również nazywana agregatorem.
Osoby, które chcą wykorzystać środki z promocji, służą nie tylko do obsługi smart tap. Na przykład wydawcy elementów promocyjnych służą też do renderowania powiadomień opartych na geolokalizacji na podstawie lokalizacji wydawcy elementów promocyjnych. Z tego powodu identyfikator wydawcy wymieniony jako wydawca karty może nie być skonfigurowany do obsługi smart tap.
Identyfikator wydawcy elementów promocyjnych a identyfikator wydawcy
Identyfikator wydawcy to unikalny identyfikator konta wydawcy Portfela Google. Identyfikator wydawcy znajdziesz w Konsoli usług Google Pay i Portfela Google.
Wydawca może reprezentować m.in. sprzedawców (np. restaurację), dostawcę oferty lub producenta terminala. Tworzone klasy i obiekty karty są powiązane z określonym identyfikatorem wydawcy. Identyfikator wydawcy jest zawarty zarówno w identyfikatorach klas karty, jak i identyfikatorach obiektów.
| Identyfikator | Format | Uwagi |
|---|---|---|
| Identyfikator kategorii | issuerId.classSuffix
|
classSuffix to unikalna, zdefiniowana przez dewelopera wartość określonej klasy karty (np.poziomu programu lojalnościowego). |
| Identyfikator obiektu | issuerId.objectSuffix
|
objectSuffix to unikalna, zdefiniowana przez programistę wartość konkretnego obiektu karty (np. identyfikatora użytkownika) |
Wystawca może utworzyć dowolną liczbę klas.
Identyfikator sprzedawcy
Jeśli sprzedawca obsługuje smart tap w swoich terminalach, wydawca elementów promocyjnych będzie miał identyfikator sprzedawcy. Identyfikator sprzedawcy to 8-cyfrowy identyfikator, za pomocą którego terminale się identyfikują. Wydawca elementów promocyjnych może obsługiwać wielu sprzedawców, więc identyfikator sprzedawcy jest używany do wysłania prośby o kartę konkretnego sprzedawcy.
Gdy użytkownik zbliży swoje urządzenie do terminala obsługującego smart tap, wyśle on identyfikator sprzedawcy na urządzenie użytkownika. Następnie urządzenie uwierzytelnia się w terminalu za pomocą klucza publicznego dla tego identyfikatora sprzedawcy. Więcej informacji znajdziesz w artykule Przepływ komunikacji.
Ważne informacje:
- Do identyfikatora wydawcy jest przypisany tylko jeden identyfikator sprzedawcy.
- Identyfikator sprzedawcy jest unikalny wśród wszystkich identyfikatorów wydawców.
Informacje o tym, jak uzyskać identyfikator sprzedawcy odpowiadający identyfikatorowi wydawcy, znajdziesz w sekcji Konfiguracja sprzedawcy.
Identyfikator klasy karty
Identyfikator klasy określa konkretny poziom lub typ karty. Identyfikator klasy ma taki format:
issuerId.classSuffix
Sufiks klasy jest zdefiniowaną przez dewelopera wartością unikalną dla tej klasy karty. Obiekt karty odwołujący się do tego identyfikatora klasy jest zapisywany w aplikacji Portfel Google użytkownika.