RP Prism User Guide - Appendix A. EFT
EFT with Nayax

Prism Nayax EFT Customization PDF

(Prism 2.5 and later)
This topic explains how to install and configure the Prism Nayax EFT customization (PrismNayaxEFT.exe) in the Prism legacy web client. The Prism Nayax EFT customization enables merchants to use a Nayax device for the following POS activities:
Credit Card

• Sales
• Referenced Returns
• Voids

Debit

• Sales

For information about configuring and using Nayax with the Prism new client (Windows and Android apps), click here.

Requirements/Limitations

• The Nayax Configuration (Admin Console > Node Preferences > Node Selection) must be done at the single workstation level.
• Nayax does not support gift cards at this time. Therefore, be sure to disable Gift Card tenders because gift cards will bypass the EFT validation process.
• Referenced returns (that reference the original credit card tender on the return) are not available when using Centrals; however, unreferenced returns are not allowed by Nayax. If Centrals is enabled and you do a return, an error will result.
• Manual Keyed Entry (MKE) is not available when Nayax is configured as the EFT provider.
• Prism version: 2.5; Agamento app version 01.06.64.

Basic Steps for Installing and Configuring the Prism Nayax EFT Customization
1. Add a new customization for PrismNayaxEFT.exe (Admin Console > Customizations).
2. Drill down to the single workstation level and select Nayax as the EFT Provider (Admin Console > Node Preference > Transactions > Tenders > EFT Server Configuration).
3. Add the PrismNayaxEFT.exe customization to the workstation's HAL Settings (Admin Console > Node Preferences > Node Selection > [SBS] > [STORE] > [WS] > HAL Settings).
4. Enter Nayax Configuration settings in Prism preferences (Admin Console > Prism Menu > Nayax Configuration).
5. Reload the hardware configuration (Right-click Prism Proxy icon in task bar and select Reload Hardware).
6. After reloading hardware, re-enter Nayax Configuration and test the device. Note: If there is a misconfiguration, a long delay will occur during steps 5 or 6.

Supported Hardware
Castles - Saturn 1000

Add Customization for PrismNayaxEFT.exe
Add the PrismNayaxEFT.exe customization via the Admin Console UI. Repeat this configuration for each proxy that will use the customization. 

1.    Navigate to the Admin Console > Customizations.     
2.    Click Add New Customization.     
3.    Enter configuration information. Refer to the New Customization Fields table for details.
4.    Save the changes.    

Customization Configuration UI (PrismNayaxEFT customization)
 
 
New Customization Fields

Set Nayax as EFT Provider
This configuration must be done at the single workstation level. Repeat this configuration for each workstation connected to a Nayax device.
1. Navigate to Admin Console > Node Preferences > Node Selection. 
2. Drill down to the list of workstations.
Sample list of workstations:
 
3. Double-click a single workstation. 
4. Double-clicking a workstation will display a record like the one below. Notice that no edit button is available. 
Example of drilling down to the single workstation level:
 
5. Next, navigate to Node Preferences > Transactions > Tenders > EFT Server Configuration. Select Nayax as the EFT Provider.
6. Save the changes.
Node Preferences > Transactions > Tenders > EFT Server Configuration:

Log Out Required
Log out and log back in. When you log back in, the Nayax Configuration button will be available on the Prism Menu in the Admin Console area.

Add PrismNayaxEFT.exe Customization in HAL Settings 
Requirement: The Nayax customization MUST be listed first in HAL Settings. If the workstation is using other customizations (e.g., Fiscalization plugin), you must first remove the other plugin(s). After you add the Nayax customization and make sure it is listed first and working correctly, add back the other plugin(s).

1. Navigate to Admin Console > Node Preferences > Node Selection. Drill down to the workstation level. Click the Edit button for the desired workstation.

2. To save changes, the workstation must have a Number. If you haven't already assigned a Number to this workstation, enter a Number.

3. Click the HAL Settings tab.
4. Select the workstation from the dropdown.

5. Click the Customizations tab.

6. Click Add Customization. The Customization Configuration screen is displayed.
 
7. Select the PrismNayaxEFT.exe customization from the dropdown.
8. Enter the path to the PrismNayaxEFT.exe customization.
9. Leave the Configuration Data area blank.
10. Select the Required checkbox.
11. Save the changes. You will see a prompt to reload the hardware configurations for the workstation.
12. Right-click on the Prism Proxy taskbar icon. Select Reload HW Config.

Sample HAL Settings - Customization tab - Add Customization:

HAL Settings - Add Customization

Nayax Configuration
1. Navigate to the Administration Console area if not there already.
2. Select Nayax Configuration from the Prism Menu. The Nayax Configuration button is only available in the Administration Console area.
3. Enter configuration information. Refer to the Nayax Configuration fields table.
4. Save the changes. You will see a prompt to reload the hardware configurations for the workstation.
5. Navigate to the taskbar for the workstation. Right-click on the Prism Proxy taskbar icon. Select Reload HW Config.
6. Re-enter Nayax Configuration and click Test Device. If anything is misconfigured there will be a long delay.
Nayax Configuration fields 

Sample Nayax Configuration screen:
 

PrismNayaxEFT.ini Configuration File
Configuration settings for the PrismNayaxEFT.exe customization are saved in the PrismNayaxEFT.ini file. 
File Location:
...\ProgramData\RetailPro\HardwareServices\conf\PrismNayaxEFt.ini

Log Files
This section has information about:

• Where to view log files
• How to change log settings

View Log Files
1. Navigate to Prism Tech Toolkit and log in.
2. Click Logs on the top menu. A separate login is required for Prism Log Viewer. Default credentials for log viewer: loguser/loguser
3. Scroll the list of logs and click on the desired log file.

Log Settings for PrismNayaxEFT.exe
The PrismLogging.ini file has global log settings that apply by default to PrismNayaxEFT.exe.
Technicians can change default log settings by appending a new section to the end of the PrismLogging.ini file (…\ProgramData\RetailPro\Server\Logs\). For example, a technician may temporarily want to change the LOGLEVEL to 3 to do troubleshooting.
[PrismNayaxEFT]
LOGLEVEL=2
FORCELOGINFO=True
RETAINXLOGS=9
BUFFERSIZE=100
Note: Do not edit the PrismLogging.ini file unless instructed to do so by a certified Retail Pro technician. Restart the Prism Proxy after changing log settings.
Relationship between Buffer Size and Log Files
If the BUFFERSIZE is set to 100, then the most recent 100 log lines will not be written to the log files (yet); those 100 lines will still be in the buffer.

Using the Prism Nayax EFT Customization at POS
Sales
1. When the customer is ready to pay, navigate to the Tender screen.
2. Click Credit Card or Debit Card.
3. Click Take.
4. You will hear the Nayax device beep. A prompt is displayed.  
5. You can swipe the card, insert the card into the card reader, or hold the card in close proximity to the device screen. You may be required to enter additional information (e.g., a PIN).
6. When the Amount Due is zero, click Print/Update. 
7. Select a design (or report group) to print,

Returns - Notes
Nayax only allows referenced returns (also known as "refund by reference" or "token returns"). Nayax does not allow unreferenced returns. When you do a referenced return of a credit card transaction, Prism displays a prompt to the user: "Return to original CC? Yes/No." Click Yes. If multiple credit card tenders are available, the prompt that Prism displays will list each so you can select which tender to use for this return. 
Voids
You can void credit and debit card tenders.
Force Authorization Unavailable
Although the "Force Authorization" button is visible in the Credit Card Tender UI, clicking it has no effect for Nayax (Force Authorization is only available for Genius EFT).