Przejdź do głównej zawartości

Przyjmij płatność Google Pay

Na tej stronie dodasz do checkoutu przycisk Google Pay. SDK sprawdza wsparcie urządzenia dla sieci kart i metod uwierzytelnienia skonfigurowanych dla Twojego punktu, a token płatności z Google szyfruje w przeglądarce.

Wymagania​

  • Wczytane SDK z sekcją wallet.payment w konfiguracji: Instalacja i inicjalizacja.
  • Google Pay włączone dla Twojego punktu płatności po stronie Paymentic (inaczej dostępność zwróci NOT_CONFIGURED).

Wybierz tryb integracji​

Przycisk natywny (mountGooglePay)Własny przycisk (requestGooglePay)
Gdzie działa biblioteka Googlew małym iframe serwowanym przez Paymenticna Twojej stronie
Domena, którą musi znać GooglePaymentic. Nic nie rejestrujesz po swojej stronie.Twoja. Paymentic musi zarejestrować w Google każdą domenę checkoutu przed startem.
Wygląd przyciskuoficjalny przycisk Google Pay, pełna szerokość, 48 pxTwój (obowiązują wytyczne marki Google)

Przycisk natywny (zalecane)​

<div id="google-pay" hidden></div>
const { available, reason } = await paymentic.mountGooglePay('#google-pay');
document.getElementById('google-pay').hidden = !available;

SDK renderuje oficjalny czarny przycisk „Zapłać przez Google Pay" (pełna szerokość, 48 px) wewnątrz iframe z domeny cards.paymentic.com z atrybutem allow="payment". Kliknięcie otwiera arkusz płatności. Wynik przychodzi przez zdarzenia instancji dokładnie tak, jakby przycisk był na Twojej stronie: Obsłuż wynik i dostępność portfeli.

W CSP potrzebujesz tylko frame-src https://cards.paymentic.com. Domeny pay.google.com są potrzebne wyłącznie przy własnym przycisku.

Własny przycisk​

Wytyczne marki Google wymagają oficjalnych zasobów Google Pay dla przycisków płatności. Sprawdź je, zanim ostylujesz własny przycisk. Arkusz musi być otwarty z handlera kliknięcia:

const { available } = await paymentic.isGooglePayAvailable(); // dodatkowo wstępnie ładuje pay.js
myButton.hidden = !available;

myButton.onclick = () => paymentic.requestGooglePay();

Przy własnym przycisku biblioteka Google działa na Twojej stronie, więc na produkcji Google musi powiązać merchant ID Paymentic z domenami najwyższego poziomu, które pokazują przycisk. Przekaż Paymentic każdą domenę checkoutu (bez wildcardów) przed wejściem na produkcję. Przycisk natywny nie ma tego wymagania.

Kwota przy pojedynczym wywołaniu​

paymentic.requestGooglePay({ amount: '129.99', currencyCode: 'PLN', countryCode: 'PL', label: 'Zamówienie #123' });
// ta sama sygnatura dla mountGooglePay(selector, paymentRequest)

Wartości podane przy wywołaniu nadpisują domyślne z wallet.payment w konfiguracji.

Środowisko​

Środowisko Google Pay (TEST lub PRODUCTION) wynika z Twojego punktu płatności. Z punktem sandboxowym arkusz działa w środowisku TEST i nic nie jest obciążane. Zob. Testowanie w sandboxie.

Co dalej​