Build a Marketplace with Ishtaran
Alice buys from Bob through Mercatto. Ishtaran holds the payment until delivery is confirmed, then splits it between the seller and the marketplace — an executable Business Case, not a slide deck.
Architecture
The full sequence — every real SDK call Mercatto makes, and which Ishtaran module handles it underneath.
Setup
Mercatto signs up — one call provisions everything it needs to start integrating.
Seller onboarding
Bob and Alice each get their own financial identity — Mercatto never controls their login.
Creating an order
The order's lifecycle becomes a Workflow, and the Transaction declares exactly who gets what.
Accepting payment
Mercatto opens a Payment Intent and gets back a real deposit address for Alice to pay.
Holding funds
Reservation is like putting money in a labeled box: it's there, it's real, but it can't be spent yet.
Confirming delivery
Ishtaran has no way to know the headphones arrived — Mercatto has to tell it.
Settlement and Split
Ishtaran opens the box: computes the Platform Fee, then splits the rest exactly the way the order said it should.
Partial Settlement
Mercatto doesn't have to release everything at once — it can settle in installments, on its own schedule.
Seller balance
Bob has money now — but he doesn't check it himself; Mercatto's own dashboard does, the same way a real marketplace works.
Withdrawal
Bob wants his money out — and hits a real, deliberate 24-hour security cooldown, proven live, never bypassed.
Batched payout: the other real PayoutPolicy
The other real PayoutPolicy: Manual. A Settlement accrues a Payable instead of paying immediately, and a separate PayoutBatch call is what actually moves the money — when to use each, and the real bootstrap it needs.
Failure scenarios
11 real alternative paths — onboarding, payment, workflow, and settlement edge cases — each live-executed against a real instance, not simulated.
Full source
Every file, one page — the exact code this whole tutorial and the release-gating E2E suite share.
Known limitations
Every real platform limitation this Business Case ran into, in one place — referenced throughout the tutorial, never hidden.
Run it yourself
Run this exact story against the real public Sandbox — real IDs, real balances, real responses.