Direct API Checkout

Walk through the full escrow lifecycle using only API calls via the /api/partner/transactions/* headless API. Each step shows the endpoint, body, and response.

Transaction Parameters

Title

Price

Currency

Fee Strategy

Buyer Email

Seller Email

1partnerCreate Checkout Session

Partner creates a checkout session server-side. Seeds transaction data, buyer/seller emails. Returns a session token and URLs.

POSTPOST /api/partner/checkout/sessions

2buyerBuyer: Initiate Payment

Start the payment flow on behalf of the buyer. In sandbox mode this completes immediately. Returns a paymentUuid for confirmation.

POSTPOST /api/partner/transactions/:uuid/buyer/pay

3buyerBuyer: Confirm Payment

Capture the payment after buyer approval. Advances the transaction to 'funded' — money is now in escrow.

POSTPOST /api/partner/transactions/:uuid/buyer/confirm

4sellerSeller: Mark Shipped

Seller marks the item as shipped with tracking info. Advances to 'shipped'. Fires the checkout_session.shipped webhook.

POSTPOST /api/partner/transactions/:uuid/seller/mark-shipped

5buyerBuyer: Mark Received

Buyer confirms receipt. Starts the inspection window (default 3 days). Transaction moves to 'inspection'.

POSTPOST /api/partner/transactions/:uuid/buyer/mark-received

6buyerBuyer: Accept & Release Funds

Buyer approves after inspection. Releases escrowed funds to the seller. Transaction is now 'completed'.

POSTPOST /api/partner/transactions/:uuid/buyer/accept-inspection