Popular Topics

Integracja płatności Apple Pay bezpośrednio w aplikacji mobilnej wymaga wykorzystania SDK Tpay (sprawdź dokumentację) albo stworzenia własnej implementacji.

Możliwe jest wdrożenie Apple Pay w taki sposób, by użytkownik płacił z poziomu aplikacji, czyli bez wykorzystania przeglądarki (WebView).

Konfiguracja Apple Pay w SDK

Apple Pay to metoda płatności, która wymaga utworzenia certyfikatu  umożliwiającego rozszyfrowanie tokenu płatniczego dostarczanego przez Apple. Aby go utworzyć, trzeba mieć konto Apple Developer (dowiedz się więcej) - załóż i zaloguj się na koncie Apple Developer, a następnie postępuj zgodnie z poniższymi wskazówkami.

Krok 1: Rejestracja identyfikatora Merchant ID

  1. Wejdź w zakładkę “Certificates, Identifiers & Profiles”.
  2. Wybierz opcję “Identifiers”.
  3. Dodaj nowy identyfikator (niebieski znak “+”).
  4. Wybierz opcję “Merchant IDs”.
  5. Wprowadź opis oraz ID.
  6. Potwierdź podane dane oraz zapisz je.

Po wygenerowaniu Merchant ID, skontaktuj się ze swoim opiekunem w Tpay, aby:

  • podać swój Merchant ID w celu przyspieszenia procesu,
  • otrzymać plik CSR wymagany w dalszym procesie. 

Krok 2: Utworzenie Apple Pay Payment Processing Certificate

  1. Wejdź w zakładkę “Certificates, Identifiers & Profiles”.
  2. Wybierz opcję “Identifiers”.
  3. Wybierz swój Merchant ID oraz w niego kliknij.
  4. W oknie “Edit or Configure Merchant ID” wybierz opcję “Create a New Certificate”.
  5. W zakładce “Upload a Certificate Signing Request” załaduj otrzymany plik CSR, a następnie kliknij “Continue”.
  6. Pobierz wygenerowany certyfikat (apple_pay.cer) i wyślij go opiekunowi.

Integracja Apple Pay w SDK

W celu zintegrowania aplikacji mobilnej, wykorzystaj dokumentację Tpay SDK albo postępuj zgodnie z instrukcją dostarczoną przez Apple (dostępną tutaj).

Do opłacenia transakcji należy wykorzystać endpoint POST /transactions (Open API Documentation | Tpay).

W przypadku tej metody płatniczej w zapytaniu API, oprócz ogólnych parametrów wymaganych dla tego endpointu, należy również przekazać obiekt “pay” z następującymi parametrami:

  • “groupId” - wartość tego parametru musi odpowiadać grupie “Apple Pay” (aktualnie jest to 170). Wskazaną wartość można zweryfikować, wysyłając zapytanie API pod GET /transactions/bank-groups (Open API Documentation | Tpay).
  • “applePayPaymentData” - w tym polu należy przekazać wygenerowany obiekt płatniczy (token.paymentData) zakodowany jako base64.

 

 "pay": {

"groupId": 170,

       "applePayPaymentData": base64(token.paymentData)

  }

 

Dokładny opis wymaganych parametrów znajdziesz w dokumentacji open API.

Zasada działania Apple Pay w SDK jest podobna do Apple Pay on-site. 

Zalecenia

Ze względów bezpieczeństwa wszystkie zapytania przekazywane do API Tpay powinny być wysyłane za pośrednictwem własnego środowiska back-end.

Zwróć uwagę, czy aplikacja korzysta z odpowiedniego certyfikatu, ponieważ w przeciwnym razie nie będzie możliwe opłacenie transakcji wygenerowanym tokenem płatniczym.

Sandbox

Apple Pay można testować na środowisku testowym Sandbox. Wymaga to jednak wygenerowania dodatkowego Merchant ID oraz certyfikatu (zgłoś tę potrzebę swojemu opiekunowi).



Related Articles