Terminal Parameters
Last updated: 04-Dec-2024
This command runs the Terminal Parameters report. The TERMPARAMS report is the request/response sequence for retrieving terminal parameters separated by section. This is used in conjunction with the PrintTermParam.INI file.
Note
This is available for First Data Rapid Connect at time of publication.
Device UI Required: No
Request Packet
| Field | Rule | Type | Minimum | Maximum | Value(s) | Description |
|---|---|---|---|---|---|---|
| FUNCTION_TYPE | Required | Static value | N/A | N/A | REPORT | Type of function |
| COMMAND | Required | Static value | N/A | N/A | TERMPARAMS | Command name |
| COUNTER | Required | Numeric | 1 | 10 | COUNTER is used for a given MAC label. Each COUNTER should be higher than the last one. This is sed to authenticate the POS. Example: 1 | |
| MAC | Required | Base64 Encoded Data | N/A | N/A | Message Authentication Code. This is used to authenticate the POS. | |
| MAC_LABEL | Required | Character | 1 | 50 | Associated label that tells the device which MAC_KEY to use to decrypt the value of MAC. This is used to authenticate the POS. Example: REG1 |
Request packet Example
<TRANSACTION>
<COUNTER>1</COUNTER>
<MAC> … </MAC>
<MAC_LABEL>REG2</MAC_LABEL>
<FUNCTION_TYPE>REPORT</FUNCTION_TYPE>
<COMMAND>TERMPARAMS</COMMAND>
</TRANSACTION>
Response Packet
| Field | Type | Value | Description |
|---|---|---|---|
| RESPONSE_TEXT | Character | Processor response text. Example: REPORT COMPLETE | |
| RESULT | Character | This indicates the Result details. Example: OK | |
| RESULT_CODE | Numeric | Expected result codes: -1 | This indicates the result code. |
| TERMINATION_STATUS | Character | SUCCESS and FAILURE | This indicates the transaction termination status. This is the overall status of the transaction irrespective of approved or declined. Like, if the output is generated then the status is SUCCESS and if no output is generated then the status will be FAILURE. |
| COUNTER | Numeric | Echoes COUNTER sent in the request. Example: 1 | |
| FUNCTION_TYPE | Character | REPORT | Returns the type of function. |
| COMMAND | Character | TERMPARAMS | Returns the command name. |
| TERM_PARAM_REPORT | Refer to the response example below to have more understandings on TERM_PARAM_DATA Receipt Text Elements. |
Response packet Example
<RESPONSE>
<RESPONSE_TEXT>REPORT COMPLETE</RESPONSE_TEXT>
<RESULT>OK</RESULT>
<RESULT_CODE>-1</RESULT_CODE>
<TERMINATION_STATUS>SUCCESS</TERMINATION_STATUS>
<TERM_PARAM_REPORT>
<TERM_PARAM_DATA>
<TEXTLINE> VERIFONE SCA </TEXTLINE>
<TEXTLINE> 11700 Great Oaks Way Way </TEXTLINE>
<TEXTLINE> Suite 210 </TEXTLINE>
<TEXTLINE> Alpharetta, GA 30022 </TEXTLINE>
<TEXTLINE> </TEXTLINE>
<TEXTLINE> Merchant ID: RCTST0000042337 </TEXTLINE>
<TEXTLINE> Terminal ID:001 </TEXTLINE>
<TEXTLINE>12/27/17 00:49:00</TEXTLINE>
<TEXTLINE> Terminal Parameter Report </TEXTLINE>
<TEXTLINE> </TEXTLINE>
<TEXTLINE> Application Version </TEXTLINE>
<TEXTLINE> </TEXTLINE>
<TEXTLINE>CAM Version VCAMGN300A2</TEXTLINE>
<TEXTLINE>CTLS Firmware EP2.0.4r;MK2.1.1r;VK</TEXTLINE>
<TEXTLINE> 2.1.5r;AK2.0.5r </TEXTLINE>
<TEXTLINE>Device Serial Num 401100780</TEXTLINE>
<TEXTLINE>EMV Kernel 702</TEXTLINE>
<TEXTLINE>OS Version release-30810300</TEXTLINE>
</TERM_PARAM_DATA>
</TERM_PARAM_REPORT>
</RESPONSE>
Example PrintTermParam.INI file
PrintTermParam.INI file is in the flash location on device and in the Solution bundle.
- [Application Version]
-
- Device Serial Num=TerminalInformation/SerialNumber
- OS Version=TerminalInformation/OSVersion
- EMV Kernel=TerminalInformation/EMVKernelVersion
- CTLS Firmware=TerminalInformation/CTLSFWVersion
- CAM Version=TerminalInformation/CAMVersion
- [Ethernet Interface]
-
- Device Name=interfaces:lan/device_name
- IP Address=interfaces:lan/ip_address
- Gateway = interfaces:lan/gateway
- DHCP Enabled=interfaces:lan/dhcp_enabled
- DNS Server 1=interfaces:lan/dns_1
- [Serial Interface]
-
- Serial Port=interfaces:serial/serialport
- Baudrate =interfaces:serial/baudrate
- Databits =interfaces:serial/databits
- [Host Details]
-
- Host Name=hosts:fdrc/HostName
- Primary Auth URL=hosts:fdrc/PrimaryAuthUrl
- TPPID=hosts:fdrc/TPPID
- Merchant ID=hosts:fdrc/MerchantID
- Terminal ID=hosts:fdrc/TerminalID
- Group ID=hosts:fdrc/GroupID
- GMF Version=hosts:fdrc/GMFVersion
- [Payment Types]
-
- Gift Card Support=application/GIFT
- Debit Card Support=application/DEBIT
- EBT Card Support=application/EBT
- [Application Details]
-
- Industry Type=merchants:merchant1/Industry
- App type=application/ATYPE
- Duplicate Swipe Detection=application/DupSwipeDetectEnable
- Quick Chip Support=application/quickchip
- [Cashback Details]
-
- Cashback Support =application/PRCASH
- Cashback Prompt 1=application/CASH1
- Cashback Prompt 2=application/CASH2
- Cashback Prompt 3=application/CASH3
Rate this article:
