Google Pay
Загальні положення
Google Pay™ - електронний гаманець від компанії Google, що дозволяє клієнтам проводити платежі у кілька кліків із використанням платіжних карток, що прив’язані до їх Google-акаунтів, на сайтах, а також через мобільні застосунки на Android без необхідності щоразу вводити повні платіжні дані.
У вас є можливість інтегрувати Google Pay™ на платіжну сторінку у один із таких способів:
- Financial Line hosted-інтеграція (кнопка оплати Google Pay™ розміщується на нашій платіжній сторінці).
- Інтеграція з API Google Pay™ (розміщення кнопки оплати Google Pay™ на вашому сайті).
Зверніть увагу, що наразі оплата через Google Pay™ доступна картками Visa, Mastercard.
Список країн та валют які ми підтримуємо для платежів з використанням гаманця Google Pay™.
До початку проведення інтеграції:
- Зареєструйтесь у мерчант-порталі.
- Ознайомтесь з Політикою використання API Google Pay™, а також Умовами надання послуг від Google.
- Переконайтеся що ваш сайт відповідає вимогам брендування Google Pay™.
Financial Line hosted-інтеграція
Підключення Google Pay™ у цей спосіб не потребує від вас ніяких додаткових налаштувань: кнопка оплати Google Pay™ відображається на нашій платіжній сторінці. Для підключення, проведіть hosted-інтеграцію та зверніться до Служби підтримки Financial Line щоб активувати цей метод.
Платіжний метод Google Pay не підтримується при використанні рішення, що передбачає відображення чекаута в режимі WebView у мобільних застосунках на Android.
Інтеграція з API Google Pay™
Для використання цієї інтеграції потрібно:
- Переконатися, що ваш сайт використовує HTTPS-протокол та підтримує TLS-протокол.
- Використовувати один із таких браузерів: Google Chrome, Mozilla Firefox, Apple Safari, Microsoft Edge, Opera, або UCWeb UC Browser.
- Отримати свій Merchant ID та дотримуватися інтеграційної процедури від Google Pay™.
Ознайомтеся з документацією, що стосується процесу інтеграції:
- API документація для мобільних застосунків та сайтів.
- Гайд до використання брендових матеріалів для мобільних застосунків та сайтів.
Параметр gateway
у скрипті повинен мати постійне значення finline
.
Значення параметра gatewayMerchantId
має відповідати ідентифікатору вашого проєкту (pos_id
), через який здійснюється оплата.
У відповідь Google повинен повернути параметр PaymentData
, а поле paymentMethodData.tokenizationData.token
має містити надійно зашифрований Google Pay™ токен (рядок символів).
Списання:
Щоб провести списання з платіжної картки, збереженої в Google Pay™, у запиті direct-методу заповніть параметри payway
та cc_token
такими значеннями:
payway: gpay
mode: direct
cc_token: gpay:${base64_google_encrypted_token}
Ви можете налаштувати правила для підтвердження клієнтом платежів Google Pay™ у запиті на створення платежу, передавши відповідне значення для order_3ds_bypass
.
Детальніше про order_3ds_bypass
.
Зверніть увагу! Банк-екваєр може додатково запитати підтвердження для платежів з використанням гаманця Google Pay. У цьому випадку платнику необхідно буде підтвердити платіж за допомогою 3DS або коду ОПТ на сторінці емітента картки для завершення транзакції.
Приклад запиту:
curl -X POST \
https://api.finline.io/api/v1/payment \
-H 'Content-Type: application/json' \
-H 'X-API-Auth: CPAY <API_KEY>:<API_SECRET>' \
-H 'X-API-Key: <ENDPOINTS_KEY>' \
-d '{
"pos_id": "<POS_ID>",
"mode": "direct",
"method": "purchase",
"amount": 1,
"currency": "UAH",
"order_3ds_bypass": "supported",
"cc_token": "gpay:hlSzZOQVF5blNvVW9zVUtnSUh0MURMbWxsLzdIYUhzM3E5U2RDSnhLMGd3ZGN2eTB...",
"products":[],
"customer_email": "test@gmail.com",
"description": "Pay with Google Pay™ Token",
"order_id": "1234567890",
"server_url": "https://callback.blackhole.com/callback",
"result_url": "https://example.com/result"
}'
Подальша обробка запиту здійснюється за стандартним платіжним процесом, притаманним для direct-інтеграції.
Підказка: використання платіжного методу Google Pay™ також доступне у Sandbox-режимі. Щоб отримати облікові дані для тестового середовища, зверніться до Служби підтримки Financial Line.