This guide is only for brands with POSitouch locations that are using the “Punchh Secure” dashboard POS Type:
- 1 Prerequisites
- 2 Create the “cell type 9” and “cell type 7” items
- 3 Define check footer
- 4 Create the virtual XML Printer
- 5 Install & Configure the Punchh service
- 5.1 Installation
- 5.2 Configuration
- 6 Add custom credit card payment method for Punchh redemptions
- 7 How to apply Punchh redemption codes
- 8 Troubleshooting
- 9 Known Issues
Prerequisites
System requirements for the PC hosting the Punchh service (i.e. the back-office PC)
Minimum OS: Windows 7 (with SP1) and .NET Framework 4.6.1
Configure firewall/router
ALLOW: | FROM: | TO: | BY: |
---|---|---|---|
TCP port 443 | The PC hosting the Punchh service | pos.punchh.com | Punchh.exe (Back Office PC) |
Details
pos.punchh.com - Punchh check-in and redemption transactions, Punchh application configuration & update server
isl.punchh.com - Punchh check and barcode details
loguploads.punchh.com - Punchh log file repository #1
poslogs.punchh.com - Punchh log file repository #2
Configure antivirus
Whitelist the EXE applications in the Punchh install folder: C:\Program Files (x86)\Punchh
Application Whitelisting
Whitelist all of the Punchh EXE in the Application Whitelisting Control to allow communication over network.
Whitelist all applications that are digitally signed by “Punchh, Inc.”
To allow updates without having to go back and “re-fingerprint” individual EXEs
Version and licensing requirements
POSitouch version must be 6.41.0 or later. Here is how to check your POSitouch version:
Open C:\SC\ERROR.LST in Notepad.
CTRL+F, search for "Spcwin startup". Any lines that contain "Spcwin startup" will also contain the version number:
07/18/19 09:16:07 500 Spcwin startup: 6.41.0* 04/23/2019 05:56:42 3032576 bytes WINNT 6.1 (Windows 7) 64-bit
Loyalty module must be licensed and enabled.
Printers
Check with your POSitouch dealer to ensure that your printers can print QR codes.
Note: If your printers can’t print QR codes, guests can still earn points by manually entering the 13 digit “punchh key“ printed at the bottom of receipts into the mobile app.
Create the “cell type 9” and “cell type 7” items
Create the “cell type 9” item
Open Back Office Setup > Menu Editor > Edit An Order Screen
Select a screen, then select an empty cell.
On this form, make the following changes:
Cell name: "MEMO"
Cell type: 9-Memo
Prep Cat: None required
Opt Rtng: 0-with main item
Click Save.
Create the “cell type 7” item
Open Back Office Setup > Menu Editor > Edit An Order Screen
Select a screen, then select an empty cell.
On this form, make the following changes:
Cell name: "LOYALTY QR CODE"
Cell type: 7-Primary item, not taxed
Prep Cat: None required
Opt Rtng: 0-with main item
“Exclude from check?” checked
Click the Add button.
Screen #: Select the screen where the “MEMO” cell is located.
Option type: 3-MAY SELECT
Check the checkbox next to “MEMO”.
Click OK.
Click Save.
Back Office Setup > Immediate System Change
Define check footer
Go to Back Office Setup > Hardware > Guest Check Headings > Headings 2.
Add the following 5 lines.
Note: For the third line, copy the contents of this file: third_line.txtEdit each line to have the same settings as the following:
Check “Print on hard check?”
Check “Print on soft check?”
Check all the Cost Centers.
Back Office Setup > Immediate System Change
Create the virtual XML Printer
Go to Back Office Setup > Hardware > Prep Printers > Locations and Types.
Click Insert.
Enter the following:
Printer Number: Enter the next sequential number (see image below).
Printer Name: XML Printer
Click Yes
Select the new printer and click EDIT.
Printer Type: 1- Virtual printer
Device Location: 0- Normal-unmapped!
Click Ok.
Open C:\SC\SPCWIN.INI in Notepad. Edit the file as follows:
In the [SpcWin] section, add:
CC_SocketClose=YES
In the [XML] section, add:
XMLInPath=C:\SC\XML\IN
XMLInOrderPath=C:\SC\XML\INORDER
In the [VIRTUAL] section, add:
VirtualPath11=C:\SC\XML\CHECKS
Note: The number 11 in “VirtualPath11” is taken from the table as shown below (Back Office Setup > Hardware > Prep Printers > Locations and Types):
Go to Back Office Setup > Restaurant Misc Data > XML I/O.
Note: If other third party integrations are currently installed and utilizing XML I/O functionality, then specify folder paths that are unique to Punchh (ex: C:\SC\XML\Punchh\XYZ).
Select our new "XML Printer" for the following XML types:
Click the “XML Ordering“ Configure button and edit the info as follows:
Click the “Open Checks Request“ Configure button and edit the info as follows:
Click the “XML Services“ Configure button and edit the info as follows:
Click the “Virtual Printer Path“ button and edit the info as follows:
Back Office Setup > Immediate System Change
Install & Configure the Punchh service
Installation
On the PC that’s going to be hosting the Punchh service (i.e. the back-office PC), run the SetupPunchh_vX.X.X.X.exe, and complete the installation wizard.
After installation is completed, confirm that the Punchh service is now running:
Configuration
Navigate to the folder C:\Program Files (x86)\Punchh and run PunchhConfigurator.exe as administrator.
Enter the Location Key (aka API_Key) and Business Key:
Set the POS_Type to POSitouch:
Click on the POSitouch.cfg tab, then change the settings as follows:
PathToChecks, PathToIn, PathToInOrder, and PathToSC: Refer to the “Create the virtual XML Printer” section of this guide to obtain the values for these settings.
Note: If the POS Driver is hosted on another computer then replace "C:\" with the network path to the C drive on the POS Driver. Don't use mapped letters like "L:", it has to be full network path instead, for example like this: \\192.168.2.1\C\SC.
Port: The default port is set to 5614. If this port is already in use by another application, then an error will appear in the log files. See the Troubleshooting section of this guide for more details.
MemoItemNum: Set this value to the Item ID of the cell type 9 “MEMO” item that was previously created.
QRCodeItemNum: Set this value to the Item ID of the cell type 7 “LOYALTY QR CODE” item that was previously created.
UsePunchhSecurePOSType: Set this value to True.
UseV1PosiIntegration: Set this value to True.
Leave all other settings with their default values.
Click Apply, then Exit.
Restart the Punchh service.
Click Exit or click the X in the upper-right to close the PunchhConfigurator tool.
Add custom credit card payment method for Punchh redemptions
Punchh redemption codes are accepted by POSitouch as 7-digit credit cards. This step is required to define this payment type.
Go to Back Office Setup > Payment > Forms of Payment
Add a new payment type named “PUNCHH”:
Go to Back Office Setup > Credit Card > User Defined CC
Add the following line as shown below:
Click on More Flags and select the Loyalty Pay Type to be PUNCHH:
Go to Back Office Setup > Credit Card > Forms Of Payment and check the following boxes:
Go to Back Office Setup > Credit Card > Credit Card Types
Define the Punchh Payment Type as shown below. Select unused channel 4, 5 or 6.
Go to Back Office Setup > Credit Card > Merchant Data and click on the More 1 field.
Define channel selected in the previous step as shown below. Modify the Port to match what’s specified in the Punchh Configurator (note: avoid ports 5002, 5003, 5025, 5026, 4444, and 3333). Specify the local IP address of the PC hosting the Punchh service.
Back Office Setup > Immediate System Change
How to apply Punchh redemption codes
Ring up an order
Go to take payment and touch CC AUTH
Enter the card number (i.e. 7-digit redemption code) and touch ENTER
Touch LOYALTY REDEEM on the left
Touch ENTER
Punchh will then validate the redemption code. If successfully validated, the amount will be shown here. If not successfully validated, an error message with further details will be displayed.
Touch PAYMENT and you will see the Punchh payment on the screen:
Touch ENTER and then CASH to complete the sale:
Troubleshooting
If you are getting errors when applying redemptions or when trying to scan the QR code to earn points please check Punchh logs for errors. Logs are located here: C:\Program Files (x86)\Punchh\Logs
Log files are named by date, for example:
2017-0223-000050.log
was created on Feb-23, 2017
Port conflict error
If the default port is already in use by another application, a port conflict error will occur. In the log file, please search for the text “Port conflict occurred”. If this text was found, then the error occurred. To resolve this error, please use the PunchhConfigurator tool to change the default port to an unused TCP port. Some suggested ports, usually not in use, are: 5619, 7482, 24473, 10123.
Known Issues
Receipts displayed on the Punchh dashboard will show the price of modifier items as $0.00.