Skip to main content

SCA Functional Specification

Hosts Parameters

Last updated: 04-Dec-2024

This table describes the general parameters used for Host related configurations.

  

Note

  • Few parameters from Hosts Parameters, are not configurable using SET_PARM command. Refer to Parameters Not Configurable with SET_PARM for more details on the list parameters.
  • All the parameters above will have underscore (_) at the end of the name, except the following : SSIPROTOCOLENABLED, PARM_PRIMURL, PARM_SCNDURL, PARM_TID, PARM_MID and CTimeout.
Config.usr1/Parameter DLD Name Description Valid/Max Values Default Value Name in PropertiesData.xml
CTimeout This parameter is used to set the duration of time for the device to wait for host response. If the host response is not received in this specified time, then the application ends the connection with Comm Error. Numeric 30000 CommTimeout
CURRENCYIDX This parameter is used to set the index reference to currency used by the host. Valid Currencies Index Value 0 CurrencyIdx
CONNECTRETRYCOUNT This parameter is used to set the maximum number of retry count for the host connection. Numeric, 1 0 MaxConnectRetry
DIALPABX This parameter is used to set the PBX code for dialed connections. Numeric, 20 <blank> dial/0/pbax_code
DIALPHONE This parameter is used to set the dial-up phone number. Numeric, 20 <blank> dial/0/address
DIALTIMEOUT This parameter is used to set the transaction time out for dialed connections. Numeric, 5 <blank> dial/0/timeout
DISCLAIMER1 This parameter is used to set disclaimer line 1. Alphanumeric, 40 I AGREE TO PAY ABOVE AMOUNT ACCORDING Disclaimer1
DISCLAIMER2 This parameter is used to set disclaimer line 2. Alphanumeric, 40 TO THE CARD ISSUER AGREEMENT Disclaimer2
DISCLAIMER3 This parameter is used to set disclaimer line 3. Alphanumeric, 40 (MERCHANT AGREEMENT IF CREDIT/VOUCHER) Disclaimer3
DISCLAIMER4 This parameter is used to set disclaimer line 4. Alphanumeric, 40 [blank] Disclaimer4
HOSTNAME This parameter is used to set the host name. Alphanumeric, 10 Host specific HostName
HOSTCOMMERRORRETRIES This parameter is used to set the number of retries required for Host to connect, if comm connect is failing during an online or offline transaction. Numeric, 1 0 hostcommerrorretries
PARM_MID / MERCHANTID This is the Merchant Gateway ID. This value represents a unique number assigned to a merchant. This number is used for all processing activities. This value can also represent the network gateway through which transactions should be routed. Alphanumeric 15 [blank] MerchantID
NETWORKTCPTIMEOUT
This parameter is used to set the network TCP timeout. This parameter has underscore (_) at the end of the name. By changing the index number from 1 to 5, the following parameters will be updated accordingly:
  • interface/eppinterface/timeout
  • interface/primary/timeout
  • interface/secondary/timeout
  • interface/serial/timeout
  • interface/tertiary/timeout
Numeric 3000 timeout
PARTIALAUTH This parameter is used to enable or disable partial authorization.
  • 0 - Disable
  • 1 - Enable
1 PartialAuth
PARM_PRIMURL This parameter is used to set the primary auth URL. Alphanumeric, 128   PrimaryAuthUrl
PARM_SCNDURL This parameter is used to set the secondary auth URL. Alphanumeric, 128   SecondaryAuthUrl
PARM_TID This is for terminal ID. It represents a device from a specific facility, restaurant, or retail location. Numeric, 8 0 TerminalID
PARM_MID This is the Merchant Gateway ID. This value represents a unique number assigned to a merchant. This number is used for all processing activities. This value can also represent the network gateway through which transactions should be routed. Alphanumeric, 15 [blank] MerchantID
PRIMARYCOMMTYPE This parameter is used to set the primary communication type.
  • SERIAL
  • TCP
  • NONE
TCP PrimaryCommType
SECONDARYCOMMTYPE This parameter is used to set the secondary communication type.
  • SERIAL
  • TCP
  • NONE
NONE SecondaryCommType
TERMINALID This is for terminal ID. It represents a device from a specific facility, restaurant, or retail location. Numeric, 8 0 TerminalID
PRIMARYTCPADDRESS This parameter is used to set the primary TCP address. Alphanumeric, 200 <blank> tcp/0/address
PRIMARYTCPPORT This parameter is used to set the primary TCP port. Alphanumeric, 4 <blank> tcp/0/port
PRIMARYTCPTYPE This parameter is used to set the primary TCP type. Alphanumeric, 4 <blank> tcp/0/type
PRIMARYTCPTIMEOUT This parameter is used to set the primary TCP time out. Numeric, 5 <blank> tcp/0/timeout
SECONDARYTCPADDRESS This parameter is used to set the secondary TCP address. Alphanumeric, 200 <blank> tcp/1/address
SECONDARYTCPPORT This parameter is used to set the secondary TCP port. Alphanumeric, 4 <blank> tcp/1/port
SECONDARYTCPTYPE This parameter is used to set the secondary TCP type. Alphanumeric, 4 <blank> tcp/1/type
SECONDARYTCPTIMEOUT This parameter is used to set the secondary TCP time out. Numeric, 5 <blank> tcp/1/timeout
URIPATH URI Path for TCP/IP header. Alphanumeric, 128 ipchapi/rh.aspx URIPath
CONNECTTIMEOUT This parameter is used to set the transaction connection time out. Numeric, 6 45 seconds ConnectTimeout
RECEIVETIMEOUT This parameter is used to set the duration for time out, when receiving response from the Host. Numeric, 6 20 seconds ReceiveTimeout
SENDTIMEOUT This parameter is used to set the duration for time out, when sending request to the Host. Numeric, 6 20 seconds SendTimeout
SSIPROTOCOLENABLED This parameter is used to enable or disable SSI protocol.
  • 0 - Disable
  • 1 - Enable
1 SSIProtocolEnabled

Need help?

Do you have a question? If you didn’t find the answer you are looking for in our documentation, you can contact our Support teams for more information. If you have a technical issue or question, please contact us. We are happy to help.

Not yet a Verifone customer?

We’ll help you choose the right payment solution for your business, wherever you want to sell, in-person or online. Our team of experts will happily discuss your needs.

Verifone logo