Jak skonfigurować formę płatności

Transakcja płatności za pomocą płatności internetowych rozpoczyna się od wykrycia Twojej aplikacji płatniczej. Dowiedz się, jak skonfigurować formę płatności i przygotować aplikację płatniczą do dokonywania płatności przez sprzedawców i klientów.

Eiji Kitamura

Aby można było używać aplikacji do płatności z interfejsem Payment Request API, musi ona być powiązana z identyfikatorem formy płatności. Sprzedawcy, którzy chcą się integrować z aplikacją do płatności, będą używać identyfikatora formy płatności, aby wskazać to przeglądarce. Z tego artykułu dowiesz się, jak działa wykrywanie aplikacji do płatności i jak skonfigurować aplikację do płatności, aby była prawidłowo wykrywana i wywoływana przez przeglądarkę.

Jeśli dopiero poznajesz koncepcję płatności internetowych lub sposób dokonywania transakcji za pomocą aplikacji płatniczych, najpierw przeczytaj te artykuły:

• Wyposażenie aplikacji do płatności w możliwość korzystania z płatności internetowych
• Cykl życia transakcji płatniczej

Obsługa przeglądarek

Płatności internetowe składają się z kilku różnych technologii, a stan obsługi zależy od przeglądarki.

Jak przeglądarka znajduje aplikację do płatności

Każda aplikacja do płatności musi zawierać:

• Identyfikator formy płatności oparty na adresie URL
• plik manifestu formy płatności (z wyjątkiem sytuacji, gdy identyfikator formy płatności jest dostarczany przez osobę trzecią);
• Manifest aplikacji internetowej

Proces wykrywania rozpoczyna się, gdy sprzedawca inicjuje transakcję:

1. Przeglądarka wysyła żądanie do adresu URL identyfikatora formy płatności i pobiera plik manifestu formy płatności.
2. Przeglądarka określa adres URL pliku manifestu aplikacji internetowej na podstawie pliku manifestu metody płatności i pobiera plik manifestu aplikacji internetowej.
3. Na podstawie pliku manifestu aplikacji internetowej przeglądarka decyduje, czy uruchomić aplikację do płatności w systemie operacyjnym, czy aplikację do płatności internetowych.

W kolejnych sekcjach znajdziesz szczegółowe instrukcje konfigurowania własnej formy płatności, aby była ona rozpoznawana przez przeglądarki.

Krok 1. Podaj identyfikator formy płatności

Identyfikator formy płatności to ciąg znaków na podstawie adresu URL. Identyfikator Google Pay to na przykład https://google.com/pay. Deweloperzy aplikacji płatniczej mogą wybrać dowolny adres URL jako identyfikator formy płatności, o ile mają nad nim kontrolę i mogą wyświetlać dowolne treści. W tym artykule jako identyfikator formy płatności używamy wartości https://bobbucks.dev/pay.

Jak sprzedawcy używają identyfikatora formy płatności

Obiekt PaymentRequest jest tworzony z listą identyfikatorów form płatności, które wskazują aplikacje płatnicze, które sprzedawca akceptuje. Identyfikatory form płatności są ustawiane jako wartości właściwości supportedMethods. Na przykład:

[merchant] prosi o płatność:

const request = new PaymentRequest([{
  supportedMethods: 'https://bobbucks.dev/pay'
}], {
  total: {
    label: 'total',
    amount: { value: '10', currency: 'USD' }
  }
});

Krok 2. Prześlij plik manifestu formy płatności

Plik manifestu formy płatności to plik JSON, który określa, która aplikacja do płatności może używać tej formy.

Prześlij plik manifestu formy płatności

Gdy sprzedawca inicjuje transakcję płatności, przeglądarka wysyła żądanie HTTP GET do adresu URL identyfikatora metody płatności. Serwer odpowiada, podając treść manifestu formy płatności.

Manifest formy płatności zawiera 2 pola: default_applications i supported_origins.

Plik manifestu metody płatności powinien wyglądać tak:

[payment handler] /payment-manifest.json:

{
  "default_applications": ["https://bobbucks.dev/manifest.json"],
  "supported_origins": [
    "https://alicepay.friendsofalice.example"
  ]
}

Gdy przeglądarka odczytuje pole default_applications, znajdzie listę linków do pliku manifestu aplikacji internetowej obsługiwanych aplikacji płatniczych.

Opcjonalnie przekieruj przeglądarkę do pliku manifestu formy płatności w innym miejscu

Adres URL identyfikatora formy płatności może opcjonalnie zwracać nagłówek Link, który wskazuje na inny adres URL, z którego przeglądarka może pobrać plik manifestu formy płatności. Jest to przydatne, gdy manifest formy płatności jest hostowany na innym serwerze lub gdy aplikacja do płatności jest obsługiwana przez osobę trzecią.

Skonfiguruj serwer formy płatności, aby odpowiadał nagłówkiem HTTP Link z atrybutem rel="payment-method-manifest" i adresem URL manifestu formy płatności.

Jeśli na przykład manifest znajduje się pod adresem https://bobbucks.dev/payment-manifest.json, nagłówek odpowiedzi będzie zawierać:

Link: <https://bobbucks.dev/payment-manifest.json>; rel="payment-method-manifest"

Adres URL może być pełną nazwą domeny lub ścieżką względną. Aby zobaczyć przykład, sprawdź https://bobbucks.dev/pay/ w sekcji ruchu sieciowego. Możesz też użyć polecenia curl:

curl --include https://bobbucks.dev/pay

Krok 3. Prześlij plik manifestu aplikacji internetowej

Jak sama nazwa wskazuje, plik manifestu aplikacji internetowej służy do definiowania aplikacji internetowej. Jest to powszechnie używany plik manifestu, który określa progresywną aplikację internetową (PWA).

Typowy manifest aplikacji internetowej wygląda tak:

[payment handler] /manifest.json:

{
  "name": "Pay with Bobpay",
  "short_name": "Bobpay",
  "description": "This is an example of the Payment Handler API.",
  "icons": [
    {
      "src": "images/manifest/icon-192x192.png",
      "sizes": "192x192",
      "type": "image/png"
    },
    {
      "src": "images/manifest/icon-512x512.png",
      "sizes": "512x512",
      "type": "image/png"
    }
  ],
  "serviceworker": {
    "src": "service-worker.js",
    "scope": "/",
    "use_cache": false
  },
  "start_url": "/",
  "display": "standalone",
  "theme_color": "#3f51b5",
  "background_color": "#3f51b5",
  "related_applications": [
    {
      "platform": "play",
      "id": "com.example.android.samplepay",
      "min_version": "1",
      "fingerprints": [
        {
          "type": "sha256_cert",
          "value": "4C:FC:14:C6:97:DE:66:4E:66:97:50:C0:24:CE:5F:27:00:92:EE:F3:7F:18:B3:DA:77:66:84:CD:9D:E9:D2:CB"
        }
      ]
    }
  ]
}

Informacje opisane w pliku manifestu aplikacji internetowej służą też do określenia sposobu wyświetlania aplikacji do płatności w interfejsie żądania płatności.

Właściwość name w pliku manifestu aplikacji internetowej jest używana jako nazwa aplikacji do płatności, a właściwość icons jako jej ikona.

Jak Chrome określa, którą aplikację do płatności uruchomić

Uruchamianie aplikacji płatniczej na danej platformie

Aby uruchomić aplikację do płatności na danej platformie, muszą być spełnione następujące warunki:

• Pole related_applications jest określone w pliku manifestu aplikacji internetowej:
  • Identyfikator pakietu i sygnatura zainstalowanej aplikacji są zgodne, a minimalna wersja (min_version) w manifeście aplikacji internetowej jest mniejsza lub równa wersji zainstalowanej aplikacji.
• Pole prefer_related_applications ma wartość true.
• Zainstalowana jest aplikacja do płatności dla danej platformy, która:
  • Filtr intencji: org.chromium.action.PAY.
  • Identyfikator formy płatności określony jako wartość właściwości org.chromium.default_payment_method_name.

Więcej informacji o konfigurowaniu tych aplikacji znajdziesz w przewodniku dla deweloperów.

[payment handler] /manifest.json

"prefer_related_applications": true,
"related_applications": [{
  "platform": "play",
  "id": "xyz.bobpay.app",
  "min_version": "1",
  "fingerprints": [{
    "type": "sha256_cert",
    "value": "92:5A:39:05:C5:B9:EA:BC:71:48:5F:F2:05:0A:1E:57:5F:23:40:E9:E3:87:14:EC:6D:A2:04:21:E0:FD:3B:D1"
  }]
}]

Jeśli przeglądarka stwierdzi, że aplikacja płatnicza dla danej platformy jest dostępna, proces znajdowania kończy się. W przeciwnym razie przechodzi do następnego kroku – uruchomienia internetowej aplikacji do płatności.

Uruchamianie internetowej aplikacji do obsługi płatności

Aplikacja do płatności internetowych powinna być określona w polu serviceworker pliku manifestu aplikacji internetowej.

[payment handler] /manifest.json:

"serviceworker": {
  "src": "payment-handler.js"
}

Przeglądarka uruchamia internetową aplikację do płatności, wysyłając do niej zdarzenie paymentrequest do usługi. Skrypt service worker nie musi być zarejestrowany z wyprzedzeniem. Można go zarejestrować w ostatniej chwili.

Specjalne optymalizacje

Jak przeglądarki mogą pominąć interfejs żądania płatności i uruchomić aplikację do płatności bezpośrednio

W Chrome, gdy wywoływana jest metoda show() klasy PaymentRequest, interfejs API Payment Request wyświetla interfejs użytkownika dostarczony przez przeglądarkę, zwany „interfejsem użytkownika żądania płatności”. To UI umożliwia użytkownikom wybranie aplikacji do płatności. Po naciśnięciu przycisku Dalej w interfejsie prośby o płatność uruchamiana jest wybrana aplikacja do płatności.

Wyświetlanie interfejsu żądania płatności przed uruchomieniem aplikacji do płatności zwiększa liczbę kroków, które musi wykonać użytkownik, aby dokonać płatności. Aby zoptymalizować ten proces, przeglądarka może zlecić dostarczenie tych informacji aplikacjom do płatności i uruchomić aplikację do płatności bezpośrednio, bez wyświetlania interfejsu żądania płatności, gdy wywołana zostanie funkcja show().

Aby uruchomić aplikację do płatności bezpośrednio, muszą być spełnione te warunki:

• show() jest wywoływane przez gest użytkownika (np. kliknięcie myszką).
• Jest tylko 1 aplikacja do płatności, która:
  • Obsługuje żądany identyfikator formy płatności.

Kiedy aplikacja do płatności online jest rejestrowana w ramach just-in-time (JIT)?

Aplikacje do płatności w internecie można uruchamiać bez wcześniejszego odwiedzenia przez użytkownika witryny aplikacji do płatności i zarejestrowania service workera. Pracownik obsługi klienta może zostać zarejestrowany w samym momencie, gdy użytkownik zdecyduje się zapłacić za pomocą internetowej aplikacji do płatności. Czas rejestracji może być różny w 2 sposobach:

• Jeśli użytkownikowi wyświetla się interfejs żądania płatności, aplikacja jest rejestrowana w samym momencie i uruchamiana, gdy użytkownik kliknie Dalej.
• Jeśli interfejs żądania płatności zostanie pominięty, aplikacja do płatności zostanie zarejestrowana w samym momencie i uruchomiona bezpośrednio. Pominięcie interfejsu żądania płatności w celu uruchomienia zarejestrowanej w czasie aplikacji wymaga wykonania przez użytkownika odpowiedniego gestu, co zapobiega nieoczekiwanej rejestracji usług w ramach różnych źródeł.

Następne kroki

Teraz, gdy Twoja aplikacja płatnicza jest widoczna, dowiedz się, jak opracować aplikację płatniczą dla konkretnej platformy i aplikację płatniczą w internecie.

• Aplikacje do płatności na Androida: przewodnik dla deweloperów
• Przewodnik dla deweloperów aplikacji do płatności internetowych