WooCommerce / WordPress

Official gateway plugin for escrow-backed Buy with Bruce checkout.

Download plugin (ZIP) Developers doorway

Direct download Hosted zip: https://docs.bruce.money/downloads/bruce-escrow-checkout.zip - upload in WordPress → Plugins → Add New → Upload Plugin.

Install

  1. Download bruce-escrow-checkout.zip.
  2. WordPress Admin → Plugins → Add New → Upload Plugin → choose the zip → Install → Activate.
  3. Requires WordPress 6+ and WooCommerce 8+.
  4. WooCommerce → Settings → Payments → Buy with Bruce.

Configure

  1. Enable the gateway.
  2. Paste API key (bk_live_…) from the Bruce Business hub.
  3. Paste merchant webhook signing secret from Bruce Business hub.
  4. Copy the shown webhook URL into Bruce if you override delivery (plugin registers /wc-api/bruce_escrow).
  5. Choose escrow template (freelance / physical / digital).
  6. Complete order on checkout.released (default).

Flow

sequenceDiagram
  participant Buyer
  participant Woo as WooCommerce
  participant Bruce as Bruce checkout
  participant Escrow as On-chain escrow
  Buyer->>Woo: Choose Buy with Bruce
  Woo->>Bruce: Create checkout session
  Buyer->>Bruce: Open payUrl
  Buyer->>Escrow: Fund USDC
  Bruce-->>Woo: checkout.funded
  Note over Woo: Start fulfillment
  Bruce-->>Woo: checkout.released
  Note over Woo: Mark order paid
  1. Buyer selects Buy with Bruce at checkout.
  2. Plugin creates a Bruce session with orderId, shopDomain, redirectUrl.
  3. Buyer redirects to payUrl, funds escrow.
  4. checkout.funded → order processing; checkout.released → payment complete.

WordPress shortcode

Without Woo: [bruce_buy amount="25" description="Tip jar"] creates a session server-side and renders the button.

Download bruce-escrow-checkout.zip