Inky the octopusGet-Inky

20 · Troubleshooting

On this page
  1. The register
  2. Payments
  3. PINs and access
  4. Printing and labels
  5. Items and booths
  6. Payouts and reports
  7. Sync and Cloud+
  8. Licence and updates
  9. Data
  10. Customer display

By symptom. Each entry says what's going on and what to do; where the fix has its own page, it's linked. If none of this fits, [email protected] — and the sync log or the exact message on screen is the most useful thing to send.

The one rule underneath all of it: your data is never at risk from anything on this page. A locked register, a lapsed licence, a lost connection, a failed update — none of them touches the store on this computer.


The register

I scanned a tag and nothing rang. The bar only rings on an exact, complete SKU. If the scanner put the code in the bar but nothing happened, the SKU didn't match an item that's for sale — the item may be sold, a draft, on layaway, or the tag is from a booth that was combined into another. Type part of the title instead and tap the row; then look the item up on the Items tab. If the scanner isn't putting anything in the bar at all, click in the bar first — the scanner types wherever the cursor is.

It rang the same item twice. It didn't: scanning a tag twice raises the quantity on the one line. Use the − on the line.

The + on a line won't go higher. The booth only has that many on the shelf. Restock the item on the Items tab (raise Units on hand) if there really are more.

A line says "No price on this one". The item has no price. Type it in the box and press Enter or Set — the sale can't be completed until every flagged line has a price.

Take payment does nothing / "One item still needs a price — it's the highlighted line." As above: find the highlighted line.

"This sale discounts N%, over the M% limit. A manager or owner PIN is required." Limit staff discounts is on. A manager or owner enters their PIN, or reduce the discount. Staff & security.

"… is below the vendor's bottom dollar ($N). A manager or owner PIN is required." That line sells for less than the lowest price its vendor will take. A manager or owner enters their PIN and taps Approve price, or raise the price to the bottom dollar or more. The register.

"A tax-exempt sale needs the buyer on record." Tax-exempt is ticked with nobody attached — usually a basket parked before this shop updated. Tap the line under the tick box on the register and choose the buyer, or pick them in the Take payment window.

Process payment is greyed out. Every tender line needs a chosen tender (not Choose payment…), and the amounts must meet the total exactly — the bottom line says Balance due or Over until they do.

The coupon box isn't there / "Coupons are switched off for this shop." The Coupon codes feature switch is off, or the shop isn't on Pro. Promotions, coupons & rewards.

The whole app is asking for a cashier PIN. Require cashier login is on and nobody is clocked in. Clock in with your employee number and PIN; the owner can turn the setting off in Settings.


Payments

The card reader screen says "Card didn't go through". The sale is recorded and nothing was charged. Try the card again, take it another way, or Undo this sale. If it says Square asked Inky to slow down, wait a minute and try once. If it says Inky couldn't reach Square, check this computer has internet and try again in a minute. Either way your card reader is fine — don't unpair it. Card reader & wallets.

"Square reader" isn't in the tender list. This till has no paired reader, the Square account isn't linked on the web, or Cloud+ isn't signed in. The Card reader card in Settings says which.

A Venmo / PayPal sale keeps appearing under "Wallet payments to check". Nobody confirmed the money arrived. Check the app on your phone and tap I checked — it arrived. Cash & Credit.

"Gift certificate has no balance" / the code box turned red. The code isn't one Inky knows, the card is used up, or it was voided. Check a gift card on the register shows what's on any card. With Square gift cards on, the line under the box says what Square answered.

Square gift cards don't show up at the register. Three things: Square gift cards is ticked under Payment methods; the register is online with Cloud+; and your Square connection has the gift card permission. If you connected Square before Square gift cards existed in Inky, reconnect it once in Inky on the web. Square gift cards.

A Square gift card load is listed under "Gift card loads waiting". Square hasn't finished it yet. It finishes by itself; Check now asks right away. A paid one is never charged twice.

The drawer count is short. Check Wallet payments to check (a wallet sale rung as cash by mistake?), the pay-outs list, and the Sales tab for a void that should have been a cash refund. The count keeps what you save, so record what you found and move on.


PINs and access

"PIN not recognized." For the owner pad: the PIN is 6–8 digits, and only the owner's or a manager's PIN opens it — a cashier's PIN doesn't. For the time clock: the employee number and PIN go together. For a vendor: only a booth with a PIN set can sign in.

"Too many wrong PINs — locked for 30 seconds." Wait the 30 seconds. It's a guard against guessing, not a fault.

I've forgotten the owner PIN. The register can't change it. Reset it from your Inky account on the web (Store → Setup); the register picks it up. Staff & security.

A manager's PIN won't open Financials. Managers only open the areas ticked under Manager access (Pro). The owner's PIN opens everything.


Printing and labels

Nothing prints / "Label print failed." Check the printer is on, on the same network (or plugged in for USB), and that the address on its Settings card is right; Test print tells you quickly. With no printer set up, printing means a PDF preview — that's expected, not a fault.

Labels print but the barcode won't scan / prints garbage. The label size in Settings doesn't match the roll, or the printer language is wrong (TSPL vs ZPL). Fix the size first, then try the other language. Labels & printing.

Avery labels print as one giant page on the thermal printer. The Avery layout is a letter sheet for a desk printer. Pick a thermal size for a label printer.

The cash drawer doesn't open. The drawer opens through the receipt printer, so the receipt printer has to be set up and reachable; Open drawer on its card tests it. If a test print comes out but the drawer stays shut, set Cash drawer on that card to Drawer 2 and press Open drawer again: some drawers, often older ones, are wired that way. It opens by itself on cash sales and with No sale — open drawer; it doesn't open on card sales.

Receipts don't print automatically. They're not meant to — Print last receipt prints on request.


Items and booths

"Can't delete an item with sales history." An item that has ever been on a receipt stays; mark it sold or move it to a draft instead. Delete is for items that never sold.

"Can't delete a booth with sales history — set it Inactive instead." As it says. Inactive keeps the history and takes the booth off the pickers.

"… is filed under booth 01 (…), which is inactive" when you scan a tag. The item is still recorded under a booth that has closed, so the register won't ring it — the sale would pay the wrong vendor. Open Vendor Management: the item is listed under Items on inactive booths, usually with its live booth already picked. Press Move, then scan it again. See Vendors & booths.

Inky won't accept a booth number. Another booth already answers to it — including one that differs only by leading zeros (7, 07 and 007 print the same barcode).

An item is on the floor but the register says "No items match". The register only rings items whose status is for sale. Check the item's status on the Items tab — a draft or a layaway item won't ring.

The intake flags won't go away. needs label clears when a label is printed (or one tap on its ✓); price & qty? clears when you confirm or edit the row. Bulk actions → Clear checks does a whole booth.


Payouts and reports

The first payout is enormous / "Heads up — this payout covers N days". Imported history is being counted as due. Set the period's start to your go-live date before closing. Payouts.

A booth's rent looks wrong on the payout. Rent is charged a whole month at a time, by the payout that covers the 1st of the month. A payout with no 1st in it charges no rent; one that covers two 1sts charges two months. Pay out by whole months.

"Paid payout records cannot be removed." A payout with anyone marked paid is kept for good. Correct the sale on the Sales tab and settle the difference by hand; only an unpaid payout can be removed and re-closed.

Financials shows a different number from Payouts. Check the period and the filters at the top of Financials — a booth or payment filter narrows every report, and Show voided changes the totals. Payouts always uses its own window.

The Sales Tax report's "collected" isn't rate × sales. Tax is calculated per line and rounded to the cent, so collected can differ from calculated by cents over a month. The report shows both and the difference.


Sync and Cloud+

The chip says "Sync failed". The cloud couldn't be reached for a reason other than being offline. Click the chip to retry, then read the Sync log in the ⋯ menu — that's what to send to support.

The chip says "Reconnect" / "This register's cloud login was reset." Click it: it signs out and back in. Your data is untouched throughout.

"Your Cloud+ payment didn't go through." The card on file was declined. Syncing keeps working until the date on the banner. Update card opens My account → Billing on get-inky.com — update the card there.

"Cloud+ is paused — syncing has stopped." The register keeps working on this computer. Go to billing opens My account → Billing on get-inky.com; once the card is updated, sync resumes on its own. Don't buy Cloud+ again — the subscription you have is still there.

The books check says a booth differs. Wait for one more sync — a difference is re-checked before it's called one. If it persists, don't close a payout until it's understood; the sync log and support are the next step. Cloud+ & sync.


Licence and updates

"This register is locked." The trial or the licence's grace period ran out. Nothing is lost. Paste a key, buy at get-inky.com, or sign in with an Inky account that includes Mall OS, and it opens where it stopped. Licensing & plans.

"Enter your access key." Your Inky account includes Mall OS but this register hasn't been given its key yet. Get my keys opens the right page; paste the key.

"That license key isn't valid." Usually a partial paste. A key is a long block of text — copy the whole thing.

"Update failed — please try again later." The download didn't finish, usually a connection blip. The current version keeps running; try Update & restart again, or ⋯ → Version to check again. Nothing about your data is involved. Getting started.


Data

Where is my data? Is it backed up? One file, store.sqlite, in the Inky Mall OS folder in OneDrive (if you have OneDrive) or in Documents; the register's small print says which. OneDrive backs it up only if OneDrive is signed in and syncing. Back up now (Pro) makes a dated copy any time. Your data.

"Backup and restore work in the installed app." You're in a browser preview, which has no file to back up. The installed app has both buttons live.

The import says the layout isn't recognised. The .mdb isn't from a system Inky knows how to read yet — contact support with the file's origin. CSV import works for any system that can export booths and items as spreadsheets.


Customer display

The display says "Waiting for the register to connect…". The register isn't open yet, or was just restarted. It connects by itself; nothing to click. If it stays there, close the display window and click Open customer display in Settings again.

The second monitor just shows a copy of the register. The computer is mirroring. On Windows, press Win+P and choose Extend; on a Mac, open System Settings → Displays and set it to extend, not mirror. With Second monitor fills automatically on, the display then opens there by itself.

The display shows "Payment needs attention". A card payment didn't go through. The cashier's screen has the options; the customer's side deliberately says only that.

Guide for Inky Mall OS 0.16.0, updated Nov 20, 2026 · Download the whole guide (PDF)

Your register shouldn't be the bill that keeps you up at night.

Windows & Mac · Six booths or six hundred

Not the owner?