BlockonomicsAPI Reference

Stores

Create and manage merchant stores, configure callback URLs, and attach wallets to accept Bitcoin payments.

8 endpoints

Endpoints

GET/v2/storesAuth

List all stores

Returns a list of all stores associated with your Blockonomics account.

POST/v2/storesAuth

Create a new store

Create a new store in your Blockonomics account.

GET/v2/stores/{id}Auth

Get store details

Returns details of a specific store.

POST/v2/stores/{id}Auth

Update a store

Update the details of a specific store.

DELETE/v2/stores/{id}Auth

Delete store

Delete a store from your Blockonomics account.

GET/v2/stores/{id}/walletsAuth

Get store wallets

Returns a list of wallets attached to a specific store.

POST/v2/stores/{id}/walletsAuth

Attach wallet to store

Attach an existing wallet in your Blockonomics account to a specific store.

DELETE/v2/stores/{id}/wallets/{wallet_id}Auth

Detach wallet from store

Detach a wallet from a specific store.

object

The store object

A store represents a merchant storefront. Each store has a callback URL and can have one or more wallets attached to it.

Attributes

idinteger

Unique identifier of the store

namestring

Given name

emailidstring

Email of the store owner

http_callbackstring

Callback URL of the store

walletsarray of objects
▶Show item fields
idinteger

Unique identifier of the wallet

namestring

Given name

emailidstring

Email of the wallet owner

cryptostring

Cryptocurrency of the wallet

addressstring

Address of the wallet

xpub_indexinteger

The current xPub index for BTC wallet

gap_limitinteger

The gap limit for BTC wallet

created_atstring (date-time)

Datetime of the wallet creation

balanceobject

Aggregate wallet balance (only present when balance=true is requested).

▶Show nested fields
confirmed_satsinteger

Confirmed balance in satoshis.

unconfirmed_satsinteger

Unconfirmed balance in satoshis.

confirmed_fiatnumber

Confirmed balance in fiat currency.

unconfirmed_fiatnumber

Unconfirmed balance in fiat currency.

fiat_currencystring

Fiat currency code.

total_addressesinteger

Total number of derived addresses.

Example object

{
  "id": 0,
  "name": "",
  "emailid": "",
  "http_callback": "",
  "wallets": [
    {
      "id": 0,
      "name": "",
      "emailid": "",
      "crypto": "",
      "address": "",
      "xpub_index": 0,
      "gap_limit": 0,
      "created_at": "2024-01-01T00:00:00Z",
      "balance": {
        "confirmed_sats": 0,
        "unconfirmed_sats": 0,
        "confirmed_fiat": 0,
        "unconfirmed_fiat": 0,
        "fiat_currency": "",
        "total_addresses": 0
      }
    }
  ]
}