> For the complete documentation index, see [llms.txt](https://docs.makapay.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.makapay.io/point-of-sale-pos/faq.md).

# FAQ & Troubleshooting

## Common Questions

### What is the business short code? Is it a password?

**No.** The business short code is a **human-readable identifier** like `R1` or `MAIN`. It appears in Order IDs to help track which business 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 business) |
| Format       | 1-10 alphanumeric characters                   | 8+ digits only                           |
| Secret?      | No                                             | Yes                                      |
| Who has one? | Both businesses 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 business. 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 business?

**Yes.** Edit the business and toggle on **Restrict Available Tokens**. Then select only the tokens you want. Cashiers will only see those tokens when using the business. See [Token Restrictions](https://docs.makapay.io/point-of-sale-pos/token-restrictions.md).

### Can a cashier log into multiple businesses?

**Yes**, if they are allowed on those businesses (see [Cashier Restrictions](https://docs.makapay.io/point-of-sale-pos/cashier-restrictions.md)). Each business 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 business 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](https://docs.makapay.io/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 business. The merchant can see all payments across all cashiers from the dashboard.

### What happens if a customer sends less than the requested amount?

The business 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 business 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](https://docs.makapay.io/point-of-sale-pos/multi-currency.md) for the full list.

### How do I set up a non-USD currency on my business?

1. Go to **Dashboard > POS > Currencies** and enable the currencies you need
2. Go to **Dashboard > POS > Businesses**, edit the business, and change the default currency
3. Optionally enable "Allow cashier to switch currency" for multi-currency businesses

### 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 business 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 business. 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 business. Contact your manager."

**Cause:** The business 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 > Businesses**
2. Edit the business
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 business (restrictions)

**Fix:**

* Double-check the PIN
* Verify the cashier is active in **Dashboard > POS > Cashiers**
* Check the business'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 business. 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.

### Business URL not working

**Possible causes:**

* The business has been deactivated
* The URL is incorrect

**Fix:**

1. Check that the business is active in **Dashboard > POS > Businesses**
2. Copy the business URL directly from the dashboard
3. Make sure you're using the full URL including the business 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 business

**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 business 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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.makapay.io/point-of-sale-pos/faq.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
