Common Questions
What is the terminal short code? Is it a password?
No. The terminal short code is a human-readable identifier like R1 or MAIN. It appears in Order IDs to help track which terminal processed a payment. It is not secret and not used for authentication.
What is the difference between a short code and a PIN?
Identification (appears in Order IDs, reports)
Authentication (logging into a terminal)
1-10 alphanumeric characters
Both terminals and cashiers
Why can't I use letters in the PIN?
PINs are designed for quick entry on a numeric keypad at a POS terminal. Using only digits makes login fast and error-free on touch devices. The 8-digit minimum ensures security despite being numbers-only.
Can two cashiers have the same PIN?
No. PINs must be unique because the system uses the PIN to identify which cashier is logging in. If you get an error about duplicate PINs, choose a different PIN.
Can I control which tokens appear on a terminal?
Yes. Edit the terminal and toggle on Restrict Available Tokens. Then select only the tokens you want. Cashiers will only see those tokens when using the terminal. See Token Restrictions.
Can a cashier log into multiple terminals?
Yes, if they are allowed on those terminals (see Cashier Restrictions). Each terminal maintains separate sessions.
Can I see a cashier's PIN?
No. PINs are hashed and cannot be retrieved. If a cashier forgets their PIN, the merchant must reset it to a new value.
What happens if the terminal crashes during a payment?
The payment is not lost. Log back in and tap the History button to find and resume the pending payment. The same QR code and wallet address are preserved. See Payment History & Recovery for details.
Can a cashier see another cashier's payments?
No. Each cashier's history shows only their own payments on the current terminal. The merchant can see all payments across all cashiers from the dashboard.
What happens if a customer sends less than the requested amount?
The terminal detects partial payments automatically. The cashier can either:
Collect the partial amount and close the payment
Wait for the customer to send the remaining balance
How do I see all POS payments as a merchant?
Go to Dashboard > POS > Activity. You can filter by terminal or cashier using the Order ID codes.
Troubleshooting
Cause: The terminal has cashier restrictions enabled and no allowed cashiers, or the cashier trying to log in is not on the allowed list.
Fix:
Go to Dashboard > POS > Terminals
Add the cashier to the Allowed Cashiers list
Possible causes:
The cashier's account is deactivated
The cashier is not allowed on this terminal (restrictions)
Fix:
Verify the cashier is active in Dashboard > POS > Cashiers
Check the terminal's allowed cashiers list
Session expired / logged out unexpectedly
Cause: 15 minutes of inactivity.
Fix: Log in again with the PIN. To avoid this, stay active on the terminal. The session extends automatically with any activity.
"PIN must be at least 8 digits"
Cause: The PIN entered is too short.
Fix: Use a PIN that is 8 digits or longer. Example: 12345678.
"PIN already in use"
Cause: Another cashier already has this PIN.
Fix: Choose a different PIN. Each cashier must have a unique PIN.
Terminal URL not working
Possible causes:
The terminal has been deactivated
Fix:
Check that the terminal is active in Dashboard > POS > Terminals
Copy the terminal URL directly from the dashboard
Make sure you're using the full URL including the terminal ID
Payments not showing in dashboard
Possible causes:
Payment is still processing on-chain
Filters are applied in the dashboard
Fix:
Wait for blockchain confirmation
Clear any filters in the payment history view
Search by the Order ID if you have it
Can't find my pending payment in History
Possible causes:
The payment has already expired (expired payments show in the "All" tab but cannot be resumed)
You're logged in as a different cashier
The payment was created on a different terminal
Fix:
Check the "All" tab in the history panel
Make sure you're using the same PIN/cashier as when the payment was created
If the payment expired, create a new one
Partial payment not showing the progress bar
Cause: The balance check takes a few seconds to detect on-chain funds.
Fix: Wait 5-10 seconds. The terminal polls for balance updates every 5 seconds. If the customer just sent funds, it may take one or two polling cycles to appear.
