Skip to content

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

NameDescription
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 modeThe device mode. This can be Standalone POS, Integrated POS, or Soft POS.
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.
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

Feature settings

NameDescriptionDefault value
Return status packets Coming soonReturn status packets Coming soonN/A.
Language selection Coming soonAllow customers to choose a display language for the device.N/A.
Gratuity Coming soonAllow customers to add a gratuity.N/A.
P2PEEnable point-to-point encryption.
ON
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
KeyedAllow card payments where card details are manually keyed in.
ON
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

NameDescription
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.
Days Until Ftp UploadThe number of days after which PXP will upload a file to FTP.
Throttling limitThe maximum number of transaction we can send in one go.
Process interval(s)The interval between processes, in seconds.