Dokumentacja klienta

W tym artykule znajdziesz opis metod klienta w JavaScripcie, które możesz wykorzystywać do implementacji Google Pay API w swoich aplikacjach internetowych.

Konstruktor

Inicjuje obiekt PaymentsClient. Musisz wywołać ten konstruktor, zanim zaczniesz wywoływać zawarte w nim metody.

Nowy PaymentsClient(paymentOptions)

Argumenty

Właściwość Opis
paymentOptions

Obiekt zawierający pary klucz-wartość dla danych konfiguracyjnych Google Pay API. Różne właściwości, które można skonfigurować, znajdziesz w sekcji PaymentOptions.

Przykład: {environment:'PRODUCTION'}

Zwraca

Typ Opis
google.payments.api.PaymentsClient Obiekt PaymentsClient.

Zgłasza

Typ Opis
Error

Przekazana wartość właściwości środowiska nie jest obsługiwana.

Metody obiektów

createButton(options)

Ta wygodna metoda służy do generowania przycisku płatności Google Pay zawierającego aktualne elementy marki, który można umieścić w witrynie.

Wygenerowany HTMLElement zawiera dynamicznie wstawiany kod CSS oraz obraz SVG hostowane w CDN Google.

Informacje o tym, jak wybrać odpowiedni kolor i typ przycisku pasującego do Twojej witryny, znajdziesz w naszych wskazówkach dotyczących marki. Konieczna może być zmiana wymiarów przycisku, aby pasował on do innych podobnych przycisków i elementów procesu płatności na stronie. Użyj narzędzia do dostosowywania przycisku, aby skonfigurować przycisk do swojego przypadku użycia.

Argumenty

Nazwa Opis
options

Obiekt zawierający pary klucz-wartość do konfiguracji przycisku. Właściwości, które można skonfigurować, znajdziesz w sekcji ButtonOptions.

Przykład: {onClick:onGooglePaymentButtonClicked}

Zwraca

Typ Opis
HTMLElement <button> HTML wewnątrz ogólnego kontenera na elementy ogólnej treści dokumentu, takiego jak <div>.

Zgłasza

Typ Opis
Error

Wymagana właściwość nie jest ustawiona.

isReadyToPay(isReadyToPayRequest)

Metoda isReadyToPay(isReadyToPayRequest) pozwala określić, czy użytkownik może zwrócić formę płatności z Google Pay API.

Jeśli przeglądarka obsługuje Google Pay, isReadyToPay zwraca true. Aby sprawdzić, czy użytkownik jest zalogowany na konto Google lub zapisał już formę płatności w Google Pay, ustaw IsReadyToPayRequest.existingPaymentMethodRequired na true i sprawdź, czy paymentMethodPresent zwraca true w znalezionej obietnicy. Więcej informacji znajdziesz w sekcji IsReadyToPayResponse.

Jeśli zainicjowano PaymentsClient z użyciem właściwości środowiska TEST, paymentMethodPresent zawsze zwraca true.

Argumenty

Nazwa Opis
isReadyToPayRequest Obiekt zawierający formy płatności obsługiwane przez sprzedawcę. Szczegółowe informacje o różnych właściwościach, które można skonfigurować, znajdziesz w sekcji IsReadyToPayRequest.

Zwraca

Typ Opis
Promise

Wykonano: obiekt z informacjami o możliwości zapłacenia przez użytkownika. Więcej informacji znajdziesz w sekcji IsReadyToPayResponse.

Odrzucono: obiekt błędu zawierający więcej informacji o przyczynie odrzucenia. Więcej informacji znajdziesz w sekcji PaymentsError.

Błędy

statusCode Opis
DEVELOPER_ERROR
  • Przekazany obiekt IsReadyToPayRequest został nieprawidłowo sformatowany, zawiera nieprawidłowy parametr lub niepoprawną wartość albo brakuje w nim podstawowych wymaganych parametrów potrzebnych do określenia, czy użytkownik jest gotowy do dokonania płatności.
  • Żądanie zostało zainicjowane z kontekstu zabezpieczeń, którego żądań agent płatności lub przeglądarka zdecydowały się nie wypełniać. Najczęściej jest to błąd kontekstu niezabezpieczonej przeglądarki.

loadPaymentData(paymentDataRequest)

Ta metoda wyświetla arkusz płatności Google Pay pozwalający wybrać formę płatności i opcjonalnie skonfigurowane parametry.

Ta metoda musi być wywoływana zawsze wtedy, gdy przeglądarka przetwarza aktywację w rezultacie zdarzenia kliknięcia. Użytkownikowi może wyświetlić się wyskakujące okienko, w którym będzie mógł wybrać formę płatności lub podać inne wymagane dane określone w przekazanym parametrze żądania.

Argumenty

Nazwa Opis
paymentDataRequest Obiekt zawierający pary klucz-wartość dla pełnej konfiguracji Google Pay API. Właściwości, które można skonfigurować, znajdziesz w sekcji PaymentDataRequest.

Zwraca

Typ Opis
Promise

Wykonano: obiekt zawierający żądane dane kupującego. Więcej informacji znajdziesz w sekcji PaymentData.

Odrzucono: obiekt zawierający kod błędu i więcej informacji o przyczynie odrzucenia. Więcej informacji znajdziesz w sekcji PaymentsError.

Błędy

statusCode Opis
CANCELED
  • Bieżąca przeglądarka lub zalogowany użytkownik Google nie są obsługiwani.
  • Kupujący zamknął arkusz płatności Google Pay bez autoryzacji płatności.
  • Żądanie zostało zainicjowane z kontekstu zabezpieczeń, którego żądań agent płatności lub przeglądarka zdecydowały się nie wypełniać. Najczęściej jest to kontekst niezabezpieczonej przeglądarki.
  • Metoda została wywołana, gdy arkusz płatności Google Pay się już wyświetlał.
  • Arkusz płatności Google Pay odrzucił przekazany obiekt PaymentDataRequest. Częstą przyczyną są brakujące lub niepełne parametry PaymentMethodTokenizationSpecification Twojej bramy albo nieprawidłowe wartości parametrów.
DEVELOPER_ERROR Przekazany obiekt PaymentDataRequest został nieprawidłowo sformatowany, zawiera nieprawidłowy parametr lub niepoprawną wartość albo brakuje w nim podstawowych wymaganych parametrów.

prefetchPaymentData(paymentDataRequest)

Ta metoda umożliwia pobranie z wyprzedzeniem konfiguracji PaymentDataRequest, aby skrócić czas wykonywania loadPaymentData podczas dalszej interakcji z użytkownikiem. Nie jest zwracana żadna wartość.

Pobieranie z wyprzedzeniem jest dostępne w Chrome na Androida.

Argumenty

Nazwa Opis
paymentDataRequest Obiekt zawierający pary klucz-wartość dla pełnej konfiguracji Google Pay API. Właściwości, które można skonfigurować, znajdziesz w sekcji PaymentDataRequest. Zmiana we właściwości transactionInfo nie ma wpływu na wartość pobraną z wyprzedzeniem i zapisaną w pamięci podręcznej.

onPaymentAuthorized(paymentData)

Ta metoda jest wywoływana, gdy płatność jest autoryzowana w arkuszu płatności.

Argumenty

Nazwa Opis
paymentData Obiekt zawierający żądane dane kupującego. Więcej informacji znajdziesz w sekcji PaymentData.

Zwraca

Typ Opis
Promise

Wykonano: obiekt z informacjami o wynikach transakcji płatności. Więcej informacji znajdziesz w sekcji PaymentAuthorizationResult.

Odrzucono: obiekt błędu z intencją błędu i komunikatem, który wyświetli się w arkuszu płatności. Więcej informacji znajdziesz w sekcji PaymentDataError.

onPaymentDataChanged(intermediatePaymentData)

Ta metoda obsługuje zmiany w danych płatności w arkuszu płatności, takich jak adres dostawy i opcje dostawy.

Argumenty

Nazwa Opis
intermediatePaymentData Obiekt zawierający opcję dostawy i adres podane w arkuszu płatności. Więcej informacji znajdziesz w sekcji IntermediatePaymentData.

Zwraca

Typ Opis
Promise

Wykonano: obiekt z informacjami o nowej transakcji, opcjach dostawy oraz błędach w danych dotyczących płatności. Więcej informacji znajdziesz w sekcji PaymentDataRequestUpdate.

Odrzucono: obiekt błędu z intencją błędu i komunikatem, który wyświetli się w arkuszu płatności. Więcej informacji znajdziesz w sekcji PaymentDataError.