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.paymentw 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 Google | w małym iframe serwowanym przez Paymentic | na Twojej stronie |
| Domena, którą musi znać Google | Paymentic. Nic nie rejestrujesz po swojej stronie. | Twoja. Paymentic musi zarejestrować w Google każdą domenę checkoutu przed startem. |
| Wygląd przycisku | oficjalny przycisk Google Pay, pełna szerokość, 48 px | Twó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
- Obsłuż wynik i dostępność portfeli: zdarzenia
complete,error,canceli powody niedostępności.