Przyjmij płatność Apple Pay
Na tej stronie dodasz do checkoutu przycisk Apple Pay i przygotujesz domenę do weryfikacji u Apple.
Wymagania
- HTTPS. Apple Pay nigdy nie działa po
http://, również nalocalhost. - Weryfikacja domeny. Każda domena (i subdomena), która pokazuje przycisk Apple Pay, musi być
zarejestrowana u Apple pod merchant ID Paymentic. Rejestrację wykonuje Paymentic. Ty hostujesz
plik weryfikacyjny, który otrzymasz od Paymentic, pod adresem
https://twojadomena.pl/.well-known/apple-developer-merchantid-domain-association(serwowany bez zmian, HTTP 200, bez przekierowań). Do czasu zakończenia weryfikacji przycisk może się renderować, ale arkusz kończy się błędemMERCHANT_VALIDATION_FAILED. - Przeglądarki. Safari na urządzeniach Apple natywnie. Chrome, Edge i Firefox przez międzyprzeglądarkowy przepływ Apple (kod QR lub przekazanie na urządzenie Apple) na iOS 18 / macOS Sequoia lub nowszych.
- Wczytane SDK z sekcją
wallet.paymentw konfiguracji: Instalacja i inicjalizacja.
Przycisk natywny (zalecane)
<div id="apple-pay" hidden></div>
const { available } = await paymentic.mountApplePay('#apple-pay');
document.getElementById('apple-pay').hidden = !available;
W odróżnieniu od Google Pay przycisk Apple Pay działa na Twojej stronie, a nie w ramce Paymentic. Apple weryfikuje domenę strony najwyższego poziomu, więc hostowanie przycisku gdzie indziej nie zwolniłoby Cię z weryfikacji domeny.
Własny przycisk
Apple wymaga, żeby arkusz płatności otworzył się w ramach gestu kliknięcia. Wywołaj
isApplePayAvailable() wcześnie (przy wczytaniu strony): poza odpowiedzią wstępnie pobiera
wszystko, czego potrzebuje arkusz, więc handler kliknięcia nie wykonuje żadnego zapytania sieciowego.
const { available } = await paymentic.isApplePayAvailable();
myAppleButton.hidden = !available;
myAppleButton.onclick = () => paymentic.requestApplePay();
Kwotę przy pojedynczym wywołaniu nadpisujesz dokładnie tak samo jak w Google Pay. Do własnych przycisków stosują się wytyczne Apple Human Interface Guidelines.
Co dalej
- Obsłuż wynik i dostępność portfeli: zdarzenia
complete,error,canceli powody niedostępności. - Testowanie w sandboxie: konto testera Apple i karty testowe.