Revision History

Date

Author

Version

Description of Change

28th Oct 2008

AT

2.08

Insert Record-Type DCC and AME

1st Dec 2008

AT

2.09

Insert Check-Out-Date on TDR

16th Dec 2008

AT

2.10

Rename AME to TAR,  some clarifications

7th Jan 2009

AT

2.11

Expand TAR with DCC

13th Jan 2009

AT

2.12

Separate Visa-CPS-data and BankNet-data in different fields. Clarify ACI 

27th Jan 2009

AT

2.13

Add Check-In-Date, small corrections 

27th Jan 2009

AT

2.14

Reduce Airline Addendum-data up to 4 Legs. Correct EMV-position

4th Feb 2009

AT

2.15

Correction Check-out + in-date

10th Mar 2009

AT

 

2.16

Reduce the Cardholder-Amount (DCC) from 3 to 2 implicit decimal places and sort the TAR after the AAR

20th Mar 2009

AT

2.17

Corr. Decimal points DCC

14th Apr 2009

AT

2.18

Small corrections EMV-fields

18th Jun 2009

PS

2.19

Added values on POS entry mode for contactless payments

23rdJun 2009

PS

2.20

Explanation ECI and Purchase-date

24th Feb 2010

SF

2.21

STAN and RRN added to TDR, PAR and PIR records added.

25th Feb 2010

SF

2.21

‘Number of Line Items’ added to PAR

5th Mar 2010

AT

2.22

Corr. Filler PIR-Record

6th Apr 2010

AT

2.30

Refresh the document / Alpha-Ticket-No.

17th May 2010

AT

 

PIR-Record: add Sign-field

31st Aug 2010

AT

 

Creation SOC number

25th Jan 2011

AT

2.31

Correction SOC-No + FTR amounts

29th Mar 2011

AT

2.32

Clarifications (AAR: eliminate Check-Digit)

7th Jun 2011

AT

2.40

Insert  HAR, CRR and EXD / Insert Diners Invoice No (AAR)I

24th Jun 2011

AT

2.41

Correction Lengths on HAR, CRR

Change cut-off time from 22:45 to 22:15

11th  Oct 2011

AT

2.42

Insert Transaction Source - Table

20th Oct 2011

AT

2.43

Move DC-Airline-Invoice-Number from AAR to CRR

21st Feb 2012

AT

2.44

TAR: clarifications some fields / KAAI references

27th Mar 2012

AT

2.45

Minor corrections

29th May 2012

AT

2.46

Transaction ID change to ‘N’

19th Jun 2012

AT

2.47

Small optical changes

21st Aug 2012

AT

2.49

EMV TAG corrections

23rd Oct 2012

AT

2.50

Insert amount examples in TDR, ‘Transaction amount’.

Clarification Chip-fields / Transaction ID changed to AN

25th Jan 2013

PS

2.51

Change on TAR BankNet ref date description from zero filled into space filled

2nd Feb 2013

ME

2.52

- Fixed conflicting TAR-AAR record sequences, all to TDR->TAR->AAR

Section 4.2 – File Structure – TAR and AAR sections swapped, other sections show correct record order

Section 5.1 TDR record – description for State/Province-Code Position  [115..116] corrected – reference to Section 4.6.6 updated to 4.6.5

9th Apr 2013

AT

2.53

Correction Lengths ‘BankNet-Reference’ and ‘Condition Code’

Clarification ‘Currency’ in THR and TDR

25th Apr 2013

ME

2.54

RECORD :   TDR

POSITION :  [341..343]

CHANGE:    Field type changed from “N” to “A” after check with AXIS on field definition

28th Oct 2013

PS

2.55

Fields for Discover Processing added: Track Data Condition Code and Network Reference Identification Number (NRID)

29th Oct 2013

PS

2.56

SBR: Dynamic Merchant Indicator field added.

Merchant Group Identifier field added

TAR: Dynamic Merchant Detail fields added.

TDR: M-POS Indicator added

TDR: STAN description changed

15th Nov 2013

PS

2.57

Length of Dynamic Merchant Data changed on TAR

Correction of BankNet Reference field length and description on TAR

10th Dec 2013

PS

2.58

Added Card Brand Override Indicator

4th Feb 2014

PS

 

2.59

Added ancillary data in AAR.

Added a new record called PTA for passenger transport ancillary data for VISA only.

TDR: Added field Spend Qualified Indicator

Added file number within FHR

4th Apr 2014

PS

2.60

Added digital wallet data and MasterPass merchant enabled flag

25th Mar 2015

PS

2.61

TDR:  Added Form Factor Indicator – EMV processing value;

Added UCAF Collection Indicator field for MasterPass transactions

Added Mastercard assigned ID

TDR: Added Form Factor Indicator

13th Apr 2015

PS

2.62 draft

TDR: Added transaction source code for APM

Added authorization source code for APM

Added ZAPP transaction reference details

Added 2 notes *4 on card-number field for ZAPP payments and *5 on Expiry Date field for ZAPP payments

New Record created called APM. Added APM AUX Record

13th Oct 2015

P Hammerson

2.62a

TDR:

Transaction Reference Field: changed ‘APTRID’ to ‘Settlement Retrieval ID’

APM:

CFI RollNum Field: changed ‘To’ Column value from ‘134’ to ‘154’

Changed all subsequent ‘To’ / ‘From’ values accordingly

‘Reference ID’ Field: changed name to ‘Settlement Retrieval ID’

‘Settlement Retrieval ID’ Field: Updated Remarks Column

Added new Field: ‘Unique Reference ID’

Filler Field: changed ‘Length’ value from ‘282’ to ‘244’

Filler Field: changed ‘From’ value from ‘169’ to ‘207’

15th Feb 2016

P Hammerson

2.62b

Transaction AUX Record ‘TAR’

Removed ‘Not Supported’ comment from UCAF Collection Indicator value 3 and Mastercard Assigned ID Field

18th Apr 2016

P Hammerson

2.62c

Transaction Detail Record (TDR)

MOTO/Ecommerce Authentication Indicator Field: updated description of field contents.

Removed notes relating to 3D Secure Indicators.

29th Jul 2016

P Hammerson

2.62d

TXN Detail Record (TDR): Transaction Source Field – added value 10 Credential on File Transaction. Reformatted table.

TXN Detail Record (TDR): Dedicated File (DF) Name Field – updated description.

Transaction AUX Record (TAR): Transaction Identifier Field – updated description to support American Express Transaction ID.

4th Oct 2016

P Hammerson

2.62e

TXN Header Record – SOC Number Field: updated description.

TXN Header Record – SOC Merchant Reference Field: updated description.

TXN Detail Record – State/Province Code (Merchant) Field: updated description.

TXN Detail Record – Terminal Capabilities Field: updated description.

Revision History: moved section to end of document and corrected references where required.

TXN Detail Record – Transaction Source: Credential On File Transaction changed to Reserved For Future Use.

Reformatted document.

1st Feb 2017

P Hammerson

2.63

Special Field Requirements, Payment Facilitator: added comment re: PF requirements.

Settlement Batch Record (SBR), Payment Facilitator Dynamic Merchant Indicator Field: updated field name and description.

Transaction AUX Record (TAR): updated field names and descriptions for existing Payment Facilitator Fields. Added new Fields: Payment Facilitator MCC Code; Phone Number; Email Address; Tax ID. Added new Field: Unique Transaction Reference Number.

TXN Detail Record (TAR) – Transaction Source: added new value 30 (In-App Secure Ecommerce).

TXN Detail Record (TAR) – MOTO/Ecommerce Authentication Indicator: updated description.

File Header Record (FHR) – Processor ID: updated description.

File Header Record (FHR) – Processor Name: updated description.

Special Field Requirements – SE Number: updated description.

Settlement Batch Record (SBR), SE Number: updated description.

TXN Detail Record (TDR), Cardholder Verification Value (CVV2): updated description and added additional values.

Alternative Payment AUX Record (APM) – Reconciliation ID Field: updated description and status to Conditional where ID is available.

25th Jul 2017

P Hammerson

2.64

Transaction Detail Record (TDR) – Transaction Source: added new value 3 (PAN Auto Entry)

Transaction Detail Record (TDR): added new fields (Unattended Acceptance Terminal Indicator / Terminal Capability)

Transaction AUX Record (TAR): added new fields (DCC Reference Number / Transit Type Indicator / Transportation Mode Indicator)

4th Oct 2017

P Hammerson

2.65

TXN Detail Record (TDR), POS Capability Field: new value added, 9 (Key Entry), updated description.

TXN Detail Record (TDR), Authorisation Source Field: updated description.

Appendices: added Multi-Currency Conversion appendix.

17th Apr 2018

P Hammerson

2.66

Transaction AUX Record (TAR) – Transaction Identifier Field: updated description to include TAVV.

TXN Detail Record (TDR) – Transaction Type Field: added new values 05 (Instalment Transaction), 06 (Unscheduled Credential on File) and 07 (Storing Credential on File).

TXN Detail Record (TDR) – Transaction Source Field: updated value 10 to indicate Credential on File.

TXN Detail Record (TDR): added new field (Debt Repayment Indicator).

Diagram of GMCIF File Construction: updated diagram.

TXN Detail Record (TDR) – Form Factor Indicator Field: added support for Diners Form Factor Indicator.

Transaction AUX Record (TAR): added new field (Transaction Integrity Class).

Multi-Currency Conversion: removed Iranian Rial and Zambian Kwacha – no longer supported.

20th Jul 2018

P Hammerson

2.67

Transaction AUX Record (TAR) – Unique Transaction Response Reference Number Field: updated field name and description.

TXN Detail Record (TDR) – Transaction Reference Field: updated description.

TXN Detail Record (TDR) – Transaction Type Field: updated description of value 05 (Instalment Transaction and 07 (Storing Credential on File) to support Mastercard.

TXN Detail Record (TDR) – Transaction Source Field: updated description of value 10 (Credential on File) to support Mastercard.

Settlement Batch Record – Settlement Currency Field: updated description.

Transaction AUX Record – Cardholder Amount (DCC) Field / Cardholder Currency Code (DCC) Field / Conversion Rate (DCC) Field / Conversion Exponent (DCC) Field: updated descriptions.

1st Oct 2018

P Hammerson

2.68

TXN Detail Record (TDR) – Card Number Field: changed format from Numeric to Alphanumeric.

TXN Detail Record (TDR): new field added (Reserved for Future Use).

TXN Detail Record (TDR) – Transaction Source Field: updated description, removed references to card schemes.

TXN Detail Record (TDR) – Form Factor Indicator: updated description.

Universal Cardholder Authentication Field (UCAF): updated name to Accountholder Authentication Value (AAV) across document.

Transaction AUX Record (TAR) – Digital Wallet Description Table: updated V.Me to Visa Checkout.

TXN Detail Record (TDR) – Cardholder Verification Value (CVV2) Field: added American Express values.

Transaction Detail Record (TDR) – Mobile POS (MPOS) Indicator: updated name to differentiate it from new Mobile POS (MPOS) Acceptance Device Field.

Transaction Detail Record (TDR) – Dedicated File (DF) Name: updated description to advise that field is mandatory for Diners transactions.

Transaction AUX Record (TAR): added new fields Payment Account Reference (PAR) Number / 3D Secure Version Number / Directory Server (DS) Transaction ID / Accountholder Authentication Value (AAV) / PIN Capability / Mobile POS (MPOS) Acceptance Device Indicator.

Passenger Transport AUX Record (PTA): added new fields Ancillary Service Fee Code (x4) and Ancillary Service Amount (x4).

Appendices: added new Appendix Ancillary Fee Codes.

1st Apr 2019

P Hammerson

2.69

Transaction AUX Record (TAR) – Accountholder Authentication Value (AAV) Field: updated description to include advice on value format.

Transaction AUX Record (TAR) – Transit Transaction Type Indicator Field: updated description for added clarity.

TXN Detail Record (TDR) – Card Number Field: updated description to support Elavon Tokenisation.

TXN Detail Record (TDR) – Elavon Current Token Type Field: added new field to support Elavon Tokenisation.

TXN Detail Record (TDR) – Transaction Source Field, Value 30 (In-App Ecommerce): updated description to include card brands supported.

Transaction AUX Record (TAR) – 3D Secure Version Number Field: updated description to confirm current scheme support for 3D Secure Version 2.

13th Jan 2020

P Hammerson

2.70

Multi-Currency Processing Support

Transaction AUX Record (TAR): added new field Multi-Currency Processing Transaction Indicator to support MCP.

Transaction AUX Record (TAR): updated field names and definitions for the following fields to support Multi-Currency Processing – Cardholder Amount Field, Cardholder Currency Code Field, Conversion Rate Field and Conversion Exponent Field.

General Updates

Transaction AUX Record – 3D Secure Version Number Field: updated definition to include Diners support.

Development Guidelines – File Structure: updated comments for Transaction Auxiliary Record (TAR).

Transaction AUX Record (TAR) – Cardholder Amount Field: updated definition to clarify 1 cent example.

TXN Detail Record (TDR) – Issuer Script Results Part I / Part II: updated field definitions.

TXN Detail Record (TDR) – Cardholder Verification Value (CVV) Field: update definition.

TXN Detail Record (TDR) – MOTO/Ecommerce Authentication Indicator: updated definition.

26th Jun 2020

P Hammerson

2.71

Free Trial and Promotional Offer Indicator Support

Transaction AUX Record (TAR): added new field Free Trial and Promotional Offer Indicator.

Transaction Source Field Updates

TXN Detail Record (TDR) – Transaction Source Field: added new values 11 (Chip / No verification) and 29 (CTLS Chip / Verified by signature).

UnionPay 3D Secure Support

TXN Detail Record (TDR) – MOTO/Ecommerce Authentication Indicator Field: added new value 9 (UnionPay).

General Updates

TXN Detail Record (TDR) – Card Number Field: updated definition to clarify format requirements.

TXN Detail Record (TDR) – Transaction Type Field: updated definition to clarify use in refunds.

File Processing: removed section.

Transaction AUX Record (TAR) – Mobile POS (MPOS) Acceptance Device Indicator: added Space-Filled value.

7th Oct 2020

P Hammerson

2.72

Diners CAVV Support

Development Guidelines – File Structure: added new Second Auxiliary Record (SAR).

Second Auxiliary Record (SAR): created new record structure. Added new fields Cardholder Authentication Verification Value (CAVV) and CAVV Authentication Results Code.

Visa Mandate 2.4 Support

TXN Detail Record (TDR) - Authorisation Source Field: updated field format to Alphanumeric, deprecated values 00, 01, 02, redefined values 10, 11, 12, added new values 09, 07, N.

General Updates

TXN Detail Record - Unattended Acceptance Terminal Indicator Field / Transaction AUX Record - Accountholder Authentication Value (AAV) Collection Indicator / Transaction AUX Record - Transit Transaction Type Indicator Field / Transaction AUX Record - Transportation Mode Indicator / Transaction AUX Record - 3D Secure Version Number Indicator / Transaction AUX Record - PIN Capability Field: added comment to confirm that fields should be space-filled if not applicable.

TXN Header Record (THR) – SOC Merchant Reference Field: deprecated field from this version.

TXN Detail Record (TDR) – Form Factor Indicator Field: updated definition.

TXN Detail Record (TDR) – Spend Qualified Indicator / Unattended Acceptance Terminal Indicator / Debt Repayment Indicator / Elavon Current Token Type: changed condition from Mandatory to Conditional.

TXN Detail Record (TDR) – Transaction Type Field: updated definition.