ListTokens
Returns all the tokens linked to a card.
Request
Path parameters
string, 10 characters, required
The Paymentology issued terminal ID of the terminal requesting the transaction
string, 1-255 characters, required
Customer reference linked with this card
string, 1-10 characters, required
The tracking number of the card
string, 1-255 characters, required
Transaction ID number generated by the calling client
date, required
Transaction date generated by the calling client
string, required
HMAC-SHA256 hashed signature of the concatenated method name with all argument values using the terminal password as private key
<?xml version="1.0"?>
<methodCall>
<methodName>ListTokens</methodName>
<params>
<param>
<value>
<string>0053897254</string>
</value>
</param>
<param>
<value>
<string>66816921087</string>
</value>
</param>
<param>
<value>
<string>755348400000058</string>
</value>
</param>
<param>
<value>
<string>fb8344c9-2fc9-467b-87e4-55eaf88d06f2</string>
</value>
</param>
<param>
<value>
<dateTime.iso8601>20201102T12:01:01</dateTime.iso8601>
</value>
</param>
<param>
<value>
<string>6868417A5B171A2E113DAF6F232AD0C30D915AFD</string>
</value>
</param>
</params>
</methodCall>
Response
STATUS200 OK
Schema
integer
Status code indicating transaction result
string
Status text indicating result
array
The tokens linked to this card, where each token has the following fields:
TokenUniqueReference, string, 48 characters
Unique reference to the token.
DigitizationRequestDateTime, string
Date and time of the initial request for digitization of the Account PAN for this token. This is a conditional field, not present for CoF tokens, string in ISO 8601 format eg. “20150121T02:04:35”
TokenType, string = Type of token. Valid values:
“S” – Embedded Secure Element Token
“C” – Mastercard Cloud-Based Payments token
“F” – CoF (Card on File) token
DeviceID, string
Serial number of the device provisioned with the token. May be masked. Conditional field, not present for CoF tokens, and only present when provided by a Wallet Provider. May be masked (by the Wallet Provider). Example (unmasked) “C2ZBY14310005664”. Example (masked) “xxxxY1431xxxxxxx”.
DeviceName, string
Nickname of the device provisioned with the token. Conditional field, not present for CoF tokens, and only present when the Payment App Provider has implemented the ‘Get Device Info’ MDES API. Eg: “John’s phone”
DeviceType, string
Type of the device provisioned with the token. Valid values: NOTE – Some values from 00–19 may indicate not only the physical form factor but also other attributes such as device technology and payment app specifications.
’00’ – Card.
’01’ – Mobile Network Operator (MNO) controlled removable secure element (SIM or UICC) personalized for use with a mobile phone or smartphone.
’02’ – Key Fob.
’03’ – Watch using a contactless chip or a fixed (non-removable) secure element not controlled by the MNO.
’04’ – Mobile Tag.
’05’ – Wristband.
’06’ – Mobile Phone Case or Sleeve.
’07’ – Mobile phone or smartphone with a fixed (non-removable) secure element controlled by the MNO, for example, code division multiple access (CDMA).
’08’ – Removable secure element not controlled by the MNO, for example, memory card personalized for used with a mobile phone or smartphone.
’09’ – Mobile Phone or smartphone with a fixed (non-removable) secure element not controlled by the MNO.
’10’ – MNO controlled removable secure element (SIM or UICC) personalized for use with a tablet or e-book.
’11’ – Tablet or e-book with a fixed (non-removable) secure element controlled by the MNO.
’12’ – Removable secure element not controlled by the MNO, for example, memory card personalized for use with a tablet or e-book.
’13’ – Tablet or e-book with fixed (non-removable) secure element not controlled by the MNO.
’14’ – Mobile phone or smartphone with a payment application running in a host processor.
’15’ – Tablet or e-book with a payment application running in a host processor.
’16’ – Mobile phone or smartphone with a payment application running in the Trusted Execution Environment (TEE) of a host processor.
’17’ – Tablet or e-book with a payment application running in the TEE of a host processor.
’18’ – Watch with a payment application running in the TEE of a host processor.
’19’ – Watch with a payment application running in a host processor. NOTE – Values from 20–99 exclusively indicate the form factor only without also indicating the storage technology.
’20’ – Card.
’21’ – Phone Mobile phone.
’22’ – Tablet/e-reader Tablet computer or e-reader.
’23’ – Watch/Wristband Watch or wristband, including a fitness band, smart strap, disposable band, watch add-on, and security/ID band.
’24’ – Sticker.
’25’ – PC PC or laptop.
’26’ – Device Peripheral Mobile phone case or sleeve.
’27’ – Tag Key fob or mobile tag.
’28’ – Jewelry Ring, bracelet, necklace, and cuff links.
’29’ – Fashion Accessory Handbag, bag charm, and glasses.
’30’ – Garment Dress.
’31’ – Domestic Appliance Refrigerator, washing machine.
’32’ – Vehicle Vehicle, including vehicle attached devices.
’33’ – Media/Gaming Device Media or gaming device, including a set top box, media player, and television.
’34’ to ’99’ – Reserved for future form factors. Any value in this range may occur within form factor and transaction data without prior notice. Conditional field, not present for CoF tokens, and only present when supplied by the Payment App Provider.
example: 14
ExpirationDate, date
Expiration date of token. Conditional field, present once the token has been designated for the digitization. Four digit string. Format “mmyy”. Eg. 1016
CurrentStatusDescription, string
Description of the current status.
Unmapped. The token has not yet been linked to the Account PAN. The process of tokenization is In Progress.
Active. The token is linked to the Account PAN and may initiate new transactions to be authorized.
Suspended. The token is linked to the Account PAN but may not perform transactions at the request of one or more suspenders.
Deleted. The token is logically deleted but is still linked to the Account PAN for the purposes of post-authorization transaction processing. Eg. “Active”
TokenActivatedDateTime, date
Date and time that the token was activated. Conditional field, present only once the Token has been activated. string in ISO 8601
Example: “20150121T02:04:45”
TokenRequestorName, string
The legal name of the token requestor.
Example: “Popular High Street Merchant”
WalletID, string
Identifier of the Wallet Provider who requested the digitization or tokenization. Always populated for any token.
Example: 123
<?xml version="1.0" encoding="UTF-8"?>
<methodResponse>
<params>
<param>
<value>
<struct>
<member>
<name>clientTransactionID</name>
<value>
<string>fb8344c9-2fc9-467b-87e4-55eaf88d06f2</string>
</value>
</member>
<member>
<name>resultCode</name>
<value>
<int>1</int>
</value>
</member>
<member>
<name>terminalID</name>
<value>
<string>0053897254</string>
</value>
</member>
<member>
<name>customerReference</name>
<value>
<string>66816921087</string>
</value>
</member>
<member>
<name>resultText</name>
<value>
<string>Approved</string>
</value>
</member>
<member>
<name>tokens</name>
<value>
<array>
<data>
<value>
<struct>
<member>
<name>DeviceId</name>
<value>
<string>6b24f24a24ba98e27d43e345b532a245e4723d7a9c4f624e93452c92de93</string>
</value>
</member>
<member>
<name>DeviceName</name>
<value>
<string>John Phone</string>
</value>
</member>
<member>
<name>TokenUniqueReference</name>
<value>
<string>DWSPMC00000000010906a349d9ca4eb1a4d53e3c90a11d9c</string>
</value>
</member>
<member>
<name>DigitizationRequestDateTime</name>
<value>
<dateTime.iso8601>20150121T02:04:35</dateTime.iso8601>
</value>
</member>
<member>
<name>TokenType</name>
<value>
<string>S</string>
</value>
</member>
<member>
<name>DeviceType</name>
<value>
<double>09</double>
</value>
</member>
<member>
<name>ExpirationDate</name>
<value>
<double>0416</double>
</value>
</member>
<member>
<name>CurrentStatusDescription</name>
<value>
<string>Active</string>
</value>
</member>
<member>
<name>TokenActivatedDateTime</name>
<value>
<dateTime.iso8601>20150121T02:04:45</dateTime.iso8601>
</value>
</member>
<member>
<name>TokenRequestorName</name>
<value>
<string></string>
</value>
</member>
<member>
<name>WalletId</name>
<value>
<double>103</double>
</value>
</member>
</struct>
</value>
<value>
<struct>
<member>
<name>DeviceId</name>
<value>
<string>84f624e93452c9243e345b532a245e4723d7a9c4f624e93452c92de9357a</string>
</value>
</member>
<member>
<name>DeviceName</name>
<value>
<string>John Tablet</string>
</value>
</member>
<member>
<name>TokenUniqueReference</name>
<value>
<string>DWSPMC00000000010906a349d9ca4eb1a4d53esddddws</string>
</value>
</member>
<member>
<name>DigitizationRequestDateTime</name>
<value>
<dateTime.iso8601>20141021T02:04:35</dateTime.iso8601>
</value>
</member>
<member>
<name>TokenType</name>
<value>
<string>S</string>
</value>
</member>
<member>
<name>DeviceType</name>
<value>
<double>13</double>
</value>
</member>
<member>
<name>ExpirationDate</name>
<value>
<double>0216</double>
</value>
</member>
<member>
<name>CurrentStatusDescription</name>
<value>
<string>Deleted</string>
</value>
</member>
<member>
<name>TokenActivatedDateTime</name>
<value>
<dateTime.iso8601>20150121T02:04:45</dateTime.iso8601>
</value>
</member>
<member>
<name>TokenRequestorName</name>
<value>
<string></string>
</value>
</member>
<member>
<name>WalletId</name>
<value>
<double>103</double>
</value>
</member>
</struct>
</value>
<value>
<struct>
<member>
<name>DeviceId</name>
<value>
<string>24a24ba98e27d43e345b532a245e4723d7a9c4f624e93452c92de9357a53</string>
</value>
</member>
<member>
<name>DeviceName</name>
<value>
<string>Smart phone</string>
</value>
</member>
<member>
<name>TokenUniqueReference</name>
<value>
<string>DWSPMC00000000010906a349d9ca4eb1a4d53esdsdseee</string>
</value>
</member>
<member>
<name>DigitizationRequestDateTime</name>
<value>
<dateTime.iso8601>20150121T02:04:35</dateTime.iso8601>
</value>
</member>
<member>
<name>TokenType</name>
<value>
<string>S</string>
</value>
</member>
<member>
<name>DeviceType</name>
<value>
<double>09</double>
</value>
</member>
<member>
<name>ExpirationDate</name>
<value>
<double>0116</double>
</value>
</member>
<member>
<name>CurrentStatusDescription</name>
<value>
<string>Suspended</string>
</value>
</member>
<member>
<name>TokenActivatedDateTime</name>
<value>
<dateTime.iso8601>20150121T02:04:45</dateTime.iso8601>
</value>
</member>
<member>
<name>TokenRequestorName</name>
<value>
<string></string>
</value>
</member>
<member>
<name>WalletId</name>
<value>
<double>103</double>
</value>
</member>
</struct>
</value>
<value>
<struct>
<member>
<name>DeviceId</name>
<value>
<string></string>
</value>
</member>
<member>
<name>DeviceName</name>
<value>
<string></string>
</value>
</member>
<member>
<name>TokenUniqueReference</name>
<value>
<string>DWSPMC00000000010906a349d9ca4eb1a4d53e3c90a22557</string>
</value>
</member>
<member>
<name>DigitizationRequestDateTime</name>
<value>
<string></string>
</value>
</member>
<member>
<name>TokenType</name>
<value>
<string>F</string>
</value>
</member>
<member>
<name>DeviceType</name>
<value>
<string></string>
</value>
</member>
<member>
<name>ExpirationDate</name>
<value>
<double>0416</double>
</value>
</member>
<member>
<name>CurrentStatusDescription</name>
<value>
<string>Active</string>
</value>
</member>
<member>
<name>TokenActivatedDateTime</name>
<value>
<dateTime.iso8601>20150121T02:04:45</dateTime.iso8601>
</value>
</member>
<member>
<name>TokenRequestorName</name>
<value>
<string></string>
</value>
</member>
<member>
<name>WalletId</name>
<value>
<double>103</double>
</value>
</member>
</struct>
</value>
<value>
<struct>
<member>
<name>DeviceId</name>
<value>
<string></string>
</value>
</member>
<member>
<name>DeviceName</name>
<value>
<string></string>
</value>
</member>
<member>
<name>TokenUniqueReference</name>
<value>
<string>DWSPMC00000000010906a349d9ca4eb1a4d53e3c90a22556</string>
</value>
</member>
<member>
<name>DigitizationRequestDateTime</name>
<value>
<string></string>
</value>
</member>
<member>
<name>TokenType</name>
<value>
<string>F</string>
</value>
</member>
<member>
<name>DeviceType</name>
<value>
<string></string>
</value>
</member>
<member>
<name>ExpirationDate</name>
<value>
<double>0416</double>
</value>
</member>
<member>
<name>CurrentStatusDescription</name>
<value>
<string>Suspended</string>
</value>
</member>
<member>
<name>TokenActivatedDateTime</name>
<value>
<dateTime.iso8601>20150121T02:04:45</dateTime.iso8601>
</value>
</member>
<member>
<name>TokenRequestorName</name>
<value>
<string></string>
</value>
</member>
<member>
<name>WalletId</name>
<value>
<double>103</double>
</value>
</member>
</struct>
</value>
<value>
<struct>
<member>
<name>DeviceId</name>
<value>
<string></string>
</value>
</member>
<member>
<name>DeviceName</name>
<value>
<string></string>
</value>
</member>
<member>
<name>TokenUniqueReference</name>
<value>
<string>DWSPMC00000000010906a349d9ca4eb1a4d53e3c90a22555</string>
</value>
</member>
<member>
<name>DigitizationRequestDateTime</name>
<value>
<string></string>
</value>
</member>
<member>
<name>TokenType</name>
<value>
<string>F</string>
</value>
</member>
<member>
<name>DeviceType</name>
<value>
<string></string>
</value>
</member>
<member>
<name>ExpirationDate</name>
<value>
<double>0416</double>
</value>
</member>
<member>
<name>CurrentStatusDescription</name>
<value>
<string>Deleted</string>
</value>
</member>
<member>
<name>TokenActivatedDateTime</name>
<value>
<dateTime.iso8601>20150121T02:04:45</dateTime.iso8601>
</value>
</member>
<member>
<name>TokenRequestorName</name>
<value>
<string></string>
</value>
</member>
<member>
<name>WalletId</name>
<value>
<double>103</double>
</value>
</member>
</struct>
</value>
</data>
</array>
</value>
</member>
<member>
<name>serverTransactionID</name>
<value>
<string>43CC9C06-D3B9-C222-4473B81619CA1FF1</string>
</value>
</member>
<member>
<name>trackingNumber</name>
<value>
<string>755348400000058</string>
</value>
</member>
</struct>
</value>
</param>
</params>
</methodResponse>
Was this page helpful?