|
Date |
Description |
Guide |
|---|---|---|
|
11/07/2025 |
Added mTLS environment links to System Requirements. |
|
|
11/07/2025 |
Added section on onboarding to the Automated Back Office. |
|
|
11/07/2025 |
Removed EHI mode 5, which has been decommissioned, from EHI Guides. Other guides that referenced mode 5 have also been updated. |
|
|
11/07/2025 |
Replaced the |
What's Changed - Weekly Updates
This section provides access to everything recently added to the Documentation Portal. See also our Release Notes.
The Technical Documentation section contains the current and previous versions of each document, along with a version history that describes the changes made for each version. Please contact your Account Manager to request a document that is not listed on this site.
11th July 2025
4th July 2025
|
Date |
Description |
Guide |
|---|---|---|
|
04/07/2025 |
Added dynamicInterchange field to Create Card endpoint to support virtual cards for the Mastercard Wholesale Program. |
|
|
04/07/2025 |
Updated the card status codes pages to indicate that Card Status Codes G5 and G6 (temporary blocks) can also be set by Fraud Transaction Monitoring (FTM) service. |
|
|
04/07/2025 |
Removed the Payment Token Create (Ws_Payment_Token_Create) web service and all references to it from the guide, including removing action codes that were specific to the web service. |
|
|
04/07/2025 |
Added additional information to the Transaction Matching section on matching for incremental authorisations and revised the FAQ on incremental authorisations and how to identify them. |
|
|
04/07/2025 |
Clarified the deadline for making amendments to the card file and how to change the frequency of the card file generation. |
|
|
04/07/2025 |
Updated the example for POS_Date_DE13. Provided more details of how traceid_lifecycle is constructed. |
|
|
04/07/2025 |
Updated the maximum length of the THERMAL_LINE1 field to 120 characters. |
|
|
04/07/2025 |
Updated the maximum length of the THERMAL_LINE2 field to 70 characters for the Create Card endpoint. |
|
|
04/07/2025 |
Added further details on the use of the MerchantAdvice field and usage of Merchant Advice Code 03. |
|
|
04/07/2025 |
Added a note to the description of Additional_data_de48 to clarify the usage of this field. |
27th June 2025
|
Date |
Description |
Guide |
|---|---|---|
|
27/06/2025 |
New guide for finding a cardholder's PAN using Thredd Portal |
|
|
27/06/2025 |
Clarified the description of |
20th June 2025
|
Date |
Description |
Guide |
|---|---|---|
|
20/06/2025 |
New Thredd Portal Training, including video demonstrations, now available for viewing on the Docs Portal. |
|
|
20/06/2025 |
Added a section on creating, editing, and publishing draft risk profiles. Included descriptions on backtesting. |
|
|
20/06/2025 |
Updated the maximum length of the THERMAL_LINE2 field to 70 characters. |
|
|
20/06/2025 |
Updated the FAQ section. |
|
|
20/06/2025 |
Added new FAQ section. |
13th June 2025
|
Date |
Description |
Guide |
|---|---|---|
|
13/06/2025 |
Added note to API Usage Fees to clarify API Usage Fees are only available for Thredd’s SOAP web services. See PRN-231. |
|
|
13/06/2025 |
Added Mastercard Reason Codes 7680 and 7681. See PRN-234. |
|
|
13/06/2025 |
Updated the Tokenisation Configuration page, including updating guidance on Payment Token groups, removing the Visa/Mastercard Rules section, updating references on the Mastercard Portal, and adding new device binding logic. |
|
|
13/06/2025 |
Added the |
|
|
13/06/2025 |
Global Reporting, Transaction and Balance XML guides include a new schema where country and currency code lists have been removed. Removed country and currency codes in the reference sections of the guides. Added new schemas to the Downloads page. See PRN-230 |
Global Transaction Reporting Guide Global Balance Reporting Guide |
|
13/06/2025 |
Updated the FAQ section. |
6th June 2025
|
Date |
Description |
Guide |
|---|---|---|
|
06/06/2025 |
Added details around scheduling of the card generation file and how records are added to this file. |
30th May 2025
|
Date |
Description |
Guide |
|---|---|---|
|
30/05/2025 |
Updates to Network Reference field naming for Transaction fields. |
|
|
30/05/2025 |
Added a note to indicate that card status changes prior to 2022 are no longer retrievable to relevant guides and API endpoint descriptions. See PRN-229. |
|
|
30/05/2025 |
Revised the description of the response parameter PaymentTokenUsageGroup as used in the following web services: Card Enquiry ( |
|
|
30/05/2025 |
Three new fields ( |
23rd May 2025
|
Date |
Description |
Guide |
|---|---|---|
|
23/05/2025 |
New version of the API documentation published, supporting our new API Hub solution. |
|
|
23/05/2025 |
Quarterly Release Notes Summary - now available for viewing on the Documentation Portal. |
|
|
23/05/2025 |
Added notes to clarify the use of the SubBIN field for 6-digit and 8-digit BINs. |
16th May 2025
|
Date |
Description |
Guide |
|---|---|---|
|
16/05/2025 |
Added appendix on Notes field values. |
|
|
16/05/2025 |
Updated the FAQs with additional information on incremental authorisations and how to identify them. |
|
|
16/05/2025 |
Added Event Delivery System (Webhooks) page to Products and Services section of the Documentation Portal. |
9th May 2025
|
Date |
Description |
Guide |
|---|---|---|
|
09/05/2025 |
Added EHI response codes 12 and 15 to the EHI Response Codes page. Revised the description of response code 57. Removed card status code 57 from the Card Status Codes page. |
|
|
09/05/2025 |
Added EHI response codes 12 and 15 to the Response Status Values page. Revised the description of response code 57. Removed card status code 57 from the Card Status Codes page. |
|
|
09/05/2025 |
Removed card status code 57 from the Card Status Codes page. |
|
|
09/05/2025 |
Removed references to the 0120 A message type, as this is not supported. The appropriate message type to process is the 1240 A (for Mastercard) or 05 A, 06 A and 07 A (For Visa). |
|
|
09/05/2025 |
The Matching_Txn_ID field in EHI is now populated with data for the following types of transactions: Presentments, Authorisation Reversals, Incremental Authorisation and Incremental Authorisation Reversals. See GetTransaction Message Fields. |
|
|
09/05/2025 |
Corrected Cardholder XML Documentation to State that MaskedPAN is Mandatory |
2nd May 2025
|
Date |
Description |
Guide |
|---|---|---|
|
02/05/2025 |
Added Click to Pay to the Tokenisation Guide. |
|
|
02/05/2025 |
Updates to the Country Support map on the Documentation Portal. |
|
|
02/05/2025 |
Added MaskedPAN to the Card subelement. Updated schemas and all examples to include MaskedPAN. New XSD Files available in the Downloads page for the Global Reports. See PRN-222. |
Global Balance Reporting Guides |
|
02/05/2025 |
Updated the description of the Settlement_Date field. |
|
|
02/05/2025 |
Updated the description of the SchemeSettlementDate element. |
|
|
02/05/2025 |
New Automated Back Office guide published. |
25th April 2025
|
Date |
Description |
Guide |
|---|---|---|
|
25/04/2025 |
Added new transaction types available for transactions processed on the STAR Network via Mastercard Network Exchange (MNE). See Additional Transaction Types for MNE. |
|
|
25/04/2025 |
Guides for global reporting are now included in separate homepages. |
Global Balance Reporting Guides Global Transaction Reporting Guides
|
17th April 2025
|
Date |
Description |
Guide |
|---|---|---|
|
17/04/2025 |
Updated Card Status Response Code Mappings for Mastercard for a new code: 72. |
|
|
17/04/2025 |
Added new example to How to handle processing errors due to invalid question mark character in Troubleshooting FAQs. |
|
|
17/04/2025 |
Added the following codes for device binding that supports FIDO: 3749 and 3760. |
|
|
17/04/2025 |
PRN-212 is now set to April 28th 2025. |
|
|
17/04/2025 |
Added digital asset categories, for example Central Bank Digital Currency (CBDC) or tokenized deposits, to the list of POS codes. |
|
|
17/04/2025 |
Added Url field to Create Card, Update Card and Retrieve Card endpoints, and Updated Unblock PIN and Unblock CVV endpoints to work for all card statuses. |
11th April 2025
|
Date |
Description |
Guide |
|---|---|---|
|
11/04/2025 |
Added Response Code 72 and 46 for Mastercard to the Response Status Values and the Resp_Code_DE39 pages. |
|
|
11/04/2025 |
Added Response Code 72 and 46 and the Card Status Codes and the EHI Response Codes page. |
|
|
11/04/2025 |
Added two new Visa response codes: 5C - Transaction not supported or blocked by issuer and 9G - Blocked by cardholder, contact cardholder. |
|
|
11/04/2025 |
Added new countries for ANI support as per 25Q2VI BER Article 1.2 Requirements |
|
|
11/04/2025 |
Added currency code for the Caribbean Guilder currency (XCG) for Curacao and Sint Maarten in ISO Currency Code. 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. Updated the schemas in the Downloads page. The effective date is for the 11th of April. |
Global Transaction Reporting Guide |
|
11/04/2025 |
Updated Visa Account Updater page to include new communication flow and Opt-In and Opt-Out features |
28th March 2025
|
Date |
Description |
Guide |
|---|---|---|
|
28/03/2025 |
New Connecting to Thredd Guide available, describing Thredd's Secure Connectivity Framework and how to connect securely to Thredd. A product sheet for Connecting to Thredd is also available in the Products Sheet section. |
|
|
28/03/2025 |
Updated the maximum length of the TITLE field to 4 characters, and the SNAME field to 20 characters. |
|
|
28/03/2025 |
The maximum length of the City, Dlv_City and Delv_City parameters have been updated to 50 characters across all web services where these parameters are used. |
|
|
28/03/2025 |
Added a new appendix, describing the WebServiceResult parameter, which is returned in the response to some web services when the request includes the same WSID as a previously submitted request. |
|
|
28/03/2025 |
Added Scam Transaction Monitoring Webhook Notification section to Managing Scams. |
21st March 2025
|
Date |
Description |
Guide |
|---|---|---|
|
21/03/2025 |
Multiple EHI endpoint functionality discontinued. |
|
|
21/03/2025 |
The date for PRN-202 for Credit and Debit ASIs has been changed to the 22nd April 2025. |
14th March 2025
|
Date |
Description |
Guide |
|---|---|---|
|
14/03/2025 |
Corrected tokenised_datetime, payment_token_expdate, and wallet_reasons to optional in the response of the Payment Token Get (Ws_Payment_Token_Get) web service. Added MRCHTOKEN as an example for wallet_id. Set the minimum value of wallet_reasons to 0. Corrected the name for the field gps_status. |
7th March 2025
|
Date |
Description |
Guide |
|---|---|---|
|
07/03/2025 |
Updated descriptions and examples for How to handle processing errors due to invalid characters. |
|
|
07/03/2025 |
Added extra values 100 and 101 for ‘Message_Why’ field in Appendix A.26 (Response_Source_Why + Message_Why). See PRN-218. |
|
|
07/03/2025 |
Added references to the Discover network. Also included new elements and sub-elements that are used in the Discover network. Indicated elements that are not applicable to the Discover network. |
|
|
07/03/2025 |
Updated ASI descriptions to include Future Amount and EHI implications. Updated PRN-202 to TBC. |
28th February 2025
|
Date |
Description |
Guide |
|---|---|---|
|
28/02/2025 |
Updates to the Cards API, including NetworkSharingOptOut being added to the Update Card and Retrieve Card endpoints. |
|
|
28/02/2025 |
Updated the example request body for Apple In-App Provisioning in the Tokenisation Guide and in the Cards API documentation. |
|
|
28/02/2025 |
Added section on Multi-Factor Authentication when logging in to Smart Client and PANFinder. See PRN-216. |
21st February 2025
|
Date |
Description |
Guide |
|---|---|---|
|
21/02/2025 |
Added details of how to set up multiple EHI endpoints (URLs). |
|
|
21/02/2025 |
Added notes to clarify the effect of passing an empty space as a value in specific fields in the 3D Secure Configuration (Apata) (Ws_ApataCardLevelConfigurations) web service. |
14th February 2025
|
Date |
Description |
Guide |
|---|---|---|
|
14/02/2025 |
Added references on the Documentation Portal and in our guides to Thredd Portal, our new web application for managing your cards and transactions. New product sheet and guide for Thredd Portal now available. |
|
|
14/02/2025 |
Added notes to clarify the effect of passing an empty space as a value in specific fields in the 3D Secure Configuration (Apata) (Ws_ApataCardLevelConfigurations) web service. See Using the Card Configuration API. |
|
|
14/02/2025 |
Amended the date of PRN-209 to the 26th of March, with future versions of the schemas available on the the Downloads page. See PRN and Downloads pages. |
|
|
14/02/2025 |
Added new processing codes for Credit Account Status Inquiry (ASI) and Debit ASI to the Processing Codes page in the EHI guide. Created Overview page on Credit and Debit ASIs. See PRN-202 |
|
|
14/02/2025 |
Updated the description of the 9030 reason code in the Visa_STIP_Reason_Code field. |
|
|
14/02/2025 |
New Webhooks product sheet, describing the Thredd Event Delivery System, added to the Product Sheets section on the Documentation Portal. |
7th February 2025
|
Date |
Description |
Guide |
|---|---|---|
|
07/02/2025 |
Clarified which fields are used in the Thredd API to populate the Card Purchaser field details in Smart Client. |
|
|
07/02/2025 |
Clarified use of the Fulfilment object in a Create Card request. |
|
|
07/02/2025 |
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. Updated the Downloads page to indicate upcoming schema versions. |
Global Transaction Reporting Guide |
|
07/02/2025 |
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. See PRN-210. |
|
|
07/02/2025 |
Added a new web service, (Ws_GetApataCardLevelConfigurations) to be used to retrieve the card level configuration for Apata. |
|
|
07/02/2025 |
New endpoint added to support loading and unloading BIN sponsored cards for issuers. |
|
|
07/02/2025 |
Added an FAQ to explain differences between the balance reporting in the balance XML file and the balance in Smart Client for Primary and secondary cards. |
31st January 2025
|
Date |
Description |
Guide |
|---|---|---|
|
31/01/2025 |
Updates to the Fees product sheet to include details of Thredd's new advanced fee options for complex country and currency combinations. |
|
|
31/01/2025 |
New product sheet describing MVCs. |
|
|
31/01/2025 |
New Appendix H: Card Status Codes — lists card status changes that trigger calls to Token Service Provider (MDES/VDEP). |
|
|
31/01/2025 |
Added Orange Flow section to How Tokenisation Works page. |
|
|
31/01/2025 |
Added a new chapter describing Chip Management on the Thredd Platform. |
|
|
31/01/2025 |
Updated In-App Provisioning endpoints in Cards API. |
|
|
31/01/2025 |
Updated description of the LocalDateUTC field to explain that this is the date and time of the matching authorisation. |
|
|
31/01/2025 |
Section describing BIN Attacks added to Analytics page. |
|
|
31/01/2025 |
New update to Cards API which adds string cleaning to cardholder name fields in the Create Card and Update Card endpoints. |
24th January 2025
|
Date |
Description |
Guide |
|---|---|---|
|
24/01/2025 |
New product sheet describing the Thredd Multi-currency settlement service for Visa transactions. |
|
|
24/01/2025 |
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. See PRN-203. |
|
|
24/01/2025 |
Added 3169 RIYADH AIR to Merchant Category Codes. |
17th January 2025
|
Date |
Description |
Guide |
|---|---|---|
|
17/01/2025 |
Reinstated old IP addresses for PRD1 and PRD2 environments. |
|
|
17/01/2025 |
Added Incremental Authorisation example messages. |
|
|
17/01/2025 |
For the Status Code for Closed Account (46), updated Mastercard response code from 78 to 14. |
|
|
17/01/2025 |
Corrections to JSON tokenisation examples: ACN, TCN and TEN messages should have Txn_Type = J. ACN messages should have an MTID = 0120, while TCN and TEN messages have an MTID = 0620. |
|
|
17/01/2025 |
Added the V1045D0082 tag, 35AN Plan Registration System Identifier, to the Misc_TLV_Data Field. |
10th January 2025
|
Date |
Description |
Guide |
|---|---|---|
|
10/01/2025 |
Updated the Downloads page in line with new reporting release to indicate that global and legacy reporting schemas are now current. |
|
|
10/01/2025 |
Added descriptions on the REG suffix used in filenames of regenerated reports |
Global Transaction Reporting Guide
|
|
10/01/2025 |
Added a note to indicate that the functionality to update the balance in Mode 4 (Gateway Processing with STIP) is currently only available via SOAP Web Services. |
3rd January 2025
|
Date |
Description |
Guide |
|---|---|---|
|
03/01/2025 |
New Webhook event, to support notifying a customer when a card status changes, released. |
|
|
03/01/2025 |
Updated server and URL names to reflect RDX movement to the cloud environment. Removed RDX details on disaster recovery. |
|
|
03/01/2025 |
Clarified explanations of enrolment and unenrolment. Removed descriptions on Batch to RDX Upgrade in the 3D-Secure Cardinal guide. |
|
|
03/01/2025 |
New This field is optional, and specifies the Out of Band URL to be used during a 3D Secure authentication session. See PRN-201. |
13th December 2024
|
Date |
Description |
Guide |
|---|---|---|
|
13/12/2024 |
December quarterly release notes now available. |
|
|
13/12/2024 |
New endpoints to support Custom PANs. |
|
|
13/12/2024 |
Removed the requirement to have your public IP address(es) added to the ‘allowed’ list to use CTS. See Accessing CTS |
|
|
13/12/2024 |
Updated the maximum length of the location field in the Term element to 128 characters. See Sub-elements and Attributes: Term. |
|
|
13/12/2024 |
Updated the FIID element to indicate that it is not required. See CardChrdBackRepRes |
|
|
13/12/2024 |
Updated the format of the Acquirer_Reference_Data_031 field to AN(8,23). See PRN-200. |
6th December 2024
|
Date |
Description |
Guide |
|---|---|---|
|
06/12/2024
|
Corrected the case format of the LogoFrontId and LogoBackId.Update fields in the Cardholder Details (V2)(Ws_Update_Cardholder_Details_V2) web services, |
29th November 2024
|
Date |
Description |
Guide |
|---|---|---|
|
29/11/2024 |
New Card Chip Parameters Guide: describes how to configure the chip parameters on your physical cards to work with Thredd. |
|
|
22/11/2024
|
New Reports section added. |
22nd November 2024
|
Date |
Description |
Guide |
|---|---|---|
|
22/11/2024 |
Links to information on the Discover Network are now available from: - The Doc Portal home page (Partnership Network section) - The Products and Services menu - The Technical Documentation menu
|
|
|
22/11/2024
|
Added the following reason codes for authorisation: 3717, 3748, 3755. |
|
|
22/11/2014 |
Updated minimum length requirement of PAN in the <Card> element to 14 digits. Added new ISO currency code: 924. See PRN-196 and PRN-197. Updated the schemas in the Downloads page. The effective date is for the 9th of January. |
Global Transaction Reporting Guide
|
|
22/11/2024 |
Updates to the Cards API: The maximum number of cards that can be created in a single request within the Card Bulk Create Endpoint has been increased from 50 to 1000. Introduced a 30-minute frequency gap between multiple bulk card creation requests. |
|
|
22/11/2024 |
Updates to the Cards API, where CardholderName is removed on the example within the Introduction to Fraud Alert Service. |
|
|
22/11/2024 |
Added OptOut parameter to the Ws_Update_Cardholder_Details_V2 and the Ws_Cardholder_Details_Enquiry_V2 web services. See PRN-199 |
15th November 2024
|
Date |
Description |
Guide |
|---|---|---|
|
15/11/2024
|
Reorganisation of the Fees guide to provide separate sections and content updates for Authorisation Fees, Recurring Fees and API Usage Fees. Guide updates to reflect the new advanced fees functionality. New sections added: Fee Application and Fee Reconciliation, Fee Use Cases, Appendix 7: Advanced Authorisation Fee Examples and Appendix 8: Applying Fees to FX Transactions. |
|
|
15/11/2024
|
Updated the description of response code 61 to remove the previous restriction on Visa usage, as this code is now supported by Visa. See Response Status Values. |
|
|
15/11/2024 |
Corrected the types for several fields for the wireDetails derived type. |
|
|
15/11/2024 |
Updated the AVS page to include a new diagram, results information, and availability as part of Visa Article 1.5. Added a new page on ANI (Account Name Inquiry) as part of Visa Article 1.3. |
|
8th November 2024
|
Date |
Description |
Guide |
|---|---|---|
|
08/11/2024 |
New FAQ added to answer common questions around Virtual to Physical Card conversion. |
|
|
08/11/2024 |
Update to Cards API, including new fields added to Unblock CVV and Update Card Controls Endpoints. |
|
|
08/11/2024 |
Updated the description of the "Desc" field maximum value to 500 characters. |
|
|
08/11/2024 |
Added examples of tokenisation messages to the section GetTransaction Example Messages. |
|
|
08/11/2024 |
Updated the description of response code 61 to remove the previous restriction on Visa usage, as this code is now supported by Visa. |
|
|
08/11/2024 |
Updated AVS Results page. Removed unused codes, and clarified address and postcode/zip code results for US and non-US addresses. |
1st November 2024
|
Date |
Description |
Guide |
|---|---|---|
|
01/11/2024 |
Added FAQ item on Mastercard STIP. See General FAQs. |
|
|
01/11/2024 |
Updated Type in the 3D Secure Credentials (Cardinal and Apata) (Ws_AddUpDelCredentials) web service to clarify that OTPEMAIL is supported by Apata only. |
|
|
01/11/2024 |
Added a new action code of 591, returned if the Type is PREQUALIFIED and ComplianceData is missing. See Action Codes. |
|
|
01/11/2024 |
Added a new field, ComplianceData and new customer types (Type), to the Register a Customer for Banking web service. |
25th October 2024
|
Date |
Description |
Guide |
|---|---|---|
|
25/10/2024 |
Added Discover card type to the ACCTYPE element in the Balance XML Schema. Amended the effective status of PRN-192 and PRN-194 to be TBD. |
|
|
25/10/2024 |
Amended the Downloads page to include: THRD-BAL.v1.11.xsd (Future Versions) GPS-balexp.V1.12.xsd (Legacy Balance Reports) |
|
|
25/10/2024 |
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. See PRN-195. |
18th October 2024
|
Date |
Description |
Guide |
|---|---|---|
|
18/10/2024 |
New guide documenting Scam Transaction Monitoring released. |
|
|
18/10/2024 |
Two new fields added to the Unblock PIN endpoint. See PRN-191. |
|
|
18/10/2024 |
Rewrite to section Managing your Program, introducing new use cases and details of how to implement using either SOAP API or REST API. New Appendix G: Realtime Token Status Change. Revision to FAQ on using Thredd's In-app provisioning service. |
15th October 2024
|
Date |
Description |
Guide |
|---|---|---|
|
15/10/2024 |
Added the MVC Token Indicator to the Card subelement, included a new schema file and updated examples. See: PRN-192. |
|
|
15/10/2024 |
Added the following Global Reporting schema files to the Downloads page: THRD-NCLR.v1.50.xsd, THRD-CLR.v1.10.xsd, THRD-BAL.v1.10.xsd. |
4th October 2024
|
Date |
Description |
Guide |
|---|---|---|
|
04/10/2024 |
Added the Auth_type subelement, included a new schema file and updated examples. See: PRN-185. |
|
|
04/10/2024 |
Removed SecID, SecVal and SecValPos parameters from web services Record Descriptions and example requests. Removed 817, 818 and 828 from the Action Codes page. See PRN-189 |
|
|
04/10/2024 |
Added the Global Reporting schema file, THRD-NCLR.v1.49.xsd, to the Downloads page. |
20th September 2024
|
Date |
Description |
Guide |
|---|---|---|
|
20/09/2024 |
Correction made to the element descriptions. |
|
|
20/09/2024 |
Updates to Fraud Transaction Monitoring product sheet to include Scam Transaction Monitoring. |
|
|
20/09/2024 |
Added a new section with important information on Configuring Token Sub-Bin Ranges. |
|
|
20/09/2024 |
Changes made to Cards API, including new fields in the Create Bulk Physical Cards and Update Card endpoints |
|
|
20/09/2024 |
Removed isConfiguredGroup from the Get Card Acceptors endpoint. See PRN-186. |
13th September 2024
|
Date |
Description |
Guide |
|---|---|---|
|
13/09/2024 |
Added section on how to show card details to cardholder, and added a new section on Using the Cards API (REST). |
|
|
13/09/2024 |
New Global Reporting product sheet now available on the Documentation Portal Product Sheets page. |
6th September 2024
|
Date |
Description |
Guide |
|---|---|---|
|
06/09/2024 |
New Global Balance Reporting Guide available. |
|
|
06/09/2024 |
New Global Transaction Reporting Guide available. |
|
|
06/09/2024 |
New Global reporting schema files now available. |
|
|
06/09/2024 |
The inclusion of the Merch_Country field is typically Optional, but may be mandatory in certain cases, depending on the program or service being processed. |
|
|
06/09/2024 |
Updated the list of support card manufacturers on the Card Manufacturers page. |
23rd August 2024
|
Date |
Description |
Guide |
|---|---|---|
|
23/08/2024 |
Corrections to sample examples in Initiating a Biometric Session and Cancelling an authentication sections. |
|
|
23/08/2024 |
Added notes to clarify that some credit/refund transactions may be reported as follows:
|
|
|
23/08/2024 |
Updated the maximum length of the <BULK_ADD1>, <BULK_ADD2> and <BULK_ADD3> fields to 100 characters. |
16th August 2024
|
Date |
Description |
Guide |
|---|---|---|
|
16/08/2024 |
Updated the description of <AccNo> in the Card Enquiry (Ws_Enquiry) web service. |
|
|
16/08/2024 |
Added CITE RENT-A-CAR to Merchant Category Codes. |
9th August 2024
|
Date |
Description |
Guide |
|---|---|---|
|
09/08/2024 |
The footer of the Docs Portal now includes links to the Privacy Policy, Cookie Policy, and Thredd.com. |
|
|
09/08/2024 |
New section added showing fee examples. |
|
|
09/08/2024 |
Update to the description of Txn_GPS_Date. |
|
|
09/08/2024 |
Clarification that response code 96 may trigger card Scheme Stand-In Processing (STIP) for both Visa and Mastercard, depending on your STIP setup. |
2nd August 2024
|
Date |
Description |
Guide |
|---|---|---|
|
02/08/2024 |
In the CardChrgBackRepRes element, clarified that FIID, RIID, and ChargebackRefNum are populated only for Mastercard chargebacks. |
|
|
02/08/2024 |
Added "U - No data received" to the list of possible AVS Results. |
|
|
02/08/2024 |
Added sort functionality to the tables in the online guide version. Revised the GetTransaction WSDL example (XML Guide). |
|
|
02/08/2024 |
Added some FAQs on the use of the WSID field and the importance of ensuring this is always unique. See the FAQs. |
|
|
02/08/2024 |
Added references to Cards API Website (REST). |
|
|
02/08/2024 |
Updated diagrams to include Discover network. |
19th July 2024
|
Date |
Description |
Guide |
|---|---|---|
|
19/07/2024 |
Updated Tokenisation Guide to include new In App Provisioning functionality. |
|
|
19/07/2024 |
Released the beta version of the webhook framework, including the full release of automated fraud alerts. |
|
|
19/07/2024 |
Update to the example in the Visa Account Updater (VAU) service page. |
12th July 2024
|
Date |
Description |
Guide |
|---|---|---|
|
11/07/2024 |
New page documenting Primary and Secondary Card behaviour in Cards API. |
|
|
11/07/2024 |
Updated Managing your Programme to update Mastercard update file frequency. |
|
|
11/07/2024 |
Updated the definition for CrdProduct and ProductID for List Products (Ws_List_Products) web service. Changed the minimum value of MaskedPan to 14. |
|
|
11/07/2024 |
Added section on adding a one-off fee using REST to Fee Maintenance (Cards API). |
8th July 2024
|
Date |
Description |
Guide |
|---|---|---|
|
08/07/2024 |
Thredd office address change. |
All documents on the Documentation Portal. |
|
08/07/2024 |
Changes to the Cards API, including new fields in the Get Card Transactions and Update Card Control Groups endpoints |
|
|
08/07/2024 |
Added Master Virtual Cards page to the Products & Services section. |
28th June 2024
|
Date |
Description |
Guide |
|---|---|---|
|
28/06/2024 |
Consolidated the Get Allowed Merchants and Get Disallowed Merchants endpoints into a new singular endpoint (Get Get Card Acceptor endpoint). See PRN-183. |
|
|
28/06/2024 |
Added examples of EHI 34000, 35000, 36000 and 37000 tokenisation messages. See Appendix C: EHI Tokenisation Fields. |
|
|
28/06/2024 |
Added descriptions of the different types of chargeback records that can be provided in the CardChrgBackRepRes element. |
|
|
28/06/2024 |
Removed the MTID value of 0100 from the Automatic Authorisation Reversal message on the Transaction Matching and GetTransaction Message Fields pages. |
21st June 2024
|
Date |
Description |
Guide |
|---|---|---|
|
21/06/2024 |
New Getting Started Guide to introduce fraud rules in Fraud Transaction Monitoring. |
|
|
21/06/2024 |
Removed references to the Forwarding a PIN request to an External API option, which is no longer supported. |
|
|
21/06/2024 |
Changes made to Cards API, including new fields added to the Retrieve Card endpoint. |
|
|
21/06/2024 |
Correction to EHI Guides — an Automatic Authorisation Reversal message should have an MTID value of 0100. See Transaction Matching and GetTransaction Message Fields. |
14th June 2024
|
Date |
Description |
Guide |
|---|---|---|
|
14/06/2024 |
Changes made to Cards API, including new fields added to responses of the Retrieve Card and List Card Control Groups endpoints, as well as changes to limit checks when adjusting the balance of a card. |
7th June 2024
|
Date |
Description |
Guide |
|---|---|---|
|
07/06/2024 |
Release date for the 'Extended Authorization Indicator' in GPS_POS_DATA field position 32, revised to 2nd July. See PRN-182. |
|
|
07/06/2024 |
Updated the definition for |
31st May 2024
|
Date |
Description |
Guide |
|---|---|---|
|
31/05/2024 |
Clarification on use of the 3-digit country code for Romania. |
|
|
31/05/2024 |
Added a new value to the GPS_POS_DATA field position 32, to indicate, whether the acquirer requested a 30-day clearing extension (Visa Only). See PRN-182. |
24th May 2024
|
Date |
Description |
Guide |
|---|---|---|
|
24/05/2024 |
Changed the |
|
|
24/05/2024 |
Updated the card status and response code mappings. See Full List of Thredd Card Status Codes. |
20th May 2024
|
Date |
Description |
Guide |
|---|---|---|
|
20/05/2024 |
New guide supporting client landlord users of the Fraud Portal. |
|
|
20/05/2024 |
Changes made to Cards API, including new fields added to responses of the Retrieve Card, Get 3DS Configuration, and Get Product for Program Manager endpoints. |
|
|
20/05/2024 |
Added details of processing chargebacks for US debit cards on Mastercard Network Exchange (MNE). |
10th May 2024
|
Date |
Description |
Guide |
|---|---|---|
|
10/05/2024 |
Added details on the var and rules scope for rule scores using the @score annotation to the Rules Configuration Guide. |
3rd May 2024
|
Date |
Description |
Guide |
|---|---|---|
|
03/05/2024 |
Added Thailand and The Philippines to the list of countries we support in the Asia Pacific region. Updated our North American region page to include support for US debit processing. |
|
|
03/05/2024 |
Update to list of supported Card Manufacturers. |
|
|
03/05/2024 |
Thredd Quarterly Release Notes now available on the Documentation Portal, in the What's Changed section. |
|
|
03/05/2024 |
Corrected name of heading to describe HTTP response in Using the Delegated SMS API. |
26th April 2024
|
Date |
Description |
Guide |
|---|---|---|
|
26/04/2024 |
Changes made to the behaviour of Master Virtual Cards and the Get Token Details response. |
|
|
26/04/2024 |
Added details of use of Card Biometric Authentication as a card security feature. See Card Security Features. |
|
|
26/04/2024 |
Updates to field descriptions in JSON Data Types and EHI Fields. |
|
|
26/04/2024 |
Revised description of the usage of the 0101 A Authorisation Repeat message (Visa Only). See Transaction Matching. |
|
|
26/04/2024 |
Updates to content and graphics to align with taxonomy updates on our Documentation Portal to the following guides: Smart Client Guide, Physical Cards Guide, Fraud Transaction Monitoring Guides, SMS Guide, IVR Guide, MVC Guide, Dynamic CVV2 Guide, PAN Finder Guide, Third Party Web Services Guide, Thredd Card Status and Response Codes, Guide Payments Dispute (Chargeback) Guide, Virtual Cards Guide and Fraud Reporting Guide. |
|
19th April 2024
|
Date |
Description |
Guide |
|---|---|---|
|
19/04/2024 |
Added French Territories (Guadeloupe, French Guiana, Martinique, Mayotte, Saint-Martin, Saint-Barthélemy, and Réunion) to the list of supported countries. |
|
|
19/04/2024 |
CardManufacturer removed from the Manufacturing Details object in the Create Card endpoint. See PRN-177. |
12th April 2024
|
Date |
Description |
Guide |
|---|---|---|
|
12/04/2024 |
Updates to content and graphics to align with taxonomy updates on our Documentation Portal to the following guides: 3D Secure Guides, Transaction Reporting Guides, Balance Reporting Guide, Tokenisation Guide, Card Generation Interface Specification Guide, Introduction to Cards Payments Guide, Cardholder XML Report Guide, Virtual Cards Guide and CTS Guide. |
|
|
12/04/2024 |
Correction to file format naming convention and examples. |
|
|
12/04/2024 |
Added descriptions of Client-Managed OTP SMS authentication. |
5th April 2024
|
Date |
Description |
Guide |
|---|---|---|
|
05/04/2024
|
For clarity on shared balances, moved subsection to MVC Setup Options. |
|
|
05/04/2024 |
Virtual Cards changed to be created in an active status by default. See PRN-178. |
|
|
05/04/2024 |
Clarification on use of action code 104.
|
|
|
05/04/2024 |
Added descriptions of usage of positions 27-31 in the GPS_POS_Data field. See the GPS_POS_Data Field. |
28th March 2024
|
Date |
Description |
Guide |
|---|---|---|
|
28/03/2024 |
Updates to content and graphics to align with taxonomy updates on our Documentation Portal to the following guides:
|
|
|
28/03/2024 |
Cards API: Examples in documentation and Postman Collection updated to camel case. |
|
|
28/03/2024 |
Additional information added on use of REST-based Cards API to manage fees, |
|
|
28/03/2024 |
New Sandbox Replay section added to Fraud Portal Guide. |
22nd March 2024
|
Date |
Description |
Guide |
|---|---|---|
|
22/03/2024 |
New EHI Guide for Single Message Systems published. |
|
|
22/03/2024 |
Updates to content and graphics to align with taxonomy updates in our Cards API documentation. |
|
|
22/03/2024 |
Updates to endpoint URLs and examples in Using the Biometric/In-App Authentication APIs. Updates to a field name in the Delegate SCAValidation Message Fields. |
15th March 2024
|
Date |
Description |
Guide |
|---|---|---|
|
15/03/2024 |
Added note to state that EHI feeds in JSON cannot send fields to externally hosted systems where the data values are blank. This differs from EHI data feeds for XML that allow the sending of fields with blank values. |
|
|
15/03/2024 |
Updates to endpoint URLs and examples in Using the Biometric/In-App Authentication APIs. Updates to a field name in the Delegate SCAValidation Message Fields. |
|
|
15/03/2024 |
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. For more information, see PRN-179. |
|
|
15/03/2024 |
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. |
|
|
15/03/2024
|
Updates made to the Cards API, including new fields for the Get 3DS Configuration and Get Card Transactions endpoints. |
|
|
15/03/2024 |
New terminology introduced around EHI modes: Gateway Processing (mode 1), Cooperative Processing (mode 2), Full Service Processing (mode 3) and Gateway Processing with STIP (modes 4, 5). See EHI Modes. |
|
|
15/03/2024 |
Updates to content and graphics to align with taxonomy updates on our Documentation Portal. |
8th March 2024
|
Date |
Description |
Guide |
|---|---|---|
|
07/03/2024 |
In the Card Send Files ( |
|
|
07/03/2024 |
In the Card Renew ( |
|
|
07/03/2024 |
Correction to description of the processing code for ASI transactions listed in the FAQs section. Should be 39. |
|
|
07/03/2024 |
Clarified how the transaction status of Cleared (C) and Settled (S) impacts the card balance. See Transaction Status Codes. |
1st March 2024
|
Date |
Description |
Guide |
|---|---|---|
|
26/02/2024 |
Added Network field to Transaction Details page and added reference to new transaction types. |
|
|
29/02/2024 |
Mastercard Network Exchange functionality added to Standard and STIP tests. |
|
|
27/02/2024 |
Updated the description of the BLKAMT field. See the ACCOUNT element. |
|
|
01/03/2024 |
Refresh of product sheets to bring them up-to-date. |
23rd February 2024
|
Date |
Description |
Guide |
|---|---|---|
|
23/02/2024 |
New pages in the products and Services section to describe the Thredd Partnership network, Thredd use cases and options around Physical card setup. Updates to the EHI transaction processing option selector wizard. Other menu updates and content enhancements. |
|
|
21/02/2024 |
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. See PRN-172. |
|
|
23/02/2024 |
Added details of how to add, update or delete card level configurations for Apata, such as the language of the Apata Challenge screens and the Challenge Profile to use. |
|
|
23/02/2024
|
Updates to the Cards API, including a new Bulk Create Cards endpoint and support for idempotent endpoints. |
|
|
23/02/2024 |
Updated descriptions on Knowledge Based Authentication in Cardholder Authentication Flows, added the Production API endpoints to Authorising Thredd IP Addresses, updated reference details in Appendix 6: Biometric OOB Fields. Updated description on adding reports to email in Analytics. Corrections to screenshots. These include: Figure 3: 3D Secure Authentication Process – Using 3D Secure and Biometrics or Out of Band (OOB), Figure 7: OTP SMS Challenge Screen Customisation and Figure 11: 3D Secure Authentication Screens - for Biometric |
16th February 2024
|
Date |
Description |
Guide |
|---|---|---|
|
16/02/2024 |
Products and Services menu updates. New topics added to the Products and Services > Programme Delivery section: Support for your Project, New Programmes, Project implementation process and Environments. New topic added to the Account Management section: Account Support. New topic added to the Customer Experience Enablers section: Card Management APIs. |
|
|
15/02/2024 |
Added examples of Financial Reversals (1240 type E messages). |
|
|
15/02/2024 |
Updated the list of values that can be returned in the Visa_ResponseInfo_DE44 field position 5 (CVV/iCVV/dCVV result). See Visa_ResponseInfo_DE44. |
|
|
15/02/2024 |
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. See PRN-170. |
|
|
15/02/2024 |
When creating a card, clarified that CreateType option 3 works the same as option 1. See Card Create (Ws_CreateCard), Card Bulk Create (Ws_BulkCreation), Wallet Create (Ws_CreateWallet) and Wallet Bulk Create (Ws_BulkWalletCreation). |
9th February 2024
|
Date |
Description |
Guide |
|---|---|---|
|
07/02/2024 |
Added details of additional values in the <DELV_METHOD> field. |
|
|
09/02/2024 |
Revamp and reorganisation of the navigation menus and content sections on the Documentation Portal. We have also released a new section on Country Support (accessed from the Support menu), and new content about our Risk Management and Fraud solutions. |
2nd February 2024
|
Date |
Description |
Guide |
|---|---|---|
|
02/02/2024 |
New guides on Fraud Transaction Monitoring for:
|
|
|
02/02/2024 |
A new product sheet for our 3D Secure (Apata) service is now available |
|
|
02/02/2024 |
A new product sheet for Fraud Transaction Monitoring is now available |
|
|
02/02/2024 |
A new guide on Master Virtual Cards (MVC) is not available |
|
|
02/02/2024 |
Added the WebServiceResult parameter to the following web services: Card Balance Transfer (Ws_BalanceTransfer) and 3D Secure Credentials (Ws_AddUpDelCredentials).
|
|
|
02/02/2024 |
Updated the list of prerequisite software required before installing Smart Client. |
26th January 2024
|
Date |
Description |
Guide |
|---|---|---|
|
26/01/2024 |
Updated the description for action code 119. Added action code 575. |
|
|
26/01/2024 |
Updated Glossary, Cards API to reference the new 3D Secure Apata guide. |
|
|
26/01/2024 |
Added details of changes to the available file formats. See File Formats. |
19th January 2024
|
Date |
Description |
Guide |
|---|---|---|
|
19/01/2024 |
Updates made to Cards API, including changes to the Create Card endpoint. |
12th January 2024
|
Date |
Description |
Guide |
|---|---|---|
|
08/01/2024 |
Removed the CardDesign field from the Card Activate and Load (Ws_Activate_Load) web service. |
|
|
10/01/2024 |
Added details to clarify the usage of the Resp_Code_DE39 field. See GetTransaction Message Fields. |
|
|
12/01/2024 |
Updated the Cards API Sandbox to match the latest version of the UAT. |
5th January 2024
|
Date |
Description |
Guide |
|---|---|---|
|
03/01/2024 |
Added a new page to describe the HTTP header fields in EHI request and response messages. |
|
|
03/01/2024 |
Added a note to clarify that the EHI message response should not contain the value "null" in any response fields where EHI is expecting a numeric value, as this may result in EHI declining the transaction. |
|
|
03/01/2024 |
Added Smart Client download links to PRD1 and PRD2 environments. |
|
|
03/01/2024 |
Clarified usage of the Auth_Code_DE38 field: an authorisation code is generated for both approved and declined authorisations. |
|
|
02/01/2024 |
Updated the description of action code 439. |
|
|
05/01/2024 |
Added Biometric endpoint content on Apata. This includes updates in the following areas:
|
29th December 2023
|
Date |
Description |
Guide |
|---|---|---|
|
29/12/2023 |
PRN Page on Doc Portal: Release date for PRN-159 revised to 21st February, 2024. |
21st December 2023
|
Date |
Description |
Guide |
|---|---|---|
|
21/12/2023 |
Revised note on EHI mode restrictions when applying fees and recurring payments. See Fees and EHI Mode. |
|
|
21/12/2023 |
Added a reference to the Fees Guide, which provides further guidance on applying card fees using web services. |
|
|
21/12/2023 |
Updated the list of card Status Codes that can be used when setting the status of a card using the Card Change Status (Ws_Status_Change) web service. |
|
|
21/12/2023 |
Updated the description of action code 952. |
15th December 2023
|
Date |
Description |
Guide |
|---|---|---|
|
13/12/2023 |
Added details of how to use the Resp_Code_DE39 field when returning a decline response to Thredd. See the appendix Resp_Code_DE39 Values. |
|
|
13/12/2023 |
Added MCC code 5262 to the Merchant Category Codes page. |
|
|
15/12/2023 |
Updated 3DS Credentials endpoint, added new flags to Get Product endpoint and other changes. |
24th November 2023
|
Date |
Description |
Guide |
|---|---|---|
|
23/11/2023 |
Updates to the description of the fields in the Product Setup Form (PSF), added sections describing new features on the Apata Portal, plus other corrections. |
17th November 2023
|
Date |
Description |
Guide |
|---|---|---|
|
17/11/2023 |
Multiple clarifications and corrections across the document based on feedback. Updated Smart Client screen shots in Managing Chargebacks on Smart Client and Case Filing. |
|
|
17/11/2023 |
Removed references to the following web services, which were deprecated 30/07/2021: |
10th November 2023
|
Date |
Description |
Guide |
|---|---|---|
|
10/11/2023 |
New Thredd AI Chatbot added to the Documentation Portal. |
|
|
02/11/2023 |
Correction to matching logic table for transactions of type 1240 N |
3rd November 2023
|
Date |
Description |
Guide |
|---|---|---|
|
31/10/2023 |
Editorial review of content including the re-branding of all screen shots. |
|
|
31/10/2023 |
Removed references to creating multiple chargebacks from Managing Chargebacks. |
|
|
02/11/2023 |
Updates to the WSDL for the EHI XML version. See GetTransaction WSDL. |
|
|
03/11/2023 |
New Get 3DS Configuration endpoint, and string cleaning added to certain fields in the Create Card and Update Card endpoint. |
27th October 2023
|
Date |
Description |
Guide |
|---|---|---|
|
26/10/2023 |
New 3D Secure Guide for Apata. |
|
|
27/10/2023 |
Two optional boolean fields, See PRN-165. |
17th October 2023
|
Date |
Description |
Guide |
|---|---|---|
|
17/10/2023 |
Two optional boolean fields, |
|
|
15/10/2023 |
Removed the Correction: In the Card Create web service section, updated the table of fields to include the |
13th October 2023
|
Date |
Description |
Guide |
|---|---|---|
|
13/09/2023 |
New Get Encrypted Data added, as well as changes to the behaviour of the Create Card, Update Card, Renew Card and Replace Card endpoints. |
|
|
12/09/2023 |
Updated Smart Client Screenshots in Virtual Cards, Agency Banking, PSD2, Tokenisation and Fraud Reporting guides. |
|
|
12/10/2023 |
In the section Checking fields used for 3D Secure Authentication, added a note and reference to the PSD2 and SCA Guide. |
|
|
21/09/2023 |
Added details to clarify that the EHI field PaymentToken_creatorStatus can contain “ “ or be empty when no value has been provided. |
|
|
21/09/2023 |
Added details to clarify that the field PaymentToken_creatorStatus can contain “ “ or be empty when no value has been provided. |
|
|
05/10/2023 |
Correction to text in Scenario 1 in Appendix E: Mastercard Tokenisation Messages. The EHI ProcCode received in Green Flow should be "350000 (TCN)". |
29th September 2023
|
Date |
Description |
Guide |
|---|---|---|
|
29/09/2023 |
Changed behaviour for cards with the Security Violation status, added field length validation to fields in Create Card endpoint, and card balance set to zero when setting a card status to either Refund to Customer or Card Voided. |
15th September 2023
|
Date |
Description |
Guide |
|---|---|---|
|
11/09/2023 |
Correction: In the Card Create web service section, updated the table of fields to include the ItemID field in the response, and the example response to include the StartDate field. |
|
|
15/09/2023 |
Updates made to Create Card and Update Card endpoints. |
|
|
12/09/2023 |
Added details of the new Fetch 3DS Credentials button, available on the Card Master screen. |
|
|
12/09/2023 |
Updated wording in Introduction section. |
25th August 2023
|
Date |
Description |
Guide |
|---|---|---|
|
25/08/2023 |
Added information on the interchange fee received in the Interchange_Amount_Fee and Interchange_Amount_Fee_Settlement fields. |
|
|
25/08/2023 |
In the section PRD1 and PRD2 - Cloud Production Environments, updated the oAuth endpoint for PRD2 to |
21st August 2023
|
Date |
Description |
Guide |
|---|---|---|
|
14/08/2023 |
Correction to the list of Visa documents that must be completed when implementing a tokenisation project through Visa. |
|
|
14/08/2023 |
Update to Figure 3. Thredd support during your project. |
11th August 2023
|
Date |
Description |
Guide |
|---|---|---|
|
11/08/2023 |
Updated FAQs page with queries raised using the AI Chatbot. |
|
|
10/08/2023 |
Removal of Ws_Check web service and update to glossary and action codes to only show what is relevant to third party web services. |
|
|
11/08/2023 |
Updates to the introduction section. You should contact Operations for further details about generating this report. |
|
|
03/08/2023 |
Correction to System architecture image. |
|
|
08/08/2023 |
Correction: In the Create Payment Token (Ws_PaymentToken_Create) web service, one of the supported values that can be used in the WalletID field should be SAMSUNG, Using a value that is not supported will return an action code of 439. |
|
|
08/08/2023 |
Added a note to clarify that the Token Device Management web service (Ws_Token_Device_Management) is for use on the Visa (VDEP) service only. |
4th August 2023
|
Date |
Description |
Guide |
|---|---|---|
|
03/08/2023 |
Updated FAQs page with queries raised using the AI Chatbot. |
|
|
31/07/2023 |
Maximum length of the CardManufacturer field updated to 50 characters. |
|
|
03/08/2023 |
Correction to System architecture image. |
28th July 2023
|
Date |
Description |
Guide |
|---|---|---|
|
28/07/2023 |
Added further information describing the use of transaction processing codes 01,02,11, 12, 21, 26, 28 and 39. On the GPS_POS_Data field page, fixed the link to the Card Present Indicator section. In the GetTransaction Message Fields section, updated the Request Message Fields headings to clarify whether this applies to authorisation, financial or non-card network messages. |
|
|
28/07/2023 |
Updated the PIN field usage table defining how a card's PIN can be updated. See Card PIN Control. |
|
|
24/07/2023 |
Added details of when you might receive the FAILWITHFEEDBACK status in the response to a NotifyValidate API call. |
|
|
26/07/2023 |
Added a note to clarify that Merchant Category Code (MCC) exemptions from SCA only apply to transactions where the cardholder is present. |
7th July 2023
|
Date |
Description |
Guide |
|---|---|---|
|
23/06/2023 |
Added a landing page and links to the Dynamic CVV2 Guide. |
|
|
04/07/2023 |
When creating a card, you can now use additional characters in the CardName field if the card manufacturer is (internal card manufacturer account used for non-printed cards, such as virtual cards). |
|
|
07/07/2023 |
New updates made to the Cards API, including the addition of a Chatbot and changes made to Create Card and Update Card endpoints in the Postman Collection to resolve issue with nameOnCard object not displaying. |
30th June 2023
|
Date |
Description |
Guide |
|---|---|---|
|
30/06/2023 |
Added details of which card status values can be used to Suspend, Delete and Deactivate a payment token at the Card Scheme. |
|
|
30/06/2023 |
For bulk card create (Quantity greater than 1), we recommend that you run the token / card details enquiry one day after the bulk card creation. |
|
|
30/06/2023 |
Added details of relevant ISO specifications that provide additional details on some field formats. |
23rd June 2023
|
Date |
Description |
Guide |
|---|---|---|
|
22/06/2023 |
Added details of Visa Dispute Reason Codes; added Mastercard Reason Codes 1403 and 1404. |
|
|
23/06/2023 |
Added a new section describing implementation of Dynamic CVV2 functionality. This section is also available as a stand-alone document. |
16th June 2023
|
Date |
Description |
Guide |
|---|---|---|
|
12/06/2023 |
Key Concepts Guide: Corrections to Figures 8, 10, 11 and 12. |
|
|
13/6/2023 |
Reference to Multi-FX via CurrencyCloud have been removed from our Documentation Portal and product sheets, as this service is no longer supported. |
9th June 2023
|
Date |
Description |
Guide |
|---|---|---|
|
09/06/2023 |
Updated the Thredd Operations Command Centre email address to occ@thredd.com. |
All guides. |
2nd June 2023
|
Date |
Description |
Guide |
|---|---|---|
|
01/06/2023 |
New FAQs added to 3D Secure Guide. |
|
|
Added details of relevant Cards API functionality and endpoints. |
||
|
Restructuring of guide topics. Updates to reflect changes to the Thredd 3DS Product Setup Form (PSF) and steps in a 3D Secure project. Added details of using the Cards API 3D Secure endpoints. Added details of using Compliance Manager. |
||
|
26/05/2023 |
Added links to the PANFinder guide to Documentation Portal. |
|
|
02/06/2023 |
Reference to Multi-FX via CurrencyCloud has been removed from our Documentation Portal and product sheets, as this service is no longer supported. |
|
26th May 2023
|
Date |
Description |
Guide |
|---|---|---|
|
26/05/2023 |
Examples added to each endpoint in the Postman Collection. |
|
|
26/05/2023 |
New PANFinder Guide, describing the Thredd PAN Finder service |
|
|
23/05/2023 |
When using the Create Card web service (Ws_CreateCard), if quantity is greater than 1, then some fields in this web service are not relevant and should be left blank or, if mandatory, set to the default value of '0'. |
|
|
26/05/2023 |
ActivateNow field added to the Create Card endpoint. |
19th May 2023
|
Date |
Description |
Guide |
|---|---|---|
|
16/05/2023 |
Updates to EHI authorisation examples. |
|
|
16/05/2023 |
Rebrand to EHI Mode Selector wizard and some additional small fixes. |
|
|
16/05/2023 |
Fraud Team email address updated. |
|
|
18/05/2023 |
Note added to Introduction regarding programmes sending SMS messages in Singapore. |
|
|
19/05/2023 |
Updated the Trans_link field data type from Number (Long) to string, to align with the RFC 8259 Standard for JSON fields. |
12th May 2023
|
Date |
Description |
Guide |
|---|---|---|
|
09/05/2023 |
Duplicate Gemalto Singapore entry removed from the Card Manufacturer Approved Characters table in the String Cleaning and Approved Characters page. |
28th April 2023
|
Date |
Description |
Guide |
|---|---|---|
|
28/04/2023 |
New Cloud Upgrade FAQs now available on the Thredd documentation portal. |
|
|
28/04/2023 |
Temporarily removed the Program Manager endpoints from the Cards API. |
27th April 2023
Major update affecting all our guides!
We have rebranded our Documentation Portal and all our documentation to reflect our new company name and brand identity.
GPS is now Thredd. Find out more >
17th April 2023
|
Date |
Description |
Guide |
|---|---|---|
|
17/04/2023 |
New Physical Card Configuration Guide now available on the Documentation Portal. |
|
|
12/04/2023 |
Added a new appendix which provides details of the contents of the Trans_Link field. |
|
|
12/04/2023 |
The ExpDate field in the Card Activate (Ws_Activate) and Card Activate and Load (Ws_Activate_Load) web services can now be used to update the internal card record expiry date, if you want to specify a shorter expiry date than the card expiry date that was set when the card was issued. This will not change the expiry date that was set when the card was issued (and as shown on the printed card or card image). |
6th April 2023
|
Date |
Description |
Guide |
|---|---|---|
|
05/04/2023 |
Update to description of action code 816. |
|
|
05/04/2023 |
In the Card Bulk Create web service (Ws_BulkCreation), the field name ActivateNow in the CARD element has been corrected to ActivateOrNot. |
|
|
06/04/2023 |
Temporarily removed the Card Override endpoints from the Cards API. |
31st March 2023
|
Date |
Description |
Guide |
|---|---|---|
|
17/03/2023 |
Removed references to EHI mode 2 and 3 from balance report sentence in the Reporting and Reconciliation product sheet. |
|
|
28/03/2023 |
Update to the description of the contents of the Daily Cardholder XML report. |
|
|
31/03/2023 |
Added Get Card Stock endpoint and updated Convert Card endpoint to include moveExpiryDate and newExpiryDate fields. |
17th March 2023
|
Date |
Description |
Guide |
|---|---|---|
|
14/03/2023 |
New schema file version 1.48 added to the Documentation Portal Downloads page. |
|
|
16/03/2023 |
Added a Developer Portal page to the Documentation Portal, including a link for users to navigate to the Portal. Also added Developer Portal and Sandbox references added to the Glossary. |
|
|
14/03/2023 |
Added a new attribute called TTI (Transaction Type Identifier) to the Txn element. |
10th March 2023
|
Date |
Description |
Guide |
|---|---|---|
|
09/03/2023 |
Added Chinese Offshore Renminbi (currency code CNH) to the list of supported currencies. |
|
|
07/03/2023 |
Added a note to explain that in EHI Mode 2, you can override the Thredddecline code of 51 (Insufficient Funds) with another decline code), if you would like to use a more specific decline reason to be passed to cardholder. |
|
|
09/03/2023 |
Updates to the Transaction XML data Schemas to change the data type of <PresentmentID> from "unsigned Int" to "unsigned Long". Added a new currency code value of 157 (CNH) to the ISOCurrencyCode type in the schema file. |
3rd March 2023
|
Date |
Description |
Guide |
|---|---|---|
|
27/02/2023 |
Clarification: when using the Apply FX Rate web service (Ws_Client_FX) to stream your own FX rates; if you are not using the optional SellRate and MidRate fields, then you should pass a value of '0' in these fields, |
|
|
02/03/2023 |
Correction to description of the token field and its possible values. |
|
|
27/02/2023 |
Correction: the CurrCode value in Card Activate and Load (Ws_Activate_Load) is optional. If it is not provided, then card’s billing currency will be used. |
|
|
02/03/2023 |
In the GetTransaction Message Fields section, updated the maximum length and maximum values for the following fields: Token, TXn_ID, TLogIDOrg, Trans_link and Matching_Txn_ID. |
|
|
02/03/2023 |
Added further details and clarification on the use of JSON data types and the compatibility of EHI fields with the IEEE 754 binary-64 (double precision) format. |
24th February 2023
|
Date |
Description |
Guide |
|---|---|---|
|
17/02/2023 |
Updated the section Matching Transaction XML Records to EHI Records to remove reference to use of Trace element as a unique identifier. |
|
|
17/02/2023 |
Updated the description of the Trace element to clarify its usage. |
|
|
20/02/2023 |
Updated XML Schema version. Trace auditno attribute changed from required to optional. |
|
|
20/02/2023 |
Added two new Visa Merchant Category Codes (MCC): 3839 and 5723. |
|
|
20/02/2023 |
Added a note to clarify the use of GPS_POS_Capability position 44. |
|
|
21/02/2023 |
Correction to the list of special characters supported by the Gemalto Czech Republic Card Manufacturer. |
|
|
21/02/2023 |
Added a note to the Card Extend Expiry Date (Ws_ExtendExpiry) web service to indicate that changing the expiry date will also change the card status to '00' (All Good). |
|
|
21/02/2023 |
Clarification to description of the Payment_Token_ID field in Payment Token Get (Ws_Payment_Token_Get) web service. Applies to both Mastercard and Visa cards. |
17th February 2023
|
Date |
Description |
Guide |
|---|---|---|
|
15/02/2023 |
Added details to clarify how the transaction processing codes 01, 12 and 17 are used. |
|
|
10/02/2023 |
Update to the description of the XML report file naming convention. |
|
|
10/02/2023 |
Update to the description of the XML report file naming convention. |
|
|
13/02/2023 |
Revised wording around Apple Pay Orange flow support. |
|
|
15/02/2023 |
Added a note to GPS_POS_DATA Cardholder Authentication Methods, to indicate that it is possible for merchants to send two authentication values, which are recording in positions 4 and 5. |
|
|
17/02/2023 |
Documented changes to Card Status Codes for REST API. |
|
|
17/02/2023 |
Simplification of file names in PDFs to shorten their length. |
|
10th February 2023
|
Date |
Description |
Guide |
|---|---|---|
|
07/02/2023 |
Added new Example Files of both cut-down and full file formats, and a new File Format and File Versions section with details of fields included with each file format and data format version. |
|
|
06/02/2023 |
Update to description of action code 213. |
|
|
08/02/2023 |
Correction to clearing field values when using the Update Cardholder Details (V1) and Update Cardholder Details (V2) web services: the newAccCode field has been removed from the list of fields that can have their values cleared by sending a <space>. |
3rd February 2023
|
Date |
Description |
Guide |
|---|---|---|
|
26/01/2023 |
Update to description of action code 122. |
|
|
26/01/2023 |
Added information to clarify the use of CreateType = 5 when using the Card Create (Ws_CreateCard) web service. |
27th January 2023
|
Date |
Description |
Guide |
|---|---|---|
|
24/01/2023 |
Updated the description of the following fields to clarify their usage: POS_Data_DE61, POS_Data_DE22 and Merch_Name_DE43. |
|
|
25/01/2023 |
Update to description of frequency of XML reports in FAQs section. |
|
|
25/01/2023 |
Update to description of frequency of XML reports in FAQs section. |
|
|
26/01/2023 |
Updated the FAQs with additional information around clearing files. |
20th January 2023
|
Date |
Description |
Guide |
|---|---|---|
|
05/01/2023 |
Added a note to indicate that if the CVV2_Result field is blank, then the merchant did not provide this information. In this case, Thredd will not complete the CVV2 pre-check and will authorise or decline the transaction based on the card usage group settings for your programme. |
|
|
05/01/2023 |
Amended the description of Auth_Code_DE38. Thredd will generate this code for an approved authorisation request. |
|
|
20/01/2023 |
Updated the GetTransaction Example Messages for the EHI JSON Guide. |
13th January 2023
|
Date |
Description |
Guide |
|---|---|---|
|
13/01/2023 |
Added a note the Card Renew web service to indicate that when the new card is activated, Thredd will change the status of the old card to 62 restricted card. |
6th January 2023
|
Date |
Description |
Guide |
|---|---|---|
|
04/01/2023 |
Added additional IP addresses that need to be allowed for secure communication between Thredd and your systems when using one of our cloud production environments (PRD1 or PRD2). |
23rd December 2022
|
Date |
Description |
Guide |
|---|---|---|
|
20/12/2022 |
Web Services and 3D Secure guides updated to reflect that the OUTOFBAND authentication type is now available. |
|
|
22/12/2022 |
Added details of the real-time API for Mastercard clients. |
|
|
23/12/2022 |
Replaced screenshots in Editing Card Details to show additional fields like 'Country' 'City' and 'DOB' and in Locating MDES/VDEP Device Status to show additional 'PAN Source' field. |
16th December 2022
|
Date |
Description |
Guide |
|---|---|---|
|
13/12/2022 |
Added new Quick Links to the Products and Services pages. |
Payment Card Industry Compliance Second European Payment Services Directive (PSD 2) |
|
13/12/2022 |
Added a link to the new EHI Mode Selector Wizard, an interactive tool which can be used to select the right EHI Mode for your business. |
|
|
13/12/2022 |
Added a link in the Products and Services > EHI page to the new EHI Mode Selector Wizard, an interactive tool which can be used to select the right EHI Mode for your business. |
9th December 2022
|
Date |
Description |
Guide |
|---|---|---|
|
07/12/2022 |
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. |
|
|
07/12/2022 |
Added Direct Debit notifications and sections on retrieving and cancelling Direct Debit mandates using web services. Added a note to clarify that Direct Debit is currently only available to customers on EHI Mode 3. |
|
|
07/12/2022 |
New cut-off messages in JSON format now available. |
|
|
07/12/2022 |
Removal of references to OTP Email, which is currently not supported. |
|
|
08/12/2022 |
3D Secure Guide: Added a note to indicate that your NotifyInitiateAction endpoint must resolve to a static IP address. |
2nd December 2022
|
Date |
Description |
Guide |
|---|---|---|
|
01/12/2022 |
Added new SMS Product Sheet |
|
|
01/12/2022 |
Added new IVR Product Sheet |
|
|
01/12/2022 |
Updated the Copyright Statement for the Documentation Portal and All Guides |
|
|
01/12/2022 |
Updated the headings for the GPS_POS_Capability field, GPS_POS_Data field and the POS_Data_DE61 field to fix issue with duplicate entries in the Table of Contents |
25th November 2022
|
Date |
Description |
Guide |
|---|---|---|
|
22/11/2022 |
Update to description of action code 779. |
|
|
22/11/2022 |
Updates to screenshots for latest release; updates to table layouts in Appendix A. |
|
|
24/11/2022 |
Added further criteria to 25pp, 26pp and 27pp in Transaction Matching. |
18th November 2022
|
Date |
Description |
Guide |
|---|---|---|
|
16/11/2022 |
New Visa Account Updater (VAU) service page added to the Products and Services section on the Documentation Portal. |
|
|
18/11/2022 |
New design and images applied to all product sheets |
16th November 2022
|
Date |
Description |
Guide |
|---|---|---|
|
07/11/2022 |
Correction: In the Visa Tokenisation yellow flow, the final message PaymentToken_creatorStatus status should be "I". |
|
|
10/11/2022 |
Added Glossary definitions for OCT and AFT transactions. |
|
|
11/11/2022 |
Added a note to the transaction matching section for 0400 authorisation reversals about Visa transactions potentially missing an Auth_Code_DE38 value and how to treat this. |
|
|
16/11/2022 |
Addition of AFD test, CVS History Export, Partial Reversals, POS without PIN, PSD2 Contactless transactions, Magstripe and contactless cash withdrawals, PIN Change, and MCC capabilities |
11th November 2022
|
Date |
Description |
Guide |
|---|---|---|
|
09/11/2022 |
Removal of all POSFX documentation. This will be republished once launched to market. |
Not available |
|
10/11/2022 |
Removal of Letter of Commercial Agreement (LOCA). |
|
|
10/11/2022 |
First Version. Provides an overview of card payments and highlights information you’ll need to know when implementing your own card programme through Thredd . |
|
|
11/11/2022 |
Updated link to Cards API website |
4th November 2022
|
Date |
Description |
Guide |
|---|---|---|
|
28/10/2022 |
Updated Thredd UAT IP addresses. |
|
|
28/10/2022 |
Removal of timescales from project stages |
|
|
28/10/2022 |
The maximum length of the DE94_Txn_Orig_ID field has been updated to 16. |
28th October 2022
|
Date |
Description |
Guide |
|---|---|---|
|
27/10/2022 |
Added a note and examples of cut-off message, which are currently only available in XML format. |
|
|
27/10/2022 |
Correction to the OAuth Introspect example which shows how to validate a bearer token. |
|
|
27/10/2022 |
Added a description of the Thredd 16-digit public token. |
|
|
27/10/2022 |
Added Orange Flow to the Glossary. |
|
|
27/10/2022 |
Added a description of the Thredd 16-digit public token. |
21st October 2022
|
Date |
Description |
Guide |
|---|---|---|
|
20/10/2022 |
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. |
|
|
20/10/2022 |
Updated the code examples in the 3D Secure RDX Credentials (Ws_AddUpDelCredentials) web service to show the correct format of the KBA fields. |
14th October 2022
|
Date |
Description |
Guide |
|---|---|---|
|
10/10/2022 |
PSD2 and SCA Guide: Updates to PSD2 flow diagrams and new section on SCA Checks added. |
|
|
11/10/2022 |
Card Generation Interface Specification: Clarified customer file and data format options; updates to TYPE and CARRIER_TYPE elements. |
|
|
11/10/2022 |
Web Services Guide: Updated the list of special characters that are removed from input fields. |
|
|
11/10/2022 |
Web Services Guide: Added a new CarrierType parameter to the Card Renew and Card Convert web services. |
|
|
11/10/2022
|
Web Servies Guide: Added a note to the ProductRef field in the Update Cardholder Details (V2) web service to indicate that this field can also be used during mobile wallet tokenisation, to specify which card profile the card scheme should use. |
|
|
12/10/2022 |
Tokenisation Guide: Added a new section on Updating the Card Profile Linked to a Token. |
|
|
12/10/2022 |
Tokenisation Guide: New Payment-Token Transactions setting enables you to decide whether the Thredd card status should be checked or ignored during transaction authorisations. |
|
|
12/10/2022 |
Smart Client Guide: Added a note about how card status of the card is taken into consideration during the authorisation process for tokenised cards. |
|
|
12/10/2022 |
Transaction XML Guide: Updates to the transaction XML filename format to include details of the applicable Production environment. |
|
|
12/10/2022 |
Card Generation Interface Specification: Added details of the file naming conventions for both cloud and on-premise Thredd solutions. |
|
|
12/10/2022 |
Balance XML Guide: Updates to description of when the balance XML files can be generated. Updates to the Balance XML filename format to include details of the applicable Production environment. |
|
|
12/10/2022 |
Cardholder XML Guide: Added details of the file naming convention for both cloud and on-premise Thredd solutions. |
|
|
12/10/2022 |
Transaction XML Guide: Update to the table Matching Transaction XML Records to EHI Records. |
|
|
12/10/2022 |
3D Secure Guide: Fix to examples in Appendix 4: KBA Questions. |
|
|
12/10/2022 |
Web Services Guide: Added additional accumulator types related to Strong Customer Authentication (SCA). |
|
|
13/10/2022 |
EHI Guide: Added a new value of 'L' (delegated authentication) to the GPS_POS_Data field, position 15 (3D secure authentication method). |
7th October 2022
|
Date |
Description | Guide |
|---|---|---|
|
03/10/2022 |
EHI Guide: Added status code 59 to the table of status values appearing in the Resp_Code_DE39 field. |
|
|
03/10/2022 |
EHI Guide: Added new sections on Refunds and Financial Reversals to the Transaction Flow Scenarios section. |
|
|
04/10/2022 |
Card Status Response Codes: New HTML version is now available on the documentation portal. |
|
|
05/10/2022 |
Card Status Response Codes - Mastercard Mappings: New PDF layout (password protected) is now available on the documentation portal. |
|
|
05/10/2022 |
Card Status Response Codes - Visa Mappings: New PDF layout (password protected) is now available on the documentation portal. |
|
|
06/10/2022 |
Product Sheets: Added Sandbox product sheet to documentation portal. |
30th September 2022
|
Date |
Description | Guide |
|---|---|---|
|
30/09/2022 |
Documentation Portal: Re-designed pages are now available. |
23rd September 2022
|
Date |
Description | Guide |
|---|---|---|
|
22/09/2022 |
IVR Guide: New HTML version is now available on the Documentation Portal. |
|
|
21/09/2022 |
XSD Schema: Latest version added to the Downloads page. |
|
|
21/09/2022 |
Address Verification Service (AVS) page updated |
|
|
23/09/2022 |
Transaction XML Reporting Guide: 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. |
16th September 2022
|
Date |
Description | Guide |
|---|---|---|
|
15/09/2022 |
Cardholder XML Report Guide: New HTML version is now available on the Documentation Portal. |
|
|
15/09/2022 |
EHI Guide: Added new examples to JSON version |
|
|
16/09/2022 |
Web Services Guide: Added a new action code of 221 |
|
|
16/09/2022 |
Guide to Moving Issuer Processing to Thredd : New HTML version is now available on the Documentation Portal. |
Guide to Moving Issuer Processing to Thredd |
9th September 2022
|
Date |
Description | Guide |
|---|---|---|
|
|
Updated Thredd UAT IP addresses. |
|
|
|
Added new column to 3D Secure Authentication Method section of GPS_POS_Data. Also clarified content for Mastercard SPA v2. |
|
|
|
Added new Currency code SLE to EHI Guide. |
|
|
|
Added new Currency code SLE to Web Services Guide. |
|
|
|
Added new Currency code SLE to Transaction XML Guide. |
2nd September 2022
|
Date |
Description | Guide |
|---|---|---|
|
01/9/2022 |
Updated to reflect report handling for CardEvent records that exceed 2GB in size. |
|
|
01/09/2022 |
Latest XSD Schema version added to the Downloads page. |
|
|
01/09/2022 |
New HTML version is now available on the Documentation Portal. |
26th August 2022
|
Date |
Description | Guide |
|---|---|---|
|
23/08/2022 |
Card Generation Interface Specification: New HTML version is now available on the Documentation Portal. |
|
|
23/08/2022 |
Fraud Reporting Guide: New HTML version is now available on the Documentation Portal. |
|
|
23/08/2022 |
SMS Guide: New HTML version is now available on the Documentation Portal. |
|
|
26/08/2022 |
Updated EHI examples added to XML version of EHI guide. |
|
|
26/08/2022 |
PSD2 Guide: Details added of how to reset transaction and amount counters using Web Services. |