POS Punchh Key & Barcode Generator

The POS Punchh Key & Barcode Generator enables developers and testers to generate valid barcodes for the various point-of-sale (POS) terminal systems with which Punchh integrates. It embodies the four main algorithms (map1, map1short, map2, and map3) to generate valid barcodes when the location short key (e.g., store number) and the check number are set.

Developers and testers can use this tool to test POS check-ins with valid barcodes. It has been tested on MacOS and Windows.

Prerequisites

You must have Docker installed and running on your computer for this program to work.

Installation

1. Download the POS Punchh Key & Barcode Generator zip file here. Access to this file is restricted. Contact your Punchh representative for more information.

2. Extract all files from the zip file.

3. Open the README.md file at the root level and follow the instructions on how to run the program.

Sample Output

> help
These are the commands which can be used:
   set check <check number> - Set the check number. e.g. set check 55678 
   set shortkey <short key> - Set the location short key. e.g. set shortkey 3179 
   set map <Punchh Key map> - Set the Punchh Key map to one of map1, map1short, map2, or map3
   set salt <number> - Set the salt to a number. e.g. set salt 12345. If number is blank, then the default salt is used 
   generate <number> - Generate set Punchh Key(s) with the current configuration, and increasing check numbers 
   get config  - Get the current Punchh Key generator configuration parameters set
   get version - Get the current version of the application
   help        - Get a list of possible commands
   debug on    - Enable debug logs when running the code
   debug off   - Disable debug logs when running the code
   exit 

> get config
Current configuration is set to: shortkey:6979, check:22779, map:map1, salt:19846

> generate 2
For check: 22779
 Config: 
   shortkey: 6979
   map:map1
   salt: 19846
 Punchh Key (without parity bit) is: 582434313583

For check: 22780
 Config: 
   shortkey: 6979
   map:map1
   salt: 19846
 Punchh Key (without parity bit) is: 582434315640

> 
Copyright © 2025 PAR Technology Corporation. All rights reserved.
PAR Technology Corporation 8383 Seneca Turnpike, Suite 3 New Hartford, New York 13413 (315) 738-0600 legal@partech.com. PAR Tech is a leading global provider of software, systems, and service solutions to the restaurant and retail industries.
You may learn about its product offerings here.
Before using this application, please read the Limited License Agreement and the PAR Tech Terms of Use.