Перейти до основного вмісту

Google Pay™

Загальні положення

Google Pay™ - електронний гаманець від компанії Google, що дозволяє клієнтам проводити платежі у кілька кліків із використанням платіжних карток, що прив’язані до їх Google-акаунтів, на сайтах, а також через мобільні застосунки на Android без необхідності щоразу вводити повні платіжні дані.

У вас є можливість інтегрувати Google Pay™ на платіжну сторінку у один із таких способів:

  • AI Fintech hosted-інтеграція (кнопка оплати Google Pay™ розміщується на нашій платіжній сторінці).
  • Інтеграція з API Google Pay™ (розміщення кнопки оплати Google Pay™ на вашому сайті).
інформація

Зверніть увагу, що наразі оплата через Google Pay™ доступна картками Visa, Mastercard.

Список країн та валют які ми підтримуємо для платежів з використанням гаманця Google Pay™.

AI Fintech hosted-інтеграція

Підключення Google Pay™ у цей спосіб не потребує від вас ніяких додаткових налаштувань: кнопка оплати Google Pay™ відображається на нашій платіжній сторінці. Для підключення, проведіть hosted-інтеграцію та зверніться до Служби підтримки AI Fintech щоб активувати цей метод.

Важливо

Платіжний метод Google Pay™ не підтримується при використанні рішення, що передбачає відображення чекаута в режимі WebView у мобільних застосунках на Android.

Інтеграція з API Google Pay™

Для проведення інтеграції з Google Pay™ потрібно:

  1. Переконатися, що ваш сайт використовує HTTPS-протокол та підтримує TLS-протокол.
  2. Використовувати один із таких браузерів: Google Chrome, Mozilla Firefox, Apple Safari, Microsoft Edge, Opera, або UCWeb UC Browser.
  3. Ознайомитись з Політикою використання API Google Pay™, а також Умовами надання послуг від Google.
  4. Впевнитись, що правила використання брендових матеріалів для мобільних застосунків та сайтів дотримуються.
  5. Ознайомитись з документацією, що стосується інтеграційної процедури від Google Pay™ для мобільних застосунків та сайтів.
  6. Зареєструватись у мерчант-порталі Tranzzo для отримання API-ключів.
  7. Пройти реєстрацію в Google Pay™ Business Console для отримання свого Merchant ID та активації вашого акаунту.
    Процес виглядає так:
    • Реєстрація
    • Надання необхідної інформації та документів (Назва компанії або ім’я фізичної особи, Країна реєстрації та Контактна інформація, Документація, що підтверджує власність бізнес)
    • Верифікація та підтвердження вашого облікового запису.
    • Верифікація домену (Надання скрінів сторінок сайту тощо)
    • Отримання Merchant ID та налаштування API ключів.
  8. Використовувати API документацію для мобільних застосунків та сайтів.
інформація

Параметр gateway у скрипті повинен мати постійне значення aifintech. Значення параметра gatewayMerchantId має відповідати ідентифікатору вашого проєкту (pos_id), через який здійснюється оплата. У відповідь Google повинен повернути параметр PaymentData, а поле paymentMethodData.tokenizationData.token має містити надійно зашифрований Google Pay™ токен (рядок символів).

Списання:

The Google Pay™ API дозволяє автентифікувати платежі за допомогою методів, які підвищують безпеку та спрощують процес оплати. Ці підходи впливають на захист транзакцій.

Існує 2 методи автентифікації:

PAN_ONLY: Цей метод, пов’язаний із картками, збереженими в Google-акаунті користувача. В цьому випадку повертаються - номер картки (PAN), а також дані по закінченню терміну її дії

CRYPTOGRAM_3DS: Цей метод автентифікації пов’язаний із картками, збереженими як токени на Android-пристроях. Повернені платіжні дані містять 3D Secure (3DS) криптограму, згенеровану на пристрої.

AI Fintech підтримує обидва ці методи.

Щоб провести списання з платіжної картки, збереженої в Google Pay™, у запиті direct-методу заповніть параметри payway та cc_token такими значеннями:

  • payway: gpay
  • mode: direct
  • cc_token: gpay:${base64_google_encrypted_token}
інформація

Платежі Google Pay™ з PAN_ONLY мають проходити с обов'язковим застосуванням 3ds перевірки. Це гарантує високий рівень безпеки платежу та запобігає шахрайству. Для платежів PAN_ONLY виклик 3ds здійснюється через запит на створення платежу, з передачею параметру order_3ds_bypass = always. Детальніше про order_3ds_bypass в розділі Використання 3ds протоколу.

Зверніть увагу! Банк-екваєр може додатково запитати підтвердження для платежів з використанням гаманця Google Pay™. У цьому випадку платнику необхідно буде підтвердити платіж за допомогою 3DS або коду ОПТ на сторінці емітента картки для завершення транзакції.

Приклад запиту:

  curl -X POST \
https://api.aifintech.ua/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": "always",
"cc_token": "gpay:hlSzZOQVF5blNvVW9zVUtnSUh0MURMbWxsLzdIYUhzM3E5U2RDSnhLMGd3ZGN2eTB...",
"products":[],
"customer_email": "[email protected]",
"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™ на вашому вебсайті необхідно передбачити використання параметрів phoneNumber та billingAddress. Докладна інформація про ці параметри доступна в офіційній документації Google Pay™ за посиланням.