---
# System prepended metadata

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

---

УКР | [ENG](https://hackmd.io/dGsFmNB9T5mxDec-z6Sz8g)
![](https://i.imgur.com/ULmPUgP.jpg)
: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



![](https://i.imgur.com/qQWJ7t0.png)



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

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

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


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


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

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

![](https://i.imgur.com/gtxKB22.png)
:::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)



![](https://i.imgur.com/17gAyWb.png)
:arrow_left: [На Головну](/Mj2ZqCVpSq6A6Jzm6ladlw)
:arrow_left: [Checkout](https://hackmd.io/0mVv8NSpR1SBlFDoUtK5GQ)

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

Телефон: +38 093 891 92 00
Email: info@xpay.com.ua
Telegram: @xpaysupportbot
</details>







