{"shop":{"name":"Demo Store Local","domain":"demostorelink.demodomain999.io","platform":"shopify"},"version":1,"requirements":{"version":1,"platform":"shopify","requiresVariantId":true,"fields":[{"key":"customer.email","type":"string","required":true,"description":"Buyer email"},{"key":"qty","type":"integer","required":false,"default":1,"description":"Quantity of units (default 1)"},{"key":"variantId","type":"string","required":true,"description":"Variant ID (size/color)"},{"key":"customer.name","type":"string","required":false},{"key":"customer.phone","type":"string","required":false},{"key":"customer.address1","type":"string","required":false},{"key":"customer.address2","type":"string","required":false},{"key":"customer.city","type":"string","required":false},{"key":"customer.province","type":"string","required":false},{"key":"customer.zip","type":"string","required":false},{"key":"customer.country","type":"string","required":false}],"headers":{"Idempotency-Key":{"type":"string","format":"uuid","required":true,"description":"Unique per request. Reuse with identical body to safely retry."},"Content-Type":{"type":"string","enum":["application/json"],"required":true}}},"jsonSchema":{"$schema":"http://json-schema.org/draft-07/schema#","$ref":"#/definitions/CheckoutCreate","definitions":{"CheckoutCreate":{"type":"object","properties":{"domain":{"type":"string","minLength":1},"productId":{"type":"string","minLength":1},"variantId":{"type":"string"},"qty":{"type":"integer","exclusiveMinimum":0,"default":1},"customer":{"type":"object","properties":{"email":{"type":"string","format":"email"},"name":{"type":"string"},"phone":{"type":"string"},"address1":{"type":"string"},"address2":{"type":"string"},"city":{"type":"string"},"province":{"type":"string"},"zip":{"type":"string"},"country":{"type":"string"}},"required":["email"],"additionalProperties":false},"sendEmail":{"type":"boolean"}},"required":["domain","productId","customer"],"additionalProperties":false}},"required":["domain","productId","customer","variantId"]},"policies":{"auth":{"modes":["public"],"public_scope":"draft-only"},"idempotency":{"required":true,"header":"Idempotency-Key","replayHeader":"Idempotent-Replay","conflictStatus":409,"notes":"Same key + same body → 200 with Idempotent-Replay:true. Same key + different body → 409."},"rateLimit":{"rpm":10,"burst":20,"headers":true,"headerNames":{"limit":"X-RateLimit-Limit","remaining":"X-RateLimit-Remaining","reset":"X-RateLimit-Reset","retryAfter":"Retry-After"}},"retry":{"policy":"exponential","baseMs":500,"maxAttempts":3,"onStatus":[502,503,504,522,524,408],"doNotRetry":[400,401,403,404,409,422]}},"steps":[{"step":1,"action":"GET products sitemap","url":"/api/sitewai/demostorelink.demodomain999.io"},{"step":2,"action":"Pick product & variant","note":"Use urls.checkout per-variant if available"},{"step":3,"action":"POST checkout create","url":"/api/checkout/create","requiredHeaders":["Idempotency-Key","Content-Type: application/json"]}],"example":{"headers":{"Idempotency-Key":"00000000-0000-4000-8000-000000000000","Content-Type":"application/json"},"body":{"domain":"demostorelink.demodomain999.io","productId":"PRODUCT_ID","qty":1,"customer":{"email":"buyer@example.com","name":"Name Lastname","phone":"+1...","address1":"Street 1234","city":"City","province":"State","zip":"90210","country":"US"},"sendEmail":true,"variantId":"VARIANT_ID"}},"curl":"curl -X POST \"https://sitewai.com/api/checkout/create\"   -H \"Content-Type: application/json\"   -H \"Idempotency-Key: $(uuidgen)\"   -d '{\"domain\":\"demostorelink.demodomain999.io\",\"productId\":\"PRODUCT_ID\",\"qty\":1,\"customer\":{\"email\":\"buyer@example.com\",\"name\":\"Name Lastname\",\"phone\":\"+1...\",\"address1\":\"Street 1234\",\"city\":\"City\",\"province\":\"State\",\"zip\":\"90210\",\"country\":\"US\"},\"sendEmail\":true,\"variantId\":\"VARIANT_ID\"}'","errors":{"format":{"ok":false,"error":"validation_error|request_error","code":"string","message":"string","retryable":false,"traceId":"string","timestamp":"ISO-8601"},"codes":["missing_idempotency_key","validation_error","variant_required_for_shopify","product_not_found_for_domain","shopify_draft_error","woo_order_error","idempotency_key_mismatch","rate_limited","abuse_guard_email"]}}