Aktywacja Apple Pay

W modalu strona płatności paymove działa w iframie osadzonym na Twojej stronie. Apple pozwala uruchomić arkusz Apple Pay tylko na domenie, która jest u niego zarejestrowana i zweryfikowana. Domyślnie zarejestrowane są wyłącznie domeny paymove, dlatego Apple Pay w widgecie wymaga jednorazowego onboardingu Twojej domeny. BLIK i Google Pay działają w widgecie od razu - ta strona dotyczy wyłącznie Apple Pay.

Podaj domenę w produkcie

Ustaw metadata.merchantDomain produktu, który osadzasz w widgecie.

Napisz do nas

Wyślij domenę na integration@paymove.io. Zarejestrujemy ją w Apple i odeślemy Ci plik weryfikacyjny.

Opublikuj plik weryfikacyjny

Wystaw plik pod stałym adresem na swojej domenie.

Poczekaj na potwierdzenie

Gdy Apple zweryfikuje domenę, potwierdzimy Ci rejestrację - od tej chwili Apple Pay działa w modalu.

1. `merchantDomain` w produkcie

merchantDomain to domena strony, na której wklejasz skrypt widgetu - ta, którą klient widzi w pasku adresu. Nie domena paymove z adresu skryptu. Najwygodniej podać ją od razu przy tworzeniu produktu:

POST /api/product/pay

{
  "partnerId": "78562c79-2f5c-4415-8af4-c871eea92ef2",
  "productType": "PAY",
  "name": "Fundacja Przykład",
  "location": "Warszawa",
  "timezone": "Europe/Warsaw",
  "metadata": {
    "locale": "pl-PL",
    "merchantDomain": "fundacja.example.com"
  }
}

Do istniejącego produktu dodasz ją aktualizacją. Uwaga na dwie różnice względem tworzenia produktu:

PATCH /api/product/pay/{productId}

{
  "productMetadata": {
    "locale": "pl-PL",
    "logoUrl": "https://fundacja.example.com/logo.png",
    "merchantDomain": "fundacja.example.com"
  }
}

W aktualizacji pole nazywa się productMetadata, a nie metadata. Body z metadata zwróci 200, ale niczego nie zmieni - nieznane pola są ignorowane.
productMetadata zastępuje całe metadane produktu. Przepisz w nim wszystkie pola, które już ustawiłeś (locale, logoUrl i pozostałe) - pominięte zostaną wyczyszczone.

Jeśli nie zarządzasz produktem przez API, podaj domenę w wiadomości z kroku 2 - ustawimy merchantDomain po naszej stronie.

Zasady:

Sama domena - bez https://, portu, ścieżki i ukośnika na końcu: fundacja.example.com. Jeśli wyślesz pełny adres, API zostawi z niego samą domenę i zamieni ją na małe litery. Wartość, z której nie da się wyciągnąć poprawnej domeny, kończy się kodem 400.
Dokładnie ta domena, na której działa strona. example.com i www.example.com to dla Apple dwie różne domeny - podaj tę, pod którą klient faktycznie widzi stronę (i najlepiej przekierowuj drugą na nią).
Jedna domena na produkt. Jeśli ten sam produkt ma działać w widgecie na kilku domenach, napisz do nas - każdą domenę trzeba zarejestrować w Apple osobno.
localhost i domeny bez publicznego HTTPS nie przejdą weryfikacji Apple. Apple Pay testuj na domenie dostępnej z internetu.

2. Zgłoszenie domeny

Napisz na integration@paymove.io i podaj:

domenę (lub domeny), na której osadzasz widget,
identyfikatory produktów (productId), które będą tam działać,
środowisko - sandbox, produkcja albo oba.

Zarejestrujemy domenę w Apple dla identyfikatora sprzedawcy paymove i odeślemy Ci plik weryfikacyjny wygenerowany dla Twojej domeny.

Pliku nie wygenerujesz samodzielnie na swoim koncie Apple Developer - jest powiązany z identyfikatorem sprzedawcy Apple należącym do paymove. Własne konto Apple Developer nie jest potrzebne.

3. Plik weryfikacyjny

Wystaw otrzymany plik dokładnie pod tym adresem:

https://fundacja.example.com/.well-known/apple-developer-merchantid-domain-association

Apple sprawdza go automatycznie, więc musi być:

dostępny publicznie przez HTTPS, bez logowania, bez blokady geograficznej i bez ochrony przed botami (Cloudflare challenge, WAF),
pod dokładnie tą ścieżką - katalog .well-known w głównym katalogu domeny, nazwa pliku bez rozszerzenia,
serwowany bez przekierowania (kod 200, nie 301/302),
w niezmienionej postaci - nie edytuj go i nie zmieniaj kodowania.

Sprawdź go przed zgłoszeniem gotowości:

curl -i https://fundacja.example.com/.well-known/apple-developer-merchantid-domain-association

Oczekiwany wynik to HTTP/2 200 i treść pliku od pierwszego bajtu. Przykładowe konfiguracje:

location = /.well-known/apple-developer-merchantid-domain-association {
  alias /var/www/apple/apple-developer-merchantid-domain-association;
  default_type text/plain;
}

public/.well-known/apple-developer-merchantid-domain-association

Wgraj plik przez FTP/SFTP do katalogu głównego instalacji:
/.well-known/apple-developer-merchantid-domain-association
(bez wtyczek przepisujących adresy - plik musi być serwowany wprost)

Nie usuwaj pliku po weryfikacji. Apple może sprawdzić domenę ponownie, a brak pliku wyłączy Apple Pay w widgecie.

4. Potwierdzenie i test

Gdy plik jest na miejscu, daj nam znać - poprosimy Apple o weryfikację i potwierdzimy wynik. Potem przetestuj płatność:

w Safari na iPhonie, iPadzie albo Macu z kartą dodaną do Apple Wallet - w innych przeglądarkach Apple Pay się nie pokazuje,
na stronie pod zgłoszoną domeną - wersja testowa pod inną domeną (np. staging.example.com) wymaga osobnej rejestracji.

Co się dzieje bez rejestracji

Dopóki domena nie jest zarejestrowana, Apple odrzuca sesję płatniczą: klient wybiera Apple Pay, ale arkusz płatności się nie otwiera albo zamyka się z błędem. Pozostałe metody działają normalnie. Jeśli nie planujesz rejestracji, wyłącz Apple Pay dla produktu osadzanego w widgecie - napisz do nas, a zrobimy to za Ciebie. Rejestracja nie jest potrzebna, gdy klient płaci poza widgetem - na stronie płatności otwartej z linku albo z kodu QR arkusz Apple Pay pokazuje się na domenie paymove.

Ta sama procedura dotyczy widgetu checkoutu. Jeśli osadzasz na jednej domenie oba widgety, zgłoś to w jednej wiadomości - podaj wszystkie produkty, które mają tam działać.

Wprowadzenie

Integracje

Tutoriale

Pomoc

1. `merchantDomain` w produkcie

2. Zgłoszenie domeny

3. Plik weryfikacyjny

4. Potwierdzenie i test

Co się dzieje bez rejestracji

​1. merchantDomain w produkcie

​2. Zgłoszenie domeny

​3. Plik weryfikacyjny

​4. Potwierdzenie i test

​Co się dzieje bez rejestracji

1. `merchantDomain` w produkcie

2. Zgłoszenie domeny

3. Plik weryfikacyjny

4. Potwierdzenie i test

Co się dzieje bez rejestracji