Key Settings

Settings that may be different for each POS.

Table 5-1 Pay by Link - Key Settings

Setting Type Default Description
maintenanceMenuTimeoutSeconds number 6000 Specifies the admin menu timeout; in seconds.
httpConnectTimeoutSeconds number 30 How long to wait in seconds to establish a connection before timing out.
abortTimeoutSeconds number 30 Specifies in seconds, how long to wait for a cancellable transaction to be available otherwise an AbortRequest will be ignored;

adyen

object __________
adyen.merchantAccount string

The Adyen merchant account.

For example: "merchantAccount": "Oracle"

adyen.paybylink

object __________

adyen.paybylink

.apiKeyEncrypted

string

Specifies the encrypted Adyen API Key.

adyen.paybylink.customerNotPresent object __________
adyen.paybylink.customerNotPresent.endpoint string Specifies the endpoint for customer not present {format: https://<CLOUD_SERVICE_ENDPOINT >:<PORT>}
adyen.paybylink.customerNotPresent.responseTimeoutSeconds number 600 Specifies how long to wait in seconds, for a response from the customer not present endpoint.
adyen.paybylink.customerNotPresent.defaultCountryCode string Specifies the default country code to use in customer not present transactions when the country code has not been specified in the original request. This is in ISO 3166-1 alpha-2 format.
adyen.paybylink.customerNotPresent.defaultShopperLocale string

Specifies the default shopper locale to use in customer not present transactions when the shopper locale has not been specified in the original request.

For example: "defaultCountryCode": "en-GB"

adyen.paybylink.customerNotPresent.defaultLinkExpiryHours number 24 Specifies the default expiry time (in hours) for links created for customer-not-present transactions.
adyen.paybylink.customerNotPresent.truststore object __________
adyen.paybylink.customerNotPresent.truststore.trustAllServers boolean false

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

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

Ciphers and protocols restrictions continue to apply even when validation is disabled.

adyen.paybylink.customerNotPresent.truststore.disableHostnameVerification boolean false
adyen.paybylink.customerNotPresent.truststore.useJVMTrustStore boolean false use JVM cacert truststore instead of EFTLink dedicated truststore.
adyen.paybylink.customerNotPresent.truststore.expiringLogWarningDays number 90 Number of days prior to TLS certificate expiry that error warnings will be placed in EFTLink log files.
adyen.paybylink.customerNotPresent.truststore.protocolsAllowList array

TLSv1.3, TLSv1.2

Restricts the protocols which are permissible in the connection between EFTLink and OPI devices.

adyen.paybylink.customerNotPresent.truststore.cipherAllowList

array 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, "LS_ECDHE_ECDSA_WITH_AES_128_CCM Restricts the ciphers which are permissible in the connection between EFTLink and OPI devices. It is recommended that the allow list only include ciphers which are approved under Oracle Approved Technologies: Security Protocols
adyen.paybylink.customerNotPresent.truststore.cipherDenyList array SSL_.*, TLS_EMPTY_.*, .*_SHA, .*_3DES_.*, .*_DES_.*, .*_WITH_NULL_.*, .*_anon_.*, .*EXPORT.*, .*LOW.*, .*MD5.*, .*DES.*, .*RC2.*, .*RC4.*, .*PSK.*, TLS_DH_.*, TLS_DHE_.* Restricts the ciphers which are not permissible in the connection between EFTLink and OPI devices. The deny list by default includes ciphers which are not approved under Oracle Approved Technologies: Security Protocols.

adyen.paybylink.customePresent

object __________
adyen.paybylink.customePresent.endpoint string Specifies the endpoint for customer present {format: https://<TERMINAL_IP>:<PORT>/nexo}
adyen.paybylink.customePresent.responseTimeoutSeconds number 300 Specifies how long to wait in seconds, for a response from the customer present endpoint.
adyen.paybylink.customePresent.saleId string Specifies the unique cash register identifier to send in customer present transactions.
adyen.paybylink.customePresent.poiId string

The unique ID of the terminal {format: <TERMINAL_MODEL>-<SERIAL_NUMBER>.

For example: "poiId": " P400-123456789",

adyen.paybylink.customePresent.protocolVersion string 3.0 Specifies the version of Adyen’s Terminal API to send in customer present transactions.

adyen.paybylink.customePresent.adyenCryptoVersion

string 1 Specifies the Adyen crypto version to send in customer present transactions.
adyen.paybylink.customePresent.key object __________
adyen.paybylink.customePresent.identifierEncrypted string Specifies the (Encrypted) Adyen Key Identifier to use to perform customer present transactions.
adyen.paybylink.customePresent.passphraseEncrypted string Specifies the (Encrypted) Adyen Key Passphrase to use to perform customer present transactions.

adyen.paybylink.customePresent.versionEncrypted

string Specifies the (Encrypted) Adyen Key Version to use to perform customer present transactions.
adyen.paybylink.customePresent.trustore object __________
adyen.paybylink.customerPresent.truststore.trustAllServers boolean false

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

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

Ciphers and protocols restrictions continue to apply even when validation is disabled.

adyen.paybylink.customerPresent.truststore.disableHostnameVerification boolean false
adyen.paybylink.customerPresent.truststore.useJVMTrustStore boolean false use JVM cacert truststore instead of EFTLink dedicated truststore.
adyen.paybylink.customerPresent.truststore.expiringLogWarningDays number 90 Number of days prior to TLS certificate expiry that error warnings will be placed in EFTLink log files.
adyen.paybylink.customerPresent.truststore.protocolsAllowList array

TLSv1.3, TLSv1.2

Restricts the protocols which are permissible in the connection between EFTLink and OPI devices.

adyen.paybylink.customerPresent.truststore.cipherAllowList

array 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, "LS_ECDHE_ECDSA_WITH_AES_128_CCM Restricts the ciphers which are permissible in the connection between EFTLink and OPI devices. It is recommended that the allow list only include ciphers which are approved under Oracle Approved Technologies: Security Protocols
adyen.paybylink.customerPresent.truststore.cipherDenyList array SSL_.*, TLS_EMPTY_.*, .*_SHA, .*_3DES_.*, .*_DES_.*, .*_WITH_NULL_.*, .*_anon_.*, .*EXPORT.*, .*LOW.*, .*MD5.*, .*DES.*, .*RC2.*, .*RC4.*, .*PSK.*, TLS_DH_.*, TLS_DHE_.* Restricts the ciphers which are not permissible in the connection between EFTLink and OPI devices. The deny list by default includes ciphers which are not approved under Oracle Approved Technologies: Security Protocols.

merchantReference

string The unique merchant reference.
merchantReferenceFormat String R

The format of the merchant reference - replaces static value with a dynamically generated value using a number of substitutions.

See Merchant Reference Formats.

merchantReferenceSpecialChar

string

a character that is to be passed through 'as is' in addition to the ones already mentioned.

For example: “merchantReferenceSpecialChar

“: “K”