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

# [10102/101023/101025] Карта-гаманець

*Що таке "оплата картою Server-Server" та як проходить автентифікація відправника див. у розділі ["Оплата картою Server-Server"](https://hackmd.io/oXcYbY08Tq69ggTIX9OyaA).*

## Застосування

|"OperationType"| Тип операції |
|:----:|----|
|`10102`| Списання коштів з карти та зарахування на гаманець мерчанта. Повернення коштів для запиту [10102] здійснюється через запит [[30201]](https://hackmd.io/W25MdduPQFidcqLdTWIbpg).|
|`101023`| Списання коштів з карти (ecom) та зарахування на гаманці мерчантів, вказаних в структурі `MIDs` (див. опис нижче). Повернення коштів для запиту [101023] здійснюється через запит [[302013]](https://hackmd.io/W25MdduPQFidcqLdTWIbpg).|
|`101025`| Списання коштів з карти (c2a) та зарахування на гаманці мерчантів, вказаних в структурі `MIDs` (див. опис нижче). Повернення коштів для запиту [101025] здійснюється через запит [[302015]](https://hackmd.io/W25MdduPQFidcqLdTWIbpg).|

## Запит

*Опис атрибутів "Partner", "KeyAES" та "Sign" див. у розділі ["Загальна інформація по підключенню (API)"](https://hackmd.io/g3cItPVFStez0ql3Xj-2TA).*

### Структура "Data"

Структура "Data" для даної операції формується з наступних параметрів:

:::info
<details>
<summary>Формування структури "Data" (приклади наведені нижче)</summary>
<br>

**Схема руху коштів:** "SenderCard" -> RecipientWallet" -> "Wallet".
~~~
{
"GoogleToken/AppleToken": "",
"Currency": "",
"Purpose": "",
"site": "",
"Order": "",
"Wallet": {
"ID": "",
"UserName": ""
},
"TransferC2W": {
"Sum": ,
"SenderCard": {
"PAN": "",
"ExpMon": "",
"ExpYear": "",
"CVV": "",
"Cryptogram": "",
"Gateway": "",
"eciIndicator": ""
},
"RecipientWallet": {
"ID": "",
"UserName": ""
},
"SuccessCallback": "",
"FailedCallback": "",
"CallbackURL": ""
},
"MIDs": [
{
"MID": ,
"Sum": ,
"PaymentInfo": [
{
"Caption": "",
"Value": ""
}
],
"Account": "",
"EDRPOU": "",
"MFO": "",
"Name": ""
}
],
"RecipientCard": {
"PAN": ""
},
"SenderPerson": {
"FirstName": "",
"LastName": "",
"MiddleName": "",
"Phone": "",
"Email": "",
"INN": "",
"Passport": "",
"BirthDate": "",
"Address": "",
"City": "",
"CountryCode": "",
"PostCode": "",
"State": ""
},
"RecipientPerson": {
"FirstName": "",
"LastName": "",
"MiddleName": "",
"INN": "",
"Passport": "",
"BirthDate": "",
"Address": "",
"City": "",
"CountryCode": "",
"PostCode": "",
"State": ""
},
"Transaction": {
"TransactionID": "",
"TerminalID": "",
"DateTime": ""
},
"BrowserData": {
"device": {
"channel": ""
},
"browserIP": "",
"browserTZ": ,
"browserLanguage": "",
"browserUserAgent": "",
"browserColorDepth": ,
"browserJavaEnabled": ,
"browserScreenWidth": ,
"browserScreenHeight": ,
"fraudhuntFingerprint": ""
}
}
~~~
</details>
:::

|Параметр|Обов'язковість|Тип|Опис|Приклад|
|:----:|:----:|:----:|----|:----:|
|`GoogleToken` / `AppleToken`|Ні|Рядок|Токен картки відправника, що передається при оплаті методом "Google/Apple Pay". |`24iOiJFQ3YyI-UwMDNk9In0...`|
| `Currency` | Так - при оплаті у валюті, відмінній від UAH | Рядок | Код валюти списання – скорочене буквене позначення валюти, описане в стандарті [ISO 4217](https://uk.wikipedia.org/wiki/%D0%9A%D0%BB%D0%B0%D1%81%D0%B8%D1%84%D1%96%D0%BA%D0%B0%D1%86%D1%96%D1%8F_%D0%B2%D0%B0%D0%BB%D1%8E%D1%82_(ISO_4217)) (“GBP”, “USD” та ін.). |`USD`|
|`Purpose`|Ні|Рядок|Опис призначення платежу.|`Оплата замовлення №333`|
|`site`|Ні|Рядок|Назва сайту, з якого здійснюється оплата.|`https://www.xpay.com.ua/`|
| `Order` | Ні | Рядок |Номер замовлення. |`1234А`|
|`Wallet`^1^|Ні|Структура|Структура, що передає дані гаманця підсумкового одержувача (мерчанта) коштів у системі Оператора.|Див. нижче.|
|`TransferC2W`^2^|Так|Структу|Структура, що передає дані про операцію.|Див. нижче.|
| `MIDs`^4^ | Ні - для [10102]; Так - для **[101023/101025]** | Масив | Масив, що передає дані для розщеплення прийнятого платежу на користь мерчантів. |Див. приклад нижче.|
|`RecipientCard`^6^|Умовно-обов’язковий (визначається на етапі інтеграції)|Структура|Структура, що передає дані банківської картки одержувача.|Див. нижче.|
|`SenderPerson`^7^| Умовно-обов’язковий (визначається на етапі інтеграції) |Структура|Структура, що передає персональні дані відправника.|Див. нижче.|
|`RecipientPerson`^8^| Умовно-обов’язковий (визначається на етапі інтеграції)|Структура|Структура, що передає персональні дані одержувача.|Див. нижче.|
|`BrowserData`|Ні|Структура|Структура, що передає дані браузера при *3DSecure 2.0*. Див. розділ ["Структура "BrowserData"](https://hackmd.io/oXcYbY08Tq69ggTIX9OyaA?both#%D0%A1%D1%82%D1%80%D1%83%D0%BA%D1%82%D1%83%D1%80%D0%B0-%E2%80%9CBrowserData%E2%80%9D).|Див. приклад у розділі ["Структура "BrowserData"](https://hackmd.io/oXcYbY08Tq69ggTIX9OyaA?both#%D0%A1%D1%82%D1%80%D1%83%D0%BA%D1%82%D1%83%D1%80%D0%B0-%E2%80%9CBrowserData%E2%80%9D).|
|`Transaction`|Так|Структура|Структура, що передає дані про транзакцію. Див. розділ ["Структура "Transaction"](https://hackmd.io/g3cItPVFStez0ql3Xj-2TA#2-Data).|Див. нижче.|

^1^ Параметри структури **"Wallet":**

| Параметр | Обов'яз-ковість | Тип | Опис | Приклад|
|:----:|:----:|:----:|----|:----:|
|`ID`|Так|Рядок|Ідентифікатор гаманця, яким може виступати: </br> - номер телефону, </br> - email, </br> - унікальний ідентифікатор клієнта в системі Партнера, </br> - номер картки клієнта.| `[e-mail]`|
|`UserName`|Ні|Рядок|Назва власника гаманця.|`267608990`|

^2^ Параметри структури **"TransferC2W"**:

| Параметр | Обов'яз-ковість | Тип | Опис | Приклад|
|:----:|:----:|:----:|----|:----:|
|`Sum`|Так|Ціле|Сума операції у копійках. |1грн.=>`100`|
|`SenderCard`^3^|Так|Структура|Структура, що передає дані банківської картки відправника.|Див. нижче.|
|`RecipientWallet`|Так|Структура|Структура, що передає дані гаманця користувача у системі Оператора. Параметри аналогічні структурі "Wallet": `ID` та `UserName`.|Див. нижче.|
| `SuccessCallback` | Ні | Рядок | URL (server), що викликається у разі успішного проведення операції. Див. розділ ["Оплата картою Server-Server"](https://hackmd.io/oXcYbY08Tq69ggTIX9OyaA?both#%D0%A0%D0%B5%D0%B4%D0%B8%D1%80%D0%B5%D0%BA%D1%82-%D0%BA%D0%BB%D1%96%D1%94%D0%BD%D1%82%D0%B0-%D0%BD%D0%B0-%D1%81%D1%82%D0%BE%D1%80%D1%96%D0%BD%D0%BA%D1%83-CallbackURL). |`https://partner.host/cb_success`|
| `FailedCallback` | Ні | Рядок | URL (server), що викликається у разі помилки проведення операції. Див. розділ ["Оплата картою Server-Server"](https://hackmd.io/oXcYbY08Tq69ggTIX9OyaA?both#%D0%A0%D0%B5%D0%B4%D0%B8%D1%80%D0%B5%D0%BA%D1%82-%D0%BA%D0%BB%D1%96%D1%94%D0%BD%D1%82%D0%B0-%D0%BD%D0%B0-%D1%81%D1%82%D0%BE%D1%80%D1%96%D0%BD%D0%BA%D1%83-CallbackURL). |`https://partner.host/cb_fail`|
| `CallbackURL` | Ні | Рядок | URL адреса, на яку буде перенаправлений клієнт після завершення оплати. Див. розділ ["Оплата картою Server-Server"](https://hackmd.io/oXcYbY08Tq69ggTIX9OyaA?both#%D0%A0%D0%B5%D0%B4%D0%B8%D1%80%D0%B5%D0%BA%D1%82-%D0%BA%D0%BB%D1%96%D1%94%D0%BD%D1%82%D0%B0-%D0%BD%D0%B0-%D1%81%D1%82%D0%BE%D1%80%D1%96%D0%BD%D0%BA%D1%83-CallbackURL). |`https://partner.host/resul_page`|

^3^ Параметри структури **“SenderCard”**:

| Параметр | Обов'яз-ковість | Тип | Опис | Приклад|
|:----:|:----:|:----:|----|:----:|
|`PAN`|Так|Рядок[16]| PAN картки (номер банківської карти).| `8888888888888888` |
|`ExpMon`|Так|Рядок[2]|Місяць терміну дії картки. Параметр вирівнюється до 2-х знаків символом "0".|`02`|
|`ExpYear`|Так|Рядок[2]|Останні 2 цифри року терміну дії картки. Параметр вирівнюється до 2-х знаків символом "0".|`22`|
|`CVV`|Ні, якщо передається параметр `Cryptogram`.|Рядок[3]|CVV код картки.|`356`|
|`Cryptogram`|Ні|Рядок|Криптограма розшифрованого токена "Google/Apple Pay". Криптограма - динамічний одноразовий код кожної транзакції, що супроводжує токен. |`AFYjls2Of..XFAoABFA==`|
|`Gateway`|Так, якщо передається параметр `Cryptogram`.|Рядок|Шлюз токенізації "Google/Apple Pay". Передається лише, якщо дані картки були отримані в результаті розшифровування даних.|`gpay` або `applepay`|
|`eciIndicator`|Так, якщо передається параметр `Cryptogram`.|Рядок| [ECI-індикатор](https://developer.visa.com/request_response_codes#moto_eci_ind_codes), значення якого береться з розшифрованої криптограми "Google/Apple Pay". |`7`|

^4^ Параметри масиву **"MIDs"**:

| Параметр | Обов’яз-ковість | Тип | Опис | Приклад |
|:-:|:-:|:-:|-|:-:|
| `MID` |Так| Ціле | Ідентифікатор мерчанта в системі Оператора (Merchant ID), на гаманець якого зараховуються кошти. |`111`|
| `Sum` |Так| Ціле | Сума платежу у копійках.|1грн.=>`100` |
| `PaymentInfo`^5^ | Ні | Масив | Параметр передається для відображення деталей платежу на сторінці оплати. |Див. приклад нижче.|
| `Account` |Ні| Рядок | Розрахунковий рахунок або IBAN одержувача (міжнародний номер банківського рахунку). | `UA4830529900000 26008031203677`|
|`EDRPOU`|Ні|Рядок | [ЄДРПОУ](https://uk.wikipedia.org/wiki/%D0%84%D0%B4%D0%B8%D0%BD%D0%B8%D0%B9_%D0%B4%D0%B5%D1%80%D0%B6%D0%B0%D0%B2%D0%BD%D0%B8%D0%B9_%D1%80%D0%B5%D1%94%D1%81%D1%82%D1%80_%D0%BF%D1%96%D0%B4%D0%BF%D1%80%D0%B8%D1%94%D0%BC%D1%81%D1%82%D0%B2_%D1%82%D0%B0_%D0%BE%D1%80%D0%B3%D0%B0%D0%BD%D1%96%D0%B7%D0%B0%D1%86%D1%96%D0%B9_%D0%A3%D0%BA%D1%80%D0%B0%D1%97%D0%BD%D0%B8) одержувача.|`3505506226` |
| `MFO` |Ні |Рядок | [МФО](https://uk.wikipedia.org/wiki/%D0%9C%D0%A4%D0%9E) - код банку одержувача. |`305299`|
| `Name` | Ні | Рядок | Назва одержувача. |`ТОВ "Ресурс"`|

^5^ Параметри масиву **"PaymentInfo"**:

| Параметр | Обов’яз-ковість | Тип | Опис | Приклад |
|:-:|:-:|:-:|-|:-:|
| `Caption` |Так| Рядок | Опис додаткової інформації. |`Призначення`|
| `Value` |Так| Рядок | Додаткова інформація. |`Погашення за контрактом №3642989012-5 від 03.04.2021 Пупкіна Валерія Сергіївна`|

^6^ Параметри структури **"RecipientCard"**:

| Параметр | Обов'яз-ковість | Тип | Опис | Приклад|
|:----:|:----:|:----:|----|:----:|
|`PAN`|Так|Рядок[16]| PAN картки одержувача (номер банківської карти).| `8888888888888888`|

^7^ Параметри структури **"SenderPerson"**:

| Параметр | Обов'яз-ковість | Тип | Опис | Приклад|
|:----:|:----:|:----:|----|:----:|
| `FirstName` | Ні | Рядок | Ім'я відправника. |`Олег`|
| `MiddleName` | Ні | Рядок | По батькові відправника. |`Михайлович`|
| `LastName` | Ні | Рядок | Прізвище відправника. |`Подільський`|
| `Phone` | Ні | Рядок | Телефон відправника у форматі: "380ххххххххх". |`380679335544`|
| `Email` | Ні | Рядок | Email відправника. |`[e-mail]`|
| `INN` | Ні | Рядок | Реєстраційний номер облікової картки платника податків відправника. |`1234567891`|
| `Passport` | Ні | Рядок | Номер (та за наявності - серія) паспорта громадянина України або номер закордонного паспорта відправника, якщо клієнт нерезидент. |`АН 123456`|
| `BirthDate` | Ні | Рядок | Дата народження відправника. |`10.01.1993`|
| `Address`* | Ні | Рядок | Білінгова адреса відправника. |`456 Main Street`|
| `City`* | Ні | Рядок | Місто відправника. |`San Diego`|
| `CountryCode`* | Ні | Рядок | Код країни відправника (ISO CODES), згідно табл. "[Country Codes](https://countrycode.org/)". |`US`|
| `PostCode`* | Ні | Рядок | Індекс відправника. |`92126`|
| `State`* | Ні | Рядок | Штат відправника. |`California (CA)`|

^8^ Параметри структури **"RecipientPerson"**:

| Параметр | Обов'яз-ковість | Тип | Опис | Приклад|
|:----:|:----:|:----:|----|:----:|
| `FirstName` | Ні | Рядок | Ім'я одержувача. |`Андрій`|
| `MiddleName` | Ні | Рядок | По батькові одержувача. |`Валерійович`|
| `LastName` | Ні | Рядок | Прізвище одержувача. |`Мазур`|
| `INN` | Ні | Рядок | Реєстраційний номер облікової картки платника податків одержувача. |`1234567891`|
| `Passport` | Ні | Рядок | Номер (та за наявності - серія) паспорта громадянина України або номер закордонного паспорта одержувача, якщо клієнт нерезидент. |`АН 123456`|
| `BirthDate` | Ні | Рядок | Дата народження одержувача. |`10.01.1993`|
| `Address`* | Ні | Рядок | Білінгова адреса одержувача. |`pl. Bankowy 3/5`|
| `City`* | Ні | Рядок | Місто одержувача. |`Warszawa`|
| `CountryCode`* | Ні | Рядок | Код країни одержувача (ISO CODES), згідно табл. "[Country Codes](https://countrycode.org/)". |`PL`|
| `PostCode`* | Ні | Рядок | Індекс одержувача. |`00-950`|
| `State`* | Ні | Рядок | Штат одержувача. |-|

:::warning
*Параметри передаються лише при використанні картки відправника/одержувача, емітованої не банком України.
:::

:::success
<details>
<summary>Приклад структури "Data"</summary>
<br>

~~~md
{
"GoogleToken/AppleToken": "72a8ddb8-9145-4a41-af1a-8c48ecaa4be1",
"Currency": "USD",
"Purpose": "Оплата замовлення №333",
"site": "https://www.xpay.com.ua/",
"Order": "1234А",
"Wallet": {
"ID": "[e-mail]",
"UserName": "267608990"
},
"TransferC2W": {
"Sum": 100000,
"SenderCard": {
"PAN": "8888888888888888",
"ExpMon": "02",
"ExpYear": "22",
"CVV": "356",
"Cryptogram": "AFYjls2Of..XFAoABFA==",
"Gateway": "gpay",
"eciIndicator": "7"
},
"RecipientWallet": {
"ID": "[e-mail]",
"UserName": "267608990"
},
"SuccessCallback": "https://partner.host/cb_success",
"FailedCallback": "https://partner.host/cb_fail",
"CallbackURL": "https://partner.host/resul_page"
},
"MIDs": [
{
"MID": 111,
"Sum": 100000,
"PaymentInfo": [
{
"Caption": "Призначення",
"Value": "Погашення за контрактом №3642989012"
}
],
"Account": "UA483052990000026008031203677",
"EDRPOU": "3505506226",
"MFO": "305299",
"Name": "ТОВ Ресурс"
}
],
"RecipientCard": {
"PAN": "8888888888888888"
},
"SenderPerson": {
"FirstName": "Олег",
"LastName": "Михайлович",
"MiddleName": "Подільський",
"Phone": "380679335544",
"Email": "[e-mail]",
"INN": "1234567891",
"Passport": "АН 123456",
"BirthDate": "10.01.1993",
"Address": "456 Main Street",
"City": "San Diego",
"CountryCode": "US",
"PostCode": "92126",
"State": "California (CA)"
},
"RecipientPerson": {
"FirstName": "Андрій",
"LastName": "Валерійович",
"MiddleName": "Мазур",
"INN": "1234567891",
"Passport": "АН 123456",
"BirthDate": "10.01.1993",
"Address": "pl. Bankowy 3/5",
"City": "Warszawa",
"CountryCode": "PL",
"PostCode": "00-950",
"State": "-"
},
"Transaction": {
"TransactionID": "45913135c6e2be0cbf5",
"TerminalID": "1",
"DateTime": "20220521 06:41:04"
},
"BrowserData": {
"device": {
"channel": "BRW"
},
"browserIP": "146.120.244.242",
"browserTZ": 180,
"browserLanguage": "UA",
"browserUserAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/100.0.4896.127 Safari/537.36",
"browserColorDepth": 24,
"browserJavaEnabled": false,
"browserScreenWidth": 1920,
"browserScreenHeight": 1080,
"fraudhuntFingerprint": "kHqPGWS1Mj18sZFsP8Wl",
"challengeWindowSize": "01"
}
}
~~~
</details>
:::

## Відповідь

*Загальна інформація по формуванню структури відповіді наведена у розділі [“Загальна інформація по підключенню (API)”](https://hackmd.io/g3cItPVFStez0ql3Xj-2TA?both#%D0%A1%D1%82%D1%80%D1%83%D0%BA%D1%82%D1%83%D1%80%D0%B0-%D0%B2%D1%96%D0%B4%D0%BF%D0%BE%D0%B2%D1%96%D0%B4%D1%96).*

### Приклади відповідей

:::success
<details>
<summary>Запит успішно прийнятий та вимагає підтвердження "3DS"</summary>
<br>

~~~md
{
"Code": 102,
"Message": "need3ds",
"Data": {
"OperationID": 111,
"3dsHtml": "<html сторінка у кодуванні base64>",
"OperationStatus": 2
},
"KeyAES": "",
"Sign": ""
}
~~~
</details>
:::

:::success
<details>
<summary>Запит успішно прийнятий та вимагає підтвердження "OTP"</summary>
<br>

~~~md
{
"Code": 102,
"Message": "needOTP",
"Data": {
"OperationID": 111,
"otpJson": "<JSON структура у вигляді рядка>",
"OperationStatus": 3
},
"KeyAES": "",
"Sign": ""
}
~~~
</details>
:::

:::success
<details>
<summary>Операція проведена успішно</summary>
<br>

~~~md
{
"Code": 200,
"Message": "done",
"Data": {
"OperationID": 555,
"OperationStatus": 10
},
"KeyAES": "",
"Sign": ""
}
~~~
</details>
:::

:::success
<details>
<summary>Помилка виконання операції</summary>
<br>

~~~md
{
"Code": 200,
"Message": "done",
"Data": {
"OperationID": 111,
"OperationStatus": 21,
"Reason": 3
},
"KeyAES": "",
"Sign": ""
}
~~~
</details>
:::

## Тестові дані

:::info

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

Для операцій [10102/101023/101025] доступна зміна поведінки в залежності від переданого значення **"TerminalID"**:
- **"GO_TO_3DS"** - 3ds,
- **"SUCCESS_NO3DS"** - без 3ds,
- **"FAIL_BY_GATE"** - помилка.

<details>
<summary>Тестовий запит</summary>
<br>

~~~md
{
"Partner": {
"PartnerToken": "72a8ddb8-9145-4a41-af1a-8c48ecaa4be1",
"OperationType": 10102
},
"Data": "{\"GoogleToken/AppleToken\": \"72a8ddb8-9145-4a41-af1a-8c48ecaa4be1\", \"Currency\": \"USD\", \"Purpose\": \"\\u041e\\u043f\\u043b\\u0430\\u0442\\u0430 \\u0437\\u0430\\u043c\\u043e\\u0432\\u043b\\u0435\\u043d\\u043d\\u044f \\u2116333\", \"site\": \"https://www.xpay.com.ua/\", \"Order\": \"1234\\u0410\", \"Wallet\": {\"ID\": \"[e-mail]\", \"UserName\": \"267608990\"}, \"TransferC2W\": {\"Sum\": 100000, \"SenderCard\": {\"PAN\": \"8888888888888888\", \"ExpMon\": \"02\", \"ExpYear\": \"22\", \"CVV\": \"356\", \"Cryptogram\": \"AFYjls2Of..XFAoABFA==\", \"Gateway\": \"gpay\", \"eciIndicator\": \"7\"}, \"RecipientWallet\": {\"ID\": \"[e-mail]\", \"UserName\": \"267608990\"}, \"SuccessCallback\": \"https://partner.host/cb_success\", \"FailedCallback\": \"https://partner.host/cb_fail\", \"CallbackURL\": \"https://partner.host/resul_page\"}, \"MIDs\": [{\"MID\": 111, \"Sum\": 100000, \"PaymentInfo\": [{\"Caption\": \"\\u041f\\u0440\\u0438\\u0437\\u043d\\u0430\\u0447\\u0435\\u043d\\u043d\\u044f\", \"Value\": \"\\u041f\\u043e\\u0433\\u0430\\u0448\\u0435\\u043d\\u043d\\u044f \\u0437\\u0430 \\u043a\\u043e\\u043d\\u0442\\u0440\\u0430\\u043a\\u0442\\u043e\\u043c \\u21163642989012\"}], \"Account\": \"UA483052990000026008031203677\", \"EDRPOU\": \"3505506226\", \"MFO\": \"305299\", \"Name\": \"\\u0422\\u041e\\u0412 \\\"\\u0420\\u0435\\u0441\\u0443\\u0440\\u0441\\\"\"}], \"RecipientCard\": {\"PAN\": \"8888888888888888\"}, \"SenderPerson\": {\"FirstName\": \"\\u041e\\u043b\\u0435\\u0433\", \"LastName\": \"\\u041c\\u0438\\u0445\\u0430\\u0439\\u043b\\u043e\\u0432\\u0438\\u0447\", \"MiddleName\": \"\\u041f\\u043e\\u0434\\u0456\\u043b\\u044c\\u0441\\u044c\\u043a\\u0438\\u0439\", \"Phone\": \"380679335544\", \"Email\": \"[e-mail]\", \"INN\": \"1234567891\", \"Passport\": \"\\u0410\\u041d 123456\", \"BirthDate\": \"10.01.1993\", \"Address\": \"456 Main Street\", \"City\": \"San Diego\", \"CountryCode\": \"US\", \"PostCode\": \"92126\", \"State\": \"California (CA)\"}, \"RecipientPerson\": {\"FirstName\": \"\\u0410\\u043d\\u0434\\u0440\\u0456\\u0439\", \"LastName\": \"\\u0412\\u0430\\u043b\\u0435\\u0440\\u0456\\u0439\\u043e\\u0432\\u0438\\u0447\", \"MiddleName\": \"\\u041c\\u0430\\u0437\\u0443\\u0440\", \"INN\": \"1234567891\", \"Passport\": \"\\u0410\\u041d 123456\", \"BirthDate\": \"10.01.1993\", \"Address\": \"pl. Bankowy 3/5\", \"City\": \"Warszawa\", \"CountryCode\": \"PL\", \"PostCode\": \"00-950\", \"State\": \"-\"}, \"Transaction\": {\"TransactionID\": \"oVqBmbNVrfXO5psW_qwCQg\", \"TerminalID\": \"1\", \"DateTime\": \"20240820 10:43:09\"}, \"BrowserData\": {\"device\": {\"channel\": \"BRW\"}, \"browserIP\": \"146.120.244.242\", \"browserTZ\": 180, \"browserLanguage\": \"UA\", \"browserUserAgent\": \"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/100.0.4896.127 Safari/537.36\", \"browserColorDepth\": 24, \"browserJavaEnabled\": false, \"browserScreenWidth\": 1920, \"browserScreenHeight\": 1080, \"fraudhuntFingerprint\": \"kHqPGWS1Mj18sZFsP8Wl\", \"challengeWindowSize\": \"01\"}}",
"KeyAES": "",
"Sign": ""
}
~~~
</details>

<details>
<summary>Очікувана відповідь</summary>
<br>

~~~md
{
"Code": 102,
"Message": "needACS",
"Data": {
"3dsHtml": "PCFET0NUWVBFIGh0bWwgUFVCTElDICItLy9XM0MvL0RURCBIVE1MIDQuMDEgVHJhbnNpdGlvbmFsLy9FTiIKCSJodHRwOi8vd3d3LnczLm9yZy9UUi9odG1sNC9sb29zZS5kdGQiPgoJPGh0bWw+Cgk8aGVhZD4KCSA8dGl0bGU+WFBBWSB0ZXN0IDNkczwvdGl0bGU+Cgk8L2hlYWQ+Cgk8Ym9keT4KICAgCgkgPGZvcm0gYWN0aW9uPSdodHRwczovL3N0YWdlLWNiMS54cGF5LmNvbS51YS9kdW1tZXJjYjNkcy8yMTQ3NTQ5NDA0Lzk3MTU3MjMvWU0zTngtOFR6ekx2L3NtcC9zdWNjJyBtZXRob2Q9J0dFVCc+CgkgPHAgc3R5bGU9InRleHQtYWxpZ246IGNlbnRlciI+CgkgPGJ1dHRvbj5NYWtlIFNVQ0NFU1M8L2J1dHRvbj4KCSA8L3A+CgkgPC9mb3JtPgogICAKCSA8Zm9ybSBhY3Rpb249J2h0dHBzOi8vc3RhZ2UtY2IxLnhwYXkuY29tLnVhL2R1bW1lcmNiM2RzLzIxNDc1NDk0MDQvOTcxNTcyMy9ZTTNOeC04VHp6THYvc21wL2ZhaWwnIG1ldGhvZD0nR0VUJz4KCSA8cCBzdHlsZT0idGV4dC1hbGlnbjogY2VudGVyIj4KCSA8YnV0dG9uPk1ha2UgRkFJTDwvYnV0dG9uPgoJIDwvcD4KCSA8L2Zvcm0+CiAgIAogICAKCSA8Zm9ybSBhY3Rpb249J2h0dHBzOi8vc3RhZ2UtY2IxLnhwYXkuY29tLnVhL2R1bW1lcmNiM2RzLzIxNDc1NDk0MDQvOTcxNTcyMy9ZTTNOeC04VHp6THYvc21wL2V5SmtZWFJoSWpwN0luUnZjR2xqSWpvaU56SmhPR1JrWWpndE9URTBOUzAwWVRReExXRm1NV0V0T0dNME9HVmpZV0UwWW1VeExURXdNVEF5TFc5V2NVSnRZazVXY21aWVR6VndjMWRmY1hkRFVXY2lMQ0pqWlc1MGNubGtZWFJoSWpwN0lsSmxZWE52YmlJNklqRTRJaXdpY21WemRXeDBJam8zTkgxOUxDSmxlSFIwY21GdWMyRmpkR2x2Ym1sa0lqb2lNQ0lzSW1kaGRHVmhjR2tpT2lKMGIwTmxiblJ5YVdaMVoyOGlMQ0puWVhSbGFXUWlPakFzSW1kaGRHVndZWEpoYlNJNmV5Sm5ZWFJsYVdRaU9pSXhOekl6SWl3aWNtVnpkV3gwSWpvaU1UQWlMQ0p4ZFZObGNuWnBZMlVpT2lKeGRUSmpaVzUwY21sbWRXZHZJbjBzSW14dloybGtJam96TVRZMk5qTXpNeXdpYjNCbGNtRjBhVzl1YVdRaU9qazNNVFUzTWpNc0ltOXdaWEpoZEdsdmJuUjVjR1VpT2lJeE1ERXdNaUlzSW5CaGNuUnVaWEowYjJ0bGJpSTZJamN5WVRoa1pHSTRMVGt4TkRVdE5HRTBNUzFoWmpGaExUaGpORGhsWTJGaE5HSmxNU0lzSW5SeVlXNXpZV04wYVc5dWFXUWlPakl4TkRjMU5EazBNRFFzSW5SeVlXNXpZV04wYVc5dWMzUmhkSFZ6SWpvd2ZRPT0nIG1ldGhvZD0nR0VUJz4KCSA8cCBzdHlsZT0idGV4dC1hbGlnbjogY2VudGVyIj4KCSA8YnV0dG9uPk1ha2UgNzQ8L2J1dHRvbj4KCSA8L3A+CgkgPC9mb3JtPgogICAKCTwvYm9keT4KICAgPC9odG1sPg==",
"LongPollerID": "9715723",
"OperationDate": "2024-08-20T13:43:11.211816+03:00",
"OperationID": 9715723,
"OperationStatus": 2
},
"KeyAES": "",
"Sign": ""
}
~~~
</details>
:::

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

[[10101] Карта-карта](https://hackmd.io/ZpBbYAb4RsaTc8NU_0zwfA)
[[10103] Карта-IBAN фізична особа](https://hackmd.io/mQFXiO1USRuVX2-ah4h1FQ)
[[101031] Карта-IBAN юридична особа](https://hackmd.io/-jgdOWRiRwaabSv5_YjAKQ)
[[10150/10051] Карта-телефон-карта](https://hackmd.io/rXZuYXYwQp2W-QffXO99yA)

**Оплата по токену**
[[104021] Оплата картою по токену](https://hackmd.io/CCEZ0su4T3OBtY-_QBSzew)
[[1040217] Пакетна оплата карткою по токену](https://hackmd.io/UvXgiPdmRGOs0hwDtc_CEQ)
[[104121] Автосписання з карти по токену (МОТО-операції)](https://hackmd.io/-_Rj-iqZTMy22FxFgUc08w)

**Отримання даних карти**
[[20400/20410] Отримання даних карти за номером телефону](https://hackmd.io/EjF35e_sSfKad2ojsEoYWQ)
[[20404] Отримання даних карти за токеном](https://hackmd.io/Fo0-oeZ4Sz-Gju6Qg01hiA)

**Отримання даних по проведеній операції**
[[20003] Отримання статусу операції](https://hackmd.io/fvd8btZLQXywluia6w5uxg)
[[20009] Отримання ліміту по операції [10101]](https://hackmd.io/a-XSuzvRvG9t9cU2yoUvg)
[[20110] Отримання даних карти](https://hackmd.io/zFCegCSASKKjGCmoJkTYmw)

**Повернення коштів**
[[30201/302013/302015] Відміна/повернення платежу, здійсненого через запити [10102/101023/101025]](https://hackmd.io/W25MdduPQFidcqLdTWIbpg)

## Довідкові матеріали

Опис загальних параметрів системи XPAY див. у розділі ["Довідкові матеріали"](https://hackmd.io/aBE7H5cfQ-iqaN3SnwaQ-w): коди типів операцій, типи платіжних методів, коди статусів обробки операцій, відомості та помилки, що повертаються у відповіді та ін.

:arrow_left: [На Головну](/Mj2ZqCVpSq6A6Jzm6ladlw)
:arrow_left: [Загальна інформація по підключенню (API)](https://hackmd.io/g3cItPVFStez0ql3Xj-2TA)

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

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