NCR Voyix Logo

Docs

Aloha POS

About Aloha POS

Implementing

Advanced features

Field definitions

About this section

Activation Schedules

Additional Features (Corporate Administration)

Advanced Pizza Depletion - Pizza Sizes

Advanced Pizza Depletion - Topping Levels

Alert Settings

Auto Menus (TS only)

Barcode Messages

Break Reminder Messages

Break Rules

Campaign Rulebook (TS Only)

Cash Cards

Cash Drawers

Categories

Clock-In Message

Club Member (TS only)

Club Member Hold Reason (TS only)

Coins and Bills

Comp Codes

Comp Employees

Comps

Concept

Concepts

County

Custom EDC Response Messages

Custom FOH Reports

Day Part

Debug Event

Default Favorites

Deposit Reasons

Display Boards

Drink Dispensers

Employees

Event Schedule

Exception Modifiers (TS only)

Family Style - Family Style Groups (TS only)

Family Style - Plating Types (TS only)

Family Style - Portion Matrix (TS only)

Filter Text

Fiscal Calendar Settings

Fiscal Devices

Fixed Item Pricing (TS only)

Flex Tax Rule

Foreign Currencies

Gold Points (TS only)

Gratuities (TS only)

Guest Check Message

House Accounts

Installed Products (Global Administration)

Integrations

Interactive Messages

Item Cook Times

Item Cost

Item Routing

Items

Job Groups

Jobcodes

Labels

Labor Groups

Loyalty Providers

Main Screen Message

Media Files

Menus (TS only)

Minor Exemptions

Modifier Codes

Modifier Groups

Movie

No Sale Reasons

Occasion Categories

Occasions

Order Entry Queue

Order Mode

Par Templates

Pay Adjustments (formerly Other Wages)

Payment Device - Payment Devices

Payment Device - Payment Device Settings

Performance Measures

Petty Cash Account

Pos Access Levels

Price Changes

Price Level

Print Designer

Printer Groups

Printers

Promotions

Punch Edit Reasons

Report Settings

Revenue Center

Routing Level (QS only)

Scales

Screen Designer

Security Roles

Server Info Messages (TS only)

Size Groups (QS Only)

Skins

State

Store

Store Settings

Submenus (TS only)

Surcharge

Survey

Table Definition (TS only)

Tags

Tares

Tax Group

Tax Locale

Tax Type

Tender Groups

Tenders

Terminals

Terminated Employees

Termination Reasons

Tip-share Pools (TS only)

Tracking Item

Users

Video Controllers

Video Groups

Video Queues

Void Reasons

Volume Level

Waive Break Messages

Aloha POS

Loyalty Providers

Select Maintenance > Guest Experience > Loyalty Providers to access this function.

The Loyalty Providers function enables you to designate the loyalty provider for your site and to establish the communication between the Aloha Point-of-Sale (POS) and the loyalty provider. The communication between the provider and the POS is accomplished using Aloha Transaction Gateway, which is an interface management application that broadens the connectivity of the Aloha POS, and enables restaurants to connect to various external applications. Contact your NCR representative for help in configuring the POS to communicate with your loyalty provider through Aloha Transaction Gateway.

Loyalty Provider types

The Aloha POS system currently supports the following loyalty providers in this function: Aloha Loyalty, Bally CMP, EMN8 Loyalty, GiveX Mobile Couponing, Aloha Enterprise Loyalty, and Generic. You must select one of these loyalty providers from the list box when you click the New drop-down arrow to create a new loyalty provider record; however, some providers with which you can integrate may use Generic instead. If your provider is not in this list, you may be able to take advantage of the Generic loyalty provider type for your loyalty needs.

Provider tab

The Provider tab identifies the loyalty provider and allows you to select which stores in your network use the selected provider as their loyalty provider. When you select a provider from the Type list box, a tab specific to the provider of your choice appears.

Custom tab

Use the Custom tab to enter custom variables to support features that are not yet available in the Integrations.cfg file for a provider. This tab appears for every provider type but is not valid for Generic Loyalty.

Generic tab

This tab appears when you click New and select Generic from the Type list box.

Group Bar: Client

IP address — Designates the IP address to use when connecting to the third-party loyalty provider; typically this is the IP address of the BOH site controller. Contact the loyalty host for specific information.

Port — Designates the active port through which the third-party loyalty provider will be listening. Contact the loyalty host for specific information.

Open item to use for member entry — Designates the item created for adding a loyalty card number to the check. This option is not supported effective ATG 15.x and later because ATG handles this for you.

Open item button text — Designates the text to appear on the button used to add a loyalty card number to the check. This option is not supported effective ATG 15.x and later because ATG handles this for you.

POS type identifier for loyalty host — Designates the POS identifier the third-party loyalty provider uses to identify your system. Contact the loyalty host for specific information.

Number of milliseconds to wait for host connection — Designates how long, in milliseconds, the system waits for a connection, when attempting to contact the loyalty host. Valid entries include: -1=wait indefinitely, and whole numbers representing milliseconds.

Allow manual card entry — Designates whether an employee can manually type a loyalty card number into the system. When cleared, this option requires the employee to slide a magnetic stripe card or scan a bar code.

System employee to remove discounts — Designates the employee, usually a manager, that has security permission to remove discounts from a check.

Jobcode for system employee — Specifies the job code under which the employee designated in ‘System employee to remove discounts’ must log in to have security permission to remove discounts from the check.

Loyalty magcard track number — Designates the track on a magnetic card the system uses to specify the loyalty program.

Loyalty balance inquiry message — Specifies the message text to appear when showing the loyalty balance.

Loyalty reminder message for cashier — Specifies optional message text to appear to an employee as they access the Tender screen, when no loyalty card was entered for a guest check.

Lookup message type — Designates the method to use when looking up a loyalty member. Contact the loyalty provider for more information.

  • Member lookup —

  • Filter account —

Group Bar: Dialogs

The group bars available under the Dialog group bar allow you to customize the Loyalty screen provided by Generic Loyalty. This is the default screen that appears when you touch the Loyalty button without first designing a custom Loyalty screen using Screen Designer.

Group Bar: Dialogs id="main-screen"> Main screen

Dialog logo image — Allows you to select the image to appear on the main menu screen. Required Options: You must upload the bitmap image to the BMP folder before it appears in the selection box.

Border color — Designates the color in the color palette to use for the screen border.

Background gradient start — Designates the starting color in the color palette to use for the gradient background.

Background gradient end — Designates the ending color in the color palette to use for the gradient background. Note: Selecting the same color as ‘Background gradient start’ provides a solid, single-color screen background.

Assign button label — Designates the text to appear on screen on the Assign button.

Activate button label — Designates the text to appear on screen on the Activate button.

Renew button label — Designates the text to appear on screen on the Renew button.

Refund button label — Designates the text to appear on screen on the Refund button.

Balance button label — Designates the text to appear on screen on the Balance button.

Group Bar: Dialogs id="message"> Message

Dialog logo image — Allows you to select the image to appear on the message screen. Required Options: You must upload the bitmap image to the BMP folder before it appears in the selection box.

Border color — Designates the color in the color palette for the screen border.

Background gradient start — Designates the starting color in the color palette for the gradient background.

Background gradient end — Designates the ending color in the color palette for the gradient background. Note: Selecting the same color as ‘Background gradient start’ provides a solid, single-color screen background.

Group Bar: Dialogs id="input"> Input

Dialog logo image — Allows you to select the image to appear on the input screen. Required Options: You must upload the bitmap image to the BMP folder before it appears in the selection box.

Border color — Designates the color in the color palette to use for the screen border.

Background gradient start — Designates the starting color in the color palette for the gradient background.

Background gradient end — Designates the ending color in the color palette for the gradient background. Note: Selecting the same color as ‘Background gradient start’ provides a solid, single-color screen background.

Enable email search — Indicates your loyalty provider supports email search. Required Options: Aloha Generic Loyalty supports selecting any combination of the available search options ‘email,’ ‘phone,’ and ‘name.’ If your loyalty provider does not support one or more of these options, you must clear the unsupported options.

Enable phone search — Indicates your loyalty provider supports phone number search. Required Options: Aloha Generic Loyalty supports selecting any combination of the available search options ‘email,’ ‘phone,’ and ‘name.’ If your loyalty provider does not support one or more of these options, you must clear the unsupported options.

Enable name search — Indicates your loyalty provider supports member name search. Required Options: Aloha Generic Loyalty supports selecting any combination of the available search options ‘email,’ ‘phone,’ and ‘name.’ If your loyalty provider does not support one or more of these options, you must clear the unsupported options.

Group Bar: Dialogs id="keyboard"> Keyboard

Dialog logo image — Allows you to select an image to appear on the keyboard screen. Required Options: You must upload the bitmap image to the BMP folder before it appears in the selection box.

Border color — Designates the color in the color palette to use for the screen border.

Background gradient start — Designates the starting color in the color palette for the gradient background.

Background gradient end — Designates the ending color in the color palette for the gradient background. Note: Selecting the same color as ‘Background gradient start’ provides a solid, single-color screen background.

Group Bar: Dialogs id="loyalty-activation"> Loyalty activation

Use this group bar to customize the screen that appears when you activate a loyalty card.

Dialog logo image — Allows you to select the image to appear on the loyalty activation screen. Required Options: You must upload the bitmap image to the BMP folder before it appears in the selection box.

Border color — Designates the color in the color palette to use for the screen border.

Background gradient start — Designates the starting color in the color palette for the beginning of a gradient background.

Background gradient end — Designates the ending color in the color palette for the end of a gradient background. 📝 Selecting the same color as ‘Background gradient start’ provides a solid, single-color screen background.

Group Bar: Dialogs id="member-select"> Member select

Use this group bar to customize the screen that appears when perform a search for a loyalty member.

Border color — Designates the color in the color palette to use for the screen border.

Background gradient start — Designates the starting color in the color palette for the beginning of a gradient background.

Background gradient end — Designates the ending color in the color palette for the end of a gradient background. Note: Selecting the same color as ‘Background gradient start’ provides a solid, single-color screen background.

Barcode tab

This tab only appears for the Generic loyalty provider type.

Group Bar: Settings

Barcode image format — Allows you to select the type of bar code image supported by your loyalty provider. Valid options include QR code, Aztec, Code 128, Data matrix, and Maxicode.

Barcode image generated width — Specifies the bar code width, in pixels, that your printers can support.

Barcode image generated height — Specifies the bar code height, in pixels, that your printers can support.

Skip text embedded in barcode image — Allows you print bar codes that do not include any identifying text.

String to find in check text to insert message — Allows you to specify a code string above which the printer will print the bar code on a check. For example, the string 4 prints four blank lines. The system searches for those four blank lines and prints the bar code above that point.

Barcode — Allows you to specify the bar code image that prints on a check. For example, the string [image name] designates the bar code to use where image name is the file name of the bar code image you uploaded to the BMP folder.

Barcode text — Allows you to specify the bar code text that prints as part of the bar code if you did not select ‘Skip text embedded in bar code image.’ For example, the string %BARCODETEXT%[text string] allows you to specify the text to embed in the bar code.

Group Bar: Receipt message

Message line — ‘Displays the message as you build it using ‘Edit message line’

Edit message line — Allows you to build the message by selecting from a list of variables that appear in a Message Line Builder list box when you click ‘Edit message line.’

  • In this Article

  • Provider tab

  • Custom tab

  • Generic tab

  • Group Bar: Client

  • Group Bar: Dialogs

  • Main screen

  • Message

  • Input

  • Keyboard

  • Loyalty activation

  • Member select

  • Barcode tab

  • Group Bar: Settings

  • Group Bar: Receipt message

NCR Voyix Logo

© 2025 NCR Voyix Corporation

Contact Us
Voyix Privacy Policy
Do Not Sell My Information
Legal Notice

NCR Payment Solutions, LLC is a registered ISO/MSP of Citizens Bank, N.A., Providence, RI.