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
- Download
bruce-escrow-checkout.zip. - WordPress Admin → Plugins → Add New → Upload Plugin → choose the zip → Install → Activate.
- Requires WordPress 6+ and WooCommerce 8+.
- WooCommerce → Settings → Payments → Buy with Bruce.
Configure
- Enable the gateway.
- Paste API key (
bk_live_…) from the Bruce Business hub. - Paste merchant webhook signing secret from Bruce Business hub.
- Copy the shown webhook URL into Bruce if you override delivery (plugin registers
/wc-api/bruce_escrow). - Choose escrow template (freelance / physical / digital).
- 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
- Buyer selects Buy with Bruce at checkout.
- Plugin creates a Bruce session with
orderId,shopDomain,redirectUrl. - Buyer redirects to
payUrl, funds escrow. 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.