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
| Name |
Description |
| Status |
The current status of the POS device. |
| POS ID |
The unique identifier for the point-of-sale device. This is set at device creation and can't be changed later. |
| Device model |
The device model. |
| Serial number |
The serial number of the device. |
| Communication protocol |
The communication protocol used to transfer data to and from the device. This can be TCP or HTTP. |
| Communication endpoint |
The URL that TWPayz should communicate with. |
| Device model |
The device model. |
| Commercial model |
The commercial model. This can be One-time fee, Recurring fee, or One-time & Recurring fee. |
Host URLs
| Name |
Description |
| Instore notification URL |
The URL that TWPayz sends device logs to. |
| Store & forward URL |
The URL that TWPayz sends transactions to for processing, if store and forward is enabled. |
| Transaction URL |
The URL that TWPayz sends transactions to. |
| Reporting URL |
The URL that TWPayz sends reports to. |
| Status Packet URL |
The URL that TWPayz sends status updates to. |
Logging settings
| Name |
Description |
| Verbose logging |
Whether verbose logging is enabled for this device. |
| Log file clean up days |
The number of days after which TWPayz will delete the log data. |
| Device log level |
The 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
General
| Name |
Description |
Default value |
| Return status packets |
Receive status updates about the customer's payment journey. This will only work if you have a status packet webhook URL configured. |
OFF |
| Language selection |
Allow customers to choose a display language for the device. |
OFF |
| Gratuity |
Allow customers to add a gratuity. |
OFF |
| Service charge |
Enable service charges. |
OFF |
| Split billing |
Allow customers to split a bill between multiple payers. |
OFF |
| P2PE |
Enable point-to-point encryption. |
ON |
| Accessibility mode |
Enable accessibility mode. |
ON |
| Currency |
The default currency. |
GBP |
| On-device limit |
The on-device limit. |
100.00 |
| Contactless limit |
The contactless payment limit. |
50.00 |
| Floor limit |
The floor limit. |
0.00 |
| CVM limit |
The CVM limit. |
50.00 |
| Refund limit |
The refund limit. |
OFF |
Receipt settings
| Name |
Description |
Default value |
| Print Merchant Receipt |
Print a merchant receipt, in addition to the customer receipt. |
ON |
| Certification Mode |
Provides additional EMV details when running a certification on behalf of an acquirer. This should not be enabled when live. |
OFF |
DCC settings
| Name |
Description |
Default value |
| Enabled |
Enable Dynamic Currency Conversion for this device. When enabled, eligible transactions will automatically present currency choice options to international customers. |
OFF |
| DCC on Pre-auths |
Allow DCC to be offered on estimated authorisations. |
OFF |
| DCC on Capture |
Allow DCC to be offered on captures. |
OFF |
DCC settings
| Name |
Description |
Default value |
| Keyed |
Allow card payments where card details are manually keyed in. |
ON |
| MOTO |
Allow Mail Order/Telephone Order payments. |
ON |
| Swiped |
Accept card payments with swipe (magnetic strip). |
ON |
| Contact Chip (ICC) |
Accept card payments with chip. |
ON |
| On-Line PIN |
Accept 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 Signature |
Accept card payments with signature. |
ON |
| Offline PIN (Encrypted) |
Accept card payments with an encrypted offline Personal Identification Number (PIN). |
ON |
| No CVM Required |
Accept 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 Capability |
Enables 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
| Name |
Description |
Default value |
| Store and Forward |
Enable Store and Forward for this device. |
ON |
| Transaction amount threshold |
The 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 Upload |
The number of days after which TWPayz will upload a file to FTP. |
7 |
| Throttling limit |
The maximum number of transaction we can send in one go. |
0 |
| Process interval(s) |
The interval between processes, in seconds. |
0 |