Escrow lifecycle

How funds move from buyer → escrow → merchant.

Event	Meaning	Merchant action
`checkout.funded`	Buyer deposited USDC into escrow	Start fulfillment / mark awaiting delivery
`checkout.accepted`	Seller accepted (when required)	—
`checkout.released`	Funds paid to merchant	Mark order paid
`checkout.disputed`	Dispute opened	Pause fulfillment
`checkout.refunded` / `cancelled`	Buyer refunded or deal cancelled	Cancel order
`checkout.paid`	Alias of released	Legacy listeners only

Do not treat deposit as paid checkout.paid is never fired on fund. Use checkout.funded for “money is secured” and checkout.released for settlement.

Templates

freelance — services, review window (default)
physical — products, longer release + inspection
digital — short inspection / auto-release
custom — flexible defaults

Pass escrowTemplateId when creating a session.