Shopify

Bruce Escrow Checkout custom app for order redirect + webhooks.

Install / open Shopify app This guide

Install URL Open https://shopify-app.bruce.money to start OAuth / configure your store. Not a downloadable zip - Shopify apps install via Partner OAuth.

Install

  1. Open shopify-app.bruce.money.
  2. Install on a development (or production) store via OAuth with your Shopify Partner app credentials.
  3. Open /app?shop=your-store.myshopify.com and paste your Bruce API key (bk_live_…) and webhook signing secret.
  4. Point Bruce merchant webhooks at the URL shown in the app (e.g. …/webhooks/bruce?shop=…).

Flow

sequenceDiagram
  participant Buyer
  participant Shopify
  participant App as shopify-app.bruce.money
  participant Bruce as Bruce checkout
  Buyer->>Shopify: Checkout / draft Buy with Bruce
  Shopify->>App: Create session
  App->>Bruce: POST checkout-sessions
  Buyer->>Bruce: Fund escrow
  Bruce-->>App: checkout.funded / released
  App-->>Shopify: Tag / mark paid
  1. On unpaid Bruce orders (or draft order “Buy with Bruce”), the app creates a checkout session.
  2. Buyer is redirected to payUrl.
  3. Webhooks tag the order bruce-funded / mark paid on checkout.released.

Metafields

Session id and escrow status are stored on the order for support and retries. Prefer webhook truth over thank-you page alone.

App Store listing v1 ships as a custom/unlisted app at shopify-app.bruce.money. Official Shopify App Store submission follows after production webhook volume is stable.

Open Shopify app