21/11/2017 EMV Request Tags

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 HPS Integrator's Guide along with field descriptions, usage conditions, and examples.

Field Name Tag Usage Description

ADDITIONAL 9F40 C
TERMINAL The 10-character Additional Terminal Capabilities field contains the POS terminal
CAPABILITIES input and output capabilities.
Example (5 bytes binary) => FF-80-F0-F0-01
TLV => 9F4005FF80F0F001

AMOUNT, 9F02 M
AUTHORISED The 12-character numeric Amount, Authorised (Numeric) contains the authorized
(NUMERIC) 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, 9F03 M
OTHER The 12-character numeric Amount, Other (Numeric) contains the cashback amount
(NUMERIC) 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 9F26 M
CRYPTOGRAM 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 82 M
INTERCHANGE The four-character Application Interchange Profile indicates the capabilities of the
PROFILE chip card to support specific functions in the application.
Example (2 bytes binary) => 5C-00
TLV => 82025C00

APPLICATION 50 C
LABEL The mnemonic associated with the AID according to the ISO/IEC 7816-5.
Example (1 to 16 bytes alphanumeric special characters) => Credit

APPLICATION 9F12 C
PREFERRED The mnemonic associated with the AID.
NAME Example (1 to 16 bytes alphanumeric special characters) => Credit

https://cert.api2.heartlandportico.com/Gateway/PorticoDevGuide/build/PorticoDeveloperGuide/EMV%20Request%20Tags.html 1/7
21/11/2017 EMV Request Tags

Field Name Tag Usage Description

APPLICATION 5F34 C
PRIMARY The two-character numeric Application Primary Account Number Sequence
ACCOUNT Number contains a counter maintained and supplied by the chip card. This field
NUMBER (PAN) identifies the card when multiple chip cards are associated with a single account
SEQUENCE number. If the chip card does not contain an Application PAN Sequence Number,
NUMBER then the Application PAN Sequence Number value subfield must be set to 00.
Example (decimal value) => 2
TLV => 5F340102

APPLICATION 9F36 M
TRANSACTION The four-character numeric (binary) Application Transaction Counter contains the
COUNTER counter value maintained by the chip card. The chip card increments this value for
(ATC) each transaction (including failed transactions).
Example (decimal value) => 10
TLV => 9F3602000A

APPLICATION 9F07 C
USAGE The four-character Application Usage Control indicates the Issuer’s specified
CONTROL restrictions on the geographic usage and services allowed for the chip card
application.
Example (2 bytes binary) => FF-00
TLV => 9F0702FF00

APPLICATION 9F08 C
VERSION The four-character Application Version Number (ICC) is the version number of the
NUMBER (ICC) chip card application.
Example (2 bytes binary) => 08-C1
TLV => 9F080208C1

APPLICATION 9F09 C
VERSION The four-character Application Version Number (Terminal) is the version number of
NUMBER the POS terminal payment application.
(TERMINAL) Example (2 bytes binary) => 10-01
TLV => 9F09021001

AUTHORISATION 8A C
RESPONSE The four-character Authorisation Response Code is generated by the issuer and
CODE 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

https://cert.api2.heartlandportico.com/Gateway/PorticoDevGuide/build/PorticoDeveloperGuide/EMV%20Request%20Tags.html 2/7
21/11/2017 EMV Request Tags

Field Name Tag Usage Description

CARDHOLDER 9F34 C
VERIFICATION The six-character Cardholder Verification Method (CVM) Results indicate the results
METHOD of the last CVM performed.
(CVM) RESULTS Example (3 bytes binary) => A4-00-02
TLV => 9F3403A40002

CRYPTOGRAM 9F27 C
INFORMATION The two-character Cryptogram Information Data indicates the type of cryptogram
DATA 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 9F1E C
DEVICE (IFD) The 16-character Interface Device (IFD) Serial Number contains a unique and
SERIAL NUMBER permanent identification number assigned to the IFD by the manufacturer.
Example ( 8 bytes alphanumeric) => SERIAL12
TLV => 9F1E0853455249414C3132

ISSUER ACTION 9F0D C

CODE - A 10-character Issuer Action Code – Default specifies the issuer’s conditions that
DEFAULT 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 9F0E C

CODE - DENIAL 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 9F0F C

CODE - A 10-character Issuer Action Code – Online specifies the issuer’s conditions that
ONLINE cause a transaction to be transmitted online.
Example (5 bytes binary) => FC-F8-FC-F8-F0
TLV => 9F0F05FCF8FCF8F0

ISSUER 5F28 C
COUNTRY CODE The four-character numeric Issuer Country Code indicates the country of the issuer
according to ISO 3166.
Example (decimal value) => 840
TLV => 5F28020840

POS ENTRY 9F39 C

MODE A two-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

https://cert.api2.heartlandportico.com/Gateway/PorticoDevGuide/build/PorticoDeveloperGuide/EMV%20Request%20Tags.html 3/7
21/11/2017 EMV Request Tags

Field Name Tag Usage Description

TERMINAL FFC6 C
ACTION CODE - A 10-character Terminal Action Code – Default specifies the acquirer’s conditions
DEFAULT 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 FFC7 C
ACTION CODE - A 10-character Terminal Action Code – Denial specifies the acquirer’s conditions
DENIAL 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 FFC8 C
ACTION CODE - A 10-character Terminal Action Code – Online specifies the acquirer’s conditions
ONLINE that cause a transaction to be transmitted online.
Example (5 bytes binary) => FC-F8-FC-F8-F0
TLV => FFC805FCF8FCF8F0

TERMINAL 9F33 C
CAPABILITIES The six-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 9F1A M
COUNTRY CODE The four-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 two-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 95 M
VERIFICATION The 10-character Terminal Verification Results (TVR) contains a series of indicators
RESULTS set by the POS terminal recording both offline and online processing results.
Example (5 binary bytes) => 00-00-04-80-00
TLV => 95050000048000

TRANSACTION 5F2A M
CURRENCY The four-character numeric Transaction Currency Code contains the currency code
CODE of the transaction according to ISO 4217.
Example (decimal value) => 840
TLV => 5F2A020840

https://cert.api2.heartlandportico.com/Gateway/PorticoDevGuide/build/PorticoDeveloperGuide/EMV%20Request%20Tags.html 4/7
21/11/2017 EMV Request Tags

Field Name Tag Usage Description

TRANSACTION 9A M
DATE The six-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 9B C
STATUS The four-character Transaction Status Information contains the functions performed
INFORMATION in the transaction.
Example (2 binary bytes) => 48-00
TLV => 9B024800

TRANSACTION 9F21 C
TIME The six-character numeric Transaction Time subfield contains the local time that the
transaction was authorized.
Example (decimal value - HHMMSS) => 123456
TLV => 9F2103123456

TRANSACTION 9C M
TYPE The two-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 9F37 M
NUMBER The eight-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 4F M
DEDICATED A 10- to 32-character Application Dedicated File (ADF) Name is used to address an
FILE (ADF) NAME application in the chip card. An ADF Name consists of a registered application
provider identifier (RID) of five 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

https://cert.api2.heartlandportico.com/Gateway/PorticoDevGuide/build/PorticoDeveloperGuide/EMV%20Request%20Tags.html 5/7
21/11/2017 EMV Request Tags

Field Name Tag Usage Description

APPLICATION 9F06 C
IDENTIFIER The 10- to 32-character Application Identifier (AID) – Terminal is used to address an
(AID) - application in the chip card. An AID consists of a registered application provider
TERMINAL identifier (RID) of five 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 9F7C C
EXCLUSIVE The up to 64-character variable length Customer Exclusive Data contains issuer
DATA (CED) proprietary data for transmission to the issuer.
Example (4 bytes binary) => 12-34-56-78
TLV => 9F7C0412345678

DEDICATED FILE 84 C
(DF) NAME 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 9F6E C

INDICATOR FORM FACTOR INDICATOR (FFI)
(FFI)/PAYPASS The eight-character Form Factor Indicator indicates the form factor of the consumer
THIRD-PARTY payment device and the type of contactless interface over which the transaction
DATA was conducted. The Form Factor Indicator is both an implementation and issuer
option.
Example (5 bytes binary) => 12-34-56-78-9A
TLV => 9F6E05123456789A
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
ASCII-coded binary format.
Example (4 bytes binary) => 01-02-03-04
TLV => 9F6E0401020304

ICC DYNAMIC 9F4C C

NUMBER The four- 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 => 9F6E0401020304

ISSUER 9F10 M
APPLICATION The up to 64-character Issuer Application Data contains proprietary application
DATA data for transmission to the issuer.
Example (6 bytes binary) => 01-0A-03-60-00-00
TLV => 9F1006010A03600000

https://cert.api2.heartlandportico.com/Gateway/PorticoDevGuide/build/PorticoDeveloperGuide/EMV%20Request%20Tags.html 6/7
21/11/2017 EMV Request Tags

Field Name Tag Usage Description

ISSUER SCRIPT 9F5B C
RESULTS 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 ASCII coded binary format. Conversion from ASCII to coded binary is dependent
on the kernel API.
Example (5 bytes binary) => 20-00-00-00-00
TLV => 9F5B052000000000

TRANSACTION 9F41 C
SEQUENCE The four- to eight-character numeric (binary) Transaction Sequence Counter
COUNTER uniquely identifies each transaction on a POS terminal.
Example (decimal value) => 435
TLV => 9F4104000001B3

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 this data it will not be sent to the Host. The following will not be sent:

56 - Track 1 Equivalent Data

57 – Track 2 Equivalent Data
5A – Application PAN
5F20 – Cardholder Name
5F24 – Application Expiration Date
99 – Transaction PIN Data
9F0B – Cardholder Name Extended
9F1F – Track 1 Discretionary Data
9F20 – Track 2 Discretionary Data

 
 

© 2017 Heartland Payment Systems, LLC

https://cert.api2.heartlandportico.com/Gateway/PorticoDevGuide/build/PorticoDeveloperGuide/EMV%20Request%20Tags.html 7/7