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
- Open shopify-app.bruce.money.
- Install on a development (or production) store via OAuth with your Shopify Partner app credentials.
- Open
/app?shop=your-store.myshopify.comand paste your Bruce API key (bk_live_…) and webhook signing secret. - 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
- On unpaid Bruce orders (or draft order “Buy with Bruce”), the app creates a checkout session.
- Buyer is redirected to
payUrl. - Webhooks tag the order
bruce-funded/ mark paid oncheckout.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.