Key Settings

Settings that may be different for each POS.

Table 4-1 OPI - Key Settings

Setting Description Default Example

EPSAddress

Specifies the host address of the EPS.

localhost

EPSAddress = IP ADDRESS

EPSPort

Specifies the host port of the EPS.

5007

EPSPort = 5007

EPSName

Specifies the name of the EPS. This is typically used to identify the PaymentProviderName during Tax Free processing.

Blank

EPSName = [PaymentProviderName]

where the PaymentProviderName is any supported provider.
truststore.trustAllServers

Disable validation of certificates with the truststore on connection between EFTLink and OPI devices.

Please note, disabling validation of the trusted certificate is never a recommended practice.

Ciphers and protocols will still continue to be restricted as configured below.

 false

truststore.trustAllServers = false
truststore.ProtocolsWhiteList Restricts the protocols which are permissible in the connection between EFTLink and EPS devices. Default allows for TLS 1.3 or 1.2 security. TLSv1.3,TLSv1.2

truststore.ProtocolsWhiteList = TLSv1.3,TLSv1.2
truststore.CipherWhiteList Restricts the ciphers which are permissible in the connection between EFTLink and EPS devices. The whitelist only includes ciphers which are approved under Oracle Approved Technologies: Security Protocols

TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256,TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384,TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256,TLS_AES_128_GCM_SHA256,TLS_AES_256_GCM_SHA384,TLS_CHACHA20_POLY1305_SHA256,TLS_AES_128_CCM_SHA256,TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384,TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256,TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256,TLS_ECDHE_ECDSA_WITH_AES_256_CCM,TLS_ECDHE_ECDSA_WITH_AES_128_CCM

truststore.CipherWhiteList =

TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256,TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384,TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256,TLS_AES_128_GCM_SHA256,TLS_AES_256_GCM_SHA384,TLS_CHACHA20_POLY1305_SHA256,TLS_AES_128_CCM_SHA256,TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384,TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256,TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256,TLS_ECDHE_ECDSA_WITH_AES_256_CCM,TLS_ECDHE_ECDSA_WITH_AES_128_CCM
truststore.CipherBlackList Restricts the ciphers which are not permissible in the connection between EFTLink and EPS devices. The blacklist only includes ciphers which are not approved under Oracle Approved Technologies: Security Protocols

SSL_.*,TLS_EMPTY_.*,.*_SHA,.*_3DES_.*,.*_DES_.*,.*_WITH_NULL_.*,.*_anon_.*,.*EXPORT.*,.*LOW.*,.*MD5.*,.*DES.*,.*RC2.*,.*RC4.*,.*PSK.*,TLS_DH_.*,TLS_DHE_.*

truststore.CipherBlackList =

SSL_.*,TLS_EMPTY_.*,.*_SHA,.*_3DES_.*,.*_DES_.*,.*_WITH_NULL_.*,.*_anon_.*,.*EXPORT.*,.*LOW.*,.*MD5.*,.*DES.*,.*RC2.*,.*RC4.*,.*PSK.*,TLS_DH_.*,TLS_DHE_.*

DefaultOperatorId

Specifies a default operator id for POS systems that do not provide an operator id in the CardServiceRequest.

EFTLink OPI Operator

DefaultOperatorId = EFTLink OPI Operator

DefaultBaseCurrency

Specifies the default base currency to be used as part of the TransCurrency element in the OPI Retail messages.

GBP

DefaultBaseCurrency = GBP

DefaultCheckType

Specifies the default check type for check processing.

01

DefaultCheckType = 01

DefaultCheckName

Specifies the default check name for check processing.

Personal Check

DefaultCheckName = Personal Check

SiteId

Specifies the SiteId data which is required in every Oracle Payments Interface request.

null

SiteId = Site

ProxyInfo

Override the ProxyInfo value reported on every Oracle Payments Interface request.

null

ProxyInfo = OPI Version 25.1

POSInfo

Specifies the POSInfo data which is required for every Oracle Payments Interface request.

null

POSInfo = Test POS

PartialAuthEnabled

Specifies whether partial authorization is enabled.

false

PartialAuthEnabled = true

ElectronicSignatureEnabled

Specifies whether Electronic Signature processing is enabled.

true

ElectronicSignatureEnabled = true

GiftCardProcessingEnabled

Specifies whether Gift Card processing is enabled.

true

GiftCardProcessingEnabled = true

PersonalCheckProcessingEnabled

Specifies whether Personal Check/Cheque processing is enabled.

true

PersonalCheckProcessingEnabled = true

LineDisplayEnabled

Specifies whether Line Item Display processing is enabled.

false

LineDisplayEnabled = true

ElectronicJournal

Specifies whether to add journal attributes to print lines.

false

ElectronicJournal = true

CombinedReceipt

Specifies whether to defer printing of the EFT customer receipt and instead include within the standard POS customer receipt.

CombinedReceiptFilter_X and DoNotCombineCustomerReceiptForDecline settings become effective when this setting is true.

false

CombinedReceipt = true

EWalletProcessingEnabled

Specifies whether to enable EWallet processing. EWalletIssuerIds setting becomes effective when this setting is true.

true

EWalletProcessingEnabled = true

InstallmentsEnabled

Specifies whether to enable installment payments functionality. MaxInstallmentsAllowed, DebitCreditSelectionPromptTimeout, NoOfInstallmentsPromptTimeout, NoOfInstallmentsPromptRetries settings become effective when this setting is true.

false

InstallmentsEnabled = true

LoyaltyBrandsEnable

Specifies whether to enable Loyalty Brands.

false

LoyaltyBrandsEnabled = true

AllowedLoyaltyBrands

A comma-separated list of allowed loyalty brands.

Dependent on property LoyaltyBrandsEnabled.

  

AllowedLoyaltyBrands = AppleVas,Google Smarttap

CardAcquisitionEnabled

Specifies whether to enable Card Acquisition message processing prior to Sale/Purchase message processing for 2-stage payment.

false

CardAcquisitionEnabled = true

RefRefundUseCardTokenEnabled

Specifies whether to use the Card Token to perform refund requests instead of the OriginalRRN/AcquirerTransactionReference.

false

RefRefundUseCardTokenEnabled = false

TokenizeAnonymousCardsEnabled

Specifies whether to always tokenize the card regardless of the existence of a CustomerId on the Payment CardServiceRequest.

false

TokenizeAnonymousCardsEnabled = true

QuickChipEnabled

Specifies whether to enable Quick Chip functionality to allow the customer to pre-authorize their card prior to sale tendering. QuickChipAverageTransactionValue setting becomes effective when this setting is true.

Warning: This setting will not be in effect unless LineDisplayEnabled is true and a value greater than 0 is set in the QuickChipAverageTransactionValue.

false

QuickChipEnabled = false

UseLegacyToke nLogicEnabled

Specifies whether to use legacy token logic processing. This ensures the RRN is set on the CardServiceResponse.CardValue.Token object so that linked refunds will use the CardServiceRequest.CardValue.Token for processing as the OriginalRRN.

Warning: this setting disables/disallows the ability to pay by stored card token/vault card token.

false

UseLegacyTokenLogicEnabled = true

PayByLinkExpiresAtHours

Defines how many hours a generated URL should be considered valid.

24

PayByLinkExpiresAtHours = 24

LegacyXstoreCopyCardTokenToOrigAltTransRef

Enable when using Xstore pre V19.0.1 and Cardless Reference Refund required when moving from POS Jni Core to OPI Core.

When process a Referenced Refund, it will copy CSRequest.Card.Token to OPI Refund Request OrigAltTransRef if CSRequest.TransactionReference is not set.

false

LegacyXstoreCopyCardTokenToOrigAltTransRef = true

CustomFormsUseSeparateTextLines

Define whether the core will move the separate TextLines in the DeviceRequest from PromptText to PromptText2, PromptText3, PromptText4 & PromptText5

Note, when obtaining Signature, these additional fields will be Title2, Title3, Title4 & Title5

false

CustomFormsUseSeparateTextLines = true
TerminalMessagesEnabled Define whether the core will connect to PED to receives terminale messages. PSP terminal should support this functionality. False TerminalMessagesEnabled=false
TerminalMessagesEndpoint When enabled, PED wss endpoint used to receive terminal message. PSP vendor should provide the address. Empty TerminalMessagesEndpoint=wss://<terminal_ip:port>/path
TerminalMessagesConnectionTimeoutMillis When enabled, connection timeout in milliseconds to TerminalMessagesEndpoint. 3000 TerminalMessagesConnectionTimeoutMillis=3000
EPSTerminalID Specify the unique name for EPS Terminal Id. Empty EPSTerminalID = EPS1
EnableSettingOfTerminalId Whether to use the EPS terminal Id. False EnableSettingOfTerminalId = false