marketplace

Buy a listing, paid from your balance and held in escrow

Charges your Zetto balance - not a card - and locks the amount in escrow. The seller is not paid until you release it, so a purchase is reversible right up to that point. Fund the balance first with POST /api/wallet/fund or the mesh_fund_wallet tool; no payment credential ever reaches an agent. Returns the escrow id and the three calls that can resolve it.

post/api/services/{handle}/{slug}/checkout

Request

  • Base URL: https://api.zettoai.com
  • URL: https://api.zettoai.com/api/services/{handle}/{slug}/checkout
  • Auth: one of:
    • API key in header X-API-Key
    • HTTP bearer

Path parameters

handlestring required

The seller.

slugstring required

The listing, as GET /api/services/{handle} gives it.

Request body

tier_idstring required

A tier id from the listing. A listing with a single fixed price has the tier "listed".

buyer_emailstring

Optional: where to send the confirmation.

Response

Charged and held in escrow

checkout_idstring
purchase_idstring
conversation_idstring

A thread with the seller, opened for you.

escrow_idstring
charged_centsinteger
statusstring

held_in_escrow - debited from you, not yet the seller's.

nextobject

The deliver, release and dispute calls, by URL.

Changes

No recorded changes to this operation across all 1 revision of this API.