Skip to content

About device settings

Learn about the different settings available and their default values.

Overview

A device's settings are configured in the Unity Portal when you first set up a new POS. They're then automatically downloaded to the device when it first connects.

You can update a device's settings in the Portal at any time and the modified settings will automatically be updated on the device.

General settings

POS settings

NameDescription
StatusThe current status of the POS device.
POS IDThe unique identifier for the point-of-sale device. This is set at device creation and can't be changed later.
Device modelThe device model.
Serial numberThe serial number of the device.
Communication protocolThe communication protocol used to transfer data to and from the device. This can be TCP or HTTP.
Communication endpointThe URL that PXP should communicate with.
Device modelThe device model.
Commercial modelThe commercial model. This can be One-time fee, Recurring fee, or One-time & Recurring fee.

Host URLs

NameDescription
Instore notification URLThe URL that PXP sends device logs to.
Store & forward URLThe URL that PXP sends transactions to for processing, if store and forward is enabled.
Transaction URLThe URL that PXP sends transactions to.
Reporting URLThe URL that PXP sends reports to.
Status Packet URLThe URL that PXP sends status updates to.

Logging settings

NameDescription
Verbose loggingWhether verbose logging is enabled for this device.
Maximum log size (MB)The maximum size that a log can reach, in megabytes. Once this size is reached, the old log will be discarded and a new log will be created.
Log file clean up daysThe number of days after which PXP will delete the log data.
Device log levelThe device log level. This can be one of:
  • None: no information is logged.
  • Information: all activity is logged.
  • Exception: only errors or exceptions that caused issues with a transaction are logged.
  • Health Coming soon

Feature settings

General

NameDescriptionDefault value
Return status packetsReceive status updates about the customer's payment journey. This will only work if you have a status packet webhook URL configured.
OFF
Language selection Coming soonAllow customers to choose a display language for the device.
OFF
Gratuity Coming soonAllow customers to add a gratuity.
OFF
P2PEEnable point-to-point encryption.
ON
Accessibility modeEnable accessibility mode.
ON
CurrencyThe default currency.GBP
On-device limitThe on-device limit.100.00
Contactless limitThe contactless payment limit.50.00
Floor limitThe floor limit.0.00
CVM limitThe CVM limit.50.00
Refund limitThe refund limit. Learn more.
OFF

Receipt settings

NameDescriptionDefault value
Print Merchant ReceiptPrint a merchant receipt, in addition to the customer receipt.
ON
Certification ModeProvides additional EMV details when running a certification on behalf of an acquirer. This should not be enabled when live.
OFF

DCC settings

NameDescriptionDefault value
EnabledEnable Dynamic Currency Conversion for this device. When enabled, eligible transactions will automatically present currency choice options to international customers. Learn more.
OFF
DCC on Pre-authsAllow DCC to be offered on estimated authorisations.
OFF
DCC on CaptureAllow DCC to be offered on captures.
OFF

Terminal capabilities

NameDescriptionDefault value
KeyedAllow card payments where card details are manually keyed in.
ON
MOTOAllow Mail Order/Telephone Order payments.
OFF
SwipedAccept card payments with swipe (magnetic strip).
ON
Contact Chip (ICC)Accept card payments with chip.
ON
On-Line PINAccept card payments with online Personal Identification Number (PIN).
ON
Plaintext PIN (Offline)Accept card payments with a plaintext offline Personal Identification Number (PIN).
ON
Paper SignatureAccept card payments with signature.
ON
Offline PIN (Encrypted)Accept card payments with an encrypted offline Personal Identification Number (PIN).
ON
No CVM RequiredAccept card payments without requiring any card verification.
ON
Static Data Authentication (SDA)Enable Static Data Authentication (SDA). This is a basic security mechanism used in EMV chip cards where the card contains a digital signature created by the issuing bank that remains constant (static) for the life of the card.
ON
Dynamic Data Authentication (DDA)Enable Dynamic Data Authentication (DDA). This is a security mechanism used in EMV chip card transactions where the payment terminal verifies the authenticity of the card by performing a real-time cryptographic challenge-response authentication. During this process, the chip card generates a unique digital signature using its private key for each transaction, and the terminal validates this signature using the card's public key certificate. This makes it extremely difficult for fraudsters to clone or counterfeit cards, since each transaction requires a new and unique cryptographic proof of authenticity.
ON
Card Capture CapabilityEnables you to physically retain (capture) a customer's card. For example, if you suspect fraudulent activities.
OFF
Combined DDA/AC Generation (CDA)Enable combined Dynamic Data Authentication (DDA) and Application Cryptogram (AC) generation. DDA verifies the authenticity of the chip card by validating its digital signature, while AC generation creates a unique cryptogram for each transaction to ensure its security and prevent replay attacks. This combined process enhances transaction security by verifying both the card's legitimacy and the transaction's integrity in one step.
ON

Store and Forward settings

NameDescriptionDefault value
Store and ForwardEnable Store and Forward for this device.
ON
Transaction amount thresholdThe threshold amount up to which to store a transaction for offline processing. Transactions with an amount above this threshold won't be stored.0
Days Until Ftp UploadThe number of days after which PXP will upload a file to FTP.7
Throttling limitThe maximum number of transaction we can send in one go.0
Process interval(s)The interval between processes, in seconds.0