Settings

Create and Test a Kiosk Store ID

The Kiosk Account tab stores one 3-6 character alphanumeric Store ID for the current branch. That identifier is used to resolve the branch for kiosk catalog and order requests.

Menu path
Settings -> Sales Channels -> Kiosk -> Account
Verified from
Posnic demo and current POS source reviewed on 2026-09-08
Technical source evidence

Live demo Settings -> Sales Channels -> Kiosk -> Account audited 2026-09-04, frontend/modules/settings_write.html kioskaccount-line, frontend/static/script/js/modules/js/settings.js kioskAccountSettings and validation, api/src/models/setting.model.js kioskAccountSettingsModel uniqueness and branch entry update, api/src/repositories/item.repository.js accessKiosk and accessQr branch resolution, api/src/models/sale.model.js kioskOrderModel branch resolution

Kiosk Account tabLive Posnic demo rechecked 2026-09-04. Account currently asks for a Store ID only; the identifier must contain 3-6 letters or numbers.
Continue kiosk setupA Store ID identifies the channel, but customer-facing images, payment, print and item availability still require separate setup and testing.
Verify a test orderA complete test ends with the order visible in the Kiosk Report for the correct branch and channel.

What the Store ID Does

The Store ID is the short branch identifier that kiosk and self-order requests use to find the correct Posnic branch. It is not a cashier login, payment key, password or receipt number.

  • The current Account tab contains one Store id field and Save; the old secret-key field is not active in the interface.
  • The ID is stored inside the current branch's kiosk settings entry.
  • Kiosk catalog and order code resolves a branch by this Store ID, so a mistyped ID can make the customer channel report that the branch was not found.
  • The ID must be unique. Posnic rejects an ID already used by another kiosk entry.
  • Treat the ID as public routing information, not as an authentication secret. Do not use a password or sensitive business value.

Choose a Stable ID

RuleGood examplesAvoid
Length3 to 6 charactersTwo characters or more than six
CharactersLetters and numbers onlySpaces, hyphens, underscores or punctuation
MeaningA short stable outlet code such as MDU01A staff name, phone number or temporary campaign
UniquenessOne approved value per kiosk branchReusing another branch's ID
SecurityPublic identifier with no secret meaningPIN, password, gateway key or tax identity

Create the Store ID

  1. Confirm the current Posnic branch in the app header.
  2. Open Settings and choose Sales Channels or Kiosk, depending on the visible navigation label.
  3. Open Kiosk Settings -> Account.
  4. Enter the approved 3-6 character Store ID using letters and numbers only.
  5. Click Save and wait for Kiosk settings updated successfully.
  6. Leave the page and reopen Account to confirm the saved value loads for this branch.
  7. Record the branch name and Store ID in the rollout record before configuring customer devices.

Finish the Channel Before Sharing It

A saved Store ID only establishes branch routing. It does not by itself make a kiosk ready for customers.

  1. Enable the relevant Sales Channels or Kiosk feature for the branch and plan.
  2. Mark the intended items for the kiosk or sales channel and verify prices, tax, images, stock behavior and availability.
  3. Configure Kiosk Images for the correct shop identity.
  4. Configure Kiosk Payment and verify any required Razorpay gateway first.
  5. Configure Kiosk Print with printer names that exist on the kiosk device or print bridge.
  6. Open the customer-facing kiosk using the deployment's approved link containing this Store ID.
  7. Place one controlled order and verify branch, items, totals, customer details, payment, print and Kiosk Report output.

Changing an Existing ID

  • Schedule the change while the kiosk is closed to customers; old links or bookmarks can stop resolving after the identifier changes.
  • Update every kiosk device, QR code, customer link, sign and support record that contains the old ID.
  • Do not change an ID to fix product, image, payment or printer problems; those settings have their own tabs.
  • After a rename, test both the new link and the old link. The new one must reach the intended branch, and the old one must not continue accepting orders unexpectedly.
  • Keep the previous ID and change time in the rollout log so support can diagnose stale links.

Troubleshooting

Message or symptomLikely causeAction
Enter the store IDField is blank.Enter the approved ID and save.
Minimum 3 charactersID is too short.Use 3-6 characters.
Maximum 6 charactersID is too long.Shorten the approved outlet code.
Only letters and numbers allowedSpaces or punctuation are present.Remove every non-alphanumeric character.
A kiosk with this Store ID already existsAnother kiosk entry already uses it.Choose a different approved ID; do not overwrite another branch.
Branch not found on kioskThe customer link has a missing, stale or mistyped ID.Compare it character for character with Account and reopen the correct link.
Catalog opens but items are missingItem kiosk/channel eligibility or availability is incomplete.Review item sales-channel settings; changing Store ID will not publish items.
Order reaches the wrong outletA stale link or wrong branch rollout was used.Stop ordering, verify branch-to-ID mapping, replace the link and run a fresh controlled order.

Rollout Evidence

  • Branch name and Store ID match the approved mapping.
  • Account reloads the saved ID.
  • Customer kiosk opens the correct branch.
  • Only approved items and prices appear.
  • One controlled order completes with the intended payment and printer behavior.
  • The order appears in Kiosk Reports and reconciles with the sale and payment records.