Rejestrowanie internetowej aplikacji płatniczej

Dowiedz się, jak skonfigurować internetową aplikację do płatności podczas rejestracji.

Eiji Kitamura

Internetowe aplikacje do płatności to progresywne aplikacje internetowe (PWA), które współpracują z skryptami service worker. Skrypt service worker w aplikacji płatniczej odgrywa ważną rolę, ponieważ rejestruje żądania płatności od sprzedawcy, uruchamia aplikację płatniczą i pośredniczy w komunikacji ze sprzedawcą.

Aby skonfigurować internetową aplikację do płatności, musisz zarejestrować dostępne metody płatności i usługę workera. Aplikację do płatności w przeglądarce możesz skonfigurować deklaratywnie za pomocą pliku manifestu aplikacji internetowej.

Obsługa przeglądarek

Płatności internetowe obejmują kilka różnych technologii, a stan obsługi zależy od przeglądarki.

Chromium Safari Firefox
Komputer Android Komputer Urządzenia mobilne Komputer/urządzenie mobilne
Interfejs Payment Request API ✔ ✔ ✔ ✔
Interfejs Payment Handler API ✔ ✔
Aplikacja płatnicza na iOS lub Androida ✔ ✔ ✔* ✔*

Konfigurowanie aplikacji płatniczej z plikiem manifestu aplikacji internetowej

Aby deklaratywnie skonfigurować internetową aplikację do płatności, wyślij plik manifestu aplikacji internetowej.

W przypadku aplikacji do płatności internetowych istotne są te właściwości w pliku manifestu aplikacji internetowej:

  • name
  • icons
  • serviceworker
    • src
    • scope
    • use_cache

Zapoznaj się z artykułem Konfigurowanie formy płatności, aby mieć pewność, że plik manifestu Twojej formy płatności prawidłowo wskazuje plik manifestu aplikacji internetowej.

Rejestrowanie skryptu service worker w czasie rzeczywistym (JIT)

Rejestracja JIT wymaga tylko wyświetlenia pliku manifestu aplikacji internetowej i nie wymaga dodatkowego kodowania. Jeśli masz już skonfigurowany plik manifestu aplikacji internetowej i prawidłowo go wyświetlasz, nie musisz nic więcej robić. Przeglądarka zajmuje się resztą.

Debugowanie internetowej aplikacji do płatności

Podczas tworzenia frontendu aplikacji do płatności internetowej będziesz prawdopodobnie przełączać się między kontekstem sprzedawcy a kontekstem aplikacji do płatności. Poniższe wskazówki na temat debugowania ułatwią Ci programowanie w Chrome.

Tworzenie na serwerze lokalnym

Którego serwera używasz do tworzenia aplikacji? Wielu programistów używa localhosta lub wewnętrznego środowiska serwera firmy, co może być trudne, ponieważ zaawansowane funkcje w przeglądarce wymagają zazwyczaj bezpiecznego środowiska (HTTPS) i ważnego certyfikatu. Interfejs Payment Request API i Payment Handler API nie stanowią wyjątków, a hosty lokalne lub serwery wewnętrzne zwykle nie mają prawidłowego certyfikatu.

Dobra wiadomość jest taka, że niektóre przeglądarki, w tym Chrome, domyślnie nie wymagają certyfikatów dla http://localhost. W Chrome możesz też wyłączyć wymóg certyfikatu, uruchamiając instancję Chrome. Aby na przykład wyłączyć wymaganie z zasad http://*.corp.company.com, użyj tych flag:

macOS

/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome --ignore-certificate-errors --unsafely-treat-insecure-origin-as-secure=http://*.corp.company.com

Windows

chrome.exe --ignore-certificate-errors --unsafely-treat-insecure-origin-as-secure=http://*.corp.company.com

Więcej informacji o uruchamianiu Chrome z flagą środowiska wykonawczego znajdziesz w artykule Uruchamianie Chromium z flagami.

Przekierowanie portów przez serwer lokalny

Możesz przekierować lokalny serwer WWW na urządzenie z Androidem za pomocą Narzędzi deweloperskich w Chrome i sprawdzić, jak działa w przeglądarce mobilnej. Aby dowiedzieć się, jak to zrobić, przeczytaj artykuł Dostęp do serwerów lokalnych.

Debugowanie zdalne witryny w Chrome na Androida w Narzędziach dla programistów na komputerze

Możesz też debugować Chrome w Androidzie za pomocą Narzędzi deweloperskich na komputerze. Aby dowiedzieć się, jak to zrobić, zapoznaj się z artykułem Pierwsze kroki ze zdalnym debugowaniem urządzeń z Androidem.

Rejestrowanie zdarzeń modułu do obsługi płatności

Narzędzia deweloperskie mogą wyświetlać zdarzenia interfejsu Payment Handler API, aby ułatwić lokalne programowanie. Otwórz Narzędzia deweloperskie w kontekście sprzedawcy i przejdź do sekcji „Moduł obsługi płatności” w panelu Aplikacja. Zaznacz pole „Pokaż zdarzenia z innych domen” i kliknij przycisk „Rejestruj”, aby zacząć rejestrować zdarzenia wysyłane do service workera, który obsługuje płatności.

Zrzut ekranu pokazujący rejestrowanie zdarzeń przez moduł obsługi płatności
Logowanie zdarzeń modułu obsługi płatności.

Dalsze kroki

W następnym kroku dowiesz się, jak usługa workera może zarządzać transakcją płatności w czasie wykonywania.