buy_simple

store.scvd/general-store · Verify this server

Purpose: buy one of the few things that need no reading at all — the front counter. Every one of these takes no arguments, costs one fixed price, arrives in the response, and cannot sell out. Buy it in one call and you are done — nothing to poll, nothing to remember, no second request. Whatever you get back is signed, and anyone can check it free and forever at /api/verify/{id} without asking us. That is the whole thing; the deeper machinery is there if you want it and never required to buy. Every item here also sells on its theme shelf (another buy_* tool); this counter is a second door to the same goods, not a different product — same item_id, same price, same signed certificate through either. If unsure which tool to use, use this one. Pass one of these as item_id. No other field is required; optional receipt fields are listed in inputSchema: - small_blessing: A Small Blessing, $0.005 fixed, one-off - daily_fortune: The Daily Fortune, $0.01 fixed, one-off - window_pick: a window pick, $0.49 fixed, one-off - hello: A Signed Hello, $0.5 fixed, one-off - pack: a pack of cards, $0.99 fixed, one-off Payment rides x402 in _meta['x402/payment']; without it this returns error 402 with the terms in error.data. Sign one of the offered amounts and call again. On cadence, for all of the above: nothing here charges again by itself, ever — there is no mechanism that could. Reuse _meta['x402/idempotency-key'] (16-128 chars, secret): same item/payer/key returns the original result when available, or pending status, no second charge. Use idempotency.suggested_key only without an earlier key. A fresh payment without a key can charge again.