Secondary Settings

These settings are normally correct at their default values but can be overridden if necessary.

Table 11-2 Verifone Point (US) - Secondary Settings

Setting Description Default Example

TerminalPort

Port number.

5015

TerminalPort = 5015

MaintenanceTimeout

Timeout on maintenance menu selection. Timeout is specified in seconds.

60

MaintenanceTimeout = 60

ResponseTimeout

Time allowed in seconds for the transaction to complete at the terminal. This needs to be long enough to cover all customer interaction and host authorization.

120

ResponseTimeout = 120

ConnectionTimeout

The Connection timeout. Timeout is specified in seconds.

10

ConnectionTimeout = 10

ConnectionIssueRetryAttempts

When exceeding the ResponseTimeout. How many attempts should the associate be given to re-establish communications before returning failure.

1

ConnectionIssueRetryAttempts = 3

ValidateLoyaltyData

When a loyalty card swipe is requested, the customer may identify themselves by entering a phone number rather than swiping a card. If loyalty cards are suitably defined in the card range file and tagged as "Loyalty", this can be checked.

Option to enable validation of loyalty data to try to differentiate between card numbers and phone numbers.

false

ValidateLoyaltyData = false

SignatureCheckFloorLimit

Floor limit for swiped credit transactions.

0.00

SignatureCheckFloorLimit = 0.00

SignatureCheckTimeout

Timeout on waiting for signature.

30

SignatureCheckTimeout = 30

EmbeddedPrinting

Whether customer printout is to be buffered and included in the POS authorization response such that it can be embedded # in the POS receipt.

false

EmbeddedPrinting = false

MaxLineItems

Maximum number of line items allowed in a single message.

10

MaxLineItems = 10

MaxLineItemUpdates

Maximum number of individual line item update messages it is practical to send before it becomes too cumbersome and slow.

20

MaxLineItemUpdates = 20

MaxLineItemTextLength

Maximum line item description length allowed by comms protocol or visible on terminal.

17

MaxLineItemTextLength = 17

ShowlineItemsOnVoucher

Whether to show line items on the EFT voucher.

false

ShowlineItemsOnVoucher = false

ReceiptLineItemStartTag

Key word/phrase that identifies the start of line item summary on EFT voucher.

QTY DESCRIPTION

ReceiptLineItemStartTag = QTY DESCRIPTION

ReceiptLineItemEndTag

Key word/phrase that identifies the end of line item summary on EFT voucher.

Total:

ReceiptLineItemEndTag = Total:

ShowEMVTagsOnVoucher

Whether to show diagnostic EMV tags on the EFT voucher.

false

ShowEMVTagsOnVoucher = false

EmbeddedPrintFilter_<n>

Print filters to allow voucher to be trimmed when embedded in the POS receipt for example, to remove header/footer lines starting with text in this list will be skipped.

Maximum filter is 99.

null

EmbeddedPrintFilter_1 =<blank>

EnableTrack2ForCardSwipe

Specifies whether track2 is to be returned for certain card types. Also requires changes to range xml to prevent masking of numbers.

false

EnableTrack2ForCardSwipe=false

SwipeFallbackToKeyed

Specifies whether failure of card swipe during payment will result in fallback to keyed entry on the PED.

false

SwipeFallbackToKeyed=false

MaxRetrySendDeviceCommand

Number of retry to send the device command in a situation where the device is busy during the first attempt.

2

MaxRetrySendDeviceCommand=2

RetrySendDeviceCommandDelay

The delay in milliseconds in every retry of sending the device command.

3000

RetrySendDeviceCommandDelay=3000

DisplayMessageTimeout

The number of seconds to display the message in the PIN pad for the device command, DISPLAY_MESSAGE.

The timeout value specified can be overriden within the DeviceRequest

<?xml version='1.0' encoding='UTF-8'?>

<DeviceRequest RequestType="Output" ApplicationSender="MICROS" WorkstationID="1" RequestID="5">

<Output OutDeviceTarget="PinPad" TimeOut="10">

<TextLine>Black Friday Sale</TextLine>

</Output>

</DeviceRequest>

10

DisplayMessageTimeout = 30

DisplayQRCodeDoneButtonLabel

The label of the button in the command to display QR code in the terminal.

Done

DisplayQRCodeDoneButtonLabel = Done

MaxNumberOfSurveyTextLine

Maximum number of lines of text in the survey command.

5

MaxNumberOfSurveyTextLine = 5

MaxSurveyLineMessageLength

Maximum number of characters for each line in the survey message.

50

MaxSurveyLineMesageLength = 50

MaxDonationLineMessageLength

Maximum number of characters for each line in the donation message.

50

MaxDonationLineMesageLength = 50

MaxNumberOfDonationTextLine

Maximum number of lines of text in the donation command.

5

MaxNumberOfDonationTextLine = 5

MaxNumberOfDonationChoices

Maximum number of choices for the donation command.

5

MaxNumberOfDonationChoices = 5

MaxNumberOfCustomerButtonChoices

Maximum number of choices in the customer buttons command.

6

MaxNumberOfCustomerButtonChoices = 6

MaxCustomerButtonsLineMessageLength

Maximum number of characters for each line in the customer buttons message.

45

MaxCustomerButtonsLineMessageLength = 45

MaxNumberOfCustomerButtonsTextLine

Maximum number of lines of the message for the customer buttons command.

5

MaxNumberOfCustomerButtonsTextLine = 5

MaxQRCodeDataLength

Maximum number of characters for the QR code data.

200

MaxQRCodeDataLength = 200

MaxQRCodeMessageLengthWithTransaction

The maximum number of characters of the message in the display QR code command in an active transaction.

72

MaxQRCodeMessageLengthWithTransaction = 72

MaxQRCodeMessageLengthWithOutTransaction

The maximum number of characters of the message in the display QR code command when there is no active transaction.

150

MaxQRCodeMessageLengthWithOutTransaction = 150

MaxDisplayTextLength

The maximum number of characters of the message to display for the DISPLAY_MESSAGE command.

150

MaxDisplayTextLength = 150

TokenExpiryDate

Enables the core to pass the card's expiration date to the POS. As such, this will be passed to PointUS for verified refund.

true

TokenExpiryDate = true

TenderLineItemIdAddend

The number that gets added to the tender line sequence to become the unique LINE_ITEM_ID.

1000

TenderLineItemIdAddend = 1000

MCLabelCounterMaxValue

The maximum value of the counter in the PED for a given Mac label.

4294967295

MCLabelCounterMaxValue = 4294967295

WaitTimeForLineDisplayToFinish

The wait time interval in milliseconds given to the line item manager thread to finish processing before the core sends the payment request to Point.

5000

WaitTimeForLineDisplayToFinish = 5000

SignatureLineIndicator

The indicator used as the signature line in the merchant receipt where customer will sign in case the device used does not support electronic signature.

x

SignatureLineIndicator = x

MerchantReceiptIndicator

An indicator for the merchant copy of the receipt.

MERCHANT COPY

MerchantReceiptIndicator = MERCHANT COPY

CustomerReceiptIndicator

An indicator for the customer copy of the receipt.

CUSTOMER COPY

CustomerReceiptIndicator = CUSTOMER COPY

PrintMerchantReceipt

Whether to print the merchant receipt or not.

true

PrintMerchantReceipt = true

MerchantID

Merchant ID required for "Setup Device Parameters" function in EFTLink Admin functions in Xstore back office.

MerchantID= 12345678

TerminalID

Terminal ID required for required for "Setup Device Parameters" function in EFTLink Admin functions in Xstore back office.

TerminalID=002

Lane

Lane required for "Setup Device Parameters" function in EFTLink Admin functions in Xstore back office.

Lane=002

HostIndicator

Host Indicator required for "Setup Device Parameters" function in EFTLink Admin functions in Xstore back office.

HostIndicator=VNTV

RestrictToDebitCredit

Restrict payment capture command to credit debit payment types.

false

RestrictToDebitCredit=true

RemoveOfferLineItem

Specify whether to include the OFFER line item when removing the parent or main item.

Enable this for Engage devices such as the M400 that will not remove the child OFFER line automatically when the parent item is removed.

Consult Verifone to determine which devices behave this way.

false

RemoveOfferLineItem = true

IgnoreSignatureCapture

Determine whether to ignore the capture of electronic signature. This is applicable for Engage devices such as the E285 which does not support the 3BA format and signature capture cannot be disabled on the device.

false

IgnoreSignatureCapture=true

EnforceGiftTenderType

Specifies whether a giftcard type action will enforce a GIFT tendertype on PED device.

false

EnforceGiftTenderType = false

ReceiptAPMType

Whether the additional receipt data should be used.

0 — do not print additional receipt data.

1 — only print additional receipt data with APM transactions.

2 — append additional receipt data to standard receipt.

0

ReceiptAPMType = 2

AddResponseFieldsToMiscData

The PointUS fields to be returned within Miscellaneous Data.

  

AddResponseFieldsTo MiscData = BANK_USERDATA

RestartSessionOnVoids

Performs a session stop and start before sending the void/reversal request.

false

RestartSessionOnVoids = true

AddCtroutdToCreditRefunds

If true and the Payment Type is Credit, then add CTROUTD to the Credit/Refund request.

false

AddCtroutdToCreditRefunds = true

IncludeBankUserDataWithCardToken

If true and the BANK_USERDATA and CARD_TOKEN is included in the Payment response then store them together within the CardServiceResponse Card Object.

true

IncludeBankUserDataWithCardToken = true
VoiceAuthorizationResultCodes A comma-separated list of RESULT_CODE indicators to trigger for voice authorization. 59024,59074 VoiceAuthorizationResultCodes = 59024,59074

FullPacketEncryption

Enables Full Packet Encryption where all messages will be encrypted with the AES 128. Note: REGISTER_ENCRYPTION and STATUS requests are not encrypted.

false

FullPacketEncryption = true

PayloadKeyPairAlgorithm

The name of the secret-key algorithm used for encrypting/decrypting the payload.

This setting requires FullPacketEncryption to be set to true.

Must match the PointUS Algorithm.

AES

PayloadKeyPairAlgorithm = AES

PayloadKeyPairCipher

The cipher initialization used for encrypting/decrypting the payload.

This setting requires FullPacketEncryption to be set to true.

Must match the PointUS Algorithm.

false

PayloadKeyPairCipher = AES/CBC/PKCS5PADDING

crypto.keygenType

Sets keygen algorithm type.

AES

crypto.keygenType = AES

crypto.cipherType

Sets cipher algorithm type.

AES/GCM/PKCS5Padding

crypto.cipherType = AES/CBC/PKCS5Padding

crypto.keySize

Sets size of the keystore.

Note: When the keysize is greater than 128, you may get java.security.InvalidKeyException: Illegal key size or default parameters. If this happens you will need to download additional Java Cryptography Extension (JCE) Unlimited Strength Jurisdiction Policy Files and extract those files to $JAVA_HOME/jre/lib/security/

128

crypto.keySize = 128

crypto.iterations

Sets number of iterations.

100000

crypto.iterations = 10000

crypto.factoryinstance

Sets crypto factory instance for keystore password encryption.

PBKDF2WithHmacSHA512

crypto.factoryinstance = PBKDF2WithHmacSHA512

crypto.secretkeyspec

Sets crypto secret key spec for keystore password encryption.

AES

crypto.secretkeyspec = AES

crypto.keystoretype

Sets keystore type.

JKS

crypto.keystoretype = JKS

crypto.digest

Sets digest for keystore password.

SHA-512

crypto.digest = SHA-512

crypto.hashbyteSize

Sets hash byte size for keystore password.

384

crypto.hashbyteSize = 384