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