Appendix F: Transaction Details Fields

This section describes the fields available in Thredd Portal: Cards and Transaction Management for each transaction. The information displayed when Viewing Transactions depends on the type of transaction. For example, more information is shown about authorisations than about presentments.

Details Tab

This section displays summary information related to the transaction.

Details displays for all transactions.

Field

Description

Billing Amount

Bill amount (in the currency of the card).

Transaction Amount

Transaction amount (in the transaction currency).

Total Fee

The accumulated total fee for the transaction. This includes any MCC Padding, FX Padding, Fixed and Rate fees.

Customer Name

The name of the cardholder.

Instrument

The last eight characters of the masked PAN.

Network Type

The network associated with the card on the transaction. For example, Visa, Mastercard, or Discover Global Network (DGN).

Expiry Date

The expiry date of the card.

Product Name

The product name the card is associated with.

Card Scheme

The scheme the card is associated with. For example, Mastercard or Visa.

Transaction Date

Date and time the transaction occurred. The time relates to where the Thredd servers are located, for, GMT time zone for the UK.

Transaction Type

Type of transaction, such as authorisation, balance adjustment, presentment, and auth reversal.

Transaction Status

Transaction status, such as Settled.

Response Status (DE039)

The response code that Thredd provided back to the scheme.

Transaction Amount (DE004)

Transaction amount (in the transaction currency).

Billing Amount(DE006)

Bill amount (in the currency of the card).

Settlement Amount(DE005)

Settlement amount and currency.

Blocked Amount

Blocked amount (pending payments) after the transaction.

Available Balance

Available balance after the transaction.

Actual Balance

Actual balance after the transaction.

Processing Code

Transaction processing code, for example, recurring fees, balance inquiry.

Transaction Note

Note for the transaction. Notes are taken from transaction details appended during each type of transaction. For example, for declined transactions, there could be text explaining why the transaction was declined.

The Notes field is a useful source of information about a transaction, particularly for declines, as it can identify the reason. For example, in the case of a decline, an incorrect PIN or the transaction exceeding the maximum permitted limit. Scroll right on the View Transactions screen to display it.

Amount and Fees Tab

The Amount and Fee tab displays information on additional fees related to the transaction.

Amount and Fees Details displays for all transactions.

Field

Description

Calculated Total Fee Applied to Card Holder

The combined value of all fees related to the transaction.

MCC Padding

Financial padding applied to transactions in specific MCCs (typically used for hotels and rental cars where cardholders might be charged a little more than authorised for).

FX Padding

Financial padding (to allow for currency fluctuations).

Fixed Fee

Fixed fees levied against the transaction based on specific amounts.

Rate Fee

Rate-based fee. Fees levied against the transaction based on a percentage charge.

Domestic Fixed Fee

Fixed amount to apply as a fee to a domestic transaction.

Domestic Rate Fee

Percentage of the domestic transaction amount to apply as a fee.

FX Fixed Fee

Fixed amount to apply as a fee to an FX transaction.

FX Rate Fee

Percentage of an FX transaction amount to apply as a fee.

Non Domestic Fixed Fee

Fixed amount to apply to the transaction for non-domestic transactions.

Non Domestic Rate Fee

Percentage of a non-domestic transaction amount to apply as a rate fee.

Surcharge Fee

The surcharge fee for the transaction.

Additional Amounts (DE054)

Contains additional amount information for the transaction, if relevant. For example, for purchase with cashback transactions, the additional amounts field is present with the cashback amount. For more information, see Additional Amount field in the EHI Guide.

Amounts, Transaction Fee (PDS0146)

This is a specific data field used in Mastercard’s IPM (Interchange Processing Module) clearing file format. The fee carries one or more transaction-fee amounts associated with a Mastercard clearing record.

Merchant and Other Details Tab

The Merchant tab describes information on the merchant for the transaction, and other details associated with the transaction. The tab is split between two sections - a Merchant Details section, and an Other Details section.

Merchant Details

Merchant Details only displays for Authorisation, Auth Reversal, Auth Advice and Presentment transaction types.

Field

Description

Merchant Name

The name of the merchant.

City

Where applicable, the city where the transaction took place.

County

Where applicable, the county where the transaction took place.

Postcode

Where applicable, the postcode where the transaction took place.

Region

Where applicable, the region where the transaction took place.

Street

Where applicable, the street where the transaction took place.

Phone

The Merchant telephone number. Can include non-digits. For example, "+18001112345"

Merchant Website

Where applicable, the website of the merchant for the transaction.

Contact

The Merchant contact details. For example, a phone number or email address.

POS Entry Mode (DE022)

How the transaction was created, for example, contactless at a machine, ecommerce, online, ATM. ICC indicates the card was physically inserted into a machine and the PIN entered.

Card Acceptor Name Location (DE043)

Identifies the card acceptor (such as merchant, ATM owner, or financial institution) and the point of interaction for the transaction.

Till Time

Time of the transaction as provided by the merchant on the customer’s receipt. This value may differ from the time when the transaction is processed. This is because the transaction might be processed in a different time zone.

Merchant Category Code (MCC)

Code that describes a merchant's primary business activities. For a full list of available MCCs, see Merchant Category Codes in the EHI Guide.

POS Data (DE061)

For Mastercard authorisation-related messages: This holds additional POS condition codes. For more information, see POS_Data_DE61 field in the EHI Guide.

For Visa Authorisation-related messages: this is empty.

For Financial and all other messages: this is empty

Card Acceptor ID Code (DE042)

Code relating to the specific Point of Sale (POS) terminal.

Card Acceptor Terminal ID (DE041)

Uniquely identifies the terminal which accepted the card. Always present if the card data was read by a terminal.

AID

The Acquiring Bank ID as assigned by the network. Note that the format differs depending on whether this is an Authorisation or a Financial type message.

For Authorisation messages:

  • 2 digits length of Acquirer ID (01 to 09)

  • Acquirer ID

For Financial messages:

  • 6 digit Acquirer ID (possibly with leading zeros)

Other Details

The Other Details section describes a variety of different fields related to the transaction.

Other Details only displays for Authorisation, Auth Reversal, Auth Advice and Presentment transaction types.

Field

Description

Message Type

The type of transaction, such as an authorisation or presentment.

STAN (DE011)

System Trace Audit Number. This links the authorisation and presentment (note this number is not unique).

Processing Code

Transaction processing code, for example, recurring fees, balance inquiry.

Transaction ID

Identifier for tracing a specific transaction and narrowing a search. This is a unique identifier generated by Thredd to help identify and search for transaction in the Thredd platform.

Transaction Originating Institution

The merchant or store where the transaction was made.

Document Reference (DE037)

The number supplied by Thredd. Retains the original source document of the transaction and assists in locating the source document.

Authorisation Code

Authorisation code generated by Thredd for approved and declined authorisation requests.

Additional Response Data (DE044)

Response data for transactions where the content can differ depending on the network.

For example, for Mastercard, the details it provides depends on the response code only (where it is only populated in the case of a decline). For payment networks such as Visa, this field includes the response for transaction data validations.

For more information, see Visa_ResponseInfo_DE44 in the EHI Guides.

Additional Data (DE048)

This is extra details on a transaction, which you should not use unless agreed with Thredd.

AVS Response

The Address Verification Service (AVS) response to the transaction. This verifies the cardholder in order to avoid fraudulent transactions by comparing the address input by the cardholder against the address on file.

Expiry Date

The expiry date provided at the time of the transaction (useful to check in case the cardholder has entered an incorrect expiry date).

FID

Forwarding Institution Identification Code. Identifies the acquiring institution forwarding a Request or Advice message.

Thredd POS Data

Information on the transaction at the POS terminal, including details such as how the transaction was authenticated, the cardholder present/not present status and fraud details.

Click the expand button to display the Thredd POS Data Decoded Values. The following fields display.

  • Cardholder Present

  • Card Present

  • Card Data Input Method

  • Cardholder Authentication Method 1

  • Cardholder Authentication Method 2

  • Cardholder Authentication Method 3

  • Cardholder Authentication Method 4

  • Cardholder Authentication Entity 1

  • Cardholder Authentication Entity 2

  • Cardholder Authentication Entity 3

  • Cardholder Authentication Entity 4

  • Chip Fallback

  • Cardholder to Merchant Security

  • 3D Secure Authentication Method

Network ID

Also known as DE48, this a unique transaction number that is generated by the payment network for linking authorisations and presentments.

Acquirer Reference Data

Acquirer Reference Number/Data. ISO 8583 field 31. The acquirer reference number exists for clearing messages only (Financial advices/notifications, and Chargeback advices/notifications (and reversals of)).

ICC Data (DE055 - 0100)

Data from the card’s chip.

Advice Reason Data

Mastercard Authorisation Advice Reason Code. Explains why Mastercard Stand-In processing (STIP) occurred or why an advice was created.

This field will only be present for transactions received by Thredd from Mastercard.

Tax ID

The merchant's Tax ID (from Base II TCR6 31-50 (len 20), Mastercard GCMS - from IPM DE48 PDS 596 subfield 1) is the unique code assigned to a business by the processor or acquiring bank.

Record ID

A unique Thredd identifier used to link transactions to other tables in the Thredd database.

Payment Token ID

Unique Thredd identifier of the payment token. Only present if transaction relates to a payment token (for example, Apple Pay).

Network Data

Also known as DE48, this a unique transaction number that is generated by the payment network for linking authorisations and presentments.