top of page

Co zyskują deweloperzy na wdrożeniu Web Push Provisioning

Writer: Michał Stachera
Michał Stachera
Jan 30
4 min read

Zanim karta trafi do portfela cyfrowego, przechodzi transformację zwaną tokenizacją. W swojej istocie tokenizacja to proces zastępowania wrażliwych danych — takich jak 16-cyfrowy numer karty (PAN) — unikalnym, bezpiecznym identyfikatorem zwanym tokenem.


W świecie płatności token ten pełni rolę cyfrowego zastępcy. Pozwala on na przetworzenie transakcji bez ujawniania rzeczywistych danych karty sprzedawcy ani przesyłania ich "w eterze". Nawet jeśli token zostanie przechwycony, jest on bezużyteczny dla hakerów, ponieważ jest matematycznie powiązany z konkretnym urządzeniem (np. iPhone'em) lub konkretnym sprzedawcą.


Ten fundament bezpieczeństwa jest tym, co umożliwia nowoczesne płatności mobilne i stanowi "sekretny składnik" najnowszej zmiany w branży fintech: Web Push Provisioning.


Webpush provisioning - co to oznacza dla deweloperów

Dlaczego Web Push Provisioning ma znaczenie?


Przez lata deweloper, który chciał pomóc użytkownikowi bezpiecznie dodać ztokenizowaną kartę do portfela cyfrowego, musiał budować natywną aplikację mobilną. Proces ten znany był jako In-App Provisioning.


Web Push Provisioning (WPP) przełamuje tę barierę. Pozwala deweloperom zainicjować proces "Dodaj do Portfela" (Add to Wallet) bezpośrednio z poziomu przeglądarki internetowej (Safari lub Chrome). Wykorzystując te same standardy tokenizacji EMV, co aplikacje natywne, WPP umożliwia bezpieczny, szyfrowany "uścisk dłoni" (handshake) między stroną WWW a mobilnym systemem operacyjnym, całkowicie pomijając konieczność pobierania aplikacji z App Store czy Google Play.

Dodanie karty do Apple Wallet

Wdrożenie: Minimum wysiłku, maksimum efektu


Jednym z najbardziej atrakcyjnych aspektów WPP jest fakt, że implementacja stanowi stosunkowo niewielki wysiłek technologiczny (tzw. light lift). Obejmuje ona integrację z istniejącymi interfejsami API oraz portfelami Apple i Google bez nakładów pracy związanych z natywnym developmentem mobilnym.


Na wysokim poziomie integracja ta wymaga dwóch głównych komponentów:

  • Front-End: Dodanie specyficznej biblioteki JavaScript do strony WWW w celu obsługi interfejsu użytkownika i wywołania zdarzenia w systemie mobilnym.

  • Back-End: Integracja z API wydawcy karty w celu dostarczenia niezbędnych parametrów (zaszyfrowanego pakietu tokena — encrypted token bundle) do dostawcy portfela.


Dzięki wykorzystaniu standardowych protokołów webowych, deweloperzy mogą uniknąć "podatku App Store" w postaci czasu i zasobów, często przechodząc z piaskownicy (sandbox) do produkcji w ułamku czasu wymaganego dla aplikacji natywnych.


Jak działa Web Push Provisioning?


Od strony technicznej Web Push Provisioning działa jako bezpieczny most między siecią web a wysoce bezpiecznym środowiskiem mobilnego systemu operacyjnego.


Gdy użytkownik inicjuje proces, klikając przycisk "Dodaj do Portfela", frontend wysyła żądanie do backendu o pobranie unikalnego, zaszyfrowanego pakietu aprowizacyjnego od wydawcy karty. Pakiet ten — zawierający ztokenizowane dane karty — jest następnie przekazywany do specyficznej dla platformy biblioteki JavaScript (np. ApplePayJS). Przeglądarka przekazuje proces do natywnego systemu operacyjnego urządzenia, który wyświetla bezpieczną nakładkę (overlay) w celu potwierdzenia dodania karty za pomocą biometrii.


To płynne przejście gwarantuje, że wrażliwe informacje o karcie nigdy nie są wystawione na działanie przeglądarki ani serwerów sprzedawcy, zachowując najwyższe standardy bezpieczeństwa przy jednoczesnym zapewnieniu bezproblemowego UX.


Sekwencja Web Push Provisioning
Sekwencja Web Push Provisioning

Zalety dla deweloperów fintech


  1. Eliminacja "App Fatigue": Użytkownicy coraz niechętniej pobierają nowe aplikacje do pojedynczych zadań. WPP pozwala zaoferować doświadczenie typu "Top of Wallet" natychmiast po zakończeniu wnioskowania o kartę lub otrzymaniu karty wirtualnej — prosto z przeglądarki.

  2. Niższe koszty utrzymania i spójny kod: Zamiast utrzymywać oddzielne biblioteki w Swift (iOS) i Kotlin (Android), deweloperzy mogą zarządzać pojedynczą integracją webową. Redukuje to dług techniczny i zapewnia spójne doświadczenie na różnych urządzeniach.

  3. Błyskawiczne przychody: W fintechu "Time to First Spend" (czas do pierwszego wydatku) to kluczowa metryka. Umożliwiając aprowizację karty zaraz po jej zatwierdzeniu przez stronę WWW, usuwasz bariery instalacji aplikacji, co przekłada się na wyższe współczynniki aktywacji i szybszy wzrost wolumenu transakcji.


Porównanie metod aprowizacji / konfiguaracji Apple Wallet & Google Wallet

Funkcja

Wpis ręczny

In-App Provisioning

Web Push Provisioning

Bezpieczeństwo

Niskie (ekspozycja danych kartowych)

Wysokie (tokenizacja)

Wysokie (tokenizacja)

Stopień utrudnień UX

Wysoki (wpisywanie)

Średni (pobranie apki)

Niski (jedno kliknięcie)

Złożoność Dev

Niska

Wysoka (Natywne SDK)

Średnia (Web + API)

Zastosowanie

Systemy starszego typu

Aplikacje mobilne

Natychmiastowe dodanie karty: web-first

Kwestie kluczowe


Choć wdrożenie jest "lekkie", deweloperzy muszą przejść przez kilka procedur kontrolnych:


  • Weryfikacja domeny: Musisz udowodnić prawo własności do domeny przed Apple i Google poprzez hostowanie plików konfiguracyjnych (np. w katalogach .well-known).

  • Ścisła zgodność UI: Obaj dostawcy portfeli mają rygorystyczne wymagania brandingowe dotyczące przycisków "Dodaj do Portfela"; muszą być one przestrzegane co do joty, aby przejść proces weryfikacji.

  • Bezpieczny Backend: Twój serwer musi być w stanie obsłużyć szyfrowanie PGP wymagane do "opakowania" ztokenizowanych danych przed ich wysłaniem do przeglądarki.


Aby przenieść integrację WPP z piaskownicy na produkcję, musisz spełnić wymogi zaufania Apple i Google. Ponieważ prosisz system operacyjny o obsługę danych finansowych w imieniu Twojej strony WWW, weryfikacja domeny jest kluczowa.


Checklista deweloperska dla weryfikacji domeny:


1. Wymagania SSL/TLS

  • [ ] HTTPS wszędzie: Strona musi być serwowana przez bezpieczne połączenie. Certyfikaty self-signed nie zadziałają.

  • [ ] TLS 1.2 lub wyższy: Serwer musi wspierać nowoczesne protokoły bezpieczeństwa.

2. Weryfikacja domeny Apple (Apple Pay JS)

  • [ ] Rejestracja domeny: Zarejestruj domenę i subdomeny w  Apple Developer Account.

  • [ ] Ścieżka .well-known: Utwórz katalog .well-known w katalogu głównym (web root) serwera.

  • [ ] Plik asocjacji: Pobierz plik apple-developer-merchantid-domain-association i umieść go pod adresem: https://twojadomena.pl/.well-known/apple-developer-merchantid-domain-association.

  • [ ] Dostępność: Upewnij się, że plik jest publicznie dostępny (brak firewalli czy splash screenów).

3. Konfiguracja Google Pay Merchant Center

  • [ ] Profil biznesowy: Zarejestruj firmę w Google Pay Business Console.

  • [ ] Whitelisting URL: Dodaj pełne nazwy domen (FQDN) do listy "Allowed Domains".

  • [ ] Walidacja Origin: Upewnij się, że serwer wysyła poprawne nagłówki Allow-Origin przy zapytaniach cross-origin.

4. Zgodność z marką (Brand & UI)

  • [ ] Zasoby przycisków: Nie hostuj własnych grafik. Użyj oficjalnych zasobów CSS/SVG od Apple i Google.

  • [ ] Logika widoczności: Przycisk Apple powinien pojawiać się tylko w Safari/iOS, a przycisk Google w Chrome/Android.

5. Gotowość backendu

  • [ ] Merchant Identity Certificate: W przypadku Apple upewnij się, że backend używa certyfikatu tożsamości sprzedawcy (.pem lub .p12) do podpisywania żądań sesji.

  • [ ] CORS Policy: Zweryfikuj, czy Twoje API dopuszcza zapytania z konkretnej domeny webowej.

Pro-Tip: Pułapka przekierowań! Uważaj na przekierowania: Jeśli adres URL w katalogu .well-known przekierowuje (np. z http na https lub dodając przedrostek www), niektóre boty weryfikacyjne mogą zgłosić błąd. Najlepiej upewnić się, że plik zwraca status 200 OK bezpośrednio pod żądanym adresem URL.

Podsumowanie


Dystans między "wydaniem karty" a "pierwszą transakcją" to ostateczna miara sukcesu. Przez lata deweloperzy byli zmuszeni wybierać między uciążliwym dla użytkownika ręcznym wpisywaniem danych a wysokimi kosztami budowy aplikacji natywnych. Web Push Provisioning (WPP) stał się pomostem, który pozwala deweloperom wdrażać bezpieczne rozwiązania "top-of-wallet" bezpośrednio z poziomu przeglądarki. Łącząc żelazne bezpieczeństwo tokenizacji z uniwersalnym zasięgiem sieci Web, programiści mogą teraz przekazywać karty do rąk (i portfeli) użytkowników szybciej niż kiedykolwiek wcześniej.




 
 

Find out how we can help your business!

SPARADOS - THE OPTIMAL SOLUTION

Sparados S.A.

Sparados SA with headquarters in Lublin, at 17A Rusałka St., 20-103 Lublin, entered into the register of entrepreneurs of the National Court Register with the KRS No. (National Court Register No.): 0000985680, NIP (Tax ID No./VAT Reference No.): 9462719635 and REGON (Business ID No.): 522752701, with a fully paid share capital of PLN 336 704.

 

Data Protection Officer: Weronika Dawidzka

Email: [email protected]

​

Contact: +48 781 761 200

  • Instagram
  • Facebook
  • LinkedIn
  • YouTube

Sparados App

Download on the Apple Store
Download on the Apple Store
Get it on Google Play
Get it on Google Play

© 2026 Sparados. All rights reserved.

European Funds for Smart Growth
NCBR – National Centre for Research and Development
European Union – European Regional Development Fund

Designed by

Sparados S.A. (Tax Identification Number/NIP: 9462719635), with its registered office in Lublin at ul. Rusałka 17A, 20-103 Lublin, is neither a payment service provider nor a payment institution within the meaning of the Act of 19 August 2011 on Payment Services. The Company does not hold an authorization from the Polish Financial Supervision Authority (KNF) to provide payment services, does not hold user funds, and provides solely a technological platform for expense management and integration with third-party payment service providers.

Payment services, including the maintenance of accounts, issuance of payment cards, and execution of transactions, are provided by appropriately licensed payment service providers operating within Europe, in accordance with applicable laws and under the supervision of relevant regulatory authorities.

The use of payment functionalities is subject to the acceptance of the terms and conditions of the respective payment service provider. The agreement for the provision of payment services is concluded directly between the user and said provider.

Sparados S.A. shall not be held liable for the execution of payment transactions or for their settlement between the user and the payment service provider. The Company acts exclusively as a technology solution provider enabling access to these services.

bottom of page