Konfigurowanie smart tap za pomocą interfejsu API

Na tej stronie opisaliśmy, jak skonfigurować smart tap za pomocą interfejsu API.

Tworzenie konta wydawcy elementów promocyjnych do obsługi smart tap

Aby utworzyć konto wydawcy elementów promocyjnych, wykonaj te czynności:

1. Utwórz konto wydawcy.
2. Przypisz co najmniej 1 klucz publiczny oraz co najmniej 1 wersję klucza.
3. Pobierz automatycznie utworzony identyfikator sprzedawcy.

Tworzenie konta wydawcy

Informacje o tym, jak utworzyć konta wydawców za pomocą interfejsu API, znajdziesz na stronie Automatyczne tworzenie kont wydawców.

Aby utworzyć konto wydawcy ręcznie, otwórz Business Console.

Przypisywanie co najmniej 1 klucza publicznego oraz co najmniej 1 wersji klucza

Klucz publiczny i jego wersja są dostarczane przez dostawcę terminala.

Ważne: jeśli dostawca terminala nie udostępnia klucza publicznego, dopóki nie podasz identyfikatora sprzedawcy, możesz użyć tego przykładowego klucza:

-----BEGIN PUBLIC KEY-----\nMFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEchyXj86
9zfmKhRi9xP7f2AK07kEo\n4lE7ZlWTN14jh4YBTny+hRGRXcUzevV9zSSPJlPHpqqu5pEwlv1xyFvE1w==
\n-----END PUBLIC KEY-----\n
    

Gdy ustawisz klucz publiczny po raz pierwszy, dla konta wydawcy elementów promocyjnych utworzony zostanie unikalny identyfikator sprzedawcy.

Pamiętaj, aby usunąć przykładowy klucz, gdy otrzymasz właściwy klucz od dostawcy terminala.

Aby przypisać klucze publiczne i wersje kluczy, wyślij wywołanie REST do poniższego punktu końcowego przy użyciu autoryzowanego klucza konta usługi:

PATCH https://walletobjects.googleapis.com/walletobjects/v1/issuer/<issuerid>

Ważne: smartTapMerchantData.authenticationKeys[].id musi być wartością dziesiętną. Wartość musi być z zakresu od 1 do 2 147 483 647 (włącznie). Każdy klucz publiczny musi mieć unikalną wersję klucza.

Uwaga: użyj autoryzowanego klucza konta usługi połączonego z kontem użytkownika, za pomocą którego utworzono to konto wydawcy.

W wywołaniu REST umieść kod:

{
  "smartTapMerchantData": {
    "authenticationKeys": [{
        "id": 1,
        "publicKeyPem": "<my_public_key>"
      },
      {
        "id": 2,
        "publicKeyPem": "..."
      }
    ]
  }
}

Odpowiedź zawiera wysłaną treść i dodatkowe pole smartTapMerchantData.smartTapMerchantId. Jest to identyfikator sprzedawcy konta wydawcy elementów promocyjnych. Podaj dostawcy terminala i sprzedawcy otrzymany identyfikator sprzedawcy oraz pozostałe informacje, aby sprzedawca mógł zacząć używać smart tap.

Więcej informacji o tym, jak używać punktu końcowego wydawcy, znajdziesz w dokumentacji API.

Pobieranie tworzonego automatycznie identyfikatora sprzedawcy

Identyfikator sprzedawcy można uzyskać też w inny sposób. Wyślij wywołanie REST do poniższego punktu końcowego przy użyciu autoryzowanego klucza konta usługi:

GET https://walletobjects.googleapis.com/walletobjects/v1/issuer/<issuerid>

Uwaga: użyj autoryzowanego klucza konta usługi połączonego z kontem użytkownika, za pomocą którego utworzono to konto wydawcy.

Odpowiedź zawiera pole smartTapMerchantData.smartTapMerchantId. Jest to identyfikator sprzedawcy konta wydawcy elementów promocyjnych. Podaj dostawcy terminala i sprzedawcy otrzymany identyfikator sprzedawcy oraz pozostałe informacje, aby sprzedawca mógł zacząć używać smart tap.

Więcej informacji o tym, jak używać punktu końcowego wydawcy, znajdziesz w dokumentacji API.

Wykorzystywanie kart za pomocą smart tap

Z tej sekcji dowiesz się, jak skonfigurować klasy i obiekty, aby wykorzystywać karty za pomocą smart tap.

Jeśli poniższe wartości i konto wydawcy elementów promocyjnych są skonfigurowane poprawnie, na karcie w Google Pay wyświetli się ikona NFC (Near Field Communication). Karty z ikoną NFC mogą być wykorzystywane tylko przez sprzedawców, którzy mają terminale obsługujące smart tap.

Konfiguracja klasy

Aby skonfigurować klasę do obsługi NFC przez jej obiekty, wykonaj żądanie poprawki i ustaw te wartości:

  class.enableSmartTap = true
  class.redemptionIssuers[] = ["issuer_id_1",... ,"issuer_id_n"]

Po ustawieniu powyższych właściwości klasy wszystkie jej obiekty będą obsługiwać NFC. Aby zobaczyć ikonę NFC, skonfiguruj obiekt smart tap i wydawców elementów promocyjnych. Informacje o tym, jak określić wydawców elementów promocyjnych, znajdziesz na stronie Określanie konta wydawcy elementów promocyjnych.

Ostrzeżenie: jeśli w interfejsie API REST używasz klasy update(), musisz najpierw wywołać metodę get(), a potem wykonać aktualizację. W przeciwnym razie te właściwości mogą zostać usunięte lub nieprawidłowo ustawione. Możesz też użyć polecenia patch().

Konfigurowanie obiektu

Aby skonfigurować obiekt do obsługi NFC, skonfiguruj klasę smart tap. Następnie ustaw w terminalu wartość przekazaną z karty:

  object.smartTapRedemptionValue = "string value to be conveyed over NFC"

Ta wartość jest przesyłana po naciśnięciu NFC. Więcej informacji znajdziesz na stronie Wartość przekazywana z karty.

Ostrzeżenie: jeśli w interfejsie API REST używasz klasy update(), musisz najpierw wywołać metodę get(), a potem wykonać aktualizację. W przeciwnym razie te właściwości mogą zostać usunięte lub nieprawidłowo ustawione. Możesz też użyć polecenia patch().