Release Notes for 26th April 2024
New changes to the Thredd Cards API for the week ending 26th April 2024.
New behaviour when unloading MVC cards
New optional behaviour has been added when unloading MVC cards of restricting an unload that is more than the balance of the MVC.
Note
This behaviour must be enabled before it can be used. Please contact application support via your implementations manager to discuss enabling this functionality.
For example, if the MVCs balance is £800 and the unload is for a value of £1000, then a 400 response can be returned with the below message.
{
Cannot unload due to insufficient fund.
}
Information
For more information on MVCs, see Master Virtual Cards.
New fields added to Get Token Details response
New fields have been added to the response for the Get Token Details endpoint. This change expands the details returned when querying a token associated with a publicToken.
The following table describes the new fields for the Get Token Details endpoint.
| Field | Description |
|---|---|
| creatorTokenReference | The token creator's unique reference for this payment token. (Mastercard Token Unique Reference (TUR) and Visa Token reference ID.) |
| cardUsageGroup | The card usage group the token is associated with. |
| paymentTokenUsageGroup | The payment token usage group the token is associated with. |
| walletAccountScore | 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 |
| walletDeviceScore | 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 |
| walletReasons | Wallet service provider tokenization recommendation reason codes. |
| transactionID | The unique identifier for the transaction. |
| responseCode | The action code for the response. |
| transactionDate | The date and time of the transaction. |
| cardAcceptorNameLocation | The location of the card acceptor, which can be a merchant or an ATM where the transaction occurred. |
| bnReference | The network reference. |
| mtid | The Message Type Identifier (MTID) for the transaction. |
| ehiRequestTime | The date and time the EHI received the request. |
| ehiResponseTime | The date and time the EHI responded to the request. |
| activationCode | Activation code to be sent directly to the cardholder to activate this payment token. |
| activationMethod | 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 |
| activationStatus | The payment token's activation status: Status is 'R' when Reason code = 00 Status is 'T' when Reason code = 01 Status is 'F' when Reason code = 02 |
| walletId | Name of the wallet provider this payment token uses (e.g., APPLE, ANDROID, SAMSON). |
| walletProvider | The name of the wallet provider. For example Apple or Google. |
| transactionStatus | 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 |
| tokenType | Payment token type. |
| deviceType | The type of device used at the terminal. |
| deviceName | Name the cardholder assigned to the device in the wallet. |
| merchantName | The name of the merchant for the transaction. |
See the below example of a successful Get Token Details response.
{
"creatorTokenReference": "DAPLMC0000239565f52605b88199440da31349c23457eeb5",
"cardUsageGroup": "TES-CU-001 - Test CR",
"paymentTokenUsageGroup": "CORPT-0001 - TXN_Default",
"walletAccountScore": 5,
"walletDeviceScore": 3,
"walletReasons": "000000000010000000000000",
"transactionID": 0,
"responseCode": null,
"transactionDate": null,
"cardAcceptorNameLocation": "",
"bnReference": "",
"mtid": null,
"ehiRequestTime": null,
"ehiResponseTime": null,
"activationCode": "297147",
"activationMethod": "Email",
"activationStatus": "",
"id": 6783,
"walletId": "APPLE",
"walletProvider": "Apple",
"tokenPAN": "1321",
"statuses": {
"tokenisedStatus": {
"code": "1",
"description": "Tokenised"
},
"authorisationStatus": {
"code": "A",
"description": "Approve with Authentication"
},
"authorisationDecision": {
"code": "A",
"description": "Approve with Authentication"
},
"transactionStatus": {
"code": "A",
"description": "Active"
},
"gpsStatusInfo": {
"code": "83",
"description": "Deactivated"
}
},
"tokenisedDate": "01/17/2020 08:48:06",
"expiryDate": "12/31/2022 00:00:00",
"tokenType": "Secure Element PAN",
"deviceType": "Unknown",
"deviceName": "iPhone",
"merchantName": null
}
Information
For more information on Get Payment Details, see Get Card Payment Token Details.