---
# System prepended metadata

title: '[20110] Get Card Data'

---

[УКР](https://hackmd.io/zFCegCSASKKjGCmoJkTYmw) | ENG
![](https://i.imgur.com/ULmPUgP.jpg)
:arrow_left: [Guide](https://hackmd.io/QA2NYRliRLGviJl5P4-ZCw)

# [20110] Get Card Data

## Usage

Request [20110] is used to get card data by card number.

## Request

*See the description of the "Partner", "KeyAES" and "Sign" attributes in the section "[General API Integration Information](https://hackmd.io/ijxPm0xtTpycgTjuU_NHQQ)".*


### Data Structure

The "Data" structure for this operation is formed from only one `Pan` parameter:


|Parameter|Required|Type|Description|Example|
|:----:|:----:|:----:|----|:----:|
| `PAN` | Yes | String[16] | Сlient card PAN (bank card number). |`8888888888888888`|

:::success
<details>
<summary>Example of the "Data" structure"</summary>
<br>

~~~
{
    "Pan": "1234123412341234"
}
~~~
</details>
:::


## Response

*See the general information on the response structure formation in the section "[General API Integration Information](https://hackmd.io/ijxPm0xtTpycgTjuU_NHQQ?view#Response-Structure)"*.

### Data Structure

Successful response to the request [20110] is formed from the following parameters:

|Parameter|Required|Type|Description|Example|
|:----:|:----:|:----:|----|:----:|
|`PaySystem`|Yes|String|International payment system. |`Visa`|
|`Bank`|Yes|Structure|Structure transmits the bank name issuing the card: </br> `uk` - in Ukrainian; </br> `en` - in English. |`"ПАТ_"МТБ БАНК"` </br> `"PJSC_"MTB_BANK"`|
| Country | Yes |String | Country code. |`UKR`|
| `ProductName`| Yes |String | Card name. |`CREDIT CLASSIC`|
| `CardZone`| Yes  | String | Transfer type for this card. Valid values: `LOCAL`, `DOMESTIC`, `CROSS_BOARD`, `FORBIDDEN`. |`LOCAL`|


### Response Examples

:::success
<details>
<summary>Operation Successfully Completed</summary>
<br>

~~~md
{
   "Code": 200,
   "Message": "done",
   "Data": {
     "PaySystem": "VISA",
     "Bank": {
       "uk": "ПАТ "МТБ БАНК",
       "en": "PJSC "MTB BANK"
     },
     "Country": "UKR",
     "CardZone": "LOCAL",
     "ProductName": "CREDIT CLASSIC",
     "OperationID": 35444,
     "OperationStatus": 10
   },
   "KeyAES": "",
   "Sign": ""
}
~~~
</details>
:::


:::success
<details>
<summary>Operation Failed - BIN Not Found</summary>
<br>

~~~md
{
   "Code": 400,
   "Data": {
     "Reason": 736,
     "OperationStatus": 21
   },
   "Message": "BIN not found"
}
~~~
</details>
:::


## Related Requests

[[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)
[[20008] Get Exchange Rate](https://hackmd.io/k_ZnVoMwQ-i4WelDZ0wtZA)
[[20009] Get Limit for Operation [10101]](https://hackmd.io/rQ7epWnbQmG9kM0rFjUfhA)


## Reference Materials

General parameters of the XPAY system are given in the section ["Reference Materials"](https://hackmd.io/16yLv895Qo-FWTvrWWQwbg):  operation types, payment types, response codes, operation status, reasons of operation rejection, etc.


![](https://i.imgur.com/17gAyWb.png)
: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: +38 093 891 92 00
Email: info@xpay.com.ua
Telegram: @xpaysupportbot
</details>



