105 operations · v1.2

GoBTC Pay Merchant Account API endpoints

For the merchant dashboard and back office. Generated from the OpenAPI specification, grouped by area.

Base URL

https://api.gobtcpay.com/public/api/v1.2

Auth · merchantAuth

Merchant dashboard access token obtained from /merchant/auth/login (or the OAuth / passkey / 2FA login flows). Send it as Authorization: Bearer <accessToken>. Refresh it via /merchant/auth/refresh when it expires.

Download OpenAPI spec

Areas

Payments6 endpoints

Create and inspect payments, list payment history, and build / submit the signed transaction that settles a payment.

POSTCreate paymentPOSTGet paymentPOSTList paymentsPOSTCreate paymentPOSTGet paymentPOSTList payments
Merchant Auth27 endpoints

Merchant dashboard sign-in: email/password, OAuth, passkeys, TOTP 2FA, sessions, token refresh, and switching the active merchant context.

POSTLog inPOSTRegisterPOSTRefresh tokensPOSTLog outPOSTCurrent userPOSTVerify email+21 more
Stores5 endpoints

Manage the merchant's stores: create, read, update, and delete.

POSTCreate storePOSTGet storePOSTList storesPOSTUpdate storePOSTDelete store
POS Terminals6 endpoints

Manage POS terminals within a store, including issuing and rotating their API keys.

POSTCreate POS terminalPOSTGet POS terminalPOSTList POS terminalsPOSTUpdate POS terminalPOSTDelete POS terminalPOSTRotate POS API key
Team & Access9 endpoints

Team members, roles, and invitations for the merchant account.

POSTGet memberPOSTList membersPOSTInvite memberPOSTAccept invitePOSTGet invite infoPOSTList invites+3 more
Reports5 endpoints

Sales summaries, transaction and aggregated reports, and async exports.

POSTSales summaryPOSTTransactions reportPOSTAggregated reportPOSTCreate exportPOSTExport status
Webhooks7 endpoints

Configure outbound webhook endpoints (URL, scope, signing secret) so your backend is notified when a payment's status changes, an alternative to polling Get payment.

POSTCreate webhookPOSTList webhooksPOSTGet webhookPOSTUpdate webhookPOSTDelete webhookPOSTRotate webhook secret+1 more
Dashboard3 endpoints

Aggregated home-screen summary: balance, today's metrics, the 7-day chart, and recent payments in a single call.

POSTCustodial balancePOSTCustodial capabilitiesPOSTDashboard summary
Business Profile4 endpoints

The merchant's public business profile, display name, description, category, support email, and logo.

POSTGet profilePOSTUpdate profilePOSTUpload logoPOSTDelete logo
Receiving Wallet7 endpoints

Link a receiving wallet by scanning a QR with the mobile app: start a link session and poll its status.

POSTStart wallet linkPOSTWallet link statusPOSTNon-custodial balancePOSTWallets with a balancePOSTBuild withdrawal PSBTPOSTBroadcast withdrawal+1 more
API Keys4 endpoints

Issue, list, rotate, and revoke Web SDK integration keys (publishable / secret).

POSTCreate API keyPOSTList API keysPOSTRotate API keyPOSTRevoke API key
Notifications2 endpoints

Per-event notification preferences across email, in-app, and SMS channels.

POSTGet notification preferencesPOSTUpdate notification preferences
Audit Log1 endpoint

Read the merchant's audit log of account actions.

POSTList audit log
Custodial Withdrawal8 endpoints

Custodial merchants only: manage saved BTC destination wallets and withdraw the Uphold balance to them, including the Uphold Travel Rule verification a held withdrawal may require.

POSTAdd destination walletPOSTList destination walletsPOSTCreate withdrawalPOSTList withdrawalsPOSTGet withdrawalPOSTCancel withdrawal+2 more
Custodial Bank Accounts4 endpoints

Custodial merchants only, register, list, inspect, and remove ACH bank accounts (Uphold External Accounts) used as off-ramp destinations.

POSTAdd bank accountPOSTList bank accountsPOSTGet bank accountPOSTDelete bank account
Custodial Off-Ramp7 endpoints

Custodial merchants only, sell BTC from the Uphold account and send USD to a registered bank account, including the Travel Rule compliance step when required. Amounts are denominated in satoshi (BTC debit) and USD (bank destination).

POSTPreview off-ramp quotePOSTCreate off-rampPOSTList off-rampsPOSTGet off-rampPOSTCancel off-rampPOSTOpen Travel Rule session+1 more