# FAQ & Troubleshooting ## 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? | | Short Code | PIN | | ------------ | ---------------------------------------------- | ---------------------------------------- | | Used for | Identification (appears in Order IDs, reports) | Authentication (logging into a terminal) | | Format | 1-10 alphanumeric characters | 8+ digits only | | Secret? | No | Yes | | Who has one? | Both terminals and cashiers | Cashiers only | ### 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](/point-of-sale-pos/token-restrictions.md). ### Can a cashier log into multiple terminals? **Yes**, if they are allowed on those terminals (see [Cashier Restrictions](/point-of-sale-pos/cashier-restrictions.md)). 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](/point-of-sale-pos/payment-history.md) 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. ### Which currencies are supported? 31 currencies from the European Central Bank (ECB) including USD, EUR, GBP, JPY, CHF, CAD, AUD, and more. See [Multi-Currency Support](/point-of-sale-pos/multi-currency.md) for the full list. ### How do I set up a non-USD currency on my terminal? 1. Go to **Dashboard > POS > Currencies** and enable the currencies you need 2. Go to **Dashboard > POS > Terminals**, edit the terminal, and change the default currency 3. Optionally enable "Allow cashier to switch currency" for multi-currency terminals ### How often are exchange rates updated? Every 30 minutes. Rates come from the European Central Bank. If the primary source is down, a fallback CDN is used automatically. ### What is a zero-decimal currency? JPY, KRW, ISK, and HUF have no fractional units. Entering `1500` on a JPY terminal means 1,500 yen, not 15.00 yen. The keypad adjusts automatically based on the selected currency. ### Can a cashier switch currencies during a transaction? Only if the merchant enabled "Allow cashier to switch currency" on the terminal. If enabled, the cashier sees currency pills at the top of the amount screen and can tap to switch. ## Troubleshooting ### "No cashiers assigned to this terminal. Contact your manager." **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:** 1. Go to **Dashboard > POS > Terminals** 2. Edit the terminal 3. Add the cashier to the **Allowed Cashiers** list 4. Save ### "Invalid PIN" **Possible causes:** * Wrong PIN entered * The cashier's account is deactivated * The cashier is not allowed on this terminal (restrictions) **Fix:** * Double-check the PIN * 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 * The URL is incorrect **Fix:** 1. Check that the terminal is active in **Dashboard > POS > Terminals** 2. Copy the terminal URL directly from the dashboard 3. 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. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.makapay.io/point-of-sale-pos/faq.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.