How To Configure NFC Loyalty - Single TAP Flow

The NFC Single TAP Loyalty flow allows customers to present their digital loyalty card (stored in Apple Wallet or Google Wallet) to a PED device via NFC. The PED reads the loyalty card details in a single tap, streamlining the checkout experience without requiring a separate card scan or barcode.

note

This guide covers external NFC loyalty configuration only. Customer card registration must be performed via Estate Manager - registering an alphanumeric card ID directly from the POS is not currently supported.

---

Overview

This guide walks through the end-to-end setup including:

1. Step 1: PED Key Load - Load the required NFC loyalty keys onto the PED.
2. Step 2: Digital Wallet Configuration - Configure digital wallets with loyalty and payment support.
3. Step 3: POS / ICC Reader Configuration - Update the ICC Reader Configuration with the required VAS files and enable contactless loyalty.
4. Step 4: PDC Configuration - Enable PDC support for loyalty capture, configure the menu button, and set the required privileges.

Prerequisites

Resources

Before starting, ensure the following are in place:

• Enactor Estate Manager
• Enactor POS with a compatible NFC-capable PED (e.g. Verifone P400)
• MxDownloader utility installed on a Windows machine
• VRK key packages (.tgz) for your PED - provided by Verifone
• ICC Reader Configuration record already created for the PED

Prior Training / Experience

You should be familiar with the following:

• Estate Manager configuration
• ICC Reader Configuration maintenance
• Data broadcasting

---

Step 1: PED Key Load

info

If this workflow has already been completed on your PED, skip to Step 2.

Before the PED can process NFC loyalty cards, the appropriate loyalty keys must be loaded onto the device using the MxDownloader utility.

1.1 Install MxDownloader

Download and install the MxDownloader utility on a Windows machine.

1.2 Access the PED Supervisor Menu

1. From the Engineering Menu, press 159 + Enter to access the Supervisor Menu.
2. Enter the Supervisor Menu password when prompted.

1.3 Initiate the Download on the PED

1. From the Supervisor Menu, navigate to Update > Netloader > eth0 / wlan0.
2. The PED will display: "Starting download on [IP Address]" - note this IP address, as you will need it in the next step.

1.4 Send the Key Package via MxDownloader

The .tgz VRK key packages required for this step are provided by Verifone. Ensure you download the correct file for the device you are configuring.

1. Download the relevant .tgz key package file for your PED to your Windows machine.
2. Open the MxDownloader utility.
3. Go to the Network tab and enter the PED's IP address (without a port number).
4. Leave the Download Type set to Partial (default).
5. Click Browse, select the downloaded .tgz file, and click Send.

1.5 Reboot and Verify

• If the transfer is successful, the PED will automatically restart.
• If it does not restart automatically, click Cancel to exit, then manually reboot the PED.
• After the restart, verify the key installation via: Security > Key Status menu on the PED.

This completes the PED Key Load.

---

Step 2: Digital Wallet Configuration (Loyalty + Payments)

The NFC Single TAP flow supports loyalty cards stored in Apple Wallet and Google Wallet. Customers scan a QR code to add their loyalty pass to their mobile wallet, after which they can tap their phone at the PED for loyalty capture.

Configure your digital wallet provider (Apple / Google) to issue loyalty passes that are compatible with the VAS (Value Added Services) protocol supported by the PED. Refer to your digital wallet provider's documentation for pass configuration details.

This completes the Digital Wallet Configuration.

---

Step 3: POS / ICC Reader Configuration

To enable NFC loyalty capture at the POS, the ICC Reader Configuration must be updated to include the required VAS configuration files. These files, provided by Verifone, instruct the PED to handle Apple Pay and Google Pay loyalty cards presented via NFC.

info

This is a one-time setup. If the VAS resource files have already been added to the ICC Reader Configuration, skip to Step 4.

3.1 Add Required Resource Files

Navigate to ICC Reader Configurations using Search or the menu path:

Configuration > Organisation > ICC Reader Configurations

Edit the appropriate ICC Reader Configuration record and navigate to the Resources tab.

The Resources tab lists all files deployed to the PED. An existing .wky key file entry is shown as an example.

Add each of the following files. For each file, set the Deployment Path to the exact filename as shown:

File	Deployment Path
wallet_vas_config.json	wallet_vas_config.json
terminal_vas_config.json	terminal_vas_config.json
<XXXX>.wky	flash/<XXXX>.wky

note

The filenames must be entered exactly as shown above (case-sensitive). Incorrect filenames will prevent VAS card support from activating.

The resulting configuration should resemble the screenshot below:

The Resources tab after adding the VAS configuration files. The terminal_vas_config.json and wallet_vas_config.json entries are highlighted.

To enable VAS functionality, also set VasSupported = 1 in the CICAPP.CFG file parameters in the ICC Reader Configuration.

3.2 Enable Contactless Loyalty

Navigate to the Contactless tab of the ICC Reader Configuration record.

On the Contactless tab, ensure Enable Contactless is checked and set Enable Contactless Loyalty Cards to enabled.

Ensure the following are set:

Field	Value
Enable Contactless	Checked
Enable Contactless Loyalty Cards	Checked

note

When Enable Contactless Loyalty Cards is enabled, the POS instructs the PED to perform Smartcard capture at the loyalty card prompt. By default, this triggers MiFare card capture mode. However, when the wallet_vas_config.json and terminal_vas_config.json files are present in the configuration, the PED switches to VAS mode instead, enabling the capture of Apple Pay and Google Pay loyalty cards via NFC.

Save the ICC Reader Configuration record.

Customer Card Registration Requirement:

Before a loyalty card can be captured at the POS, it must first be registered in the system. Use Estate Manager > Customer Card Maintenance to register the card against the customer record.

This completes the POS / ICC Reader Configuration.

---

Step 4: PDC Configuration

To enable loyalty card capture via the Payment Device Controller (PDC), the following configuration steps are required.

4.1 ICC Reader Configuration for PDC

The ICC Reader Configuration for the PDC must match the POS configuration described in Step 3 above.

Use Payment Device Host Status Maintenance to deploy the updated ICC Reader Configuration to the PDC.

4.2 Enable Loyalty Capture Process at the POS

A new entry must be created in Process Detail Maintenance. Navigate to Process Detail Maintenance using Search.

Create a new Process Detail entry with the values shown. The Process ID must be entered exactly as shown.

Set the following values on the General tab:

Field	Value
Process Type	Process
Process ID	Pos/Loyalty/SelectPdcLoyaltyCardCapture
Description	Select Pdc Loyalty Card Capture

Navigate to the Extension tab and set the following:

On the Extension tab, set the Extension Point to SelectLoyaltyCardCaptureMethod.

Field	Value
Extension Point	SelectLoyaltyCardCaptureMethod

note

There is no process file to upload for this entry - the configuration alone is sufficient to register the extension point.

This completes the Process Detail Maintenance configuration.

4.3 Configure a New Button - PAYMENT SERVICE/LOYALTY

Configure a new menu button at the POS for the loyalty payment mode.

Navigate to Menus using Search or the menu path:

Configuration > System > Menus

1. Select the relevant Tender Menu from the list.
2. Copy an existing Payment Service button and rename the button text to PAYMENT SERVICE/LOYALTY.
3. Navigate to the Data tab and add the following key-value entries:

Set the two data entries on the button as shown above.

Name	Java Type	Value
enactor.mfc.TenderId	String	PAYMENT_SERVICE
enactor.pos.PaymentMode	String	PAYMENT_LOYALTY

Save the menu button.

This completes the Menu Configuration.

4.4 Set Privileges

Navigate to User Roles using Search or the menu path:

Configuration > HR > User Roles

1. Select the relevant POS User Role.
2. Navigate to the Authorised Functions tab.
3. Set Application Package to Enactor POS.
4. Set Process filter to # Payment Service Payment Tender.
5. Enable the following privileges:

Enable the two loyalty-mode privileges highlighted in the list.

Privilege ID
enactor.pos.PaymentServiceTenderPaymentLoyaltyModeAllowed
enactor.pos.AuthorisesPaymentServiceTenderPaymentLoyaltyMode

This completes the Privilege Configuration.

4.5 Broadcast and Restart

1. Save the Process Detail Maintenance configuration.
2. Broadcast the updated configuration to the POS.
3. After the POS restarts, it will use the new process as an extension point and enable the PED via the PDC for loyalty card capture when available.

This completes the PDC Configuration.

---

Broadcasting

After completing the configuration steps above, broadcast the following entities to ensure all changes are deployed to the POS:

info

Broadcast the following entities after completing NFC Loyalty Setup:

• ICC Reader Configuration - includes VAS resource files and contactless settings
• Process Detail - registers the loyalty capture extension point
• Menu - deploys the new PAYMENT SERVICE/LOYALTY button
• User Role - applies the updated privilege settings

Broadcasts are covered in detail in the Broadcasting How-To Guide.

---