Payment Token Get

<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. If only <IssCode> is present in the request then this method returns the pending fee details of all cards belonging to the given program manager.

Mandatory

<TxnCode>

AN

1

2

The Transaction Code. See Transaction Codes. Default value is 9.

Mandatory

<PAN>

N

14

19

Card Number. Unique card identifier.

Conditional

<PublicToken>

N

9

9

Thredd 9-digit public token of the card.

Conditional

<DPAN>

AN

16

19

Digital PAN value for the card.

Conditional

<Payment_Token_ID>

N

1

20

Payment token identifier for the MDES or VTS Card.

Conditional

<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

<Creator>

AN

1

10

Name of the system or process that created the token (e.g., MC-MDES and VISA-T).

Omit

<Creator_PAN_Ref>

AN

1

48

The token creator's unique reference to the linked card.

Omit

<Creator_Token_Ref>

AN

1

48

The token creator's unique reference for this payment token. (Mastercard Token Unique Reference (TUR) and Visa Token reference ID.)

Omit

<PANT>

N

16

19

PAN for the card linked to the MDES or VTS card.

Omit

<Payment_Token >

N

16

19

Payment token Device PAN for the MDES or VTS card.

Omit

<Payment_Token_ExpDate >

Date

10

10

Expiry date of the payment token.

Omit

<Payment_Token_ID>

N

1

20

Payment token identifier for the MDES or VTS card.

Omit

<Payment_Token_Type >

AN

1

2

Payment token type. See Payment Token Types.

Omit

<Wallet_ID>

AN

1

10

Name of the wallet provider this payment token uses (For example: APPLE, ANDROID, SAMSUNG, MRCHTOKEN).

Omit

<gps_status>

N

2

2

The Thredd status of the payment token for transacting. See Status Codes.

Omit

<Tokenised_Datetime>

DateTime

19

19

Date and time when tokenised, in the format: yyyy-mm-ddhhmmss.

Omit

<Tokenised_Status>

AN

1

1

Tokenised status of this payment token: U = unknown; 0 = not tokenised; 1=tokenised.

Omit

<Txn_Status>

AN

1

1

Status of the payment token as received from the payment token creator (normally Visa or Mastercard). After tokenisation, this is not changed by Thredd.

A = Active

D = Deleted (once in this status, it is normally never changed)

I = Inactive

N = Not Tokenised

P = Pending

S = Suspended

U = Unknown

X = Deactivated

Omit

<Txn_Status_Actor>

AN

1

10

Indicates which system last changed the transaction status.

Omit

<Txn_Status_Change_Datetime>

DateTime

16

16

Date and time that the transaction status was last changed. In the format: yyyy-mm-ddhhmmss.

Omit

<Accepted_Terms_Date_GMT>

DateTime

16

16

Date (in GMT) that terms and conditions were accepted by the cardholder (as received from the network).

Omit

<Accepted_Terms_Version>

AN

1

32

Version of the terms and conditions which were accepted by the cardholder  (as received from the network).

Omit

<Auth_Datetime>

DateTime

16

16

Date and time when the tokenisation request was last responded to.

Omit

<Auth_Decision>

AN

1

1

Final tokenisation decision:

U = unknown

0 = approve digitisation request

A = approve digitisation request (with additional authentication).

Omit

<Auth_RSPSRC>

AN

10

10

Name of the system or process that approved the tokenisation (e.g., MC-MDES and ISSUER).

Omit

<Auth_Status>

AN

1

1

Status of the authorisation to digitise this payment token:

U = unknown

0 = approve digitisation request

A = approve digitisation request (with additional authentication)

1 = decline digitisation request

Note: this is not the same as a transaction authorisation.

Omit

<Digitisation_Ref>

AN

1

64

Unique reference (per payment_token_issuer_id) which all digitisation messages use, to link them together.

Omit

<Wallet_Account_Score>

N

1

1

Risk score for the account, received from the wallet provider during digitisation:

1 = highest risk; 2 = higher risk

3 = neutral; 4 = lower risk; 5 = least risk

Omit

<Wallet_Device_Score>

N

1

1

Risk score for the device received from the wallet provider during digitisation:

1 = highest risk; 2 = higher risk

3 = neutral; 4 = lower risk; 5 = least risk

Omit

<Wallet_Reasons>

AN

0

24

Wallet service provider tokenization recommendation reason codes. This field can be null. See Wallet Tokenisation Reason Codes.

Omit

<Activation_Code>

AN

1

40

Activation code to be sent directly to the cardholder to activate this payment token.

Omit

<Activation_Code_Expdate

DateTime

16

16

Date and time when the activation code expires, in GMT (UTC) in the format: yyyy-mm-ddhhmmss.

Omit

<Activation_Method>

N

1

1

Which activation method was used:

0 = none;

1 = SMS to mobile phone;

2 = email;

3 = cardholder called an automated call centre;

4 = cardholder called a human call centre;

5 = website;

6 = mobile application;

7 = voice phone call

Omit

<Device_ID>

AN

1

48

Unique ID of the secure element in the device.

Omit

<Device_IP>

AN

1

15

IP address (full or last part only) of the device at time of binding / digitisation.

Omit

<Device_Lang2>

AN

1

2

Device language code as ISO 639-1 (2 letter lowercase) code.

Omit

<Device_Latitude>

N

1

3

Device latitude in degrees at time of digitisation request:  -90 (south pole) to +90 (north pole). +ve=North, -ve=South (from equator). Example: +63.2 = North 63.2 degrees, -82.6 = South 82.6 degrees.

Omit

<Device_Longitude>

N

1

3

Device longitude in degrees at time of digitisation request: -180 to +180; +ve = East, -ve = West (of Greenwich). Example: 176.2 = East 176.2 degrees, -98.5 = West 98.5 degrees.

Omit

<Device_Name>

AN

1

20

Name the cardholder assigned to the device in the wallet.

Omit

<Device_Tel_Num>

AN

1

15

Device telephone number (full or last part only).

Omit

<Device_Type>

AN

1

1

The type of device used at the

terminal. See Device Types.

Omit

<FirstName>

AN

1

40

Cardholder's first name as provided by the wallet provider during digitisation. May not be provided, or just the initial letter.

Omit

<LastName>

AN

1

40

Cardholder's last name as provided by wallet provider during digitisation. May not be provided, or just the initial letter.

Omit