On this page:
Overview
Customer fields can be passed using a CustomerXML document to provide more accurate fraud screening.
XML Tags
The XML tags should follow the order they are listed in the following table.
Node/Element |
Description |
Mandatory |
Format and Valid Characters |
Max Length |
Allowed Values |
---|---|---|---|---|---|
customer |
The root element for all other customer elements. |
No |
Node |
|
|
customerMiddleInitial |
The customer's middle initial. |
No |
Uppercase letter |
1 |
|
customerBirth |
The customer's date of birth. |
No |
Digits and hyphens |
10 |
Date as YYYY-MM-DD |
customerWorkPhone |
The customer's work phone number in the format of: plus, country-code, dialling code less its leading zero, and phone-number. For example, a UK phone number of 01234 567891 must be written as: +44 1234 567891
Required, conditional on market or regional mandate restricting sending this information. |
Conditional |
Letters, digits, hyphens, spaces, parentheses, and plus |
19 |
|
customerMobilePhone |
The customer's mobile phone number in the format of: plus, country-code, dialling code less its leading zero, and phone-number. For example, a UK phone number of 01234 567891 must be written as: +441234567891
Required, conditional on market or regional mandate restricting sending this information although we recommended you populate this field toward a successful Authentication. It can prevent your customer from being challenged during Authentication. |
No |
Letters, digits, hyphens, spaces, parentheses, and plus
|
19 |
|
previousCust |
Is the customer a new or returning customer? Validation:
|
No |
BOOLEAN |
|
|
timeOnFile |
The number of days since the card was first recorded. |
No |
Digits, hyphens, spaces, and plus |
16 |
Min Value 0 |
customerId |
The customer's ID |
No |
Letters and digits |
16 |
|
Example XML
Line breaks are added for ease of review.
<customer> <customerMiddleInitial>W</customerMiddleInitial> <customerBirth>1983-01-01</customerBirth> <customerWorkPhone>+44201234567</customerWorkPhone> <customerMobilePhone>+44799123456</customerMobilePhone> <previousCust>0</previousCust> <timeOnFile>10</timeOnFile> <customerId>CUST123</customerId> </customer>