> For the complete documentation index, see [llms.txt](https://docs.verifone.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verifone.com/petroleum-docs/petro-and-c-store/commander-central/commander-central-user-guide/site-configuration/payment-operations/loyalty.md).

# Loyalty

Loyalty Sales allow the processing and redemption of loyalty transactions, both inside at the Point of Sale (POS) and outside at the Dispenser Card Readers (DCR). Each locations loyalty configuration can be viewed and modified for individual sites. The individual site configuration for loyalty is found under Commander Central > Site Management > Site Name > Payment Operations > Loyalty.

Loyalty Sales allow the processing and redemption of loyalty transactions, both inside at the Point of Sale (POS) and outside at the Dispenser Card Readers (DCR). Each location’s loyalty configuration can be viewed and modified for individual sites. The individual site configuration for loyalty is found under C-Site Management > Site Management > Site Name > Payment Operations > Loyalty.

Loyalty programs assigned to the site appear as tabs at the top of the page (for example, 1: NACS Loyalty). Select a program tab, then use the Parameters and Cards tabs to configure it. Complete the parameters shown for the Loyalty Host being configured. Fields marked with a red asterisk (\*) are required. See the tables below for details on each field.

Use the drop-down at the top right of the page to switch between Programs, Alternate MNSP Settings and General Settings.

## Programs

Loyalty programs assigned to the site are found by selecting Programs in the drop-down menu at the top right. If the loyalty program is managed through Enterprise configuration, it has a label next to the program name indicating ‘Enterprise’. The remaining steps on the existing page are unchanged, except that the drop-down is now at the top right of the page rather than the top left.

<figure><img src="https://2845923820-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ff8N3RLcEwSqYn1EvDXrj%2Fuploads%2FCxLLkM73kgF8MspApuZ4%2Fimage.png?alt=media&amp;token=81316a82-ab69-4411-b79c-68f56aeb9239" alt=""><figcaption></figcaption></figure>

## **Loyalty Parameters**

<figure><img src="https://2845923820-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ff8N3RLcEwSqYn1EvDXrj%2Fuploads%2FeRIX43hJSFGSRK0z9RHW%2Fimage.png?alt=media&amp;token=fceb07a1-4802-4a2d-910a-ee1ab1337ef3" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="278" valign="top">Field/Button</th><th valign="top">Description</th></tr></thead><tbody><tr><td valign="top">FEP Enabled</td><td valign="top">Enables the loyalty program.</td></tr><tr><td valign="top">Provider</td><td valign="top">Displays the loyalty provider that hosts the program (for example, PCATS01). The field is read-only.</td></tr><tr><td valign="top">Merchant ID*</td><td valign="top">Sets the Merchant ID provided by the network.</td></tr><tr><td valign="top">Program Name*</td><td valign="top">Sets the Program ID for the loyalty program.</td></tr><tr><td valign="top">IP/Host*</td><td valign="top">Sets the IP address of the loyalty host. (Provided by loyalty host)</td></tr><tr><td valign="top">Port*</td><td valign="top">Communication Port Number for the primary loyalty host. (Provided by loyalty host)</td></tr><tr><td valign="top">Heartbeat (Seconds)*</td><td valign="top">Sets the interval in seconds between network status checks from the Electronic Payment Server to the Loyalty Host. Minimum amount allowed is 120 seconds.</td></tr><tr><td valign="top">Enable TLS</td><td valign="top">Enables the use of a secure Transport Layer Security (TLS) connection to the loyalty host. When TLS is used, data is encrypted over the communication line.</td></tr><tr><td valign="top">Enable Barcode Scan</td><td valign="top">Enables a Barcode Scanning for the related FEP. The flag default is disabled.</td></tr><tr><td valign="top">Enable Card Swipe </td><td valign="top">Controls whether Swipe Card is offered to the customer as a loyalty entry option in the loyalty prompts, both inside and outside. The flag default is enabled.<br>When cleared, Swipe Card is not shown as a selectable option for this program. Use this for programs that do not issue a physical card. A customer who swipes a loyalty card anyway is still processed normally, because this setting affects only what is displayed. The Swipe Card option on the outdoor idle screen is not affected.<br>If only one entry method (Swipe Card, Barcode, or Alt ID) is available for the program, the customer goes directly to that method without a selection prompt.</td></tr><tr><td valign="top">Enable Card Download</td><td valign="top">Enables the Loyalty Card Table Download that allows the Loyalty Host to send down card table entries. The flag default is disabled.</td></tr><tr><td valign="top">Prompt for inside transactions</td><td valign="top">Enables the loyalty program to prompt at the POS. Select for multiple PCATS loyalty programs to prompt inside. (Previously “Display FEP Inside for Multiple Loyalty”.)</td></tr><tr><td valign="top">Prompt for outside transactions</td><td valign="top">Prompt for outside transactions Enables the loyalty program to prompt at the DCR. From Commander Release 55.02, this setting is required for PCATS loyalty to prompt outside, regardless of the number of loyalty programs at the site. (Previously “Display FEP Outside for Multiple Loyalty”.)</td></tr><tr><td valign="top">Enable PAR Loyalty Support</td><td valign="top">Allows the Payment Account Reference (PAR) from the customer’s payment card to be used as a loyalty entry method. When enabled, the PAR is sent to the loyalty host as the loyalty token.<br>PAR is used only when hybrid loyalty is in use. PAR is read from the card (EMV tag 9F24), and it is not available for every card or payment device.</td></tr><tr><td valign="top">Receipt Offline Message</td><td valign="top">When loyalty is offline, the message entered here will print on the receipt.</td></tr><tr><td valign="top">Alt ID Prompt </td><td valign="top">Selects the prompt text shown when the customer is asked to enter a loyalty ID manually (Alt ID entry). Select a value from the drop-down; custom text cannot be entered.<br>If no value is selected, the program uses the site-wide Alt ID Prompt set under General Settings. If no site-wide prompt is set, the prompt is “Enter Loyalty ID”. The same prompt is used inside and outside, and the Alt ID soft key label follows the selection. The selection is also sent to the loyalty host.<br>Available prompts: Enter ID Number, Enter Phone Number, Enter Club, Enter Member, Enter Loyalty ID, Enter Loyalty Number, Enter Rewards Number, Enter Rewards ID. </td></tr><tr><td valign="top">Remove Program</td><td valign="top">Removes the loyalty program.</td></tr></tbody></table>

## Loyalty Cards

Select the Cards tab for a program to manage the card (BIN) ranges that identify that program’s loyalty cards. Cards are listed in a table. Select Add Card to add a card, or use the Edit and Delete icons on a row to change or remove it. Use the page controls below the table to move between pages.

<figure><img src="https://2845923820-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ff8N3RLcEwSqYn1EvDXrj%2Fuploads%2FPt7G4Rrcr5sumYE3WejR%2Fimage.png?alt=media&amp;token=458492ff-7e3d-4d8e-8448-a40ba3f46753" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="127" valign="top">Field/Button</th><th valign="top">Description</th></tr></thead><tbody><tr><td valign="top">Card Name</td><td valign="top">Name given to identify this entry.</td></tr><tr><td valign="top">Abbreviation</td><td valign="top">Sets a two digit abbreviation for the card.</td></tr><tr><td valign="top">Lower ISO</td><td valign="top">Sets the lower value of the card (BIN) range. The entered card number must be greater than or equal to this number to match the table entry.</td></tr><tr><td valign="top">Upper ISO</td><td valign="top">Sets the upper value of the card (BIN) range. The entered card number must be less than or equal to this number to match the table entry.</td></tr><tr><td valign="top">PAN Length</td><td valign="top">Sets the number of digits to be used with the card.</td></tr><tr><td valign="top">Hybrid</td><td valign="top">Sets the card as a hybrid card.</td></tr><tr><td valign="top">Manual Entry</td><td valign="top">Indicates that a loyalty ID matching this entry can be keyed in manually rather than swiped or scanned (for example, a phone number entered through Alt ID).</td></tr><tr><td valign="top">Add Card</td><td valign="top">Adds a new card entry to the program</td></tr><tr><td valign="top">Edit</td><td valign="top">Edit Edits the card entry.</td></tr><tr><td valign="top">Delete</td><td valign="top">Delete Deletes the card entry.</td></tr></tbody></table>

## Loyalty General Settings

{% stepper %}
{% step %}
**Site Management**

To view or edit individual site loyalty configurations navigate to Commander Central > Configuration > Site Management.
{% endstep %}

{% step %}
**Search**

Use the search by Site name or Hierarchy drop-down menu to locate the site you wish to modify the loyalty configurations for. After the site name is located, click on the name to open the site configuration.

<figure><img src="https://2845923820-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ff8N3RLcEwSqYn1EvDXrj%2Fuploads%2FhYvfwtED4DCQorDcPuiq%2Fimage.png?alt=media&amp;token=ee079662-562c-47bd-8fc9-694d7a85a4b3" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Loyalty**

Select Payment Operations > Loyalty from the left column to view the site’s loyalty parameters.
{% endstep %}

{% step %}
**General Settings**

To view the site’s general loyalty settings, use the drop-down menu on the top left column to switch from the loyalty programs to General Settings.

<figure><img src="https://2845923820-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ff8N3RLcEwSqYn1EvDXrj%2Fuploads%2F1EDHN8suJL1xc2nxKOfJ%2Fimage.png?alt=media&amp;token=ada584c3-aca6-422d-9370-9f3705c7eed4" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="296" valign="top">Field/Button</th><th valign="top">Description</th></tr></thead><tbody><tr><td valign="top">Enable Alternate ID</td><td valign="top">Enables the payment device to prompt for an alternative ID for loyalty.</td></tr><tr><td valign="top">Prompt for Loyalty after payment</td><td valign="top">Prompts the customer for loyalty after they have paid for the transaction.</td></tr><tr><td valign="top">Display Host Messages</td><td valign="top">Loyalty messages will appear on the POS from the loyalty host.</td></tr><tr><td valign="top">Journal Loyalty ID to POS</td><td valign="top">Captures the customer’s loyalty ID in the site’s POS journal logs.</td></tr><tr><td valign="top">Send Reward prompt to Cashier</td><td valign="top">Enables the cashier to answer the PIN pad prompt from the POS in the event the customer hands the cashier cash and leaves the store without using the PIN pad display.</td></tr><tr><td valign="top">Reward Prompt Timeout (in seconds)</td><td valign="top">Sets a time out value for the loyalty reward prompt in seconds.</td></tr><tr><td valign="top">Use Long Test for Indoor Prompts</td><td valign="top">Shows longer prompts inside for loyalty rather than abbreviating them.</td></tr><tr><td valign="top">Prompt for reward on fuel only</td><td valign="top">Enabling this setting will only prompt the customer for loyalty if they are purchasing fuel.</td></tr></tbody></table>
{% endstep %}

{% step %}
**Programs**

Loyalty Programs (PCATs Loyalty in Verifone Commander’s Configuration Client) assigned to the site will be found under the Programs drop-down menu. If the loyalty program is managed through Enterprise configuration, then it will have a label next to the program name indicating ‘Enterprise’.

<figure><img src="https://2845923820-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ff8N3RLcEwSqYn1EvDXrj%2Fuploads%2FPxQLuclR4Pix4U9hPCoq%2Fimage.png?alt=media&amp;token=7c7be3c9-b780-42fa-b1ea-16dfb6001421" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

To view the site’s general loyalty settings, use the drop-down menu at the top right of the page to switch from Programs to General Settings.

<figure><img src="https://2845923820-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ff8N3RLcEwSqYn1EvDXrj%2Fuploads%2F8N1DNnEpsRJ0KlGP3L8O%2Fimage.png?alt=media&amp;token=38cf2bbf-0f51-42e2-a6bb-fbad33088031" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="330" valign="top">Field/Button</th><th valign="top">Description</th></tr></thead><tbody><tr><td valign="top">Enable Alternate ID</td><td valign="top">Enables the payment device to prompt for an alternative ID for loyalty.</td></tr><tr><td valign="top">Alt ID Prompt</td><td valign="top">Selects the site-wide prompt text shown when the customer is asked to enter a loyalty ID manually. Select a value from the <br>drop-down; custom text cannot be entered. A program can use a different prompt by selecting one in its own Alt ID Prompt setting, which takes precedence. If none is set, the prompt is “Enter Loyalty ID”. The same prompt is used inside and outside.</td></tr><tr><td valign="top">Prompt Loyalty for indoor transactions</td><td valign="top">Prompts the customer for loyalty at the POS. Replaces “Prompt for Loyalty after payment” for indoor transactions. Send reward prompt to Cashier and Prompt for reward only on fuel are available only when this setting is selected.</td></tr><tr><td valign="top">Send reward prompt to Cashier</td><td valign="top">Enables the cashier to answer the PIN pad prompt from the POS in the event the customer hands the cashier cash and leaves the store without using the PIN pad display. Applies to indoor transactions only; it is not used at the dispenser.</td></tr><tr><td valign="top">Prompt for reward only on fuel</td><td valign="top">Prompts the customer for loyalty only if they are purchasing fuel. Applies to indoor transactions only.</td></tr><tr><td valign="top">Prompt Loyalty for outdoor transactions</td><td valign="top">Prompts the customer for loyalty at the Dispenser Card Reader (DCR). Applies to DCR transactions only.</td></tr><tr><td valign="top">Reward Prompt Timeout (in seconds) *</td><td valign="top">Sets a time out value for the loyalty reward prompt in seconds. Applies inside and outside.</td></tr><tr><td valign="top">Journal Loyalty ID to POS</td><td valign="top">Captures the customer’s loyalty ID in the site’s POS journal logs.</td></tr><tr><td valign="top">Use Long Text For Indoor Prompts</td><td valign="top">Shows longer prompts inside for loyalty rather than abbreviating them.</td></tr><tr><td valign="top">Use Long Text For Outdoor Prompts</td><td valign="top">Shows longer prompts at the dispenser for loyalty rather than abbreviating them.</td></tr><tr><td valign="top">Display Host Messages</td><td valign="top">Loyalty messages will appear on the POS from the loyalty host.</td></tr><tr><td valign="top">Unmask Loyalty ID in T-Log</td><td valign="top">Records the full loyalty ID in the transaction log (T-Log). By default, the loyalty ID is masked.</td></tr></tbody></table>

### Alternate MNSP Settings

To view enterprise loyalty configurations assigned to the site, use the drop-down menu at the top right of the page and select Alternate MNSP Settings. If none apply, the page displays “No Major Oil enterprise loyalty configurations currently available for this site!”&#x20;

<figure><img src="https://2845923820-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ff8N3RLcEwSqYn1EvDXrj%2Fuploads%2FldXJSvJVihJSNvpFRC0K%2Fimage.png?alt=media&amp;token=89cff718-9911-4d9e-8c63-550beae18593" alt=""><figcaption></figcaption></figure>


---

# 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://docs.verifone.com/petroleum-docs/petro-and-c-store/commander-central/commander-central-user-guide/site-configuration/payment-operations/loyalty.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.
