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

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

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>