Dzięki Google Pay Twoi klienci mogą z łatwością dokonywać płatności w Twojej aplikacji lub witrynie przy użyciu dowolnej karty kredytowej lub debetowej powiązanej z ich kontem Google. Dotyczy to kart z usług takich jak Google Play, YouTube, Chrome lub dowolnego urządzenia z Androidem.
Gdy klient dokonuje płatności za pomocą Google Pay, wyświetla się arkusz płatności, który pozwala mu wybrać preferowaną kartę i bezpiecznie potwierdzić zakup.
Opcja płatności | Kategoria | Kraje | Waluty | Cechy | Integracje |
---|---|---|---|---|---|
GooglePay | Cyfrowy portfel | Czechy, Francja, Niemcy, Portugalia, Polska, Rumunia, Słowacja, Słowenia | CZK, EUR, PLN, RON | Wstępnie autoryzowane przechwytywanie Zakup jednorazowy Częściowe przechwytywanie Częściowy zwrot pieniędzy Powtarzający się Zwroty pieniędzy Anulowanie | API Formularz Płatności Wtyczka Prestashop Wtyczka WooCommerce Wtyczka Magento |
Zanim zaczniesz
Aby rozpocząć przetwarzanie płatności Google Pay, pierwszy krok obejmuje konfigurację Google Pay. Po pomyślnej konfiguracji zyskujesz możliwość włączenia przycisku Google Pay na stronie płatności i bezpiecznego żądania zaszyfrowanych szczegółów płatności od swoich klientów.
Przed rozpoczęciem transmisji na żywo musisz ściśle przestrzegać postanowień określonych w Zasadach dopuszczalnego użytkowania interfejsu Google Pay API.
Włącz Google Pay
Aby rozpocząć ten proces, musisz być zalogowany przy użyciu konta Google Developer.
Wiąże się to z dokończeniem rejestracji w Konsoli Google Pay & Wallet i wybraniem „Brama” jako Typ integracji Google Pay API.
Po zakończeniu tego procesu uzyskasz możliwość zainicjowania płatności.
Dokonać płatności
W pierwszej kolejności należy zainicjować tworzenie zamówienia.
Po wygenerowaniu żądania zamówienia pamiętaj o podaniu „XPAY” jako metody płatności.
Następnie złóż wniosek o płatność zgodnie z poniższym szczegółowym komunikatem.
Environment | URL | Operation Method & Endpoint | Operation Description |
---|---|---|---|
PROD | api.sibsgateway.com | POST version-id/{id}/xpay/payment | Requests the payment registered by the previous checkout using xpay payment details inserted by the customer. |
TEST | stargate-cer.qly.site[1|2].sibs.pt | POST version-id/{id}/xpay/payment | Requests the payment registered by the previous checkout using xpay payment details inserted by the customer. |
Poniższy komunikat przedstawia żądanie płatności GooglePay:
Location | Data Element | Type | Condition | Description |
---|---|---|---|---|
Path | id | String | Conditional | Transaction Id |
Parametry nagłówka:
Lokalizacja | Element danych | Typ | Stan | Opis |
---|---|---|---|---|
Nagłówek żądania | Typ zawartości | Ciąg | Obowiązkowy | aplikacja/json |
Wniosek Nagłówek | Upoważnienie | Ciąg | Obowiązkowy | Token okaziciela. Na podstawie uwierzytelniania OAuth2 przeprowadzonego na etapie wstępnym. |
Nagłówek żądania | x-ibm-client-id | Ciąg | Obowiązkowy | Token identyfikujący organizację klienta. Jest on przekazywany podczas procesu onboardingu i należy go stosować podczas każdej rozmowy. |
Parametry żądania:
Location | Data Element | Type | Condition | Description |
---|---|---|---|---|
Request Body | tokenInfo | TokenInfo | Conditional | Payment Tokens |
Request Body.tokenInfo | tokenName | String | Optional | Token Name |
Request Body.tokenInfo | tokenType | String | Mandatory | Token Type. Possible values are („ApplePay”, „GooglePay”). |
Request Body.tokenInfo | value | String | Mandatory | Token Value |
Request Body | info | Info | Mandatory | Object that defines the transaction additional information. |
Request Body.info | deviceInfo | DeviceInfo | Mandatory | Object that defines the customer device information. |
Request Body.info.deviceInfo | browserAcceptHeader | String | Optional | Browser Accept Header |
Request Body.info.deviceInfo | browserJavaEnabled | String | Optional | Browser Java Enabled |
Request Body.info.deviceInfo | browserJavascriptEnabled | String | Optional | Browser Javascript Enabled |
Request Body.info.deviceInfo | browserLanguage | String | Optional | browser Language |
Request Body.info.deviceInfo | browserColorDepth | String | Optional | browser Color Depth |
Request Body.info.deviceInfo | browserScreenHeight | String | Optional | browser Screen Height |
Request Body.info.deviceInfo | browserScreenWidth | String | Optional | browser Screen Width |
Request Body.info.deviceInfo | browserTZ | String | Optional | Browser Time Zone |
Request Body.info.deviceInfo | browserUserAgent | String | Optional | Browser User Agent |
Request Body.info.deviceInfo | systemFamily | String | Optional | System Family |
Request Body.info.deviceInfo | systemVersion | String | Optional | System Version |
Request Body.info.deviceInfo | systemArchitecture | String | Optional | System Architecture |
Request Body.info.deviceInfo | deviceManufacturer | String | Optional | System Manufacturer |
Request Body.info.deviceInfo | deviceModel | String | Optional | Device Model |
Request Body.info.deviceInfo | deviceID | String | Optional | Device Unique Identification |
Request Body.info.deviceInfo | applicationName | String | Optional | Application Name |
Request Body.info.deviceInfo | applicationVersion | String | Optional | Application Version |
Request Body.info.deviceInfo | geoLocalization | String | Optional | Geolocation |
Request Body.info.deviceInfo | ipAddress | String | Optional | IP Address |
Request Body.info | customerInfo | CustomerInfo | Mandatory | Key Value tuple array. |
Request Body.info.customerInfo | key | String | Optional | |
Request Body.info.customerInfo | value | String | Optional |
Oto przykład transakcji Google Pay:
{
"info": {
"deviceInfo": {
"browserAcceptHeader": "application/json, text/plain, */*",
"browserJavaEnabled": "false",
"browserLanguage": "en",
"browserColorDepth": "24",
"browserScreenHeight": "1080",
"browserScreenWidth": "1920",
"browserTZ": "-60",
"browserUserAgent": "Mozilla/5.0 (Windows NT 10.0; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/106.0.0.0 Safari/537.36",
"geoLocalization": "Lat: 38.7350528 | Long: -9.2143616",
"systemFamily": "Windows",
"systemVersion": "Windows",
"deviceID": "498bfd4c3a3645b38667a7037b616c18",
"applicationName": "Chrome",
"applicationVersion": "106"
},
"customerInfo": [
{
"key": "customerName",
"value": "Test Name"
},
{
"key": "customerEmail",
"value": email@provider.com
}
]
},
"tokenInfo": {
"tokenType": "googlePay",
"value": "eyJzaWduYXR1cmUiOiJNRVVDSVFDVXkvSU1SVEErRk9UbjNhdERHQlQvVHZYOWZQdE8wSFhydGVBcWNJb9In0="
}
}
Po zaksięgowaniu wpłaty otrzymasz odpowiedź informującą o statusie transakcji.
Dodatkowo możesz w dowolnym momencie wykonać operację „Pobierz status”, aby sprawdzić status.
Nagłówek HTTP autoryzacji jest ustawiony na token nośnika, tak jak był używany podczas początkowej realizacji transakcji.
GET {transactionID}/status
Adres URL żądania:
https://stargate-cer.qly.site1.sibs.pt/api/v1/payments/{transactionID}/status
Nagłówki żądań:
Authorization: ‘Bearer <AuthToken>’
X-IBM-Client-Id: ‘<ClientId>’
Content-Type: application/json
Pomyślna odpowiedź techniczna składa się ze statusu HTTP-200 i returnStatus.statusCode=”000″.
Oto kilka przykładów możliwych kodów wyników:
Result Code | statusMsg | Description | Action |
---|---|---|---|
HTTP-200 | Success | Success response | N/A |
HTTP-400 | Bad Request | The JSON payload is not matching the API definition or some mandatory HTTP headers are missing. | Please check in API Market for the correct syntax. |
HTTP-401 | Unauthorized | On the Authorization, Bearer token is invalid/expired or not associated with the Terminal used. | Please check in SIBS Backoffice under the Credentials if the token is valid and create a new one if needed. |
HTTP-403 | Forbidden | The ClientID set on the X-IBM-Client-Id HTTP header is not valid or does not possess a valid subscription to the API. | Please check in SIBS Backoffice under the SPG APP 2.0 if the ClientID is correct. If the problem persists contact SIBS Gateway support for a ClientID reset. |
HTTP-405 | Method Not Allowed | The HTTP Method used is not matching any of the API definitions available. | Please check in API Market for the correct HTTP Method. |
HTTP-429 | Too Many Requests | The API calls rate limit has been exceeded. | Please check in API Market for information on the rate limits that apply to the API. |
HTTP-500 | Internal Server Error | The API call has failed… and its most likely on our side. | You should retry the operation, and if the problem persists contact SIBS Gateway support for assistance. |
HTTP-503 | Service Unavailable | The API call is not currently available. Usually we are always on, but short availability issues may occur during scheduled maintenance. | You should wait and try again later. |