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

# [auth] Оплата методом Google/Apple Pay

*Що таке Checkout, типи платежів та методи інтеграції див. у розділі ["Checkout"](https://hackmd.io/0mVv8NSpR1SBlFDoUtK5GQ).*

## Проведення оплати методом "Google/Apple Pay"

:::info
Для відображення кнопок оплати "Google/Apple Pay" на сторінці Checkout та отримання посилання на платіжну сторінку [[10005]](https://hackmd.io/1okrbJtPTVCsl6b_lyt9bg) з вже вбудованими кнопками оплати "Google/Apple Pay" - встановлюються відповідні налаштування в системі Оператора.
:::

При проведенні оплати через Checkout методом "Google/Apple Pay" - у запиті [[10005]](https://hackmd.io/1okrbJtPTVCsl6b_lyt9bg) передається тип платіжного методу `"PayType":"20"`, що ідентифікує саме оплату через “Google/Apple Pay”.

У відповідь Оператор надсилає запит **"auth"** для авторизації транзакції, що містить дані карти, необхідні для проведення платежу через "Google/Apple Pay".

## Особливості формування запиту

* Запит формується лише при здійсненні оплати через платіжну сторінку (Checkout) при будь-якому методі інтеграції (див. розділ "[Методи підключення Checkout](https://hackmd.io/0mVv8NSpR1SBlFDoUtK5GQ?both#%D0%9C%D0%B5%D1%82%D0%BE%D0%B4%D0%B8-%D0%BF%D1%96%D0%B4%D0%BA%D0%BB%D1%8E%D1%87%D0%B5%D0%BD%D0%BD%D1%8F-Checkout)").
* Запит виконується на URL адресу (параметр `CallBackURL` структури `Data`), передану у запиті [[10005]](https://hackmd.io/1okrbJtPTVCsl6b_lyt9bg).
* Запит надсилається тричі з інтервалом кожні 20 секунд до отримання відповіді Партнера. Якщо відповідь не надходить - нотифікація буде надсилатися кожні 10 хвилин до моменту отримання відповіді.
* Запит здійснюється методом "GET" та передається у вигляді рядка.
* Сума передається: у копійках (1 грн. відповідає значенню "100").
* Телефон передається: у міжнародному форматі без знака “+”.
* Роздільник між параметрами: символ "&".

## Запит "auth"

У запиті передаються наступні параметри:

| Параметр | Обов’яз-ковість | Тип | Опис | Приклад |
|:-:|:-:|:-:|-|:-:|
| `command` | Так | Рядок | Тип запиту. | `auth` |
| `txn_id` | Так | Рядок | Унікальний ідентифікатор транзакції у системі Оператора. |`321455` |
| `uuid` | Так | Рядок | Унікальний ідентифікатор, що зв'язує запити "auth" та "[pay](https://hackmd.io/2x_MsqZIT6epfiqcQimFwQ)". | `f3cd72b6-e1ea-406f-9b44-a9b93b401b7f` |
| `account` | Так | Рядок | Унікальний ідентифікатор клієнта у системі Партнера: телефон або email. | `380638754213` |
| `sum` | Ні | Цілі | Сума операції у копійках.| 1 грн.=>`100` |
| `pay_type` | Так | Рядок | Тип платіжного методу. Див. [перелік типів](https://hackmd.io/aBE7H5cfQ-iqaN3SnwaQ-w#%D0%A2%D0%B8%D0%BF%D0%B8-%D0%BF%D0%BB%D0%B0%D1%82%D1%96%D0%B6%D0%BD%D0%BE%D0%B3%D0%BE-%D0%BC%D0%B5%D1%82%D0%BE%D0%B4%D1%83-%E2%80%9CPayType%E2%80%9D). | `20` |
| `locale` | Так | Рядок | Локаль (мова) платіжної сторінки (відповідає переданій локалі за запитом [[10005](https://hackmd.io/1okrbJtPTVCsl6b_lyt9bg)]). | `uk` |
| `tavv` | Ні | Рядок | Авторизаційний токен "Google/Apple Pay". |`AYKLBHIACh7p/J0eSaLHMAACAAA=` |
| `pan` | Так | Рядок | PAN картки (номер банківської карти). | `8888888888888888` |
| `exp` | Ні | Рядок | Термін закінчення дії картки у форматі YYMM. | `2312` |
| `gateway` | Так | Рядок | Шлюз токенізації "Google/Apple Pay". |`gpay` або `applepay` |

## Відповідь на запит "auth"

На запит “auth” Партнер надсилає відповідь у вигляді JSON структури, що формується з наступних параметрів:

| Параметр | Обов’яз-ковість | Тип | Опис | Приклад |
|:-:|:-:|:-:|-|:-:|
| `txn_id` | Так | Рядок | Унікальний ідентифікатор транзакції, переданий у запиті “auth”. | `321455` |
| `result` | Так | Рядок | Статус обробки операції, згідно таблиці “[Статус обробки операції](https://hackmd.io/aBE7H5cfQ-iqaN3SnwaQ-w#%D0%A1%D1%82%D0%B0%D1%82%D1%83%D1%81-%D0%BE%D0%B1%D1%80%D0%BE%D0%B1%D0%BA%D0%B8-%D0%BE%D0%BF%D0%B5%D1%80%D0%B0%D1%86%D1%96%D1%97-%E2%80%9COperationStatus%E2%80%9D)”. |`20`|
| `message` | Ні | Рядок | Текстове повідомлення з описом результату. | `Ок` |
| `txn_date` | Так | Рядок | Час проведення операції у системі Партнера. Формат: YYYYMMDDHHMMSS. | `20190301180833` |

:::success
<details>
<summary>Приклад структури відповіді</summary>
<br>

~~~md
{
"txn_id": "321456",
"result": "10",
"message": "Done",
"txn_date": "20190301180833"
}
~~~
</details>
:::

## Довідкові матеріали

Опис загальних параметрів системи XPAY див. у розділі ["Довідкові матеріали"](https://hackmd.io/aBE7H5cfQ-iqaN3SnwaQ-w): коди типів операцій, типи платіжних методів, коди статусів обробки операцій, відомості та помилки, що повертаються у відповіді та ін.

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

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

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