Rejestrowanie internetowej aplikacji płatniczej

Dowiedz się, jak skonfigurować internetową aplikację płatniczą podczas rejestracji.

Eiji Kitamura

Aplikacje do płatności internetowych to progresywne aplikacje internetowe (PWA), które działają w skryptach service worker. Skrypt service worker w aplikacji płatniczej odgrywa ważną rolę, ponieważ rejestruje prośby o płatności od sprzedawcy, uruchamia aplikację płatniczą i pośredniczy w komunikacji ze sprzedawcą.

Aby skonfigurować internetową aplikację płatniczą, musisz zarejestrować dostępne formy płatności i skrypt service worker. Internetową aplikację płatniczą możesz skonfigurować deklaratywnie za pomocą internetowego pliku manifestu.

Obsługiwane przeglądarki

Płatności internetowe składają się z kilku różnych elementów, a stan obsługi może zależeć od przeglądarki.

Chromium Safari Firefox
Komputer Android Komputer Urządzenia mobilne Komputer/Urządzenie mobilne
Payment Request API ✔ ✔ ✔ ✔
Interfejs API do obsługi płatności ✔ ✔
Aplikacja płatnicza na iOS/Androida ✔ ✔ ✔* ✔*

Konfigurowanie aplikacji płatniczej za pomocą pliku manifestu aplikacji internetowej

Aby skonfigurować deklaratywnie internetową aplikację do płatności, prześlij manifest aplikacji internetowej.

Te właściwości w manifeście aplikacji internetowej dotyczą aplikacji do płatności internetowych:

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

Zapoznaj się z informacjami na temat konfigurowania formy płatności, aby upewnić się, że plik manifestu formy płatności prawidłowo wskazuje na plik manifestu aplikacji internetowej.

Rejestrowanie skryptu service worker „just-in-time” (JIT)

Rejestracja przez JIT wymaga udostępniania tylko manifestu aplikacji internetowej bez dodatkowego kodowania. Jeśli masz już skonfigurowany plik manifestu aplikacji internetowej i jest on wyświetlany prawidłowo, nie musisz nic więcej robić. Przeglądarka zajmuje się resztą.

Debugowanie internetowej aplikacji płatniczej

Tworząc frontend aplikacji do płatności internetowych, prawdopodobnie będziesz przechodzić między kontekstem sprzedawcy a kontekstem aplikacji do płatności. Poniższe wskazówki na temat debugowania pomogą Ci w programowaniu w Chrome.

Programowanie na serwerze lokalnym

Jakiego serwera używasz do programowania? Wielu programistów używa lokalnego hosta lub wewnętrznego serwera firmowego, co może być wyzwaniem, ponieważ zaawansowane funkcje przeglądarki wymagają zwykle bezpiecznego środowiska (HTTPS) i ważnego certyfikatu. Payment Request API i Payment Handler API nie stanowią wyjątku, a hosty lokalne i serwery wewnętrzne zwykle nie mają prawidłowego certyfikatu.

Dobra wiadomość jest taka, że niektóre przeglądarki, w tym Chrome, domyślnie wykluczają certyfikaty dla funkcji http://localhost. W Chrome możesz też zrezygnować z wymagania certyfikatu, uruchamiając wystąpienie Chrome. Aby na przykład wykluczyć wymóg z 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 do serwera lokalnego

Możesz przenieść lokalny serwer WWW na urządzenie z Androidem, korzystając z Narzędzi deweloperskich w Chrome, i sprawdzić, jak działa on w przeglądarce mobilnej. Aby dowiedzieć się, jak to zrobić, przeczytaj artykuł o dostępie do serwerów lokalnych.

Zdalne debugowanie witryny w Chrome na Androida z Narzędzi deweloperskich na komputerze

Chrome możesz też debugować w Narzędziach deweloperskich na komputerze. Aby dowiedzieć się, jak to zrobić, przeczytaj artykuł Pierwsze kroki ze zdalnym debugowaniem urządzeń z Androidem.

Logowanie zdarzeń modułu 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ł do obsługi płatności” w panelu Aplikacja. Zaznacz „Pokaż zdarzenia z innych domen” i kliknij przycisk „Rejestruj”, aby rozpocząć rejestrowanie zdarzeń wysyłanych do skryptu service worker, który obsługuje płatności.

Zrzut ekranu z logowaniem zdarzeń modułu do obsługi płatności.
Logowanie zdarzeń modułu obsługi płatności

Dalsze kroki

W następnym kroku dowiesz się, jak skrypt service worker może administrować transakcją płatniczą w czasie działania.