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™ за посиланням.