List a shop's orders
Every order a customer opened against this shop, newest first. An order is recorded when the checkout is opened and marked `paid` only when the provider reports the session settled — putty never marks one paid on its own.
Every order a customer opened against this shop, newest first. An order is recorded when the checkout is opened and marked paid only when the provider reports the session settled — putty never marks one paid on its own.
Authorization
bearerAuth A bearer token. The Account routes accept a Privy access token; the MCP transport accepts an sk- API key issued by POST /account/api-keys.
In: header
Path Parameters
The shop's id.
Response Body
application/json
application/json
application/json
curl -X GET "https://example.com/business/shops/string/checkouts"{ "checkouts": [ { "id": "string", "method": "card", "stablecoin": "string", "lines": [ { "productId": "string", "name": "string", "quantity": 1, "unitPriceUsd": "string" } ], "totalUsd": "string", "providerSessionId": "string", "checkoutUrl": "http://example.com", "state": "open", "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z" } ]}Read a shop's takings GET
How many orders the shop has taken and what they came to, split by how the customer paid. `grossUsd` is the shopkeeper's own figure. putty takes no cut of a shop's off-chain takings: the plan is explicit that the buyback share comes from plan revenue, not from a Business Kit merchant's sales. Nothing in this route is a revenue number for putty.
Read one order GET
The order's record: the cart as it was, the total, the payment provider's own session id, and whether the provider has reported it settled. An order on another shopkeeper's shop returns the same 404 as one that does not exist.