Tag Definitions
For each tag, the name, tag, type and length along with a description are summarized here. The tag value should be interpreted as hexadecimal bytes, e.g. 5fe000 represents three bytes: 0x5F, 0xE0, 0x00. A length indicates a maximum length in bytes for the tag, otherwise a dash (“-“) indicates a variable length greater than zero.
CM.com IPP Payments Platform Defined Tags
BER-TLV coding ISO/IEC 8825-1 is used, with following convention:
-
0x5FExxx for primitive data objects;
-
0x7FExxx for constructed data objects.
CM.com IPP Payments Platform Tag Summary
| TAG | Tag Name | Type | Length | Description |
|---|---|---|---|---|
| 5FE000 | Command | BIN | 2 | The command code that identifies the message |
| 5FE001 | Command result code | BIN | 2 | Contains the result code of the message |
| 5FE010 | Application Protocol Major Version | BIN | 2 | Identifies the protocol version being used by the payment terminal; For this PSP version: 0x0004 |
| 5FE011 | Application Protocol Minor Version | BIN | 2 | Identifies the protocol version being used by the payment terminal; For this PSP version: 0x0003. |
| 5FE012 | Application Dialog Variant | BIN | 1 | This specifies the application-level dialog with a fixed value of 0x0002. |
| 5FE101 | Terminal brand | TEXT | - | Identifies the terminal brand. Value to be agreed upon with CM.com during onboarding |
| 5FE102 | Terminal model | TEXT | - | Identifies the terminal model. Value to be agreed upon with CM.com during onboarding |
| 5FE130 | Terminal application version | TEXT | - | Indicates the Terminal application version. The payment Terminal Application Version is alphanumeric, e.g. 2.3.0. |
| 5FE131 | Terminal application build date | TEXT | - | Indicates the creation date of the Terminal application. |
| 5FE132 | Pay Hardware Service version (CM Terminal) | TEXT | - | Indicates the Pay Hardware Service version. |
| 5FE133 | SDK version on the terminal (CM Terminal) | TEXT | - | Indicates the SDK version on the terminal. |
| 5FE134 | ROM version (CM Terminal) | TEXT | - | Indicates the ROM version. |
| 5FE135 | Android OS version (CM Terminal) | TEXT | - | Indicates the Android OS version. |
| 5FE300 | Transaction identifier | TEXT | 31 | Universal unique identifier of the payment transaction. The identifier is generated by the CM.com IPP Payments Platform. |
| 5FE303 | Transaction type | BIN | 2 | Indicates the Transaction type sent by the terminal. |
| 5FE304 | Transaction options | BIN | 4 | Indicates the transaction options value in the PRINT_COMMAND message: 00 for NONE or 02 for Request-Signature. Terminals must use this tag to determine receipt generation logic, including signature line placement and refund line printing on merchant or cardholder receipts. |
| 5FE306 | Original reference | TEXT | 8 | Indicates the STAN of original payment/Pre-Authorization. |
| 5FE307 | Original reference date | TIME | 4 | Indicates the date of original payment/Pre-Authorization. Format: yyyyMMdd. |
| 5FE309 | Card sequence number | TEXT | 3 | Indicates the card sequence number, as extracted from Track 2 data. |
| 5FE30A | Transaction succeeded | BOOL | 1 | Transaction succeeded |
| 7fe506 | Formatted receipts | CNSTR | - | Container for formatted receipts. |
| 7fe505 | Receipt formatted lines | CNSTR | - | Container for formatted print lines |
| 5fe505 | Receipt formatted line | TEXT | 80 | Container for formatted print line |
| 5FE310 | Terminal key serial number | BIN | - | Indicates the key serial number used for encrypting the PIN. |
| 5FE311 | Encrypted PIN block | BIN | - | Encrypted PIN data |
| 5FE312 | Encrypted cardholder data | BIN | - | Indicates the Encrypted cardholder data information. |
| 5FE313 | ASCII track2data | TRACK2DATA | - | See Hexadecimal ASCII |
| 5FE314 | Masked PAN | TEXT | 20 | Indicates the masked PAN (Primary Account Number) for printing on the receipt. |
| 5FE315 | PIN length | INT | 1 | Indicates the length of the PIN, specified by the number of digits. |
| 5FE321 | Amount display string | TEXT | 16 | See Amount display string |
| 5FE333 | Processor name | TEXT | 16 | Indicates the name of the processor. |
| 5FE34A | System Trace Authentication Number | INT | 6 | Indicates the System Trace Audit Number. |
| 5FE34C | Gratuity approved amount unit | BIN | 4 | Indicates the gratuity Amount, Authorised (Binary). |
| 5FE341 | Merchant order ref | TEXT | 64 | Merchant’s order number. |
| 5FE346 | Cardholder data length | INT | 1 | Indicates the length of the cardholder data. |
| 5FE501 | Receipt footer text | TEXT | 64 | Indicates the text for the footer of the receipt, as specified in the portal. |
| 5FE502 | Receipt duplicate | BOOL | 1 | Indicates whether the receipt is a duplicate receipt. |
| 5FEF01 | Pre-authorization valid date | TIME | 6 | Indicates the end of the period during which a sale can be completed after pre-authorization. Format: yyMMdd. |
| 5FEF02 | Pre-authorization valid time | TIME | 6 | Indicates the end of the time period during which a sale can be completed after pre-authorization. Format: HHmmss. |
| 7FE010 | Application Protocol Version | CNSTR | - | Indicates the application level protocol version. |
| 7FE012 | Application Identification | CNSTR | - | Indicates the application level identification. |
| 7FE306 | Transaction AID list | CNSTR | - | Constructed tag containing the AID (Application Identifier) list from the card. |
| 7FE320 | Amount entry | CNSTR | - | Constructed tag that indicates the amount in application currency. |
| 7FE340 | Gateway data | CNSTR | - | Additional data sent along in the AUTHORIZATION_RESPONSE by CM.com IPP Payments Platform. |
IPP Payments Platform Tag Summary
EMV Tags
For further information check EMV Integrated Circuit Card Specifications for Payment Systems, Book 3, Application Specification. You can find the specification at emvco.