Card Data XML Structure

PCI Booking stores and returns card data in a standard XML format. This structure is used when migrating cards via the API and when retrieving card data through token replacement.

Full Card Data

<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 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:

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

Card Fields

Field	Description	Example
Type	Card brand (2 to 16 characters). See Supported 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>:

<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

Start Here

Getting Started

Guides

Concepts

Capture Cards

Payments Library

Manage Tokens

Use Tokens

Account Configuration

Additional Functions

Reference

Support

Card Data XML Structure

Full Card Data

Tokenized (Masked) Card Data

Card Fields

Virtual Card Fields

​Full Card Data

​Tokenized (Masked) Card Data

​Card Fields

​Virtual Card Fields

Full Card Data

Tokenized (Masked) Card Data

Card Fields

Virtual Card Fields