Secondary Settings

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

Table 9-4 Tender Retail - Secondary Settings

Setting Description Default Example

mcm.host.folder

The path to the folder where the Tender Retail's application is installed.

\MerchantConnectMulti

mcm.host.folder = C:\MerchantConnectMulti

mcm.host.port

The socket port for making payment requests.

3858

mcm.host.port = 3858

mcm.host.name

The file location of where Tender Retail's application is installed.

localhost

mcm.host.name = localhost

check.mcm.server.on.startup

Defines whether Tender Retail's application should be contacted initially when starting the EFT adapter.

true

check.mcm.server.on.startup = true

communications.type

Sets the communications type.

ip

communications.type = ip

connection.timeout.1

This parameter configures the time until when the Tender Retail application is expected to respond to a request.

This includes the time needed to swipe the card at the PIN Pad terminal (if required) and to contact the financial institution.

120000

connection.timeout.1 = 120000

connection.timeout.2

This parameter determines the interval in which Tender Retail's application is expected to continue delivering data once it began to deliver something.

2000

connection.timeout.2 = 2000

timeout.saf

This parameter determines the time Tender Retail's application must empty its store and forward queue.

Note: If there is a communication problem with the eft transaction processor or if there are many transactions in the queue, it may take quite a while to process the queue.

600000

timeout.saf

do.positive.ack

Determines whether the responses are acknowledged. The value specifies the interval in which Tender Retail's application expects the acknowledgements.

5000

do.positive.ack = 5000

currency.code

Used in conjunction with SVS Gift card to set the currency code.

840

currency.code = 840

currency.symbol

Line display currency symbol.

$

currency.symbol = $

Use.tokens

Determines whether Tender Retail's application is set to use tokens.

This setting must match the configuration of Tender Retail's application.

true

use.tokens = true

combine.receipts

Turn on/off POS combine receipt.

false

combine.receipts = false

combine.receipts.suppress.lines

When combine.receipt is true, sets which line number to suppress.

NA

combine.receipts.suppress.lines=1,3,5

combine.receipts.suppress.strings

When combine.receipt is true, sets which line to suppress when strings are matched.

NA

combine.receipts.suppress.strings = Date,Time

exclude.combine.receipts.Strings

Sets what line to suppress when strings are matched.

NA

exclude.combine.receipts.Strings = signature,welcome,ball

Void.header.n

[where n is >0]

Specify the number of header lines to include on void receipts (maximum of 3 supported lines).

None

void.header.1 = **********

void.header.2 = ** VOID **

void.header.3 = **********

Void.footer.n

[where n is >0]

Specify the number of footer lines to include on void receipts.

None

void.footer.1 = **********

void.footer.2 = ** VOID **

void.footer.3 = **********

electronic.signature

Enable the extracting of electronic signature from the device for display/approval on the POS.

false

Electronic.signature=true

electronic.signature.timeout

Sets the time out for “Amount of time to wait after a user completes signing”.

25

electronic.signature.timeout = 60

Socket.file.encoding

Overrides what character set to be used while reading the response on the socket from the Tender Retail client.

The default character set on a windows jvm is cp1252, if any other charset is specified by the jvm (-Dfile.encoding) the socket.file.encoding below will automatically be set to ISO-8859-1.

Setting the character set below will override any defaults.

  

socket.file.encoding=cp1252

perform.card.range.lookup

If true, EFTLink will use its mapping file CardRange.xml to determine the card scheme name.

false

perform.card.range.lookup=false

suppress.additional.message.prompt

If true, suppresses the message prompt on a failed transaction.

false

suppress.additional.message.prompt = false

exclude.additional.message.prompt.by.response.code

Comma delimited exception list if suppress.additional.message.prompt is true.

exclude.additional.message.prompt.by.response.code =

tr.fields.used.for.wallet.trans.ref Comma delimited list of tender retail fields that map to the CardServiceResponse’s AcquirerTransactionReference field for wallet transactions. REF tr.fields.used.for.wallet.trans.ref = REF
tr.fields.used.for.gc.trans.ref Comma delimited list of tender retail fields that map to the CardServiceResponse’s AcquirerTransactionReference field for gift card transactions. INV,REF tr.fields.used.for.gc.trans.ref = INV,REF
tr.fields.used.for.emv.trans.ref Comma delimited list of tender retail fields that map to the CardServiceResponse’s AcquirerTransactionReference field for EMV transactions. INV,REF tr.fields.used.for.emv.trans.ref = INV,REF

suppress.additional.message.prompt.for.gift.card

If true, suppresses the message prompt on a failed gift card transaction.

false

suppress.additional.message.prompt.for.gift.card = false

exclude.additional.message.prompt.for.gift.card.by.response.code

Comma delimited exception list if suppress.additional.message.prompt.for.gift.card is true.

exclude.additional.message.prompt.for.gift.card.by.response.code =

add.response.properties.to.misc.data

Specify tender retail response property codes (comma delimited) to be sent through miscellaneous data within the card service response.

SEQ,ISO,FBK,DSP

add.response.properties.to.misc.data = SEQ,ISO,FBK,DSP

manual.auth.input.type.alphanumeric

Sets the input validation to alphanumeric for entering the authorization code.

false

manual.auth.input.type.alphanumeric = false

manual.auth.minimum.length

Sets the minimum length for an authorization code.

6

manual.auth.minimum.length = 6

manual.auth.maximum.length

Sets the maximum length for an authorization code.

6

manual.auth.maximum.length = 6

manual.auth.retrys

Sets the number of retry attempts for entering an authorization code.

3

manual.auth.retrys = 3

swipe.fallback

Turns on/off the ability to prompt for manual keyed entry.

false

swipe.fallback = false

svc.card.type

Sets the gift card provider. Valid values are SVS or Givex.

svs

svc.card.type = svs

svs.pin.entry

Turn on/off the prompting for pin for SVS Gift Cards.

false

svs.pin.entry = false

svs.pin.entry.on.ped

Turn on/off the prompting for pin capture on the ped. if false the pin capture is done on the POS.

false

svs.pin.entry.on.ped = false

svs.pin.entry.types

Determines which tender types require pin capture.

83,A3,D3

svs.pin.entry.types = 83,A3,D3

svs.pin.minimum.length

Sets the minimum length for a pin.

4

svs.pin.minimum.length = 4

svs.pin.maximum.length

Sets the maximum length for a pin.

4

svs.pin.maximum.length = 4

svs.pin.retrys

Sets the number of retry attempts

3

svs.pin.retrys = 3

givex.user.id

User id provided by Givex.

givex.user.id = [encrypted user id string]

givex.user.id.iv

Encrypted password initialization vector.

givex.user.id.iv = [encrypted user id iv string]

givex.password

Password provided by Givex.

givex.password = [encrypted password string]

givex.password.iv

Encrypted password initialization vector.

givex.password.iv = [encrypted password iv string]

givex.allow.partial.tender

Specify whether to allow partial tendering of gift cards.

true

givex.allow.partial.tender = true

givex.pin.entry

Turn on/off the prompting for security pin for Givex Cards.

false

givex.pin.entry= false

givex.pin.entry.types

Sets which tender types require security pin capture.

73,83

givex.pin.entry.types = 73,83

givex.pin.minimum.length

Sets the minimum required length for a Givex security pin.

6

givex.pin.minimum.length = 6

givex.pin.maximum.length

Sets the maximum required length for a Givex security pin.

6

givex.pin.maximum.length = 6

givex.pin.retrys

Sets the maximum number of retries allowed.

3

givex.pin.retrys = 3

crypto.keygenType

Sets keygen algorithm type.

AES

crypto.keygenType = AES

crypto.cipherType

Sets cipher algorithm type.

AES/CBC/PKCS5Padding

crypto.cipherType = AES/CBC/PKCS5Padding

crypto.keySize

Sets size of the key store.

128

crypto.keySize = 128

crypto.iterations

Sets number of iterations.

100000

crypto.iterations = 100000

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

AdminMenu0.X

Specifies the ability to customize the Admin Menu. Replace X with a value between 0 - 4.

AdminMenu0.1 = TXT_DAY_END, Day End

AdminMenu0.2 = TXT_PINPAD_INITIALIZATION, PINPad Initialization

AdminMenu0.3 = TXT_SIGNATURE_CAPTURE, Signature Capture

AdminMenu0.4 = TXT_CANCEL, Cancel

AdminMenu0.1 = TXT_DAY_END, Day End

AdminMenu0.2 = TXT_CANCEL, Cancel

line.display.enabled

Enables line item display request to the PED.

false

line.display.enabled = true

wait.for.line.display If set to true, the core will pause upon receiving a payment request if there are still sale line item requests being processed, until all of these requests have been completed. false wait.for.line.display = true
wait.for.line.display.timeout The amount of time to wait for a sale line item request to be completed is dependent on the wait.for.line.display setting. A value of 0 means the wait is indefinite. 0 wait.for.line.display.timeout
max.line.items.processed The maximum number of line items to be sent upon the request. If the number of line items is greater than the specified value, then all except the most recent line items are stripped from the request. 9 max.line.items.processed = 9
cnp.request.type Sets the tender retail transaction type for card not present transaction. Possible values known are EU, E0, or 00 (however any value will be sent so long as the value length equals two). EU cnp.request.type = EU