Apple Web Push Provisioning. Co dalej po zakończeniu integracji?
Integracja Apple Web Push Provisioning jest gotowa, testy zakończyły się sukcesem, a rozwiązanie przeszło certyfikację w laboratorium takim jak Fime. Mogłoby się wydawać, że najtrudniejsza część projektu jest już za nami. W praktyce pozostaje jeszcze jeden ważny etap: przygotowanie wyglądu karty prezentowanego użytkownikowi podczas dodawania jej do Apple Wallet.
W przypadku klasycznego Push Provisioning przyzwyczailiśmy się, że konfigurację produktu oraz grafikę karty możemy dodać w Mastercard Digital Enablement Service lub Visa Token Service. Naturalne jest więc założenie, że grafika znajdująca się w MDES albo VTS zostanie wykorzystana również podczas Web Push Provisioning. Niestety proces Apple działa inaczej.
Osobna konfiguracja grafiki po stronie Apple
Podczas Web Push Provisioning Apple wymaga przekazania identyfikatora szablonu karty zarejestrowanego w swoim środowisku. W dokumentacji PassKit parametr ten występuje jako cardTemplateIdentifier. Nie jest to identyfikator grafiki z MDES ani VTS. Apple oczekuje identyfikatora utworzonego w swoim portalu, dlatego nawet karta posiadająca zatwierdzony wygląd w systemie organizacji płatniczej wymaga dodatkowej konfiguracji.
Proces rozpoczyna się od utworzenia Card Art w portalu rejestracji Apple. Dodajemy tam grafikę karty, tło, logo organizacji płatniczej, logo partnera lub marki, kolory oraz ikonę. Następnie tworzymy Card Template, któremu Apple nadaje unikalny identyfikator UUID. Identyfikator trzeba zapisać, powiązać z właściwym produktem kartowym i przekazywać podczas inicjowania Web Push Provisioning.
Apple nie udostępnia API do konfiguracji Card Art i Card Template. Dla jednego visuala nie stanowi to dużego problemu i zajmuje tylko kilka dodatkowych minut. Sytuacja komplikuje się przy obsłudze wielu klientów, walut i wariantów graficznych. Każdy kolejny szablon oznacza przygotowanie materiałów, utworzenie konfiguracji, zapisanie UUID, przypisanie go do produktu oraz przeprowadzenie testów.
Dlaczego grafika z MDES lub VTS nie wystarcza?
Apple potrzebuje grafiki, zanim zakończy się właściwa tokenizacja. Użytkownik powinien zobaczyć kartę już w momencie rozpoczynania Web Push Provisioning, dlatego Apple korzysta wtedy z własnego Card Template. Grafika skonfigurowana w MDES lub VTS pojawia się później. Po zatwierdzeniu tokenizacji token service provider przekazuje do Apple Wallet token, dane produktu oraz docelowy wygląd karty.
W praktyce występują więc dwie warstwy wizualne. Pierwsza jest używana podczas dodawania karty i pochodzi z konfiguracji Apple. Druga pojawia się po zakończeniu tokenizacji i może zostać dostarczona przez MDES albo VTS. Jeżeli konfiguracje nie są spójne, użytkownik może zobaczyć inną kartę w czasie dodawania, a inną już po zapisaniu jej w Apple Wallet.
Jeżeli na początkowym etapie nie zależy nam na prezentowaniu dokładnego wariantu karty, możemy wykorzystać ogólną, zatwierdzoną grafikę. Po zakończeniu tokenizacji Apple Wallet może pobrać docelowy wygląd z MDES lub VTS. Takie podejście upraszcza konfigurację, ale wymaga wcześniejszego sprawdzenia, czy docelowa grafika została prawidłowo skonfigurowana u token service providera. Jeżeli jej tam nie ma, karta może pozostać z wyglądem wykorzystanym podczas Web Push Provisioning.
Apple Pay i Google Pay w jednym programie
Jeżeli karta ma być dodawana zarówno do Apple Pay, jak i Google Pay, konfigurację trzeba przygotować w kilku środowiskach. Dla kart Mastercard będzie to MDES, a dla kart Visa VTS. Apple Web Push Provisioning wymaga dodatkowo utworzenia Card Art i Card Template po stronie Apple. Jeden produkt może więc posiadać osobne identyfikatory i grafiki w systemie organizacji płatniczej oraz w portalu Apple.
Najlepiej przygotować jeden zatwierdzony zestaw materiałów źródłowych, a następnie tworzyć na jego podstawie wersje dla poszczególnych systemów. Przy wielu programach warto również prowadzić rejestr zawierający nazwę klienta, produkt, BIN, organizację płatniczą, identyfikator w MDES lub VTS, Apple Card Template ID, wersję grafiki i status wdrożenia. Pozwala to uniknąć błędnego przypisania UUID oraz sytuacji, w której aktualizacja została wykonana tylko w jednym środowisku.
Apple Web Push Provisioning: Podsumowanie
Apple Web Push Provisioning umożliwia dodanie karty do Apple Wallet bez instalowania aplikacji i bez ręcznego wpisywania jej danych. Z perspektywy użytkownika proces jest szybki, ale po stronie wydawcy wymaga dodatkowej konfiguracji. Po zakończeniu integracji i certyfikacji należy utworzyć Card Art oraz Card Template w portalu Apple. Wygenerowany UUID trzeba następnie przypisać do produktu i przekazywać podczas Web Push Provisioning. Równolegle należy zadbać o docelowy wygląd tokenizowanej karty w MDES lub VTS.
W Sparados przeszliśmy ten proces w praktyce. Wspieramy firmy w integracji Apple Web Push Provisioning, tokenizacji kart oraz uruchamianiu programów obsługujących Apple Pay i Google Pay. Jeżeli planujesz podobne wdrożenie, możemy pomóc zarówno w części technicznej, jak i w przygotowaniu całego procesu operacyjnego.
Najczęściej zadawane pytania
Czy grafika z MDES wystarczy do Apple Web Push Provisioning?
Nie. Apple korzysta z własnego Card Template podczas rozpoczynania procesu. Docelowa grafika może zostać dostarczona przez MDES dopiero podczas tokenizacji.
Co oznacza Card Template ID?
Jest to unikalny identyfikator szablonu utworzonego w portalu Apple. W dokumentacji PassKit występuje jako cardTemplateIdentifier.
Czy można samodzielnie nadać ten identyfikator?
Nie. Identyfikator jest generowany przez Apple.
Czy użytkownik musi instalować aplikację?
Nie. Web Push Provisioning pozwala rozpocząć dodawanie karty bezpośrednio ze strony internetowej.
Czy proces jest taki sam dla Mastercard i Visa?
Ogólna ścieżka jest podobna, ale Mastercard korzysta z MDES, natomiast Visa z VTS.
Źródła: