gobtc payDocs

Getting Started

GoBTC Pay is a Bitcoin payment protocol for merchants and wallets: instant confirmation at the till, on-chain settlement, non-custodial by design, and zero fees for the people paying.

This page walks you through setting up GoBTC Pay and taking your first Bitcoin payment.

Take a payment in personLink a wallet, set up a store and terminal, charge a customer from the POS app.Take a payment onlineIntegrate the Web SDK with a terminal key and present checkout on your site.Send a payment linkNo store or terminal needed. Create a payable URL or QR and share it.How it all worksCumulative pre-authorization, 2-of-3 custody, batched settlement.

Before you begin

Payments happen in two stages. When a customer pays from the GoBTC Pay app, the payment becomes paid right away and you can complete the sale. The payment then settles on the Bitcoin main chain a short time later, in a batch. Because it settles directly on Bitcoin, there are no payment channels, no wrapped tokens, and no chargebacks.

By the end of this page you will have:

  1. A merchant account.
  2. A linked receiving wallet, where your Bitcoin settles.
  3. A first payment, taken with a payment link or a POS terminal.

For how instant approval and on-chain settlement relate, see Payment Lifecycle.

Step 1: Create your account

  1. Sign up at merchant.gobtcpay.com with your email and a password of at least 12 characters.
  2. Enter the 6-digit code we emailed you to verify your address.

Step 2: Get verified (KYB)

  1. Email [email protected] to request verification.
  2. Wait for our confirmation and onboarding information.

Payments cannot be settled until you connect the wallet where your Bitcoin is received.

  1. In the dashboard, open Settings, then the Receiving wallet tab:

  2. In the GoBTC Pay app, open Settings, then Merchant, then Link wallet.

  3. Scan the one-time QR to connect.

For details, see Receiving Wallet and Custody.

Step 4: Take a payment

There are two ways to take a payment: send the customer a payment link, or charge them in person on a POS terminal. Use whichever fits your business.

From Home, click New payment to open the Payment links page, then click Create payment link:

Set an amount, reference, and expiry, choose single-use or reusable, then share the URL or QR.

See Payment Links.

POS terminal

To take payments at a counter, you set up a store and a terminal. A store represents one of your locations and holds its terminals and payments.

  1. Open Stores and click Add store:

  2. Enter a Store name (address and country are optional), then click Create store.

  3. On the store's row, click Manage:

  4. On the Terminals tab, click Add terminal:

  5. Enter a Terminal name (location is optional), then click Add terminal.

  6. Pair the terminal with the GoBTC Pay POS app.

See Stores and POS Terminals.

Step 5: What the customer does

The customer opens the GoBTC Pay app, scans your POS QR or opens your link, reviews the amount and merchant, and approves.

Their wallet signs the authorization, and the payment becomes paid within moments (see Payment statuses).

On-chain settlement follows in a later batch.

Manage more than one business

Use the merchant switcher in the top bar to move between the merchant accounts your login belongs to. Each merchant has its own stores, transactions, team, and wallet.

Get the app (for your customers)

AndroidGoogle PlayiOSApp StoreMerchant dashboardmerchant.gobtcpay.com

Build an integration

POS APICreate a payment, show a QR, track it to settlement.Merchant APIThe merchant dashboard and back office surface.Wallet APIFor non-custodial wallets paying at a POS.