Card Data XML Structure
<BankCardDetails xmlns="http://www.pcibooking.net/reservation"
schemaVersion="1.0">
<BankCard>
<Type>Visa</Type>
<Virtual isMultiuse="false" currency="AUD" maxAmount="500"
cardRules="Chapter 11" validFromMonth="08" validFromDay="31"
validFromYear="2014" validToMonth="11" validToDay="1"
validToYear="2017"/>
<Number>4580458045804580</Number>
<NameOnCard>MR Y. ALON</NameOnCard>
<ExpirationDate>
<Month>04</Month>
<Year>2023</Year>
</ExpirationDate>
<IssueNumber>2</IssueNumber>
<CVV>306</CVV>
</BankCard>
</BankCardDetails>
<?xml version='1.0' encoding='utf-8'?>
<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>458045******4580</Number>
<NameOnCard>MR Y. ALON</NameOnCard>
<ExpirationDate>
<Month>04</Month>
<Year>2023</Year>
</ExpirationDate>
<IssueNumber>2</IssueNumber>
</BankCard>
XML Description
The following fields are applicable to all cards - depending on the card type and region, a specific field may or may not be required.
Field name | Description | Example |
---|---|---|
Type | Type of bank card. A string, from 2 to 16 characters | Visa |
Number | Payment card number: Max 19 - numeric | 4580458045804580 |
NameOnCard | Cardholder name | |
ExpirationMM | Expiration month. Digits without max limit (within expiration date). If the third party sends a different date format, the date will be stored here. | Can be - 01, 02, ..., 12. or store the whole date:012019; 0119 |
ExpirationYYYY | Expiration year: should be 4 digits: YYYY (within expiration date) | 2019 |
IssueNumber | An additional set of numbers found in the some of the cards | 1 |
OwnerID | Cardholder ID | |
CVV | Card verification number: a 3-4 digit number used to verify payment card | 345 |
If this is a virtual card, you can add the following card details to the token:
Field name | Description | Example |
---|---|---|
Virtual isMultiuse | Card can be used one time or multiple times | true or false |
maxAmount | Max amount for card use | 500 |
currency | Max amount currency | AUD |
VccCardRules | Rules for clearing VCC: a string | valid to the checkout date |
ValidFromDay | The day when Property can start using the card: DD | 25 |
ValidFromMonth | The month when Property can start using the card: MM | 8 |
ValidFromYear | The year when Property can start using the card:YYYY | 2014 |
ValidToDay | The day when the card is no longer valid for use: DD | 1 |
ValidToMonth | The month when the card is no longer valid for use:˙MM | 11 |
ValidToYear | The year when the card is no longer valid for use: YYYY | 2017 |
Once the card has been tokenized, the XML of the card data would look the same except for the following differences:
- The card number will show the first 6 digits and the last 4 digits of the card number. The rest will be replaced with *.
- The CVV, if provided in the original request, will not be displayed in the response.
Updated over 4 years ago