[УКР](https://hackmd.io/DyX9oooaR6OLe5MkdwqllA) | ENG
:arrow_left: [Guide](https://hackmd.io/QA2NYRliRLGviJl5P4-ZCw)

# API Checkout Integration

:::info
[TOC]
:::

*What is Checkout, payment types and integration methods, see the ["Checkout"](https://hackmd.io/B7V3CnG2QUKI6Qr820GHkA) section.*

## API Checkout Steps

1. Client places an order on the Partner website and clicks the payment button (see the scheme below).
2. Partner forms a request to the XPAY system according to technical documentation to receive a Checkout link.
3. XPAY generates and transmits a unique Checkout link (URI). See the request [[10005] "Get Checkout Link"](https://hackmd.io/qSkRHz6gRKmxNrWRwwrjqg).
4. Result of executing request will be client's redirect to the new browser's tab, where Operator's payment page will be opened.
5. Client chooses a payment method (or fills the card attributes) and confirms the payment on the Checkout page.
6. By the result, client is redirected to the payment results page, and Partner gets the Operator response about the payment status. See the section "[[pay/error/refund] Operation Status (CallBackURL)](https://hackmd.io/r0If47QcT-qyFuNvGEN2Wg)".

## Scheme of API Checkout


## Two-Step Interaction Protocol

Two-step interaction protocol is used when the Partner's Checkout page requires client authorization (phone/email entry), and during data processing on the Operator side, there is a need to check payment details and/or payment sum.

See details in the section ["[check] Two-Step Interaction Protocol"](https://hackmd.io/XcDW0oOKRLyIho-DOpOHjA).

## Checkout integration

1. You are a registered Partner in the Operator system and have completed the onboarding procedure. Otherwise, [register the main account in the Operator system](https://hackmd.io/wsBxZ4WwQDm10OuxDgjo3g?view).
2. To integrate Checkout, you need to form a request to the XPAY system to get a link to the payment page. See the request: [[10005] "Get Checkout Link"](https://hackmd.io/qSkRHz6gRKmxNrWRwwrjqg).

## Related Requests

[[10005] Get Checkout Link](https://hackmd.io/qSkRHz6gRKmxNrWRwwrjqg)
[[check] Two-Step Interaction Protocol](https://hackmd.io/XcDW0oOKRLyIho-DOpOHjA)
[[pay/error/refund] Operation Status (CallBackURL)](https://hackmd.io/r0If47QcT-qyFuNvGEN2Wg)
[[auth] Google/Apple Pay](https://hackmd.io/_NXWjnOgRfe60YctuLtIAQ)

:arrow_left: [Guide](https://hackmd.io/QA2NYRliRLGviJl5P4-ZCw)
:arrow_left: [Checkout](https://hackmd.io/B7V3CnG2QUKI6Qr820GHkA)

<details>
<summary>XPAY Support</summary>
</br>

Phone: [phone]
Email: [e-mail]
Telegram: @xpaysupportbot
</details>