Cardholder Details Enquiry

<WSID>

N

1

19

Web service ID. Must be unique for every request. For details, see the FAQs.

Mandatory

<IssCode>

AN

1

4

Thredd Issuer (Program Manager) Code. Assigned by Thredd.

Mandatory

<TxnCode>

AN

1

2

The Transaction Code. See Transaction Codes. Default value 13.

Mandatory

<LocDate>

YYYY-MM-DD

10

10

The local current date in year-month-date format.

Mandatory

<LocTime>

HHMMSS

6

6

The local current time, in hour-minute-second format.

Mandatory

<AuthType>

AN

1

1

Parameter to specify how the card is authenticated. See Authentication Methods.

Mandatory

<PAN>

AN

14

19

Card Number. Unique card identifier.

Conditional

<Track2>

AN

1

40

The card’s Track 2. Mandatory in request if <PAN> and <PublicToken> are not present or when <AuthType> is ‘7’.

Conditional

<PublicToken>

AN

1

9

The card’s public token, Mandatory in request if <PAN> and <Track2> are not present. Mandatory in the response.

Conditional

<DOB>

YYYY-MM-

DD

10

10

Date of Birth. Mandatory if value of <AuthType> is ‘2’ or ‘6’.

Conditional

<CVV>

AN

3

3

Card Verification Value The Card Verification Value (CVV) on a credit card or debit card is a 3 digit number on VISA, MasterCard and Discover branded credit and debit cards. Cardholder's are typically required to enter the CVV during any online or cardholder not present transactions. CVV numbers are also known as CSC numbers (Card Security Code), as well as CVV2 numbers, which are the same as CVV numbers, except that they have been generated by a 2nd generation process that makes them harder to guess., the 3-digit code printed on the back of the card. Mandatory if the value of <AuthType> is ‘3’.

Conditional

<AccCode>

AN

0

6

Access code or passcode. If provided, must be 6 digits, leading zeroes are acceptable. Leave empty if not required. Mandatory if the value of <AuthType> is ‘4’.

Conditional

<CrdProduct>

AN

4

4

Card product associated with the card. Legacy field.

Omit

<ClientCode>

AN

1

64

User ID of the customer using the service. Only applicable to systems using member logins. Returned in the response if present in the request. Note: Legacy field. Not used.

Not available in V2.

Conditional

<CustAccount>

AN

1

25

Cardholder account number or reference number. You can use this reference to find the cards linked to a cardholder. Also displayed in Smart Client and in Thredd Portal as Customer Reference.

Only available in V2

Omit

<ItemSrc>

N

1

5

Source field which defines the item source type. See Item Source Types. If used, overrides any existing fees for using this web service.

Mandatory

<LastName>

AN

1

20

Cardholder's last name for authenticating the cardholder if the value of <AuthType> is ‘6’.

Conditional

<StatCode>

AN

2

3

The status code of the card. See Status Codes.

Omit

<Title>

AN

1

4

Cardholder’s title.

Omit

<MiddleName>

AN

1

100

Cardholder's middle name. The <MiddleName> is not part of the <EmbossName> and therefore, does not check manufacture-approved characters. If a delivery address is not supplied, the cardholder's middle name will be the card purchaser's middle name.

Only available in V2

Omit

<FirstName>

AN

1

20

Cardholder’s first name.

Omit

<Addrl1>

AN

1

50

Address line 1.

Omit

<Addrl2>

AN

1

50

Address line 2.

Omit

<Addrl3>

AN

1

50

Address line 3.

Only available in V2

Omit

<City>

AN

1

50

City.

Omit

<PostCode>

AN

1

10

Postcode.

Omit

<Country>

AN

1

3

Cardholder’s country of residence. This is represented as a 3 digit ISO country code (e.g. 826 for UK).

Omit

<Tel>

AN

1

15

Telephone number. See Processing of Phone Numbers.

Omit

<WorkAddrl1>

AN

1

35

Work address line 1.

Omit

<WorkAddrl2>

AN

1

35

Work address line 2.

Omit

<WorkAddrl3>

AN

1

35

Work address line 3.

Omit

<WorkCity>

AN

1

15

Work city.

Omit

<WorkPostCode>

AN

1

10

Work postcode.

Omit

<WorkCounty>

AN

1

20

Work county.

Omit

<WorkCountry>

AN

1

3

Work country of residence. This is represented as a 3 digit ISO country code (e.g. 826 for UK).

Omit

<WorkTel>

AN

1

15

Work telephone number. See Processing of Phone Numbers.

Omit

<EMail>

AN

1

64

Email address of the cardholder.

Omit

<Fax>

AN

1

20

Fax number.

Omit

<PObox>

AN

1

8

Post office box number.

Omit

<MobTel>

AN

1

15

Cardholder’s mobile phone number (including dialing code if applicable). See Processing of Telephone Numbers.

Omit

<MaritalStatus>

AN

1

1

Marital status: S= single; M= married; D = divorced; W = widowed; space = not specified.

Omit

<Sex>

AN

1

1

Gender: M = male; F= female; space= Not specified.

Omit

<AccNo>

AN

1

28

Account number of the card.

Not available in V2.

Omit

<EmbossName>

AN

1

27

Name embossed on the card.

Omit

<RefuseCheck>

AN

1

1

Whether cheques should be refused.

0 = No; 1= Yes. For customer use only. Thredd ignore this field.

Omit

<MailShots>

AN

1

1

Whether the cardholder accepts mailshots or member contact. 0 = No; 1 = Yes

For customer use only. Thredd ignore this field.

Omit

<Discret>

AN

1

25

Discretionary data, for customer use only. Thredd ignores this field.

Omit

<UsrData>

AN

1

30

Cardholder information stored at card level, free text field. For customer use only. Thredd ignores this field.

Omit

<UsrData1>

AN

1

12

Cardholder information stored at member level, free text field. For customer use only. Thredd ignores this field.

Omit

<UsrData2>

AN

1

12

Cardholder information stored at member level, free text field. For customer use only. Thredd ignores this field.

Omit

<UsrData3>

AN

1

12

Cardholder information stored at member level, free text field. For customer use only. Thredd ignores this field.

Omit

<UsrData4>

AN

1

32

Cardholder information stored at member level, free text field. Thredd ignores this field.

Omit

<CurrCode>

AN

1

3

3-letter ISO currency code for the account billing currency.

Omit

<ExpDate>

YYYY-MM-DD

10

10

Expiry date of the card in YYYY-MM-DD format. This is the Thredd expiry date. If the Thredd expiry date is not set, this is the expiry date printed on the card.

Omit

<EffDate>

YYYY-MM-DD

10

10

The issue date of the card. If the issue date is not set, then is the <DateCreated>.

Omit

<SvcCode>

AN

1

3

Card Service Code 3 digit code on the magnetic strip of a card which indicates where it is valid for use.. The three-digit number which indicates where the card is valid for use.

Omit

<AdditionalNo>

N

1

1

Number of additional cards. Zero indicates the card is a primary card. Currently always set to 0.

Reserved for future use.

Omit

<DateCreated>

YYYY-MM-DD

10

10

The date created, or the issue date of the card if this is set.

Omit

<DateActivated>

YYYY-MM-DD

10

10

Date the card was activated in the system.

Omit

<CrdDesign>

AN

1

50

The card manufacturer's card design reference. Also known as PRODUCT_REF in the XML file sent to the card manufacturer.

Omit

<PIN>

AN

1

1

Indicates whether the card should have a PIN: 0=No; 1=Yes

Reserved for future use

Omit

<DlvMethod>

AN

1

1

The delivery method for the card. Options include:

0 = Standard delivery;

1 = Registered mail;

2 = Direct delivery;

3 = Customized DelvMethod 1;

4 = Customized DelvMethod 2;

5 = Customized DelvMethod 3;

6= Customized DelvMethod 4;

7 = Customized DelvMethod 5;

Default value is 0

Omit

<ImageID>

AN

1

16

Reference which identifies the card manufacturer's image file that is printed on the face of the card.

Omit

<BrnCode>

AN

8

8

Branch code (or Agent code) with which the card is associated.

Omit

<ReNew>

AN

1

1

Indicates whether the card should be renewed on expiry: 0= No; 1= Yes.

Omit

<DenyMCC>

AN

1

192

List of MCC’s (merchant category codes) that are denied for the card. MCC’s can be comma-separated, specified as a range, or combinations of both(e.g., 4546,5462,5667-5673,5957). These restrictions are in addition to MCC restrictions defined at the card product level.

Legacy field. Do not use.

Omit

<DenySVC>

AN

1

64

Omit

<AccType>

AN

2

2

Type code for the account associated with the card.

Legacy field. Not used.

Omit

<CVC2>

AN

3

3

Card Verification Value The Card Verification Value (CVV) on a credit card or debit card is a 3 digit number on VISA, MasterCard and Discover branded credit and debit cards. Cardholder's are typically required to enter the CVV during any online or cardholder not present transactions. CVV numbers are also known as CSC numbers (Card Security Code), as well as CVV2 numbers, which are the same as CVV numbers, except that they have been generated by a 2nd generation process that makes them harder to guess., the 3-digit code printed on the back of the card.

Omit

<DlvTitle>

AN

4

16

Delivery address title.

Omit

<DlvFirstName>

AN

1

20

Delivery first name.

Omit

<DlvMiddleName>

AN

1

50

Delivery middle name.

Only available in V2

Omit

<DlvLastName>

AN

1

20

Delivery last name.

Omit

<DlvAddrL1>

AN

1

50

Delivery address line 1.

Omit

<DlvAddrL2>

AN

1

50

Delivery address line 2.

Omit

<DlvAddrL3>

AN

1

50

Delivery address line 3.

Omit

<DlvCity>

AN

1

50

Delivery city.

Omit

<DlvPostcode>

AN

1

10

Delivery Post code

Only available in V2.

Omit

<DlvCounty>

AN

1

20

Card purchaser's /delivery address county.

Omit

<DlvCountry>

AN

1

3

Card purchaser's /delivery address country 3-digit ISO country code (e.g., 826 for UK).

Omit

<DlvTel>

AN

1

20

Delivery telephone number.

Omit

<DlvEffDate>

YYYY-MM-DD

10

10

Date at which the delivery name and/or address became effective. If not present, the current date is the effective date.

Legacy field. Not used.

Omit

<DlvExpDate>

YYYY-MM-DD

10

10

Date after which the delivery name and/or address expires. Mandatory if name and/or address delivery fields are present.

Legacy field. Not used.

Omit

<SysDate>

YYYY-MM-DD

10

10

The system processing date.

Omit

<ActionCode>

AN

3

3

The action code for the response. See Action Codes.

Omit

<IsoLang>

AN

2

2

The language code in ISO 639-1 format. The language is used for card mailers, and also used if bespoke SMS templates are set up.

Omit