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

# Інтеграція Checkout через API

:::info
[TOC]
:::

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

## Як працює API Checkout

1. Клієнт оформлює замовлення на сайті Партнера та натискає кнопку оплати (див. схему нижче).
2. Партнер надсилає запит до системи XPAY згідно з технічною документацією для отримання посилання на платіжну сторінку.
3. XPAY генерує та передає унікальне посилання на платіжну сторінку (URI) - див. запит [[10005] "Отримання посилання на платіжну сторінку"](https://hackmd.io/1okrbJtPTVCsl6b_lyt9bg).
4. Результатом виконання запиту являється редірект клієнта на нову вкладку у браузері, де відкривається платіжна сторінка Оператора.
5. Клієнт обирає платіжний метод (або заповнює реквізити картки) та підтверджує оплату на платіжній сторінці Оператора.
6. В завершення - клієнту відображається сторінка з результатом оплати, а Партнер отримує відповідь від Оператора про статус оплати - див. розділ "[Запити "pay/error/refund" (CallBackURL)](https://hackmd.io/2x_MsqZIT6epfiqcQimFwQ)".

## Схема роботи API Checkout


## Протокол двостадійної взаємодії

Коли платіжна сторінка Партнера передбачає авторизацію клієнта (введення телефону/email), та у ході обробки даних на стороні Оператора виникає необхідність перевірки реквізитів оплати та/або уточнення суми оплати - застосовується протокол двостадійної взаємодії.

Див. деталі у розділі "[[check] Протокол двостадійної взаємодії"](https://hackmd.io/kk2x9Wx8QSe_vV11tA-KFA).

## Підключення Checkout

1. Партнер зареєстрований в системі Оператора та пройшов процедуру онбордингу. Інакше - перейти до [реєстрації головного облікового запису в системі Оператора](https://hackmd.io/jFNaT6BzQXSi6gYgOZ-Veg).
2. Для підключення інструменту прийому платежів Checkout необхідно сформувати запит до системи XPAY для отримання посилання на платіжну сторінку. Перейти до запиту:
[[10005] "Отримання посилання на платіжну сторінку"](https://hackmd.io/1okrbJtPTVCsl6b_lyt9bg).

## Тестовий Партнер

:::info
Для тестування будь-яких операцій та ознайомлення з сервісами системи XPAY заведено **Тестового Партнера**. Див. деталі підключення у розділі: ["Параметри підключення Тестового Партнера"](https://hackmd.io/kGejjgk0QaiwfpoZFnTadA).
:::

## Пов'язані запити

[[10005] Отримання посилання на платіжну сторінку](https://hackmd.io/1okrbJtPTVCsl6b_lyt9bg)
[[check] Протокол двостадійної взаємодії](https://hackmd.io/kk2x9Wx8QSe_vV11tA-KFA)
[[pay/error/refund] Статус операції (CallBackURL)](https://hackmd.io/2x_MsqZIT6epfiqcQimFwQ)
[[auth] Оплата методом "Google/Apple Pay"](https://hackmd.io/M0Q6tH0CTy-oPCA5QuFFig)

:arrow_left: [На Головну](/Mj2ZqCVpSq6A6Jzm6ladlw)
:arrow_left: [Checkout](https://hackmd.io/0mVv8NSpR1SBlFDoUtK5GQ)

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

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