General

Selects the PED instance from the dropdown provided. After selecting a PED from the list you can set its properties. Multiple instances are configured and their property can be set using this option.

ped_instance.png

Instance

The instance to be used with Hospitality can be selected from the drop down list. A new instance can be created with the Add New button.

By default Hospitality uses the required property files from the properties folder. For other Instances it uses the properties folder in the INSTANCE_XX folder in the directory specified here.

If multiple instances are configured, run the Emboss-setup.bat file as well to enter Merchant ID and Terminal IDs for each instance.

Instance Properties

General

This tab provides options to configure general features of Hospitality.

  • PED: Used to configure the PED to be used with Hospitality. Hospitality supports P400 PED in IP, serial and USB mode. Application also supports V240m in IP and USB mode.

  • Card Inactivity Timed out: The time in seconds when the transaction times out if no card is presented.

  • Debug Mode: In debug mode TVR, TSI and CVMR are printed on the receipt.

  • Comport: Represents the value of comport where PED is connected to system with USB.

  • NumberOfLogFiles: If the yescps.log reaches to 1MB then it is renamed automatically as yescps.log.1 and the file prior to that as yescps.log.2 and so on. The number of log files can be configured from 20 to 999, and once the maximum number is reached oldest log file is overwritten.

    If the TerminalInitializer.log reaches to 1MB then it is renamed automatically as TerminalInitializer.log.1 and the file prior to that as TerminalInitializer.log.2 and so on. The number of log files can be configured from 20 to 999, and once the maximum number is reached oldest log file is overwritten.

  • Extended Debug Mode: In this mode, additional information is printed on the receipt. Examples are 9F26, 82, 9F27, 9A, 9F1A, 9F10, 9C, 9F37, 9F02, 9F03, 9F36, 5F2A, IAC ONLINE, IAC DENIAL, IAC DEFAULT, TAC ONLINE, TAC DENIAL, TAC DEFAULT.

  • Pin Pad Port: Applies when an IP PED is selected. This is the TCP socket port for communication between Hospitality and the PED.

    Each instance should be configured on different port value like example :-

    1. 5001 - Instance 1
    2. 5002 - Instance 2 ......
  • IP Address: Applies when PED is selected to connect with CHM ('P400-CHM'). This is the IP address for communication between Hospitality and the CHM.

  • Ask Gratuity: Adds a facility to prompt the cardholder for Gratuity at the time of payment.

  • Define preset Gratuity Options: This option is available only when Ask Gratuity is selected and adds a facility to prompt the cardholder for preconfigured gratuity percentage options, in addition to allowing them to enter a percentage of their choice. When this option is selected up to three preset gratuity percentages may be specified as follows

    • Only whole numbers are accepted.

    • Percentage value cannot be more than 99%. (1 to 99)

    • At least one of the preset percentages should be populated.

    • Percentage values cannot be repeated in any of the entries, for example two entries cannot have value 5%.

    • % values should be in ascending order.

instance_properties.png

  • Disable Pennies for Contactless Txn: This option helps to disable donation prompt with contactless transactions and prompt donation with chip and pin transaction after card insertion. This functionality works irrespective of donation enabled at Merchant level during the time of boarding. It is configurable at instance level.

Summary of Common and Instance specific features and configuration items

Common features are always set or changed on Default instance (i.e Instance 0) and do not have any effect if you change them on other instances. Similarly, instance specific features or changes are applicable to that instance only.

export-config.png

Features/Configuration itemCommonInstance specific
ClasspathYesNo
Base DirectoryYesNo
EnvironmentYesNo
LanguageYesNo
CountryYesNo
PEDNoYes
Card Inactivity Timed outNoYes
DebugModeNoYes
PED PortNoYes
InterfacingYesNo
Receipt DirNoYes
Print ReceiptNoYes
Receipt WidthNoYes
PrinterNoYes
Print Merchant ReceiptNoYes
AVS Details MandatoryNoYes
AVS Details Mandatory & Apply AVS Confirmation RulesNoYes
Accept only on all matchNoYes
Accept on CVV and Zip code MatchNoYes
Accept on CVV and Address MatchNoYes
Accept on CVV and of the Address or Zip code MatchNoYes
Accept on CVV MatchNoYes
Accept any ResponseNoYes
Apply AVS Confirmation RulesNoYes
EVT HostYesNo
EVT PortYesNo
Allow Custom Split TransactionYesNo
Allow Equal Split TransactionYesNo
Show Confirm Transaction ScreenYesNo
Remote Table ClosureYesNo
Cash at TableYesNo
PreSet Number FlagNoYes
Preset NumberNoYes
Delete Transaction from list after(10-60)YesNo
EPOS ReceiptNoYes
PreSet GratuityNoYes
Disable Pennies for Contactless TxnNoYes