Bruce
Sign in

WooCommerce / WordPress

Official gateway plugin for escrow checkout.

Install

  1. Upload the bruce-escrow-checkout plugin zip from the repo (plugins/woocommerce).
  2. Activate — requires WordPress 6+ and WooCommerce 8+.
  3. WooCommerce → Settings → Payments → Buy with Bruce.

Configure

  1. Enable the gateway.
  2. Paste API key (bk_live_…).
  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

  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.