Build with Bruce.

Two APIs

Bruce has two separate API surfaces. Pick the one that matches who holds the money.

• Merchant Public API (/api/v1). A business authenticates with an X-Api-Key: bk_live_… key or a bat_… OAuth token to run checkout, invoices, escrow, and webhooks. Delegated agent keys spend from the owner's balance under caps.
• Agent account API (/api/agent-auth plus the logged-in /api routes). An AI agent opens its own account with a P-256 key, logs in for a bas_… session, and signs every payment. Bruce never holds that key. Guide: Agent-native accounts.

Both surfaces are in the same OpenAPI spec, with separate security schemes.

Documentation

Guides, API reference, escrow concepts, and plugin install steps are on the docs site (light/dark, searchable).

• Agent payments

  AI agents: instant + escrow USDC, MCP, x402, AP2, A2A.

• Agent-native accounts

  An agent opens its own account with a P-256 key and signs every payment.

• Quickstart

  API key → checkout session → Buy with Bruce in minutes.

• Checkout sessions

  Escrow-only Public API for merchant payments.

• Webhooks

  HMAC-signed funded / released events with retries.

• HTML button

  Drop Buy with Bruce on any storefront.

• WooCommerce

  Official WordPress gateway plugin.

• Shopify

  Custom app for escrow checkout on orders.

• Escrow lifecycle

  Funded, accepted, released, disputed - what to do.

• MCP for agents

  Hosted MCP: merchant tools and delegated agent spend.

• ChatGPT connector

  OAuth MCP for balance, history, invoices, and approval-gated pay in chat.

Quick start

1. Create a Business organization (KYB when required).
2. Business hub → API keys → create bk_live_….
3. POST /api/v1/checkout-sessions with X-Api-Key (settlement is always escrow).
4. Send the buyer to returned payUrl (bruce.money/checkout/…).
5. Handle checkout.funded then checkout.released (legacy alias checkout.paid = released). Verify X-Bruce-Signature.

Step-by-step with curl samples: docs.bruce.money/get-started/quickstart.

Buy with Bruce button

Create the session on your server, then drop this on any HTML site. Details: HTML button docs.

<a
  class="bruce-pay-button"
  href="https://bruce.money/checkout/CHECKOUT_ID"
  data-bruce-amount="25.00"
  data-bruce-label="Buy with Bruce"
>
  Buy with Bruce
</a>
<script async src="https://bruce.money/embed/pay-button.js"></script>

Or share https://bruce.money/b/your-slug after setting a pay slug on your org.

Plugins

Download the WooCommerce gateway or install the Shopify custom app, then follow docs for API keys and webhooks.

Download WooCommerce ZIPInstall Shopify app

Guides: WooCommerce / WordPress · Shopify

MCP (agents)

Hosted endpoint https://mcp.bruce.money/mcp serves one catalog: merchant tools (checkouts, invoices, escrow, webhooks) and delegated agent spend (balance, pay, approval). Consent: Connect Bruce MCP. Tool list: docs.bruce.money/mcp/tools.

OpenAPI & fees

Spec: docs.bruce.money/openapi-v1.json · mirror on bruce.money

GET https://api.bruce.money/api/fees/quote?source=escrow&amount=100.00 - fee docs

Browse all docs · Business hub · Partner with us