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.

You manage both under the Stores section in the dashboard:

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.

From here, you can

  • 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).

Important

Keep the Terminal key server-side. If it may have been exposed, use Rotate key.

How the customer pays

The customer opens the GoBTC Pay app, scans the terminal QR, reviews the amount and merchant, and approves. The payment becomes paid within moments (see Payment Lifecycle); on-chain settlement follows in a later batch.