[УКР](https://hackmd.io/Mj2ZqCVpSq6A6Jzm6ladlw?view) | ENG

# XPAY API Guide

## Service Integration

[Registration](https://hackmd.io/wsBxZ4WwQDm10OuxDgjo3g)
[General API Integration Information](https://hackmd.io/ijxPm0xtTpycgTjuU_NHQQ)
[Test Partner Settings](https://hackmd.io/1Ftkd9PVSvGBc9JV8f9b9A)
[Cipher Service](https://hackmd.io/mW_dr90eRriYJ6OpXj7ASA)

#### Implementation Examples

* [Example of Cryptographic Transformation Implementation in "Go" Language](https://hackmd.io/L46is8sVSI2l0ct572B6nw)
* [Example of Partner Integration Implementation](https://hackmd.io/Ipph_UUvRhSV8afGmCmZDQ)
* [Example of Encryption Integration (PKCS only)](https://hackmd.io/zpDZS5G_Q5-4iAulvdbtZQ)

### Typical Integrations

[Google Pay API Direct Integration](https://hackmd.io/4FLbzFfjT3GaAWQILmxaYA)
[MTBMoney System Integration](https://hackmd.io/jgBUF8trRwSf1LIOjPbOHg)

## Checkout

#### [General Checkout Information >>](https://hackmd.io/B7V3CnG2QUKI6Qr820GHkA)

1. [API Checkout Integration](https://hackmd.io/dGsFmNB9T5mxDec-z6Sz8g)
[[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)
2. [Checkout Integration by CMS Plugins](https://hackmd.io/KuawJVgmRtaEOGweCRP16g)
3. [Checkout Integration by Structured Link](https://hackmd.io/kESHEJwhRxGaq22CaHwrwg)
4. [Checkout Integration by Payment Banner](https://hackmd.io/DjDrTZMITd65IfGH5_Hmgg)

## Server-Server Card Payment

#### [General Information about Server-Server Card Payment >>](https://hackmd.io/83UDlVHPRf2CxEBCi6ECBg)

[[10101] Card-Card](https://hackmd.io/VYlXRMiWRkimK0sxlTZ2BA)
[[10102/101023/101025] Card-Wallet](https://hackmd.io/MUZzd3mTRQeQfBsE-emVVQ)
[[10103] Card-IBAN of Individual](https://hackmd.io/9c9kaHeMTH-LiGf_mVWwpg)
[[101031] Card-IBAN of Legal Entity](https://hackmd.io/XQDv9qmoRiqFzfzcD0H1uA)
[[10150/10051] Card-Phone-Card](https://hackmd.io/ES9hW5BlS6CozQAmULgnRw)

### Token Payment

#### [General Information about Token Payment >>](https://hackmd.io/hELnx1lqQwS9RiactYbLEA)

[[104021] Card Payment by Token](https://hackmd.io/I4FJ0d0eStuvfqG2YmS8IQ)
[[1040217] Bulk Card Payment by Token](https://hackmd.io/6h9zyYaBTwOLzzP8XJDrfg)
[[104121] Auto Debit by Token. MO/TO Operations](https://hackmd.io/X4ImobdtSJ-Hy1qM-p7PWA)

### Get Card Data

[[20400/20410] Get Card Data by Phone Number](https://hackmd.io/Xd9OZWXARcSZRTCsu-1jrw)
[[20404] Get Card Data by Token](https://hackmd.io/PSdh1ldNSmmJMR4OIhM_-Q)

## XPAY Wallet (Payouts)

#### [General Information about XPAY Wallet >>](https://hackmd.io/bbv1AdS0SwiJeWqW1i1tCA)

[[10301/10311/103013] Wallet-Card](https://hackmd.io/SvLoAv49QWOIsdPhCWFezA)
[[10204/10214] Wallet-Card by Token](https://hackmd.io/-8jNNh0SQeKZ-6tbwp15OQ)
[[10202] Wallet-Wallet](https://hackmd.io/dOi__3dxSYSi_3EvZh2a5Q)
[[10303] Wallet-IBAN](https://hackmd.io/7kfzI0OAQB6Nt8ZN38UxSg)
[[10304] Wallet-UUID](https://hackmd.io/-U0QJEY_TASmrNQGwGepcA)
[[10400] Bulk Payment Wallet-Card by Token](https://hackmd.io/BHS4jBINQ-u8SQxX3XvR6Q)
[[10401] Bulk Payment Wallet-Card by Card Number](https://hackmd.io/v65TGa0uQPGCrKXQhvHuZg)

### Phone Top-Up

[[10205] Wallet-Phone](https://hackmd.io/eyewES-3TCGr99R8shURgQ)
[[10305] Card-Phone](https://hackmd.io/RFSxYF85Q0WqOd8I6Xenjg)
[[10405] Token-Phone](https://hackmd.io/hRrNYs3wQYeHChpNSk0AFg)

## Get Transaction Data

[[20001] Get Wallet Balance](https://hackmd.io/SVZQwSioRiGRiy0JwUQFWw)
[[20002] Get Wallet Statement](https://hackmd.io/ChiiYaRgQVeZcjvM5Wt7VA)
[[20003] Get Operation Status](https://hackmd.io/_eAjmoG-QPWoWWmsLOGf1g)
[[20004] Get Transaction Receipt](https://hackmd.io/k3KrwPbcRK-1G7qxG0ORlg)
[[20006] Delete Сard Data by ClientToken](https://hackmd.io/-dG-9DvRQuiMLzXrpaoJvg)
[[20008] Get Exchange Rate](https://hackmd.io/k_ZnVoMwQ-i4WelDZ0wtZA)
[[20009] Get Limit for Operation [10101]](https://hackmd.io/rQ7epWnbQmG9kM0rFjUfhA)
[[20110] Get Card Data](https://hackmd.io/WruG7PGDRsuF0gL0Wl21bA)

## Refunds

[[10001/10002] Confirm/Сancel Pre-Authorization for Operations [10102/101023/101025]](https://hackmd.io/GQcXQzGIRnmpnUW113fQGw)
[[102070221/102070222/102070251/102070252] Confirm/Сancel Pre-Authorization](https://hackmd.io/CM0Mt9FATVS3cWkihWG_bA)
[[30201/302013/302015] Cancel/Refund Payment for Operations [10102/101023/101025]](https://hackmd.io/VUh6hQpySFOsJV9yOzzgow)
[[30202] Cancel/Refund Post-Authorization](https://hackmd.io/kRNsz_UtQZKviJnWG238HA)
[[30203] Cancel/Refund Checkout Payment](https://hackmd.io/cQmrZWV5QY-QbWDTBiCB2g)

## BankID/Diia Identification

[[10015/10025/10035/10045] Get Widget Link to Pass BankID/Diia Identification](https://hackmd.io/0g4L6-zjQ-i50rtkVjJTxQ)
[[20007] Get Client Data to Pass BankID/Diia Identification](https://hackmd.io/mNtJ1eUfTcaZjJFXUlGR-Q)

## Utility Payments

[[20801] Get Directory Data](https://hackmd.io/8x6rVjR-SnOj1HHwAfa8tg)
[[208011] Get Directory City Data](https://hackmd.io/LZsuqpBMR-iPJcnBKS7DmA)
[[20802] Get Debt Data](https://hackmd.io/GuQz5QT-RpGfdoqKjhMd8g)
[[10108] Debt Repayment](https://hackmd.io/9MdA15b8Ra-SS1pGfia0oQ)

## Fines Payment

[[80200] Get Fines Information](https://hackmd.io/AWcnFUssRNGTTPKZ7mrRlg)
[[80001] Fines Payment by Card for Mobile Application](https://hackmd.io/fWnQXFk5T2-sYiloHg6IaQ)
[Fines Payment Form for Partner Resource](https://hackmd.io/sFCB2G7OT2eMgGx4LqOg2g)

## Terminal API (TAPI)

[[90001/90002/90003/90004/90005] Operation Preparation](https://hackmd.io/4oNILIFlQD-bIpuN9PVhZQ)
[[90000] Operation Execution](https://hackmd.io/5aeqF-2PRQSkO85QIMXbqw)

## XPASS API

[View now >>](https://hackmd.io/pa6TRNZTTa67jO_qYDuRBQ)

## :book: Useful Info

[Reference Materials](https://hackmd.io/16yLv895Qo-FWTvrWWQwbg)
[Brand Usage Guidelines](https://hackmd.io/WbVv3TWQSBixs_PHUQqDjQ)
[Glossary](https://hackmd.io/j8a6tIYNRe2YsAZ6mwMpTw)