Rejestrowanie internetowej aplikacji płatniczej

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

Eiji Kitamura

Aplikacje do płatności internetowych to progresywne aplikacje internetowe (PWA), które działają na wierzchu usług typu service worker. Usługa w aplikacji do płatności odgrywa ważną rolę, ponieważ rejestruje prośby o płatność od sprzedawcy, uruchamia aplikację do płatności 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 internecie możesz skonfigurować deklaratywnie za pomocą pliku manifestu aplikacji internetowej.

Obsługa przeglądarek

Płatności internetowe składają się z kilku 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 API modułu do obsługi płatności ✔ ✔
Aplikacja płatnicza na iOS lub Androida ✔ ✔ ✔* ✔*

Konfigurowanie aplikacji do płatności za pomocą pliku 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 upewnić się, że plik manifestu formy płatności odwołuje się prawidłowo do pliku 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 zajmie 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. Te wskazówki dotyczące debugowania ułatwią Ci tworzenie aplikacji 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. Interfejsy API Request i Payment Handler nie są wyjątkiem, a serwery localhost lub serwery wewnętrzne firmy 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 wykluczyć wymagania dotyczące 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ą czasu wykonywania znajdziesz w artykule Uruchamianie Chromium z flagami.

Przekierowywanie portów na serwerze lokalnym

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

Debugowanie Chrome na Androida możesz też przeprowadzić w DevTools na komputerze. Aby dowiedzieć się, jak to zrobić, zapoznaj się z artykułem Rozpoczynanie zdalnego debugowania 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ć rozwój lokalny. Otwórz DevTools w kontekście sprzedawcy i otwórz sekcję „Payment Handler” (Moduł obsługi płatności) na panelu Application (Aplikacja). Zaznacz „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
Rejestrowanie 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.