Rejestrowanie internetowej aplikacji płatniczej

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

Eiji Kitamura

Aplikacje płatnicze działające w internecie to progresywne aplikacje internetowe (PWA), które działają na service workerach. Element service worker w aplikacji do płatności odgrywa ważną rolę, ponieważ przechwytuje żądania płatności od sprzedawcy, uruchamia aplikację do płatności i pośredniczy w komunikacji ze sprzedawcą.

Aby skonfigurować aplikację płatniczą opartą na internecie, musisz zarejestrować dostępne formy płatności i instancję roboczą usługi. Aplikację płatniczą opartą na internecie możesz skonfigurować deklaratywnie za pomocą manifestu aplikacji internetowej.

Obsługa przeglądarek

Web Payments to kilka różnych technologii, a ich obsługa zależy od przeglądarki.

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

Konfigurowanie aplikacji do płatności za pomocą pliku manifestu aplikacji internetowej

Aby deklaratywnie skonfigurować aplikację do płatności w internecie, udostępnij manifest aplikacji internetowej.

W przypadku aplikacji płatniczych opartych na internecie 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 prawidłowo wskazuje plik manifestu aplikacji internetowej.

Rejestrowanie skryptu service worker w odpowiednim momencie

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

Debugowanie aplikacji płatniczej opartej na internecie

Podczas tworzenia frontendu aplikacji płatniczej opartej na internecie prawdopodobnie będziesz przełączać się między kontekstem sprzedawcy a kontekstem aplikacji płatniczej. Poniższe wskazówki dotyczące debugowania pomogą Ci w tworzeniu aplikacji w Chrome.

Opracowywanie na serwerze lokalnym

Jakiego serwera używasz do programowania? Wielu programistów używa środowiska localhost lub wewnętrznego serwera firmowego, co może być problematyczne, ponieważ zaawansowane funkcje w przeglądarce wymagają bezpiecznego środowiska (HTTPS) i ważnego certyfikatu. Interfejs Payment Request API i Web-based Payment Handler API nie są tu wyjątkiem, a serwery lokalne lub wewnętrzne firmy zwykle nie mają ważnego certyfikatu.

Dobra wiadomość jest taka, że niektóre przeglądarki, w tym Chrome, domyślnie wyłączają certyfikaty dla http://localhost. W Chrome możesz też zwolnić z wymogu certyfikatu, uruchamiając instancję Chrome. Aby na przykład wyłączyć wymaganie 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.

Przekierowywanie portów serwera lokalnego

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

Zdalne debugowanie witryny w Chrome na Androidzie za pomocą Narzędzi dla programistów na komputerze

Możesz też debugować Chrome na Androidzie w Narzędziach deweloperskich 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 Web-based Payment Handler API, co ułatwia lokalne programowanie. Otwórz Narzędzia deweloperskie w kontekście sprzedawcy i przejdź do sekcji „Payment Handler” w panelu Application (Aplikacja). Zaznacz „Pokaż zdarzenia z innych domen” i kliknij przycisk „Nagrywaj”, aby rozpocząć rejestrowanie zdarzeń wysyłanych do procesu roboczego usługi, który obsługuje płatności.

Zrzut ekranu przedstawiający rejestrowanie zdarzeń modułu obsługi płatności w internecie.
Rejestrowanie zdarzeń w obsłudze płatności internetowych.

Dalsze kroki

W następnym kroku dowiesz się, jak usługa Service Worker może koordynować transakcję płatniczą w czasie działania.