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

# Checkout

:::info
[TOC]
:::

## What is Checkout or Payment Page?

**Checkout** (Payment Page) is a personalized Partner page for payment acceptance. The link to this page is generated by the Operator. Checkout is designed for easy, quick and secure method for payment acceptance from clients on Partner website. Using payment page, client's card details are transferred completely secure and do not stay on the Partner site or server.

After successful payment, **depending on the terms of interaction** the Operator can return the payer's unique **card token**, which is used as the client's details.


## Payment Methods

- **Apple Pay**
Acceptance of payment from the client using Apple devices.
- **Google Pay**
Easy payment method from Google.
- **Card**
Payment page accepts debit, credit and corporate Mastercard/Visa cards.
- **Invoice**
Convenient method of deferred payment. The client receives a link to the invoice with a "Pay" button and can pay anytime.

## Which Types of Payment is Supported by Checkout

- **Direct debit**
Debiting of funds from the client's card via c2a (card-to-account) or p2p (person-to-person) transfer to the previously registered wallet.
- **Payment by details**
Debiting of funds from the client's card and credit to the specified details.
- **Deferred payment**
Blocking of funds on the client's card for further debiting and crediting to the previously registered wallet.
- **Deferred payment by details**
Blocking of funds on the client's card for further debiting and crediting to the specified details.
- **Bulk payment for services**
Splitting the client's payment for the few recipients and crediting funds to the previously registered wallets.
- **Bulk payment for services by details**
Splitting the client's payment for the few recipients and crediting funds to the specified details.

## Checkout Integration Methods

1. [**API Integration**](https://hackmd.io/dGsFmNB9T5mxDec-z6Sz8g)
Option for Partners, who want completely adapted solution.
2. [**Integration by CMS Plugins**](https://hackmd.io/KuawJVgmRtaEOGweCRP16g)
Payment acceptance integration without additional development - just install the plugin and configure.
3. [**Integration by Structured Link**](https://hackmd.io/kESHEJwhRxGaq22CaHwrwg)
Simplified method of checkout page generation using a structured link.
4. [**Integration by Payment Banner**](https://hackmd.io/DjDrTZMITd65IfGH5_Hmgg)
Installation of a payment banner on the Partner's side.

## Interaction with Parent Page

In the client's browser, the payment page can interact with the **"parent"** document by creating the **"close"** event.

This event is initiated by the client pressing the appropriate button or by a timer after successful payment completion.

The "close" event can be intercepted in the "parent" document.

:::success
<details>
<summary>Example of "close" event interception using JS</summary>
<br>

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

:::info
*During each integration, the Operator creates the Partner individual support chat.*
:::

:arrow_left: [Guide](https://hackmd.io/QA2NYRliRLGviJl5P4-ZCw)
:arrow_left: [General API Integration Information](https://hackmd.io/ijxPm0xtTpycgTjuU_NHQQ)

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

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