Przejdź do głównej zawartości

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ż na localhost.
  • 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łędem MERCHANT_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.payment w 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