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:
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 |
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) Example (5 bytes binary) = 12-34-56-78-9A
PAYPASS THIRD-PARTY DATA 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: