{"version":1,"prepare":"/api/commerce/proposals","read":"/api/commerce/proposals/{id}","confirm":"/api/commerce/proposals/{id}/confirm","execute":"/api/commerce/proposals/{id}/execute","authentication_required":true,"confirmation":"Authenticated owner session only. Agents cannot confirm.","integration_prepare":"/api/integrations/commerce/proposals?recipient={recipient}","confirmation_expires_minutes":15,"request_schema":{"additionalProperties":false,"properties":{"listing_id":{"maxLength":128,"minLength":1,"title":"Listing Id","type":"string"},"quantity":{"default":1,"maximum":100,"minimum":1,"title":"Quantity","type":"integer"},"answers":{"additionalProperties":{"anyOf":[{"type":"string"},{"type":"boolean"},{"type":"integer"},{"type":"number"}]},"maxProperties":30,"title":"Answers","type":"object"},"shipping_address":{"default":"","maxLength":1000,"title":"Shipping Address","type":"string"},"payment_source":{"default":"card","enum":["card","wallet"],"title":"Payment Source","type":"string"},"save_payment_method":{"default":false,"title":"Save Payment Method","type":"boolean"},"payment_terms_version":{"default":"","maxLength":100,"title":"Payment Terms Version","type":"string"},"attribution_token":{"anyOf":[{"maxLength":128,"type":"string"},{"type":"null"}],"default":null,"title":"Attribution Token"},"idempotency_key":{"maxLength":128,"minLength":1,"title":"Idempotency Key","type":"string"}},"required":["listing_id","idempotency_key"],"title":"ProposalInput","type":"object"},"retry":"Reuse the same idempotency key. Only order status paid confirms payment.","payment":"Wallet or SEC hosted card checkout. Card authentication may be required."}