Cykl życia transakcji płatniczej

Dowiedz się, jak sprzedawcy integrują aplikacje płatnicze i jak działają transakcje płatnicze z interfejsem Payment Request API.

Interfejsy Web Payments API to specjalne funkcje płatności, które po raz pierwszy zostały wbudowane w przeglądarkę. Dzięki Web Payments integracja sprzedawców z aplikacjami płatniczymi staje się prostsza, a wrażenia klienta są bardziej usprawnione i bezpieczne.

Aby dowiedzieć się więcej o korzyściach płynących z używania Web Payments, przeczytaj artykuł Empowering payment apps with Web Payments (w języku angielskim).

Z tego artykułu dowiesz się, jak przebiega transakcja płatnicza w witrynie sprzedawcy i jak działa integracja aplikacji płatniczej.

Proces ten składa się z 6 etapów:

  1. Sprzedawca inicjuje transakcję płatniczą.
  2. Sprzedawca wyświetla przycisk płatności.
  3. Klient naciska przycisk płatności.

    Diagram przedstawiający witrynę sklepu z serami z przyciskiem BobPay (aplikacja płatnicza).

  4. Przeglądarka uruchamia aplikację płatniczą.

    Diagram przedstawiający witrynę sklepu z serami z uruchomioną aplikacją BobPay w oknie modalnym. W oknie modalnym wyświetlają się opcje dostawy i łączny koszt.

  5. Jeśli klient zmieni jakiekolwiek szczegóły (np. opcje dostawy lub adres), sprzedawca aktualizuje szczegóły transakcji, aby odzwierciedlić zmianę.

    Diagram przedstawiający klienta wybierającego inną opcję dostawy w oknie aplikacji BobPay. Drugi diagram przedstawiający sprzedawcę aktualizującego łączny koszt wyświetlany w BobPay.

  6. Gdy klient potwierdzi zakup, sprzedawca weryfikuje płatność i finalizuje transakcję.

    Diagram przedstawiający klienta naciskającego

Krok 1. Sprzedawca inicjuje transakcję płatniczą

Gdy klient zdecyduje się na zakup, sprzedawca inicjuje transakcję płatniczą, tworząc obiekt PaymentRequest. Ten obiekt zawiera ważne informacje o transakcji:

  • akceptowane formy płatności i powiązane z nimi dane, które są niezbędne do przetworzenia transakcji;
  • szczegóły, takie jak łączna cena (wymagana) i informacje o produktach;
  • Opcje, w których sprzedawcy mogą poprosić o informacje o dostawie, takie jak adres dostawy i opcja dostawy.
  • Sprzedawcy mogą też poprosić o adres rozliczeniowy, imię i nazwisko płatnika, adres e-mail i numer telefonu.
  • Sprzedawcy mogą też uwzględnić w pliku PaymentRequest opcjonalny typ dostawy (shipping, delivery lub pickup). Aplikacja płatnicza może wykorzystać te informacje, aby wyświetlić prawidłowe etykiety w interfejsie.
const request = new PaymentRequest([{
  supportedMethods: 'https://bobpay.xyz/pay',
  data: {
    transactionId: '****'
  }
}], {
  displayItems: [{
    label: 'Anvil L/S Crew Neck - Grey M x1',
    amount: { currency: 'USD', value: '22.15' }
  }],
  total: {
    label: 'Total due',
    amount: { currency: 'USD', value : '22.15' }
  }
}, {
  requestShipping: true,
  requestBillingAddress: true,
  requestPayerEmail: true,
  requestPayerPhone: true,
  requestPayerName: true,
  shippingType: 'delivery'
});
Uwzględnianie identyfikatora transakcji

Niektóre moduły obsługi płatności mogą wymagać od sprzedawcy podania identyfikatora transakcji, który został wcześniej wystawiony w ramach informacji o transakcji. Typowa integracja obejmuje komunikację między serwerem sprzedawcy a serwerem modułu obsługi płatności w celu zarezerwowania łącznej ceny. Zapobiega to manipulowaniu ceną przez szkodliwych klientów i oszukiwaniu sprzedawcy dzięki weryfikacji na końcu transakcji.

Sprzedawca może przekazać identyfikator transakcji w ramach właściwości data obiektu PaymentMethodData.

Po otrzymaniu informacji o transakcji przeglądarka przechodzi przez proces wykrywania aplikacji płatniczych określonych w PaymentRequest na podstawie identyfikatorów form płatności. Dzięki temu przeglądarka może określić, którą aplikację płatniczą uruchomić, gdy tylko sprzedawca będzie gotowy do przeprowadzenia transakcji.

Szczegółowe informacje o procesie wykrywania znajdziesz w artykule Konfigurowanie formy płatności.

Krok 2. Sprzedawca wyświetla przycisk płatności

Sprzedawcy mogą obsługiwać wiele form płatności, ale powinni wyświetlać przyciski płatności tylko dla tych, z których klient może faktycznie skorzystać. Wyświetlanie przycisku płatności, którego nie można użyć, negatywnie wpływa na wrażenia użytkownika. Jeśli sprzedawca może przewidzieć, że forma płatności określona w obiekcie PaymentRequest nie będzie działać u klienta, może podać rozwiązanie zastępcze lub w ogóle nie wyświetlać tego przycisku.

Za pomocą instancji PaymentRequest sprzedawca może sprawdzić, czy klient ma dostęp do aplikacji płatniczej.

Czy klient ma dostęp do aplikacji płatniczej?

Metoda canMakePayment() interfejsu PaymentRequest zwraca wartość true, jeśli aplikacja płatnicza jest dostępna na urządzeniu klienta. „Dostępna” oznacza, że wykryto aplikację płatniczą, która obsługuje daną formę płatności, i że aplikacja płatnicza na daną platformę jest zainstalowana lub internetowa aplikacja płatnicza jest gotowa do zarejestrowania.

const canMakePayment = await request.canMakePayment();
if (!canMakePayment) {
  // Fallback to other means of payment or hide the button.
}

Krok 3. Klient naciska przycisk płatności

Gdy klient naciśnie przycisk płatności, sprzedawca wywołuje metodę show() instancji PaymentRequest, co natychmiast powoduje uruchomienie interfejsu płatności.

Jeśli ostateczna cena łączna jest ustawiana dynamicznie (np. pobierana z serwera), sprzedawca może odroczyć uruchomienie interfejsu płatności do momentu, gdy łączna kwota będzie znana.

Odroczenie uruchomienia interfejsu płatności

Zobacz wersję demonstracyjną odroczenia interfejsu płatności do momentu ustalenia ostatecznej ceny łącznej.

Aby odroczyć interfejs płatności, sprzedawca przekazuje obietnicę do metody show(). Przeglądarka będzie wyświetlać wskaźnik wczytywania, dopóki obietnica nie zostanie spełniona i transakcja nie będzie gotowa do rozpoczęcia.

const getTotalAmount = async () => {
  // Fetch the total amount from the server, etc.
};

try {
  const result = await request.show(getTotalAmount());
  // Process the result…
} catch(e) {
  handleError(e);
}

Jeśli nie podasz obietnicy jako argumentu dla show(), przeglądarka natychmiast uruchomi interfejs płatności.

Krok 4. Przeglądarka uruchamia aplikację płatniczą

Przeglądarka może uruchomić aplikację płatniczą przeznaczoną na daną platformę lub aplikację internetową. (Dowiedz się więcej o tym, jak Chrome określa, którą aplikację płatniczą uruchomić).

Sposób tworzenia aplikacji płatniczej zależy w dużej mierze od dewelopera, ale zdarzenia wysyłane do sprzedawcy i od niego, a także struktura danych przekazywanych wraz z tymi zdarzeniami są ustandaryzowane.

Po uruchomieniu aplikacja płatnicza otrzymuje informacje o transakcji przekazane do obiektu PaymentRequest w kroku 1, które obejmują:

  • Dane formy płatności
  • Łączna cena
  • Opcje płatności

Aplikacja płatnicza używa informacji o transakcji do oznaczania interfejsu.

Krok 5. Jak sprzedawca może zaktualizować szczegóły transakcji w zależności od działań klienta

Klienci mogą zmienić szczegóły transakcji, takie jak forma płatności i opcja dostawy, w aplikacji płatniczej. Gdy klient wprowadza zmiany, sprzedawca otrzymuje zdarzenia zmiany i aktualizuje szczegóły transakcji.

Sprzedawca może otrzymywać 4 rodzaje zdarzeń:

  • Zdarzenie zmiany formy płatności
  • Zdarzenie zmiany adresu dostawy
  • Zdarzenie zmiany opcji dostawy
  • Zdarzenie weryfikacji sprzedawcy

Zdarzenie zmiany formy płatności

Aplikacja płatnicza może obsługiwać wiele form płatności, a sprzedawca może oferować specjalny rabat w zależności od wyboru klienta. Aby obsłużyć ten przypadek użycia, zdarzenie zmiany formy płatności może poinformować sprzedawcę o nowej formie płatności, dzięki czemu może on zaktualizować łączną cenę o rabat i zwrócić ją do aplikacji płatniczej.

request.addEventListener('paymentmethodchange', e => {
  e.updateWith({
    // Add discount etc.
  });
});

Zdarzenie zmiany adresu dostawy

Aplikacja płatnicza może opcjonalnie podać adres dostawy klienta. Jest to wygodne dla klientów, ponieważ nie muszą ręcznie wpisywać żadnych danych w formularzu i mogą przechowywać adres dostawy w preferowanych aplikacjach płatniczych, a nie na wielu różnych stronach sprzedawców.

Jeśli klient zaktualizuje adres dostawy w aplikacji płatniczej po rozpoczęciu transakcji, do sprzedawcy zostanie wysłane zdarzenie 'shippingaddresschange'. To zdarzenie pomaga sprzedawcy określić koszt dostawy na podstawie nowego adresu, zaktualizować łączną cenę i zwrócić ją do aplikacji płatniczej.

request.addEventListener('shippingaddresschange', e => {
  e.updateWith({
    // Update the details
  });
});

Jeśli sprzedawca nie może wysłać przesyłki na zaktualizowany adres, może wyświetlić komunikat o błędzie, dodając parametr błędu do szczegółów transakcji zwracanych do aplikacji płatniczej.

Zdarzenie zmiany opcji dostawy

Sprzedawca może oferować klientowi wiele opcji dostawy i może przekazać ten wybór aplikacji płatniczej. Opcje dostawy są wyświetlane jako lista cen i nazw usług, z których klient może wybierać. Na przykład:

  • Przesyłka standardowa – bezpłatna
  • Dostawa ekspresowa – 5 USD

Gdy klient zaktualizuje opcję dostawy w aplikacji płatniczej, do sprzedawcy zostanie wysłane zdarzenie 'shippingoptionchange'. Sprzedawca może wtedy określić koszt dostawy, zaktualizować łączną cenę i przekazać ją z powrotem do aplikacji płatniczej.

request.addEventListener('shippingoptionchange', e => {
  e.updateWith({
    // Update the details
  });
});

Sprzedawca może też dynamicznie modyfikować opcje dostawy na podstawie adresu dostawy klienta. Jest to przydatne, gdy sprzedawca chce oferować różne zestawy opcji dostawy dla klientów krajowych i zagranicznych.

Zdarzenie weryfikacji sprzedawcy

Aby zwiększyć bezpieczeństwo, aplikacja płatnicza może przeprowadzić weryfikację sprzedawcy przed przejściem do procesu płatności. Projekt mechanizmu weryfikacji zależy od aplikacji płatniczej, ale zdarzenie weryfikacji sprzedawcy służy do informowania sprzedawcy o adresie URL, którego może użyć do weryfikacji.

request.addEventListener('merchantvalidation', e => {
  e.updateWith({
    // Use `e.validateURL` to validate
  });
});

Krok 6. Sprzedawca weryfikuje płatność i finalizuje transakcję

Gdy klient autoryzuje płatność, metoda show() zwraca obietnicę, która jest rozwiązywana do PaymentResponse. Obiekt PaymentResponse zawiera te informacje:

  • Szczegóły wyniku płatności
  • Adres dostawy
  • Opcja dostawy
  • Informacje kontaktowe

W tym momencie interfejs przeglądarki może nadal wyświetlać wskaźnik wczytywania, co oznacza, że transakcja nie została jeszcze zakończona.

Jeśli aplikacja płatnicza zostanie zamknięta z powodu nieudanej płatności lub błędu, obietnica zwrócona z show() zostanie odrzucona, a przeglądarka zakończy transakcję płatniczą.

Przetwarzanie i weryfikacja płatności

details w PaymentResponse to obiekt danych uwierzytelniających płatności zwrócony przez aplikację płatniczą. Sprzedawca może użyć tych danych do przetworzenia lub zweryfikowania płatności. Sposób działania tego krytycznego procesu zależy od modułu obsługi płatności.

dokończenie lub ponowienie transakcji,

Gdy sprzedawca ustali, czy transakcja się powiodła, może:

  • Wywołaj metodę .complete(), aby sfinalizować transakcję i zamknąć wskaźnik wczytywania.
  • Pozwól klientowi spróbować ponownie, wywołując metodę retry().
async function doPaymentRequest() {
  try {
    const request = new PaymentRequest(methodData, details, options);
    const response = await request.show();
    await validateResponse(response);
  } catch (err) {
    // AbortError, SecurityError
    console.error(err);
  }
}

async function validateResponse(response) {
  try {
    const errors = await checkAllValuesAreGood(response);
    if (errors.length) {
      await response.retry(errors);
      return validateResponse(response);
    }
    await response.complete("success");
  } catch (err) {
    // Something went wrong…
    await response.complete("fail");
  }
}
// Must be called as a result of a click
// or some explicit user action.
doPaymentRequest();

Dalsze kroki