Document History

12.9

01/07/2025

Updated the maximum length of the THERMAL_LINE1 field to 120 characters.
Clarified the deadline for making amendments to the card file and how to change the frequency of the card file generation.

19/06/2025

Added FAQ section.

17/06/2025

Updated the maximum length of the THERMAL_LINE2 field to 70 characters.

03/06/2025

Added details around scheduling of the card generation file and how records are added to this file. See About the Card Generation File.

25/03/2025

Updated the maximum length of the TITLE field to 4 characters, and the SNAME field to 20 characters.

11/02/2025

Added references to Thredd Portal, our new web application for managing your cards and transactions.

14/11/2024

Separated the XML Fields table into sections and added examples.

15/08/2024

Updated the maximum length of the BULK_ADD1, BULK_ADD2 and BULK_ADD3 fields to 100 characters. See XML Fields.

24/06/2024

Updated the company address.

12.8

08/04/2024

Updates to content to align with taxonomy updates on our Documentation Portal. Added details of Thredd REST-based Cards API fields which provide equivalent functionality to the web services SOAP API.

07/02/2024

Added details of additional values in the DELV_METHOD field. See XML Fields.

26/01/2024

Added details of changes to the available file formats. See File Formats.

12.7

27/06/2023

Added details of relevant ISO specifications that provide additional details on some field formats. See About this Document.

31/05/2023

Updated Operations email address to be occ@thredd.com

27/04/2023

Guide rebrand to new company name and brand identity.

12.6

07/01/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.

21/12/2022

Updated numbering in the Table of Contents

01/12/2022

Updated Copyright Statement.

12.5

12/10/2022

Added details of the file naming conventions for both cloud and on-premise Thredd solutions. See File Naming Conventions.

28/09/2022

Clarified customer file and data format options; updates to TYPE and CARRIER_TYPE elements.

12.4

12/08/2022

New guide layout and HTML version now available

12.3

11/08/2022

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

12.2

20/08/2021

07/09/2021

PRODUCT_REF field maximum length updated to 50 characters.

Thredd office address update

12.1

24/05/2021

Review and update to language.

12.0

13/05/2021

New Guide template and layout. Added section on XML reserved markup characters.

11.01

17/12/2020

Clarification of usage of BULK_ADD fields and DELV_CODE (bulk address and delivery code)

No change to file layout.

11.00

10/03/2020

Added MOBILE to CARRIER section. Only appears for version 11.00 and higher.

10.02

10/03/2020

Updated description of TRACK2 and CHIP_TRACK_2 for VISA. Added 00000 to each.

10.01

16/01/2020

Clarified descriptions of all CHIP Track data fields, to aid understanding of the usage of them:

CHIP_TRACK_1, CHIP_TRACK_2, CHIP_TRACK_1_MSD_CL, CHIP_TRACK_2_MSD_CL

Corrected the description of the PINBLOCK field, and an example is supplied.

Clarified COUNTRY and BULK_COUNTRY code values.

Clarified SERVICE_CODE values.

Added description for PAN and PAN_SEQ values.

Table headings now repeated on each page and prevent rows from breaking across pages if possible.

10.0

26/03/2019

Added BULK_COUNTY to the CARRIER section

9.03

21/03/2016

Corrected max length of TRACK1 and updated description

Corrected max length of TRACK2 and updated description

Corrected max length of TRACK3 and updated description

Corrected max length of CHIP_TRACK_1

Corrected max Length of CHIP_TRACK_2

Corrected max length of CHIP NAME

Corrected max length of CHIP_TRACK_1_MSD_CL

Corrected max length of CHIP_TRACK_2_MSD_CL

Updated list of possible CARD TYPEs.

Updated list of possible CHIP TYPEs

No change to file layout.

9.02

4/03/2016

Clarified file naming convention further.

No change to file layout.

9.01

18/01/2016

Added documentation about PIN block format, no change to file layout.

9

15/12/2015

Corrected File Naming convention

Added new optional tag CHIP_TRACK_1_MSD_CL

8.02

30/04/2015

Changed length and description of BULK_COUNTRY

Increased length of REQUEST_TYPE and added new options for PIN Mailers

8.01

19/01/2015

Corrections to spec:

Track1 increased to 79

8

9/10/2014

Added PINBLOCK as an optional element in the CARD structure

7

Moved REQUEST_TYPE from <PRODUCT> container to <RECORD>

CHIP_TRACK_1 will be present for Mastercard AND VISA

Detailed contents of Track data

Moved LANG to its correct position

Added new optional tag CHIP_TRACK_2_MSD_CL

6

03/09/2013

Added LANG to CARRIER element

Added CARRIER_LOGO_ID to CARRIER element

Added QRCODE to CARD element

Changed all CARRIER  elements to allow NULLs

Increased  maximum length of Track 1 to show maximum length Thredd will currently output . N.B. ISO specifications allow for maximum of 79 in Track 1

Added CHIP_TRACK_1 (only for VISA cards)

Changed COUNTRY from Varchar(20) to char(3) Numeric ISO Country code

Added CVV1 to sample Track 1 layout

5.01

26/03/2013

Added ORDER_REF to CARDSUM element

5

08/02/2013

Added new fields to support Bulk Delivery Address

4.01

10/09/2012

Replaced <ADD5> with <CITY> in the <CARRIER> element. Clarified Country ISO code.

Added XML closing tags for clarity.