> For the complete documentation index, see [llms.txt](https://commanderhelp.verifone.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://commanderhelp.verifone.com/feature-references/features-and-products-references/cash-rounding/configuring-cash-rounding/system-properties.md).

# System Properties

Go to **Configuration Client > Initial Setup > System Properties**

![](https://content.gitbook.com/content/5nJgnNKJ9ZrZeEdr7pqh/blobs/AixALAbRk2lwzFAitQjO/Unknown%20image)

Use the following system properties to enable cash rounding, set the value to round to, such as 0.05, and how to round transactions, such as NEAREST.

| **Property**             | **Values**            | **Default** | **Description**                         |
| ------------------------ | --------------------- | ----------- | --------------------------------------- |
| cash.rounding.adjustment | 0.05, 0.10, 0.25 1.00 | 0.05        | Rounding adjustment amount              |
| cash.rounding.enabled    | true, false           | false       | Master switch for cash rounding feature |
| cash.rounding.strategy   | NEAREST, DOWN UP,     | NEAREST     | Rounding strategy to apply              |

If no values or incorrect values are entered, the system will use the default values (false, NEAREST, and 0.05).

## **Round to Nearest (NEAREST strategy)**

This strategy rounds the cash transaction up or down to the nearest rounding value defined in system properties (for example 0.05 or 5 cents).

Calculate the remainder when dividing the amount by 5 cents

If remainder is 0: Amount is already on nickel boundary, return unchanged If the remainder is 1 or 2 cents: Round down to the lower nickel boundary If the remainder is 3 or 4 cents: Round up to the higher nickel boundary

**Examples**

$10.01 -> $10.00 (remainder 1, round down by 1 cent)

$10.02 -> $10.00 (remainder 2, round down by 2 cents)

$10.03 -> $10.05 (remainder 3, round up by 2 cents)

$10.04 -> $10.05 (remainder 4, round up by 1 cent)

$10.05 -> $10.05 (remainder 0, return unchanged)

$10.06 -> $10.05 (remainder 1, round down by 1 cent)

$10.07 -> $10.05 (remainder 2, round down by 2 cents)

$10.08 -> $10.10 (remainder 3, round up by 2 cents)

$10.09 -> $10.10 (remainder 4, round up by 1 cent)

## **Round Down (DOWN strategy)**

This Strategy will round all cash transactions down to the rounded value defined in system properties (for example 0.05 or 5 cents).

Calculate the remainder when dividing the amount by 5 cents

If remainder is 0: Amount is already on nickel boundary, return unchanged

If the remainder is non-zero: Subtract the remainder to reach the lower nickel boundary

**Examples**

$10.01 -> $10.00 (subtract 1 cent)

$10.02 -> $10.00 (subtract 2 cents)

$10.03 -> $10.00 (subtract 3 cents)

$10.04 -> $10.00 (subtract 4 cents)

## **Round Up (UP strategy)**

This Strategy will round all cash transactions up to the rounded value defined in system properties (for example 0.05 or 5 cents).

Calculate the remainder when dividing the amount by 5 cents

If remainder is 0: Amount is already on nickel boundary, return unchanged

If remainder is non-zero: Add the difference needed to reach the next nickel boundary Adjustment amount: (5 - remainder) cents

**Examples**

$10.01 -> $10.05 (add 4 cents)

$10.02 -> $10.05 (add 3 cents)

$10.03 -> $10.05 (add 2 cents)

$10.04 -> $10.05 (add 1 cent)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://commanderhelp.verifone.com/feature-references/features-and-products-references/cash-rounding/configuring-cash-rounding/system-properties.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
