> ## Documentation Index
> Fetch the complete documentation index at: https://developers.pcibooking.net/llms.txt
> Use this file to discover all available pages before exploring further.

# Card Data XML Structure

> XML schema for card data elements used in token replacement and card display requests. Field definitions and examples.

PCI Booking stores and returns card data in a standard XML format. This structure is used when [migrating cards](/capture-cards/store-card-migration) via the API and when retrieving card data through [token replacement](/use-tokens/token-replacement-in-request).

## Full Card Data

```xml theme={null}
<BankCardDetails xmlns="http://www.pcibooking.net/reservation"
                 schemaVersion="1.0">
  <BankCard>
    <Type>Visa</Type>
    <Number>4580458045804580</Number>
    <NameOnCard>MR Y. ALON</NameOnCard>
    <ExpirationDate>
      <Month>04</Month>
      <Year>2023</Year>
    </ExpirationDate>
    <IssueNumber>2</IssueNumber>
    <OwnerID>123456789</OwnerID>
    <CVV>306</CVV>
  </BankCard>
</BankCardDetails>
```

## Tokenized (Masked) Card Data

After tokenization, the XML returned by PCI Booking masks sensitive fields:

```xml theme={null}
<?xml version='1.0' encoding='utf-8'?>
<BankCard>
  <Type>Visa</Type>
  <Number>458045******4580</Number>
  <NameOnCard>MR Y. ALON</NameOnCard>
  <ExpirationDate>
    <Month>04</Month>
    <Year>2023</Year>
  </ExpirationDate>
  <IssueNumber>2</IssueNumber>
</BankCard>
```

Differences from the full card data:

1. The card number shows the first 6 and last 4 digits. The rest is replaced with `*`.
2. The CVV is removed entirely.

## Card Fields

| Field                | Description                                                                         | Example          |
| -------------------- | ----------------------------------------------------------------------------------- | ---------------- |
| Type                 | Card brand (2 to 16 characters). See [Supported Card Types](/reference/card-types). | Visa             |
| Number               | Card number, max 19 digits                                                          | 4580458045804580 |
| NameOnCard           | Cardholder name                                                                     | MR Y. ALON       |
| ExpirationDate/Month | Expiration month (MM)                                                               | 04               |
| ExpirationDate/Year  | Expiration year (YYYY)                                                              | 2023             |
| IssueNumber          | Additional number found on some cards                                               | 1                |
| OwnerID              | Cardholder's national ID number (required in some countries)                        | 123456789        |
| CVV                  | Card verification number, 3 or 4 digits                                             | 306              |

## Virtual Card Fields

Virtual cards include additional attributes on the `<Virtual>` element inside `<BankCard>`:

```xml theme={null}
<BankCard>
  <Type>Visa</Type>
  <Virtual isMultiuse="false" currency="AUD" maxAmount="500"
           cardRules="Chapter 11"
           validFromDay="31" validFromMonth="08" validFromYear="2014"
           validToDay="1" validToMonth="11" validToYear="2017" />
  <Number>4580458045804580</Number>
  <!-- other fields -->
</BankCard>
```

| Attribute      | Description                                 | Example      |
| -------------- | ------------------------------------------- | ------------ |
| isMultiuse     | Whether the card can be used more than once | true / false |
| maxAmount      | Maximum charge amount                       | 500          |
| currency       | Currency of the max amount                  | AUD          |
| cardRules      | Rules for clearing the virtual card         | Chapter 11   |
| validFromDay   | Day the card becomes valid (DD)             | 31           |
| validFromMonth | Month the card becomes valid (MM)           | 08           |
| validFromYear  | Year the card becomes valid (YYYY)          | 2014         |
| validToDay     | Day the card expires (DD)                   | 1            |
| validToMonth   | Month the card expires (MM)                 | 11           |
| validToYear    | Year the card expires (YYYY)                | 2017         |