> For the complete documentation index, see [llms.txt](https://docs.gobtcpay.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.gobtcpay.com/stores-and-pos-terminals.md).

# Stores and POS Terminals

Stores and terminals let you take GoBTC Pay payments in person. A **store** represents one of your locations and holds its **terminals** and payments; each store can have one or more terminals.&#x20;

You manage both under the **Stores** section in the dashboard:

<figure><img src="/files/wo1O7XTnoa2t65Ux3MR7" alt=""><figcaption></figcaption></figure>

### Stores overview

The Stores page lists your locations and storefronts, each with its own terminals. Summary cards show the number of stores, terminals across all stores, and overall status. Each row shows the store's name, address, status, connected terminal count, and country, with a **Manage** action.

### Add a store

Click **Add store**, then provide:

* **Store name**.
* **Address** (optional).
* **Country** (optional).

Click **Create store**. You can add terminals afterward.

### Manage a store

**Manage** opens two tabs:

* **Terminals:** the store's terminals, plus **Add terminal**.
* **Settings:** edit the store name, address, and country; **Save changes**; or **Delete store**.

### Add and pair a terminal

1. In a store's **Terminals** tab, click **Add terminal**.
2. On the **Connect in the POS app** screen, open the **GoBTC Pay POS app**.
3. Scan the QR to pair the terminal, or use **Copy pairing code**.

### Terminal details

Opening a terminal shows its **Status**, **Location** (the store), **Terminal ID**, and **Terminal key (Web SDK)** with a **Copy key** action.&#x20;

From here, you can&#x20;

* **Rotate key**
* **Disable terminal**
* **Delete terminal**

The Terminal key (Web SDK) is the credential a web integration uses for that terminal (see [Accept Payments Online](/guides/accept-payments-online.md)).

{% hint style="danger" %}
Keep the Terminal key server-side. If it may have been exposed, use the **Rotate key**.
{% endhint %}

### How the customer pays

The customer opens the GoBTC Pay app, scans the terminal QR, reviews the amount and merchant, and approves. The terminal shows **Approved** within moments; on-chain settlement follows in a later batch.


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.gobtcpay.com/stores-and-pos-terminals.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
