Pre-Release Notifications (PRNs) for Past Releases

PRN-222

Added <MaskedPan> element.

Global Balance Guides

Global Reporting Guides

Cardholder XML Report Guide

PRN-231

Added note to API Usage Fees to clarify API Usage Fees are only available for Thredd’s SOAP web services.

Fees Guide

PRN-212

Added Response Code 72 and 46 for Mastercard.

External Host Interface Guides

Thredd Card Status and Response Codes

PRN-224

The Matching_Txn_ID field in EHI is now populated with data for the following additional types of transactions: Authorisation Reversals, Incremental Authorisations and Incremental Authorisation Reversals. Previously this field only contained data for Presentments.

External Host Interface Guides

PRN-200

Updated the format of the Acquirer_Reference_Data_031 field to AN(8,23) in the External Host Interface.

External Host Interface Guides

PRN-202

Added new processing codes for Credit Account Status Inquiry (ASI) and Debit ASI.

External Host Interface Guides

PRN-218

Added extra values 100 and 101 for ‘Message_Why’ field in Appendix A.26 (Response_Source_Why + Message_Why).

External Host Interface Guides

PRN-204

For the Thredd Status Code of Closed Account (46), updated Mastercard response code from 78 to 14

Card Status Response Codes

PRN-209

For the Legacy transaction, Non-Clearing Report and Clearing Reports, amended and removed some schema child elements. These includes updates to data types of child elements and removal of elements no longer in use.

Global Transaction Reporting

Transaction XML Reporting

PRN-210

Added a new web service, 3D Secure Get Card Level Configuration (Apata) (Ws_GetApataCardLevelConfigurations) to be used to retrieve the card level configuration for Apata.

Web Services Guide

PRN-213

Added currency code for the Caribbean Guilder currency (XCG) for Curacao and Sint Maartens that replaces Netherlands Antillean guilder. Added Curacao and Sint Maartens to the currency list for this new currency.

Global Balance Reporting

Global Transaction Reporting

Balance XML Reporting
Transaction XML Reporting

PRN-216

Added section on Multi-Factor Authentication when logging in to Smart Client and PANFinder.

Smart Client Guide

PANFinder Guide

PRN-203

Updated behaviour of Update Card Status endpoint response, where a 200 response is now returned if the new status is the same as the existing card status.

Cards API

PRN-201

Added New OOBAppURL field added to various web services.

Web Services Guide

PRN-199

Added OptOut parameter to the Ws_Update_Cardholder_Details_V2 and the Ws_Cardholder_Details_Enquiry_V2 web services.

Web Services Guide

PRN-197

Added new ISO currency code: 924.

Global Balance Reporting

Global Transaction Reporting

Balance XML Reporting

Transaction XML Reporting

PRN-196

Updated the minimum length requirement of PAN in <Card>to 14 digits.

Global Balance Reporting
Global Transaction Reporting

Balance XML Reporting

Transaction XML Reporting

PRN-194

Added Discover card type to the ACCTYPE element in the Global and Legacy Balance XML Schemas.

Global Balance Reporting

Global Transaction Reporting

Balance XML Reporting

Transaction XML Reporting

PRN-192

Added the MVC token indicator to the Card sub-element. Examples added to the Clearing, Non-Clearing, and Balance reports.

Global Transaction Reporting

Global Balance Reporting

PRN-189

Removed SecID, SecVal and SecValPos parameters from web services Record Descriptions and example requests.

Web Services Guide

PRN-186

isConfiguredGroup removed from the Get Card Acceptors endpoint.

Cards API

PRN-195

Updated the card status of 75 for the Retrieve Card Status and Update Card Status endpoints to match the behaviour of SOAP and Smart Client.

Cards API

PRN-185

Auth_type subelement added to primary elements in the Non-Clearing Report

Global Transaction Reporting

PRN-183

Consolidated the Get Allowed Merchants and Get Disallowed Merchants endpoints into a new singular endpoint (Get Card Acceptor endpoint)

Cards API

PRN-182

New position 32 added to the GPS_POS_Data field in EHI authorisation request messages to support Visa'’s Extended Authorisation feature, which allows acquirers to request an extension of the clearing period for certain cardholder-initiated card-not-present transactions.

External Host Interface (EHI) Guide

External Host Interface (EHI) Guide (JSON)

PRN-177

CardManufacturer removed from the ManufacturingDetails object in the Create Card endpoint.

Cards API

PRN-178

Virtual Cards changed to be created in an active status by default.

Cards API

PRN-174

In the Card Send Files (Ws_Send_CardFiles) web service, removed the field ‘Password’ from the request and response.

Web Services Guide

PRN-179

Added additional processing codes and account types now supported by Visa (as part of Article 2.1 Changes to Support Global Processing Alignment for Issuer). See Processing Codes.

External Host Interface (EHI) Guide

External Host Interface (EHI) Guide (JSON)

PRN-181

New Merchant Category Code (MCC) added: 3168 Hainan Airlines (as part of Visa mandate 2024 Q2 VISA Article 2.5 Changes to Merchant Category Codes and Response Code). See Merchant Category Codes.

External Host Interface (EHI) Guide

External Host Interface (EHI) Guide (JSON)

PRN-169

Added the WebServiceResult parameter to the following web services: Card Balance Transfer (Ws_BalanceTransfer) and 3D Secure Credentials (Ws_AddUpDelCredentials).

Web Services Guide

PRN-172

Added a new web service, 3D Secure Configuration (Apata) (Ws_ApataCardLevelConfigurations) to be used when configuring 3D Secure credentials and challenge screen options when using Apata.

Web Services Guide

PRN-170.

Removed references to the legacy web service Ws_3DS_AddUpDelDetails, which is being decommissioned. Thredd respond with action code '996' to indicate that the service is retired.

Web Services Guide

PRN-167

Removed the CardDesign field from the Card Activate and Load (Ws_Activate_Load) web service.

Web Services Guide

PRN-159

Removed the <Replacement> and <PublicToken> fields that were used to specify a replacement card when implementing the Card Create (Ws_CreateCard), Create Card with Agency Banking (Ws_CreateCard_V2) or Card Bulk Create (Ws_BulkCreation) web services. You should always use the Card Renew (Ws_Renew_Card) web service to specify a replacement card.

Web Services Guide

PRN-31

Removed references to the following web services, which were deprecated: Ws_WebServiceResult and Web_Service_Result_V2.

Web Services Guide

PRN-162

Two optional boolean fields, IsSingleUse and IsNonReloadable have been added to the following services: Card Create (Ws_CreateCard), Create Card with Agency Banking (Ws_CreateCard_V2), Card Bulk Create (Ws_BulkCreation) , Wallet Create (Ws_CreateWallet) and Wallet Bulk Create (Ws_BulkWalletCreation). These fields enable you to specify single use and non-reloadable cards.

Web Services Guide

Cards API

PRN-160

The nameOnCard object will be removed from the Create Card and Update Card endpoints in the REST API, and replaced with a new nameOnCard field.

Cards API

PRN-165

Two optional boolean fields, IsSingleUse and IsNonReloadable have been added to the following services: Create Card and Retrieve Card. These fields enable you to specify single use and non-reloadable cards.

Cards API

PRN-156

We are adding additional Mastercard Reason Code values 1403 and 1404 to the Transaction XML report.

Transaction XML Reporting Guide

PRN-154

We are updating the Trans_link field data type from Number (Long) to String, to align with the RFC 8259 Standard for JSON fields.

External Host Interface (EHI) Guide (JSON)

PRN-144

For customers on EHI Mode 2, When Thredd declines an authorisation transaction with response status “51“ (Insufficient Balance) your systems can now respond with a different decline status if you would like a more specific decline reason to be passed to the cardholder.

External Host Interface (EHI) Guide

PRN-147

We are updating our systems to support two new Merchant Category Codes (MCCs) which will be released by Visa on 14th April 2023. These are: 3839 and 5723.

External Host Interface (EHI) Guide

PRN-138

The use of the auditno attribute of the Trace element is changing from “required” to “optional”. This is to match the data we are now receiving from the Schemes.

Transaction XML Guide

PRN-135

Added the WebServiceResult parameter to the following web services: Card Renew (Ws_Renew_Card), Regenerate Wallet (Ws_RegenerateWallet), Clear Accumulator (Ws_ResetAccumulator), Change Card Acceptor List (Ws_Card_Change_Cardacceptor_List), Card Balance Update (Ws_BalanceUpdate) and Payment Token Status Change (Ws_Payment_Token_StatusChange).

If the web service request is a duplicate of an existing request (has the same WSID) then the result will return an action code of 868, together with details of the original request, which will be displayed in the WebServiceResult parameter

Web Services Guide

PRN-134

Removed the ability to change the card status to expired using status code 54; attempting to do so will return a new action code of 447. Card expiry status is always set by the system, based on the card's expiry date.

Web Services Guide

PRN-118

In the AgencyAccount element, the sortcode and bankacc attributes have been updated to support alphanumeric characters. Sort Code should be a 6 digit number and bankacc should be an 8 digit number.

Transaction XML Reporting Guide

PRN-123

Added a new action code of 445, which is returned in a Payment Token Create request when the payment token count exceeds the allowed limit.

Added a new <Url> parameter which enables you to include URL details in the <QRCode> field of the card generation file sent to the card manufacturer. This affects the following web services: Card Create (Ws_CreateCard), Create Card with Agency Banking (Ws_CreateCard_V2), Card Renew (Ws_Renew_Card), Update Cardholders Details (Ws_Update_Cardholder_Details and Ws_Update_Cardholder_Details_V2), Card Bulk Create (Ws_BulkCreation), Wallet Create (Ws_CreateWallet) and Wallet Bulk Create (Ws_BulkWalletCreation).

Web Services Guide

PRN-122

The values in the QRCode field can now be updated using Web Services. Field size updated from 50 to 100 characters.

Card Generation Interface Specification

PRN-114

For fields of data type AmountSigned, the number of supported decimal places has been updated from 9.2 to 19.4. For example: 72.1230.

External Host Interface (EHI) Guide

PRN-86

Enhancements to the new primary element FXConversion in the transaction XML report. The fields in his new element provide Foreign Exchange (FX) rate conversion details.

Transaction XML Reporting Guide

PRN-119

Added the WebServiceResult field to wsBalanceAdjustment, wsLoad, wsUnLoad, wsUnloadStatusChange, wsStatusChange and wsActivate web services.

Web Services Guide

PRN-114

For fields of data type AmountSigned, the number of supported decimal places has been updated from 9.2 to 19.4. For example: 72.1230.

External Host Interface (EHI) Guide

PRN-118

In the AgencyAccount element, the sortcode and bankacc attributes have been updated to support alphanumeric characters. Sort Code should be a 6 digit number and bankacc should be an 8 digit number.

Transaction XML Reporting Guide

PRN-117

Removed enumeration constrains from the CashType attribute and added the value of CHAPS.

Transaction XML Reporting Guide

PRN-120

Updated CardEvent to reflect report handling for CardEvent records that exceed 2GB in size.

Transaction XML Reporting Guide

PRN-115

We now provide a new Remove Cardholder Data (Ws_Remove_CardHolder_Data) web service, which enables you to remove cardholder personal information from a card, such as name, address, email and phone number.

Web Services Guide

PRN-111

Added the two-digit country code SS (South Sudan) to the ISOCountryCode list.

Transaction XML Reporting Guide

PRN-110

For MasterCardFee, ApprovedAgencyBanking, DeclinedAgencyBanking and DeclinedAgencyBanking, the Desc element can be empty (nillable="true").

Transaction XML Reporting Guide

PRN-109

New field PRIMARYTOKEN added to the CARD element, which shows the full Primary Account Number (PAN) of the card; If this is a secondary card, shows the full PAN of the linked primary card.

Balance XML Reporting Guide

PRN-104

Standardised the field values used in the EHI field PaymentToken_PanSource so that they align with existing values already used in the EHI field GPS_POS_Data position 3 (Card Data Input Method).

External Host Interface (EHI) Guide

PRN-75

The CardEvent primary element has been updated to include a new ReportedToSafe event type; this provides a transactionid attribute to identify a SAFE reporting transaction, but will be blank for other event types.

Transaction XML Reporting Guide

PRN-102

Improvements to Authorisation processing by introducing a new processing code “39” for Account Verification transactions arriving from Visa or Mastercard.

External Host Interface (EHI) Guide

Transaction XML Reporting Guide

PRN-100

New WalletTransaction element added to the transaction XML report.

Transaction XML Reporting Guide

PRN-96

The Extend Expiry Date (Ws_ExtendExpiry) web service will return an Action Code of 654 if you attempt to extend the expiry date of a card which is in an irreversible status.

Web Services Guide

PRN-43

New Note field added to the Card Load (Ws_Load), Card Unload (Ws_Unload) and Card Unload and Change Status (Ws_UnLoad_StatusChange) web services to enable users to view the reason for the transaction in the Note field in Smart Client.

Web Services Guide

PRN-73

New Do Not Debit Second Presentment option added to the Payments Dispute Management Guide (Chargeback Guide). This option can be used to prevent a card from going into negative balance while a chargeback is being processed.

Payments Dispute Management Guide

PRN-87

PRN-88

A new 3D Secure credential for Knowledge Based Authentication (KBA) is now available via web services. Two new fields have been added to Ws_AddUpDelCredentials— KBA_Answer and KBA_AnswerOldValue — to use with the new KBA credential type.

Web Services Guide

3D Secure Guide

PRN-80

The Create Card web service (Ws_CreateCard) now includes a new tag called Ws_WebServiceResult, which is returned in the response; if this is a duplicate create card request then this tag is populated with data about the original Create Card request.

Web Services Guide

PRN-78

The following card statuses will prevent the ability to load a card with funds: 04 (Capture Card), 14 (Invalid), 33 (Expired Card), 36 (Restricted Card), 37 (Card acceptor call acquirer security), 41 (Lost), 43 (Stolen), 54 (Expired), 62 (Restricted), 67 (Card to be picked up at ATM), 83 (Destroyed) and G9 (IVR Lost/Stolen Block (like 41 Lost)).

Smart Client Guide

PRN-85

Visa Fee Collection (VFC) has been added to the RecordType element of MasterCardFee, and the <DE94_Txn_Orig_ID> element maximum length has increased from 6 to 13.

Transaction XML Reporting Guide

PRN-72

For a Visa purchase with Cashback, Thredd now sends the value of Proc_Code as 09 (instead of 00) and includes the cashback amount in the Additional_Amt_DE54 field. Thredd has standardised the format of the Additional_Amt_DE54 field in EHI GetTransaction Messages and Transaction XML messages to use the format provided by GCMS IPM / Visa Base 2, which contains only the data (a multiple of 20 characters).

External Host Interface (EHI) Guide

Transaction XML Reporting Guide

PRN-69

Improved PSD2 logic and detection:New value V = Account Verification added to the Auth_Type field in the GetTransaction message.

External Host Interface (EHI) Guide

PRN-67

The web service responses for fields containing balance amounts have been updated to return the number of decimal places based on the ISO 4217 currency exponent for the currency (Note: previously two decimal places were returned).

Web Services Guide

PRN-66

Thredd is introducing a new value of 5 added to the <CreateType> field in the Card Create web service, to enable creating a virtual card and converting to a physical card at the same time. New Action Code of 444 added, which indicates that the create card request was successful, but the conversion to a physical card failed.

Web Services Guide

PRN-63

New field <UsageGroup> added to the Payment Token Status Change web service (Ws_Payment_Token_StatusChange) to enable users to change the card usage group of the card linked to a payment token.

Web Services Guide

PRN-60

A new field called <GPSEXPDATE> has been added to the Thredd Balance XML and Cardholder XML reports. This date represents the card expiry date set when the card is activated, or the default card product expiry date.

Balance XML Reporting Guide

PRN-59

A new field <LocalDateUTC> has been added to CardAuthorisation and CardFinancial records. This field contains the LocalDateUTC data (local date and time in UTC) that Thredd receives from Mastercard and Visa.

Transaction XML Reporting Guide

Thredd PRN-58

The create wallet web service (WS_CreateWallet) now includes the <PBlock> field, which you can use to set the PIN at create stage.

Web Services Guide

PRN-48

Thredd is changing the way in which we handle declined responses, in order to support the new Visa and Mastercard rules; we are providing new card status codes and new response fields to use in EHI messages.

Thredd Card Status and Response Codes

PRN-56

Three new EHI fields are now included in Authorisation messages, which can be used to identify whether the details provided during a 3D Secure authentication session match the details approved in the authorisation stage: AuthenticationAmountUpper, AuthenticationCurrency and AuthenticationMerchantNameHash. These changes will help you to comply with the EU Directive 2015/2366 related to Strong Customer Authentication (SCA) Dynamic Linking.

External Host Interface (EHI) Guide

PRN-52

New action code 440 Archived card, deny is returned in response to a request to update an archived card.

Web Services Guide

PRN-49

The CardAuthorisation and the CardFinancial records in the transaction XML report have both been updated with an optional additional PaymentToken element. If you are using the Thredd mobile tokenisation service, then this element can be used to support your Apple-Pay Reporting requirements.

Transaction XML Reporting Guide

PRN-45

A new field EXPDate was added to the response of a Ws_Renew web service call, providing details of the card expiry date.

Web Services Guide

PRN-50

The following new fields were added for EHI version 5.0: Acquirer_Country,

PaymentToken_PanSource, ClearingFileId, ReceiverData, Network_Fraud_Data and SenderData.

Note: Customers will need to upgrade to EHI version 5.0 to receive these fields.

External Host Interface (EHI) Guide

PRN-44

In the transaction XML report, in the cardfinancial record, the BillAmt rate and SettlementAmt rate fields have been updated to show 9 decimal places, to allow extra decimal places for some currencies.

Transaction XML Reporting Guide

PRN-41

The TxId field is currently being populated with the feeId for Feecollection records; post this release the TxId element will be populated with the Transaction Id of the related Authorisation record, if we can find one, for FeeCollection records. If we can't find the Authorisation record, it will be populated as 0.

Transaction XML Reporting Guide

PRN-40

Thredd is changing the default <Sms_Required> flag to '0' (Thredd will no longer send an SMS to the cardholder unless expressly requested). This affects the following web services:

Ws_createcard

Ws_createwallet

Ws_BulkCreation

Ws_BulkCreationWallet

Ws_Regenerate

Web Services Guide

PRN-39

The SAFE Reports (WS_SafeReports) web service is being decommissioned. If you try to use this web service the action code 996 - Retired Web Service will be displayed.

Web Services Guide

PRN-38

The Card Enquiry web service (WS_Enquiry) response is being extended to return the number of online PIN tries remaining and the number of CVV2 tries remaining for the specified token. There are no changes to the request format.

Web Services Guide

PRN-37

New fields (bookingstatus, fxratebooked, providercode, fixedamountflag, settlementdate) are being added to a new element FXConv in the CardAuthorisation and CardFinancial section of Transaction XML to support currency cloud FX rates.

Transaction XML Reporting Guide

PRN-34

The web service Ws_AddUpDelCredentials is used to insert, update or delete cardholders credentials (e.g. mobile phone number, email address) using the Cardinal real-time Data Exchange (RDX) interface.

Thredd is introducing a new Action Code 438 - Credential type already exists, which will be in the response if the credential type which the web service call is intending to add/insert is already on record in Cardinal 3D Secure.

Web Services Guide

PRN-31

The following legacy web services are being deprecated: Ws_WebServiceResult and Ws_WebServiceResult_V2 webservices. These services are no longer listed in the Web Services Guide

Web Services Guide

PRN-35

Thredd is improving the granularity of decline response reasons following customer requests and in advance of scheme mandate. Where Authorisations are declined due to ‘Exceeding frequency limit’ or ‘Exceeding amount limit’ this will be reflected in the response codes Thredd sends.

There will be no difference to whether transactions are approved or declined as a result of this change. The only difference is in the Response Code sent to the Scheme, via EHI and in XML Reports for a small proportion of declined Authorisations.

External Host Interface (EHI) Guide

PRN-33

Thredd has reinstating <CrdProduct> in the web service response for the following web services:

Ws_CardHolder_Details_Enquiry

Ws_CardHolder_Details_Enquiry_V2

This <CrdProduct> parameter shows the card product ID associated with the token specified in the web service call.

Web Services Guide

PRN-32

Thredd has enhanced the Ws_AddUpDelCredentials web service to support the Get action. This allows credential details for a particular cardholder token to be obtained from Thredd . The new Get action is introduced in addition to the existing web service option (Add, Update and Delete).

Web Services Guide

PRN-30

Thredd has enhanced Web Services and Card Manufacturer files to support the hashtag symbol ‘#’ in the Address Line Fields listed below:

<Addrl1>

<Addrl2>

<Addrl3>

<Delv_AddrL1>

<Delv_AddrL2>

<Delv_AddrL3>

Prior to this release if the hashtag symbol ‘#’ is used Thredd would automatically remove it.

Web Services Guide

PRN-29

Thredd has created a new Action Code 599 - Credential and Token does not match. Thredd responds with this action code when a WS_AddUpDelCredentials Update or Delete action request specifies an incorrect <ID>.

Web Services Guide

PRN-28

A Lost & Stolen Card fee created using Web service fee processing code 089 and web service Ws_Generic_Fees is reported as Debit in the CardFee record of Transaction XML Reports. (This was previously reported as as Credits.)

Fees Guide

Transaction XML Reporting Guide

PRN-27

Thredd provides the feature to set a Card Expiry Fee for cards which deducts a specified amount from the card on card expiry. This is now reported as Debit in the CardFee record of Transaction XML Reports. (This was previously reported as as Credit.)

Fees Guide

Transaction XML Reporting Guide

PRN-26

Thredd has improved the web services to support both Upper & Lower case characters when providing the Card’s Embossed name as indicated by the Tag <CardName> in all Card Creation requests ( e.g. Ws_CreateCard, Ws_CreateCard_V2, Ws_BulkCreation)

Web Services Guide

PRN-25

Thredd sends the 3 response codes ‘04’ (Pickup card), ‘41’ (Lost card) and ‘43’ (Stolen card) to Visa and Mastercard as they are. (These were previously sent as ‘05’ (Do not honour).)

In the case of the merchant/acquirer picking up the card, the issuer may be charged.

External Host Interface (EHI) Guide

PRN-24

Thredd has updated the Address Line 3 (<addrl3>) field to support a maximum length of 50 characters. This applies to the following web services:

Ws_CreateCard

Ws_CreateWallet

Ws_Regenerate

Ws_Update_Cardholder_Details

Ws_Update_Cardholder_Details_V2

Web Services Guide