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.

FieldDescription
creatorTokenReferenceThe token creator's unique reference for this payment token. (Mastercard Token Unique Reference (TUR) and Visa Token reference ID.)
cardUsageGroupThe card usage group the token is associated with.
paymentTokenUsageGroupThe payment token usage group the token is associated with.
walletAccountScoreRisk 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
walletDeviceScoreRisk 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
walletReasonsWallet service provider tokenization recommendation reason codes.
transactionIDThe unique identifier for the transaction.
responseCodeThe action code for the response.
transactionDateThe date and time of the transaction.
cardAcceptorNameLocationThe location of the card acceptor, which can be a merchant or an ATM where the transaction occurred.
bnReferenceThe network reference.
mtidThe Message Type Identifier (MTID) for the transaction.
ehiRequestTimeThe date and time the EHI received the request.
ehiResponseTimeThe date and time the EHI responded to the request.
activationCodeActivation code to be sent directly to the cardholder to activate this payment token.
activationMethodWhich 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
activationStatusThe 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
walletIdName of the wallet provider this payment token uses (e.g., APPLE, ANDROID, SAMSON).
walletProviderThe name of the wallet provider. For example Apple or Google.
transactionStatusStatus 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
tokenTypePayment token type.
deviceTypeThe type of device used at the terminal.
deviceNameName the cardholder assigned to the device in the wallet.
merchantNameThe 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.