УКР | [ENG](https://hackmd.io/4FLbzFfjT3GaAWQILmxaYA)
:arrow_left: [На Головну](/Mj2ZqCVpSq6A6Jzm6ladlw)

# Пряма інтеграція Google Pay API
Google Pay™ – простий спосіб оплати, що надає можливість швидко та безпечно сплачувати карткою без необхідності вводити платіжні дані для кожного платежу. Дані картки надійно зберігаються в Google. Цей метод оплати доступний для всіх пристроїв (мобільних телефонів або комп'ютерів), незалежно від операційної системи та веб-браузера.

`| Google Pay і Google Play є товарними знаками Google LLC.`

Зверніть увагу, що XPAY надає Партнерам можливість підключити оплату на сайті через Google Pay у два способи, використовуючи:
1. [Платіжну сторінку - checkout XPAY](https://hackmd.io/0mVv8NSpR1SBlFDoUtK5GQ), що не потребує додаткових інтеграцій - після підписання Договору метод оплати буде активовано автоматично;
2. Пряму інтеграцію через Google Pay API.
`| Ваш сайт повинен працювати за схемою HTTPS і підтримувати протокол TLS 1.2.`

### Якщо ви обрали варіант - "Пряма інтеграція через Google Pay API" виконайте наступні кроки:

1. Ознайомтесь з [Google Pay API Terms of Service](https://payments.developers.google.com/terms/sellertos?hl);
2. Ознайомтесь з [Google Pay and Wallet APIs Acceptable Use Policy](https://payments.developers.google.com/terms/aup?hl=ru) та дотримуйтесь зазначених правил;
3. Виконайте умови брендування - [Brand guidelines](https://developers.google.com/pay/api/web/guides/brand-guidelines);
4. Переконайтеся, що ви виконали всі кроки описані у [Integration checklist](https://developers.google.com/pay/api/web/guides/test-and-deploy/integration-checklist).

## Інструкції з активації Google Pay для прямої інтеграції
1. По завершенню попередніх 4 кроків використовуйте [Google Pay API](https://developers.google.com/pay/api/android/guides/setup) для отримання [PaymentData](https://developers.google.com/pay/api/web/reference/request-objects#PaymentMethod).
2. Як параметри скрипта вкажіть:
2.1 Доступні методи платежу:
`var allowedPaymentMethods = ['CARD', 'TOKENIZED_CARD']`;
2.2 Тип токенізаціі - PAYMENT_GATEWAY:
`tokenizationType: 'PAYMENT_GATEWAY`;
2.3 Параметр gateway
`xpay`;
2.4. Параметр gatewayMerchantId
Ваш merchantAccount, який надається фахівцем XPAY.

3. Платіжна адреса Клієнта не потрібна для запитів XPAY Google Pay API.

Якщо ви коректно виконали всі кроки ваша інтеграція дозволить отримати кнопку **Google Pay** на сторінці оплати на вашому сайті чи у додатку.

Спливаюче вікно або форма вибору додаткової картки з’явиться після натискання кнопки на пристрої з підключеним Google Pay. Після того, як Клієнт обере картку, ви отримаєте набір даних із PaymentData.

### Приклад набору даних, що повертаються з Google Pay:

:::info
~~~
{
"apiVersion": 2,
"apiVersionMinor": 0,
"paymentMethodData": {
"type": "CARD",
"description": "Visa •••• 1234",
"info": {
"cardNetwork": "VISA",
"cardDetails": "1234"
},
"tokenizationData": {
"type": "PAYMENT_GATEWAY",
"token": "****PaymentMethodToken*****"
}
}
}
~~~
:::

Партнер забирає токен зі структури "tokenizationData" та передає в систему XPAY через надсилання наступного запиту (параметр `GoogleToken`):

:::info
[[10102/101023/101025] Карта-гаманець](https://hackmd.io/jxzgAy4nSt-Q-6chgRCZdQ)
:::

:arrow_left: [На Головну](/Mj2ZqCVpSq6A6Jzm6ladlw)
:arrow_left: [Загальна інформація по підключенню (API)](https://hackmd.io/g3cItPVFStez0ql3Xj-2TA)

<details>
<summary>Служба підтримки XPAY</summary>
</br>

Телефон: [phone]
Email: [e-mail]
Telegram: @xpaysupportbot
</details>