> 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/smart-suggestion/using-smart-suggestion/transaction-flow.md).

# Transaction Flow

{% hint style="info" %}
From Base057.02.00, suggestions can also appear while the sale is being rung up. See [Suggestions While the Sale Is Rung Up](https://commanderhelp.verifone.com/feature-references/features-and-products-references/smart-suggestion/using-smart-suggestion/suggestions-while-the-sale-is-rung-up.md).
{% endhint %}

<table><thead><tr><th width="200">Step / Actor</th><th>Action</th></tr></thead><tbody><tr><td>1 -- Cashier / Customer</td><td>Items are added to the transaction basket (scanned, tapped on the item panel, or selected from a menu).</td></tr><tr><td>2 -- Cashier / Customer</td><td>The Total button is pressed to initiate payment.</td></tr><tr><td>3 -- Commander</td><td>The VIP/NAXML engine evaluates the basket against active Smart Suggestion rules. If a match is found, the suggestion payload is returned to the POS.</td></tr><tr><td>4 -- POS</td><td>The Suggestion Panel overlay is displayed over the payment screen: a title image, a configurable prompt message, up to four suggested product tiles (image, name, price), a disclaimer line, and the 'Add To Cart' / 'No, Thanks' buttons plus a close (X) icon.</td></tr><tr><td>5a -- Accept path</td><td>The cashier or customer taps one or more product tiles, optionally adjusts quantity with the inline Quantity Bar (+ / −), and taps 'Add To Cart'. The selected items are added to the basket.</td></tr><tr><td>5b -- Decline path</td><td>The cashier or customer taps 'No, Thanks' (or the X close icon). The panel is dismissed without modifying the basket, and the transaction proceeds to payment immediately -- no second Total press is required.</td></tr><tr><td>6 -- POS</td><td>Payment flow continues normally (cash tender, card insert/tap/swipe, etc.).</td></tr></tbody></table>

<figure><img src="https://1800087076-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5nJgnNKJ9ZrZeEdr7pqh%2Fuploads%2FckHLm6jXeQ7EADfDLtf6%2Fimage.png?alt=media&amp;token=aa4b23e8-89cd-4618-abc8-5270b631724d" alt=""><figcaption></figcaption></figure>

<p align="center"><strong>Message Only Smart Suggestion Prompt</strong></p>

<figure><img src="https://1800087076-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5nJgnNKJ9ZrZeEdr7pqh%2Fuploads%2FeB2acHAx0zMr7Gj2GbON%2Fimage.png?alt=media&amp;token=d2981c77-bbf1-4f1a-ab4a-d67f7b7d4376" alt=""><figcaption></figcaption></figure>

<p align="center"><strong>Menu Smart Suggestion Prompt</strong> — Selecting any item opens that menu.</p>

<figure><img src="https://1800087076-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5nJgnNKJ9ZrZeEdr7pqh%2Fuploads%2F67UCJcUuPsJDzk7GZQu8%2Fimage.png?alt=media&amp;token=5d7ee3e9-5ed7-4020-b36c-18530bfea51f" alt=""><figcaption></figcaption></figure>

<p align="center"><strong>PLU Smart Suggestion Prompt</strong> - Selecting a product tile reveals the inline Quantity Bar with '−' and '+' quantity controls</p>

<figure><img src="https://1800087076-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5nJgnNKJ9ZrZeEdr7pqh%2Fuploads%2FvOHAiB3QQwylDW9d3Bye%2Fimage.png?alt=media&amp;token=e4a7d005-bea3-42f1-80fc-28a02ed93d29" alt=""><figcaption></figcaption></figure>

<p align="center">Combo Smart Suggestion Prompt</p>


---

# 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/smart-suggestion/using-smart-suggestion/transaction-flow.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.
