gobtc payDocs

Accept Payments In Person

Overview

GoBTC Pay lets you accept payments in BTC. You link a wallet for settlements, create a store and a terminal, raise a charge from the POS app, and the customer pays it by scanning a QR code from their own wallet.

Before you start

You need access to:

  • The GoBTC Pay merchant dashboard (web).
  • The GoBTC Pay mobile app, version 1.1.1 or later.

  1. In the merchant dashboard, open Settings.

  2. Open the Receiving wallet tab.
    A one-time QR code appears (it expires after about 10 minutes).

  3. Open the GoBTC Pay app on your phone.

  4. Go to Settings → Merchant → Link your wallet:

  5. Tap Scan QR code:

  6. Scan the QR code from the dashboard and wait for the Wallet linked confirmation.

Back in the dashboard, the Receiving wallet tab shows Wallet linked and your Receiving address.

To change the wallet later, tap Link a different wallet and repeat the steps.

Step 2. Create a store

  1. In the dashboard, open Stores:

  2. Tap + Add store, or the Add another store block.

  3. Enter the store details (name, address, country). The store appears in the list with the Active status.

Step 3. Add a terminal

  1. In the store list, tap Manage on the store you need:

  2. On the Terminals tab, tap + Add terminal:

  3. Enter a Terminal name, optionally fill in Location, then tap Add terminal.

  4. A pairing QR code opens (Connect in the POS app). Keep it open, or tap Copy pairing code.

Step 4. Pair the POS terminal in the app

  1. Open the GoBTC Pay app.

  2. Go to Settings → Open POS:

  3. Tap Scan QR code

  4. Scan the terminal QR code from the dashboard (Stores → your store → Manage → Terminals → terminal → QR code).

  5. Once paired, the terminal screen opens with the terminal name at the top.

Step 5. Accept a payment

  1. On the terminal screen, open the Charge tab:

  2. Select the currency from the dropdown.

  3. Enter the amount on the keypad.

  4. Tap Charge. The app generates a payment QR code.

  5. Show the QR code to the customer.

  6. The customer scans the QR code with their wallet and pays the BTC amount. The QR code contains a standard Bitcoin payment request with the exact address and amount.

  7. While the screen shows Waiting for payment, the charge stays open. After the payment is confirmed, the transaction appears on the Transactions tab.

  8. To cancel before the customer pays, tap Cancel.

Step 6. Review transactions and terminal details

In the POS app, when the terminal is open, the screen has a bottom bar with three tabs: Charge, Transactions, and Settings.

  • Open the Transactions tab to see the payment history for this terminal.
  • Open the Settings tab to see the Terminal ID, Store ID, and Merchant ID, plus the Minimize POS and Exit terminal buttons.

In the merchant dashboard (web), open the Transactions section in the left menu to track all payments across every store and terminal.