Open the Portico Schema site
Portico Developer Guide
EMV Request Tags
Special Processing Rules > EMV > EMV Tags > EMV Request Tags

The following table contains a sample list of EMV tags associated with authorization or return requests. A full list of these tags can be found in the Heartland Integrator's Guide along with field descriptions, usage conditions, and examples.

 

Field Name Tag Usage Description
ADDITIONAL TERMINAL CAPABILITIES 9F40 C

The 10-character Additional Terminal Capabilities field contains the POS terminal input and output capabilities.

Example (5 bytes binary) = FF-80-F0-F0-01
TLV = 9F4005FF80F0F001
AMOUNT, AUTHORISED (NUMERIC) 9F02 M

The 12-character numeric Amount, Authorised (Numeric) contains the authorized amount of the transaction. In the authorization request message this is the amount used by the chip card when calculating the Application Cryptogram. It must contain numeric right-justified data with leading zeros.

If the transaction includes a cashback amount, the Amount, Authorised (Numeric) includes the purchase amount plus the cashback amount.

Example (decimal value) = 12345
TLV = 9F0206000000012345
AMOUNT, OTHER (NUMERIC) 9F03 M

The 12-character numeric Amount, Other (Numeric) contains the cashback amount used by the chip card when calculating the Application Cryptogram. It must contain numeric right-justified data with leading zeros.

If the transaction does not include a cashback amount, the Amount, Other (Numeric) field must be all zeros.

Example (decimal value) = 4000
TLV = 9F0306000000004000
APPLICATION CRYPTOGRAM 9F26 M

The 16-character Application Cryptogram contains the cryptogram returned by the chip card in response to the Generate AC command.

Example (8 bytes binary) = 8E-19-ED-4B-CA-5C-67-0A
TLV = 9F26088E19ED4BCA5C670A
APPLICATION INTERCHANGE PROFILE 82 M

The 4-character Application Interchange Profile indicates the capabilities of the chip card to support specific functions in the application.

Example (2 bytes binary) = 5C-00
TLV = 82025C00
APPLICATION LABEL 50 C

The mnemonic associated with the AID according to the ISO/IEC 7816-5.

Example (1 to 16 bytes alphanumeric special characters) = Credit
APPLICATION PREFERRED NAME 9F12 C

The mnemonic associated with the AID.

Example (1 to 16 bytes alphanumeric special characters) = Credit
APPLICATION PRIMARY ACCOUNT NUMBER (PAN) SEQUENCE NUMBER 5F34 C

The 2-character numeric Application PAN Sequence Number contains a counter maintained and supplied by the chip card. This field identifies the card when multiple chip cards are associated with a single account number.

If the chip card does not contain an Application PAN Sequence Number, then the Application PAN Sequence Number value subfield must be set to 00.

Example (decimal value) = 2
TLV = 5F340102
APPLICATION TRANSACTION COUNTER (ATC) 9F36 M

The 4-character numeric (binary) Application Transaction Counter contains the counter value maintained by the chip card. The chip card increments this value for each transaction (including failed transactions).

Example (decimal value) = 10
TLV = 9F3602000A
APPLICATION USAGE CONTROL 9F07 C

The 4-character Application Usage Control indicates the Issuer’s specified restrictions on the geographic usage and services allowed for the chip card application.

Example (2 bytes binary) = FF-00
TLV = 9F0702FF00
APPLICATION VERSION NUMBER (ICC) 9F08 C

The 4-character Application Version Number (ICC) is the version number of the chip card application.

Example (2 bytes binary) = 08-C1
TLV = 9F080208C1
APPLICATION VERSION NUMBER (TERMINAL) 9F09 C

The 4-character Application Version Number (Terminal) is the version number of the POS terminal payment application.

Example (2 bytes binary) = 10-01
TLV = 9F09021001
AUTHORISATION RESPONSE CODE 8A C

The 4-character Authorisation Response Code is generated by the issuer and returned in the authorization response message. The most commonly used authorisation response codes are online approval (00), online decline (05), and referral (01). The POS terminal must not alter the Authorisation Response Code value. The POS terminal generates an authorisation response code in the following conditions:

  • Y1 - Offline approved
  • Z1 - Offline declined
  • Y3 - Unable to go online (offline approved)
  • Z3 - Unable to go online (offline declined)
Example (2 bytes alphanumeric) = Y1
TLV = 8A025931
CARDHOLDER VERIFICATION METHOD (CVM) RESULTS 9F34 C

The 6-character Cardholder Verification Method (CVM) Results indicate the results of the last CVM performed.

Example (3 bytes binary) = A4-00-02
TLV = 9F3403A40002

CRYPTOGRAM INFORMATION DATA
9F27 C

The 2-character Cryptogram Information Data indicates the type of cryptogram generated (TC, ARQC, or AAC), why the cryptogram was generated, and actions that the chip card instructed the POS terminal to perform.

Example (1 byte binary) = 80
TLV = 9F270180
INTERFACE DEVICE (IFD) SERIAL NUMBER 9F1E C

The 16-character Interface Device (IFD) Serial Number contains a unique and permanent identification number assigned to the IFD by the manufacturer.

Example (8 bytes alphanumeric) = SERIAL12
TLV = 9F1E0853455249414C3132
ISSUER ACTION CODE – DEFAULT 9F0D C

A 10-character Issuer Action Code – Default specifies the issuer’s conditions that cause a transaction to be rejected when the POS terminal is unable to process the transaction online (even when the transaction has already been approved online).

Example (5 bytes binary) = F0-40-00-88-00
TLV = 9F0D05F040008800
ISSUER ACTION CODE – DENIAL 9F0E C

A 10-character Issuer Action Code – Denial specifies the issuer’s conditions that cause the denial of a transaction without an attempt to go online.

Example (5 bytes binary) = FC-F8-FC-F8-F0
TLV = 9F0E05FCF8FCF8F0
ISSUER ACTION CODE – ONLINE 9F0F C

A 10-character Issuer Action Code – Online specifies the issuer’s conditions that cause a transaction to be transmitted online.

Example (5 bytes binary) = FC-F8-FC-F8-F0
TLV = 9F0F05FCF8FCF8F0
ISSUER COUNTRY CODE 5F28 C

The 4-character numeric Issuer Country Code indicates the country of the issuer according to ISO 3166.

Example (decimal value) = 840
TLV = 5F28020840

POS ENTRY MODE
9F39 C

A 2-character POS Entry Mode field indicates the method by which the PAN was entered, according to the first two digits of the ISO 8583:1987 POS Entry Mode.

Example (decimal value) = 0
TLV = 9F390100
TERMINAL ACTION CODE – DEFAULT FFC6 C

A 10-character Terminal Action Code – Default specifies the acquirer’s conditions that cause a transaction to be rejected when the POS terminal is unable to process the transaction online (even when the transaction has already been approved online).

Example (5 bytes binary) = FC-F8-FC-F8-F0
TLV = FFC605FCF8FCF8F0
TERMINAL ACTION CODE – DENIAL FFC7 C

A 10-character Terminal Action Code – Denial specifies the acquirer’s conditions that cause the denial of a transaction without an attempt to go online.

Example (5 bytes binary) = FC-F8-FC-F8-F0
TLV = FFC705FCF8FCF8F0
TERMINAL ACTION CODE – ONLINE FFC8 C

A 10-character Terminal Action Code – Online specifies the acquirer’s conditions that cause a transaction to be transmitted 

online.

Example (5 bytes binary) = FC-F8-FC-F8-F0
TLV = FFC805FCF8FCF8F0

TERMINAL CAPABILITIES 9F33 C

The 6-character Terminal Capabilities indicates the card data input, the cardholder verification method (CVM), and the security capabilities supported by the POS terminal.

Example (3 bytes binary) = 01-01-01
TLV = 9F3303010101
TERMINAL COUNTRY CODE 9F1A M

The 4-character numeric Terminal Country Code indicates the country of the terminal, represented according to ISO 3166.

Example (decimal value) = 840
TLV = 9F1A020840

TERMINAL TYPE
9F35 C

The 2-character numeric Terminal Type indicates the environment of the POS terminal, its communications capability, and its operational control.

Example (decimal value) = 22
TLV = 9F350122
TERMINAL VERIFICATION RESULTS 95 M

The 10-character Terminal Verification Results (TVR) contains a series of indicators set by the POS terminal recording both offline and online processing results.

Example (5 binary bytes) = 00-00-04-80-00
TLV = 95050000048000
TRANSACTION CURRENCY CODE 5F2A M

The 4-character numeric Transaction Currency Code contains the currency code of the transaction according to ISO 4217.

Example (decimal value) = 840
TLV = 5F2A020840

TRANSACTION DATE 9A M

The 6-character numeric Transaction Date contains the local date used to generate the cryptogram. The Transaction Date is in the format YYMMDD.

Example (decimal value - YYMMDD) = 140131
TLV = 9A03140131
TRANSACTION STATUS INFORMATION 9B C

The 4-character Transaction Status Information contains the functions performed in the transaction.

Example (2 binary bytes) = 48-00
TLV = 9B024800
TRANSACTION TIME 9F21 C

The 6-character numeric Transaction Time subfield contains the local time that the transaction was authorized.

Example (decimal value - HHMMSS) = 123456
TLV = 9F2103123456
TRANSACTION TYPE 9C M

The 2-character numeric Transaction Type indicates the type of financial transaction as represented by the first two digits of the ISO 8583:1987 Processing Code.

Example (decimal value) = 00 TLV = 9C0100
UNPREDICTABLE NUMBER 9F37 M

The 8-character numeric (binary) Unpredictable Number is randomly generated by the POS Terminal and is used to provide variability and uniqueness to the cryptogram.

Example (decimal value) = 12345678
TLV = 9F370400BC614E
APPLICATION DEDICATED FILE (ADF) NAME 4F M

A 10- to 32-character Application Dedicated File (ADF) Name is used to address an application in the chip card.

An ADF Name consists of a registered application provider identifier (RID) of 5 bytes, which is issued by the ISO/IEC 7816-5 registration authority. This is followed by a proprietary application identifier extension (PIX), which enables the application provider to differentiate between the different applications offered.

The ADF Name is obtained during the application selection process. Previous versions of the EMVCo specifications refer to this tag as Application Identifier (AID) – ICC.

Example (7 bytes binary) = A0-00-00-00-03-10-10
TLV = 4F07A0000000031010
APPLICATION IDENTIFIER (AID) – TERMINAL 9F06 C

The 10- to 32-character Application Identifier (AID) – Terminal is used to address an application in the chip card.

An AID consists of a registered application provider identifier (RID) of 5 bytes, which is issued by the ISO/IEC 7816-5 registration authority. This is followed by a proprietary application identifier extension (PIX) which enables the application provider to differentiate between the different applications offered. The AID is obtained during the application selection process.

Example (7 bytes binary) = A0-00-00-00-03-10-10
TLV = 9F0607A0000000031010
CUSTOMER EXCLUSIVE DATA (CED) 9F7C C

The up to 64-character variable length Customer Exclusive Data contains issuer proprietary data for transmission to the issuer.

Example (4 bytes binary) = 12-34-56-78
TLV = 9F7C0412345678

DEDICATED FILE (DF) NAME
84 C

The 10- to 32-character Dedicated File Name identifies the name of the Dedicated File as described in ISO/IEC 7816-4.

Example (7 bytes binary) = A0-00-00-00-03-10-10
TLV = 8407A0000000031010
FORM FACTOR INDICATOR (FFI) / PAYPASS THIRD-PARTY DATA 9F6E C

FORM FACTOR INDICATOR (FFI)
The 8-character Form Factor Indicator indicates the form factor of the consumer payment device and the type of contactless interface over which the transaction was conducted. The Form Factor Indicator is both an implementation and issuer option.

Example (5 bytes binary) = 12-34-56-78-9A

PAYPASS THIRD-PARTY DATA
A 10- to 64-character PayPass Third-Party Data subfield contains proprietary data from a third party. The PayPass Third-Party Data value subfield is formatted in -coded binary format.

Example (4 bytes binary) = 01-02-03-04
TLV = 9F6E0401020304
ICC DYNAMIC NUMBER 9F4C C

The 4- to 16-character ICC Dynamic Number is a time-variant numerical value generated by the chip card.

Example (4 bytes binary) = 01-02-03-04
TLV = 9F4C080000000000000000

ISSUER APPLICATION DATA 9F10 M

The up to 64-character Issuer Application Data contains proprietary application data for transmission to the issuer.

Example (6 bytes binary) = 01-0A-03-60-00-00
TLV = 9F1006010A03600000
ISSUER SCRIPT RESULTS 9F5B C

The up to 40-character Issuer Script Results contains the results of the card issuer script update to the chip card.

The Issuer Script Results value subfield is formatted in coded binary format. Conversion from to coded binary is dependent on the kernel API.

Example (5 bytes binary) = 20-00-00-00-00
TLV = 9F5B052000000000
TRANSACTION SEQUENCE COUNTER 9F41 C

The 4- to 8-character numeric (binary) Transaction Sequence Counter uniquely identifies each transaction on a POS terminal.

Example (decimal value) = 435
TLV = 9F4104000001B3

Usage = (C) Conditional, (M) Mandatory, (O) Optional

 

Sensitive cardholder data must not be sent to the Host in authorization or settlement messages even if received from the card and terminal. If Portico receives the following data, it will not be sent to the Host: