Merchants

Register a merchant

string

required

Display name of the business, e.g. "Acme Digital Goods".

POST /merchants
Authorization: Bearer <console_jwt>   # console-only

// 201 Created
{
  "merchantId": "mch_c8fdac10d39c0c4d",
  "apiKey": "sk_mch_3dc34f4326fa081f02b1e552a91b4696bb541572cbe89b23"
}

apiKey is displayed exactly once. Only its SHA-256 hash is stored.

List my merchants (console)

Every business registered under your workspace, newest first. Powers the business switcher in the console.

GET /merchants
Authorization: Bearer <console_jwt>

// 200 OK
{
  "merchants": [
    {
      "id": "mch_c8fdac10d39c0c4d",
      "name": "Acme Digital Goods",
      "balance_minor": 200,
      "currency": "USD",
      "payout_address": null,
      "created_at": "2026-08-23T09:45:47.816Z",
      "paid_charges": 3
    }
  ]
}

Each entry carries balance_minor (USD cents) and paid_charges so the overview can render without an extra call per business. The sk_mch_ key is not returned here; it lives only in the caller’s storage.

Get my balance

GET /merchant/me
Authorization: Bearer sk_mch_...

// 200 OK
{
  "merchant": {
    "id": "mch_c8fdac10d39c0c4d",
    "name": "Acme Digital Goods",
    "balanceMinor": 200,
    "currency": "USD",
    "payoutAddress": null
  }
}

balanceMinor is USD cents. It increases every time one of your charges is paid.

Set payout address

Where settled money goes. The address is screened automatically (KYT); blocked addresses are rejected with 403.

PUT /merchant/payout-address
Authorization: Bearer sk_mch_...
Content-Type: application/json

{ "address": "0xYourWalletAddress..." }

// 200 OK
{ "ok": true, "kyt": { "verdict": "pass", "reason": "no_blocklist_hit" } }

Errors:

Status	Meaning
`400`	Not a valid EVM address (`/^0x[a-fA-F0-9]{40}$/`).
`403`	Address flagged by KYT screening; includes the `verdict`.

List my charges

Last 100 charges, newest first.

GET /merchant/charges
Authorization: Bearer sk_mch_...

{ "charges": [ { "chargeId": "...", "...": "..." } ] }

See the charge object for field details.

Screen an address (console)

Standalone KYT screening; useful before paying out to an arbitrary address.

POST /kyt/screen
Authorization: Bearer <console_jwt>
Content-Type: application/json

{ "address": "0x...", "chain": "base" }

{ "verdict": "pass", "reason": "no_blocklist_hit" }

Export transactions (console)

Accounting export straight from the audit chain; every row carries its sequence number and event hash.

GET /export/transactions.csv?from=2026-08-01&to=2026-08-31
Authorization: Bearer <console_jwt>

Defaults to the last 30 days when no range is given. Response is text/csv.

​Merchants

​Register a merchant

​List my merchants (console)

​Get my balance

​Set payout address

​List my charges

​Screen an address (console)

​Export transactions (console)

Merchants

Register a merchant

List my merchants (console)

Get my balance

Set payout address

List my charges

Screen an address (console)

Export transactions (console)