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

# [20404] Отримання даних карти за токеном

*Що таке "оплата по токену" та як відбувається токенізація карт див. у розділі ["Оплата по токену"](https://hackmd.io/U6K080xgRw62OXEMXq7EbA).*

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

Запит [20404] застосовується для отримання даних карти при повторній взаємодії з клієнтом. Для цього передається токен картки клієнта - у відповідь Оператор надсилає збережені на сервері дані картки клієнта.

## Запит

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

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

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

| Параметр | Обов'яз-ковість | Тип | Опис | Приклад|
|:----:|:----:|:----:|----|:----:|
| `UserID` | Так | Рядок | Унікальний ідентифікатор клієнта у системі Партнера: телефон або email. |`380932799111`|
|`ClientToken`|Так|Рядок|Токен картки клієнта.|`72a8ddb8-9145-4a41-af1a-8c48ecaa4be1`|

## Відповідь

*Загальна інформація по формуванню структури відповіді наведена у розділі [“Загальна інформація по підключенню (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).*

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

Успішна відповідь на запит [20404] містить структуру даних `CardData`, в якій передаються дані картки:

| Параметр | Обов'яз-ковість | Тип | Опис | Приклад|
|:----:|:----:|:----:|----|:----:|
|`PAN`|Так|Рядок| PAN картки (номер банківської карти).| `8888888888888888` |
|`ExpMon`|Так|Рядок|Місяць терміну дії картки.|`02`|
|`ExpYear`|Так|Рядок|Останні 2 цифри року терміну дії картки.|`22`|
|`CardName`|Так|Рядок|Назва картки клієнта. |`картка Приватбанку`|
|`Token`|Так|Рядок|Токен картки клієнта.|`72a8ddb8-9145-4a41-af1a-8c48ecaa4be1`|

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

:::info

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

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

~~~md
{
"Partner": {
"PartnerToken": "72a8ddb8-9145-4a41-af1a-8c48ecaa4be1",
"OperationType": 20404
},
"Data": "{\"UserID\": \"380273332233\", \"ClientToken\": \"3ce2e9c4a3ad6f4391a0a1c036ce85ce3755647c5bac38a41cc1fd62d9aff305\"}",
"KeyAES": "",
"Sign": ""
}
~~~
</details>

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

~~~md
{
"Code": 200,
"Message": "Done",
"Data": {
"CardData": {
"CardName": "Mono",
"ExpMon": "06",
"ExpYear": "26",
"Pan": "5375272727272727",
"Token": "3ce2e9c4a3ad6f4391a0a1c036ce85ce3755647c5bac38a41cc1fd62d9aff305"
},
"OperationDate": "2023-03-14T12:30:58.72778+02:00",
"OperationID": 9497399,
"OperationStatus": 10
},
"KeyAES": "",
"Sign": ""
}
~~~
</details>
:::

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

[[10101] Карта-карта](https://hackmd.io/ZpBbYAb4RsaTc8NU_0zwfA)
[[10102/101023/101025] Карта-гаманець](https://hackmd.io/jxzgAy4nSt-Q-6chgRCZdQ)
[[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)

**Отримання даних по проведеній операції**
[[20003] Отримання статусу операції](https://hackmd.io/fvd8btZLQXywluia6w5uxg)

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

Опис загальних параметрів системи 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>