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

# Checkout

:::info
[TOC]
:::

## Що таке Checkout або Платіжна сторінка?

Це персоналізована сторінка Партнера для прийому платежів, посилання на яку генерується на стороні Оператора. Checkout забезпечує простий, швидкий та безпечний спосіб прийому платежів від клієнтів на сайті Партнера. При використанні платіжної сторінки дані картки клієнта передаються абсолютно безпечно та не залишаються на сайті або сервері Партнера.

Після успішної оплати, **в залежності від умов взаємодії** Оператор може повертати унікальний **токен картки** платника, який використовується в якості реквізиту клієнта.


## Методи оплати

* **Apple Pay**
Прийом оплати від клієнта за допомогою пристроїв компанії Apple.
* **Google Pay**
Зручний спосіб оплати від Google.
* **Картка**
На платіжній сторінці приймаються дебетні, кредитні та корпоративні картки Mastercard і Visa.
* **Рахунок**
Зручний спосіб відкладеної оплати. Клієнт отримує посилання на інвойс з кнопкою «Оплатити» і може зробити оплату в будь-який момент.

## Які типи платежів підтримує Checkout
- **Пряме списання**
Списання коштів з картки клієнта через с2а (card-to-account) або p2p (person-to-person) переказ на заздалегідь прописаний гаманець.
- **Оплата за реквізитами**
Cписання коштів з картки клієнта та зарахування на вказані реквізити.
- **Відкладений платіж**
Блокування коштів на картці клієнта для подальшого списання та зарахування на заздалегідь прописаний гаманець.
- **Відкладений платіж за реквізитами**
Блокування коштів на картці клієнта для подальшого списання та зарахування на вказані реквізити.
- **Пакетна оплата послуг**
Розщеплення платежу клієнта на декількох одержувачів та зарахування коштів на заздалегідь прописані гаманці.
- **Пакетна оплата послуг за реквізитами**
Розщеплення платежу клієнта на декількох одержувачів та зарахування коштів на вказані реквізити.

## Методи інтеграції Checkout

1. **[Інтеграція через API](https://hackmd.io/DyX9oooaR6OLe5MkdwqllA)**
Варіант для Партнерів, які хочуть повністю адаптоване рішення.
2. **[Інтеграція через CMS плагіни](https://hackmd.io/rNPV-bbERBWrsr0ut8tcnA)**
Підключення прийому платежів без додаткової розробки - встановлюється плагін та виконуються налаштування.
3. [**Інтеграція за структурованим посиланням**](https://hackmd.io/NuwJ87GtSgqv2H--qQP8Yw)
Спрощений метод генерації сторінки оплати за структурним посиланням.
4. [**Інтеграція через платіжний банер**](https://hackmd.io/dQd_4MhtQeq5LMQr3S35uA)
Встановлення платіжного банеру на стороні Партнера.

## Взаємодія з "батьківською" сторінкою

У браузері клієнта платіжна сторінка може взаємодіяти з "батьківським" документом шляхом створення події **"close"**.

Дана подія ініціюється натисканням відповідної кнопки клієнтом, або таймером після успішного завершення платежу.

У "батьківському" документі подію "close" можна перехопити.

:::success
<details>
<summary>Приклад перехоплення події "close" за допомогою JS</summary>
<br>

~~~md
window.addEventListener("message", function(e) {
if(event.data.event_id === 'close'){
// do something ..
}
}, false);
~~~
</details>
:::

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

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

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