Update Cardholder Details (V2)

<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 is 13.

Mandatory

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

Optional

<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

<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

<newAccCode>

AN

0

6

The new access code for the card.

This can be updated by the primary card and by additional cards that share the same customer record. If provided, must be 6 digits, leading zeroes are acceptable. Leave empty if not required.

Optional

<lastName>

AN

1

20

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

C

<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

Optional

<Title>

AN

1

4

Cardholder’s title. This can be updated by the primary card and by additional cards that share the same customer record.

Optional

<firstName>

AN

1

20

Cardholder's first name. Also used as the card purchaser's first name if no delivery address is supplied. Mandatory if <lastName> is present

and the value of <AuthType> is not ‘6’.

Conditional

<addr1>

AN

1

50

Cardholder's address line 1. Also used as the card purchaser's address line 1 if no delivery address is supplied. Mandatory if ‘Address’ fields are specified.

Conditional

<addr2>

AN

1

50

Cardholder's address line 2. Also used as the card purchaser's address line 2 if no delivery address is supplied.

Optional

<addr3>

AN

1

50

Cardholder's address line 3. Also used as the card purchaser's address line 3 if no delivery address is supplied.

Optional

<city>

AN

1

50

Cardholder's home city. Also used as the card purchaser's city if no delivery address is supplied. Mandatory if <addrL1> is present, and <postcode> is not present.

Conditional

<postcode>

AN

1

10

Conditional

<country>

AN

1

3

Cardholder’s country of residence. This is represented as a 3 digit ISO country code (e.g. 826 for UK). Mandatory if <addrL1> is present.

Conditional

<tel>

AN

1

20

Telephone number. See Processing of Phone Numbers.

Optional

<Workaddr1>

AN

1

35

Work address line 1. Mandatory if work address fields are being specified. If set to <space>, then clears all work address fields.

Conditional

<Workaddr2>

AN

1

35

Work address line 2.

Optional

<Workaddr3>

AN

1

35

Work address line 3.

Optional

<Workcity>

AN

1

15

Work city. Mandatory if <workAddrL1> is present, and <workPostcode> is not present.

Conditional

<Workpostcode>

AN

1

10

Work postcode. Mandatory if <addrL1> is present, and <workCity> is not present. See Postcode Permitted Characters.

Conditional

<Workcounty>

AN

1

20

Work county.

Optional

<Workcountry>

AN

1

3

Work country of residence. This is represented as a 3 digit ISO country code (e.g. 826 for UK). Mandatory if <workAddrL1> is present.

Conditional

<Worktel>

AN

1

20

Work telephone number. See Processing of Phone Numbers.

Optional

<email>

AN

1

64

Email address of the cardholder.

Optional

<fax>

AN

1

20

Fax number.

Optional

<mobTel>

AN

1

25

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

Optional

<maritalStatus>

AN

1

1

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

Optional

<sex>

AN

1

1

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

Optional

<embossName>

AN

1

27

Name embossed on the card. Note that actual embossed name does not change until the card is re-issued. This can be updated by the primary card and by additional cards that share the same customer record.

Optional

<discret>

AN

1

25

Discretionary data, for information only.

Optional

<userdata>

AN

1

30

Cardholder information stored at card level, free text field.

Optional

<userdata1>

AN

1

12

Cardholder information stored at member level, free text field.

Optional

<userdata2>

AN

1

12

Cardholder information stored at member level, free text field.

Optional

<userdata3>

AN

1

12

Cardholder information stored at member level, free text field.

Optional

<userdata4>

AN

1

32

Cardholder information stored at member level, free text field.

Optional

<imageID>

AN

1

16

ID of the card manufacturer image to be printed on the card. This can be updated by the primary card and by additional cards that share the same member record.

Optional

<brncode>

AN

8

8

Branch code (or Agent code) with which the card is associated. This can be updated by the primary card and by additional cards that share the same member record.

Optional

<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

Optional

<itemSrc>

N

1

5

Source field to define alternate fees. Legacy field for information purposes only; see Item Source Types. Suggest using 0.

Mandatory

<dlvTitle>

AN

4

16

Delivery address title.

Optional

<dlvfirstName>

AN

1

20

Delivery first name. Mandatory if <dlvLastName> is present.

Conditional

<dlvmiddleName>

AN

1

50

Delivery middle name.

Only available in V2

Optional

<dlvlastName>

AN

1

20

Delivery last name.

Mandatory if delivery name fields are being specified.

Conditional

<dlvaddr1>

AN

1

50

Delivery address line 1.

Mandatory if delivery address fields are being specified.

Conditional

<dlvaddr2>

AN

1

50

Delivery address line 2.

Optional

<dlvaddr3>

AN

1

50

Delivery address line 3.

Optional

<dlvcity>

AN

1

50

Delivery city. Mandatory if <dlvAddrL1> is present, and <dlvPostcode> is not present.

Conditional

<dlvpostcode>

AN

1

10

Delivery postcode. Mandatory if <dlvAddrL1> is present, and <dlvCity> is not present. See Postcode Permitted Characters.

Conditional

<dlvcounty>

AN

1

20

Delivery county.

Optional

<dlvcountry>

AN

1

3

Card purchaser's /delivery address country 3-digit ISO country code (e.g., 826 for UK). Mandatory if <dlvAddrL1> is present.

Conditional

<crdprogram>

AN

1

6

Pre-defined program reference code associated with the card. This can be updated by the primary card and by additional cards that share the same customer record.

Optional

<ProductRef>

AN

1

50

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

Note: This field serves dual purposes and can also be used during mobile wallet tokenisation, to specify which card profile (image artwork and terms and conditions) the card scheme should use. For details, see the Tokenisation Service Guide.

Optional

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

Optional

<SmsBalance>

N

1

1

Whether to send an SMS regarding the details of transaction amount and available balance to the customer after each card use. 0 or False = Do not send; 1 or True = Send; 2 = Do not change current value.

Mandatory

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

Optional

< VanityName>

AN

1

32

Enables you to add an additional alternative form of title to the card, e.g. “Company Director”. Can appear on Embossed Line 4, or Thermal Line 1 and Thermal Line 2, if configured in Smart Client, and be recorded in the card purchaser details.

Optional

< CarrierType>

AN

1

30

The Carrier Product design reference as used by the Card Manufacturer. This is the letter onto which the card is attached when sent to the cardholder. Identifies the Carrier Product type of the Card Manufacturer.

Optional

<Fulfil1>

AN

1

50

Free text field for transferring extra information to the card manufacturer, for example, to be printed on the Carrier. Identifies the FULFIL1 field in the XML file sent to the card manufacturer.

Optional

<Fulfil2>

AN

1

50

Free text field for transferring extra information to the card manufacturer, for example, to be printed on the Carrier. Identifies the FULFIL2 field in the XML file sent to the card manufacturer.

Optional

<ThermalLine1>

AN

1

120

Free text field for transferring extra information to be printed on the card. For example, to add a customer service phone number.

Optional

<ThermalLine2>

AN

1

70

Free text field for transferring extra information to be printed on the card. For example, to add a link to your service terms and conditions.

Optional

<EmbossLine4>

AN

1

27

The card’s embossed line 4 on the front of the card. Could be used for example, to add an account number or sort code.

Optional

<LogoFrontId>

AN

1

30

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

Optional

<LogoBackId>

AN

1

30

Reference which identifies the card manufacturer's logo file that is printed on the back of the card, if supported.

Optional

<Delv_Code>

AN

1

12

The delivery code for the card. If specified, the card manufacturer sends all cards with the same delivery code to the specified delivery address.

Optional

<Url>

AN

1

100

This value is included in the Thredd Card Generation file, in the <QRCode> field. For example: https://www.your-e-card.com/balance/2909680989632389

For details, see the Card Generation Interface Specifications.

Optional

<OptOut>

Boolean

1

1

Flag for opting out of Visa Account Updater (VAU) or the Automatic Billing Updater (ABU) service for Mastercard.

Optional