Apple Pay on-site

Wprowadzenie

Apple Pay “on-site” jest to integracja płatności Apple Pay bezpośrednio na stronie Merchanta. Polega ona na umieszczeniu przycisku do płatności Apple Pay w sposób umożliwiający klientom płatność bezpośrednio z poziomu strony.

Implementacja

W celu wdrożenia płatności przy pomocy Apple Pay  na swojej stronie, należy wgrać na serwer plik, który będzie dostępny z poziomu domeny. Plik ten służy do weryfikacji domeny podczas jej rejestracji. Apple, w celu weryfikacji, odpytuje zarejestrowaną domenę, jak na przykładzie poniżej.

https://{DOMAIN_NAME}/.well-known/apple-developer-merchantid-domain-association

https://secure.tpay.com/.well-known/apple-developer-merchantid-domain-association

Kolejnym krokiem w implementacji jest konfiguracja wcześniej wspomnianej domeny. W tym celu należy zalogować się do panelu akceptanta (Panel Akceptanta | Tpay ) i wejść w zakładkę Integracji, a następnie wybrać z listy Apple Pay.

 

Następnie należy kliknąć przycisk edycji oraz ikonę plusa znajdującą się po lewej stronie “Domains”. Należy wprowadzić adres url domeny, na której ma znaleźć się przycisk i zapisać ustawienia. Merchant może dodać więcej niż jedną domenę. W celu zdefiniowania kolejnych należy ponownie użyć ikony plusa.

Uwaga!!!

W przypadku, gdy dodawana domena nie istnieje na liście domen dodanych podczas rejestracji konta merchanta prosimy o ich uprzednią rejestrację w zakładce Twoje konto --> Twoje dane --> Punkt Sprzedaż.

Po zakończeniu konfiguracji domen w panelu akceptanta można dodać przycisk na stronę. W celu wygenerowania przycisku zaleca się wykorzystanie strony demo apple. Można znaleźć ją tutaj. W parametrze merchantIdentifier należy przekazać identyfikator Tpay merchanta w formie numerycznej, np. 1010.

Po wygenerowaniu kodu należy umieścić go w kodzie źródłowym strony w miejscu,  gdzie ma być  dokonywana płatność.. W tym samym miejscu należy również zaimplementować skrypt wykorzystywany do obsługi przycisku.

<script src="https://applepay.cdn-apple.com/jsapi/v1/apple-pay-sdk.js"></script>

Przy uruchomieniu kodu należy dokonać sprawdzenie, czy urządzenie wspiera płatności Apple Pay. W tym celu sprawdza się, czy istnieje obiekt ApplePaySession w przeglądarce oraz czy użytkownik ma podpiętą aktywną kartę w aplikacji Wallet

Po pomyślnej weryfikacji należy utworzyć nową sesję, w której zdefiniowane zostaną wszystkie dane dotyczące płatności. Więcej informacji o danych płatności znajdziesz tutaj.

Po utworzeniu sesji należy obsłużyć event sprawdzający domenę merchanta. W tym celu należy wysłać żądanie do własnego środowiska back-end, które odpyta API Tpay na endpoint POST/wallet/applepay/init oraz zwróci odpowiedź do aplikacji frontowej.

W kolejnym kroku należy zdefiniować obsługę eventu dotyczącego finalizacji transakcji. W tym evencie należy wysłać żądanie do własnego środowiska back-end , które odpyta Tpay API na endpoint POST/transactions oraz zwraca rezultat do aplikacji frontentowej.

Dodatkowo obsłużyć można również event dotyczący anulowania płatności. Jest to element opcjonalny.

Po więcej informacji dotyczących implementacji przycisku płatności Apple Pay odsyłamy do oficjalnej dokumentacji znajdującej się tutaj.

Zalecenia

Ze względów bezpieczeństwa, wszystkie requesty wysyłane do API Tpay powinny być wysyłane za pośrednictwem własnego środowiska back-end. Wynika to z faktu, iż każde z zapytań wymaga przekazania poświadczeń, które nie powinny być ujawniane płatnikom. W przykładzie zostało to zaimplementowane jedynie w celu ułatwienia w zrozumieniu logiki.

Was this answer helpful?
 0
 0