{"openapi":"3.1.0","info":{"title":"StableMerch API","description":"UCP custom merch API for making custom shirts, heavyweight shirts, and mugs from provided images. Agents create UCP carts that contain Printify preview media for the client UI to render, then complete x402 or mpp checkout after approval. Supports optional referral commissions added on top of the base price.","version":"1.0.0","x-guidance":"\n# StableMerch API\n\nStableMerch implements UCP Shopping for custom shirts, heavyweight shirts, and mugs from buyer-provided images. The UCP profile is at /.well-known/ucp and the UCP REST service endpoint is /api/ucp.\n\n## Products\n\nProduct IDs are:\n- shirt\n- heavyweight-shirt\n- mug\n\nUse GET /api/ucp/catalog, or GET /api/catalog, to inspect supported variants, options, and base prices before creating a cart.\n\n## Preferred Flow\n\n1. POST /api/ucp/carts with SIWX to create a preview cart.\n   StableMerch supports one custom merch line item per cart. Use line_items[0].item.id for the product ID and quantity 1. Put custom artwork/options in dev.stablemerch.customization:\n   - client_request_id: idempotency key for this exact cart input\n   - image_url: HTTP/HTTPS URL or base64 data URL\n   - size, color, placement when applicable\n   - optional commission_address and commission_rate\n\n2. Return the cart object to the client. The client UI renders cart.line_items[0].item.image_url and totals. Agents should not download preview images, paste preview URLs, or narrate preview status in chat. Do not ask for shipping/contact details or payment before the user approves the client-rendered preview.\n\n3. POST /api/ucp/checkout-sessions with SIWX after preview approval. For the low-hop path, include cart_id plus UCP buyer and fulfillment in this same request. StableMerch then prepares the Printify manual-approval order and should return ready_for_complete. If a client creates an incomplete checkout first, PUT /api/ucp/checkout-sessions/{id} later with buyer and fulfillment.\n\n4. POST /api/ucp/checkout-sessions/{id}/complete with x402 or mpp only when checkout.status is ready_for_complete. Body may use { \"id\": \"<checkout id>\" } for UCP-style clients or { \"checkout_session_id\": \"<checkout id>\" } for AgentCash checkout-completion clients. The x402/MPP challenge is the source of exact payment terms.\n\n5. Use GET /api/ucp/orders/{orderId} to retrieve the completed UCP order after checkout completion.\n\n## Fulfillment Requirements\n\nCheckout create/update accepts UCP buyer plus fulfillment. StableMerch requires buyer.email and a selected shipping destination with:\n- first_name/last_name or full_name\n- phone_number\n- address_country, address_region, street_address, address_locality, postal_code\n- optional extended_address\n\n## Recovery\n\nUse GET /api/ucp/carts/{id} to recover pre-checkout preview state. PUT the same cart body to retry a failed retryable preview. Create a new cart to change product, artwork, or options after preview generation. Cancel with POST /api/ucp/carts/{id}/cancel before checkout, or POST /api/ucp/checkout-sessions/{id}/cancel before completion. Do not call old draft or direct product endpoints.\n","guidance":"\n# StableMerch API\n\nStableMerch implements UCP Shopping for custom shirts, heavyweight shirts, and mugs from buyer-provided images. The UCP profile is at /.well-known/ucp and the UCP REST service endpoint is /api/ucp.\n\n## Products\n\nProduct IDs are:\n- shirt\n- heavyweight-shirt\n- mug\n\nUse GET /api/ucp/catalog, or GET /api/catalog, to inspect supported variants, options, and base prices before creating a cart.\n\n## Preferred Flow\n\n1. POST /api/ucp/carts with SIWX to create a preview cart.\n   StableMerch supports one custom merch line item per cart. Use line_items[0].item.id for the product ID and quantity 1. Put custom artwork/options in dev.stablemerch.customization:\n   - client_request_id: idempotency key for this exact cart input\n   - image_url: HTTP/HTTPS URL or base64 data URL\n   - size, color, placement when applicable\n   - optional commission_address and commission_rate\n\n2. Return the cart object to the client. The client UI renders cart.line_items[0].item.image_url and totals. Agents should not download preview images, paste preview URLs, or narrate preview status in chat. Do not ask for shipping/contact details or payment before the user approves the client-rendered preview.\n\n3. POST /api/ucp/checkout-sessions with SIWX after preview approval. For the low-hop path, include cart_id plus UCP buyer and fulfillment in this same request. StableMerch then prepares the Printify manual-approval order and should return ready_for_complete. If a client creates an incomplete checkout first, PUT /api/ucp/checkout-sessions/{id} later with buyer and fulfillment.\n\n4. POST /api/ucp/checkout-sessions/{id}/complete with x402 or mpp only when checkout.status is ready_for_complete. Body may use { \"id\": \"<checkout id>\" } for UCP-style clients or { \"checkout_session_id\": \"<checkout id>\" } for AgentCash checkout-completion clients. The x402/MPP challenge is the source of exact payment terms.\n\n5. Use GET /api/ucp/orders/{orderId} to retrieve the completed UCP order after checkout completion.\n\n## Fulfillment Requirements\n\nCheckout create/update accepts UCP buyer plus fulfillment. StableMerch requires buyer.email and a selected shipping destination with:\n- first_name/last_name or full_name\n- phone_number\n- address_country, address_region, street_address, address_locality, postal_code\n- optional extended_address\n\n## Recovery\n\nUse GET /api/ucp/carts/{id} to recover pre-checkout preview state. PUT the same cart body to retry a failed retryable preview. Create a new cart to change product, artwork, or options after preview generation. Cancel with POST /api/ucp/carts/{id}/cancel before checkout, or POST /api/ucp/checkout-sessions/{id}/cancel before completion. Do not call old draft or direct product endpoints.\n","contact":{"name":"Merit Systems","url":"https://stable-merch-gds0imbwo-merit-systems.vercel.app"}},"servers":[{"url":"https://stable-merch-gds0imbwo-merit-systems.vercel.app"}],"tags":[{"name":"Catalog"},{"name":"Ucp"}],"paths":{"/api/ucp/checkout-sessions/{checkoutSessionId}/complete":{"post":{"operationId":"ucp_checkout-sessions_complete","summary":"Pay for a StableMerch UCP checkout session and send its prepared Printify order to production. Requires checkout status ready_for_complete.","tags":["Ucp"],"x-payment-info":{"price":{"mode":"dynamic","currency":"USD","min":"0.01","max":"50.00"},"protocols":[{"x402":{}},{"mpp":{"method":"tempo","intent":"charge","currency":"0x20c000000000000000000000b9537d11c60e8b50"}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"checkout_session_id":{"description":"AgentCash checkout session ID being completed. UCP clients may instead send id.","type":"string","minLength":1},"id":{"description":"UCP checkout session ID being completed. AgentCash clients may instead send checkout_session_id.","type":"string","minLength":1},"payment":{}},"additionalProperties":{}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"buyer":{"type":"object","properties":{"email":{"type":"string"},"first_name":{"type":"string"},"full_name":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"}},"additionalProperties":false},"continue_url":{"type":"string"},"currency":{"type":"string"},"expires_at":{"type":"string"},"fulfillment":{"type":"object","properties":{"available_methods":{"type":"array","items":{"type":"object","properties":{"description":{"type":"string"},"fulfillable_on":{"anyOf":[{"type":"string"},{"type":"null"}]},"line_item_ids":{"type":"array","items":{"type":"string"}},"type":{"type":"string","enum":["pickup","shipping"]}},"required":["line_item_ids","type"],"additionalProperties":false}},"methods":{"type":"array","items":{"type":"object","properties":{"destinations":{"type":"array","items":{"type":"object","properties":{"address_country":{"type":"string"},"address_locality":{"type":"string"},"address_region":{"type":"string"},"extended_address":{"type":"string"},"first_name":{"type":"string"},"full_name":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"},"postal_code":{"type":"string"},"street_address":{"type":"string"},"id":{"type":"string"},"address":{"type":"object","properties":{"address_country":{"type":"string"},"address_locality":{"type":"string"},"address_region":{"type":"string"},"extended_address":{"type":"string"},"first_name":{"type":"string"},"full_name":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"},"postal_code":{"type":"string"},"street_address":{"type":"string"}},"additionalProperties":false},"name":{"type":"string"}},"required":["id"],"additionalProperties":false}},"groups":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"line_item_ids":{"type":"array","items":{"type":"string"}},"options":{"type":"array","items":{"type":"object","properties":{"carrier":{"type":"string"},"description":{"type":"string"},"earliest_fulfillment_time":{"type":"string"},"id":{"type":"string"},"latest_fulfillment_time":{"type":"string"},"title":{"type":"string"},"totals":{"type":"array","items":{"type":"object","properties":{"amount":{"type":"number"},"display_text":{"type":"string"},"type":{"type":"string","enum":["discount","fee","fulfillment","items_discount","subtotal","tax","total"]}},"required":["amount","type"],"additionalProperties":false}}},"required":["id","title","totals"],"additionalProperties":false}},"selected_option_id":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","line_item_ids"],"additionalProperties":false}},"id":{"type":"string"},"line_item_ids":{"type":"array","items":{"type":"string"}},"selected_destination_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"type":{"type":"string","enum":["pickup","shipping"]}},"required":["id","line_item_ids","type"],"additionalProperties":false}}},"additionalProperties":false},"id":{"type":"string"},"line_items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"item":{"type":"object","properties":{"id":{"type":"string"},"image_url":{"type":"string"},"price":{"type":"number"},"title":{"type":"string"}},"required":["id","price","title"],"additionalProperties":false},"parent_id":{"type":"string"},"quantity":{"type":"number"},"totals":{"type":"array","items":{"type":"object","properties":{"amount":{"type":"number"},"display_text":{"type":"string"},"type":{"type":"string","enum":["discount","fee","fulfillment","items_discount","subtotal","tax","total"]}},"required":["amount","type"],"additionalProperties":false}}},"required":["id","item","quantity","totals"],"additionalProperties":false}},"links":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"type":{"type":"string"},"url":{"type":"string"}},"required":["type","url"],"additionalProperties":false}},"messages":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"content":{"type":"string"},"content_type":{"type":"string","enum":["markdown","plain"]},"path":{"type":"string"},"severity":{"type":"string","enum":["recoverable","requires_buyer_input","requires_buyer_review"]},"type":{"type":"string","enum":["error","info","warning"]}},"required":["content","type"],"additionalProperties":false}},"order":{"type":"object","properties":{"id":{"type":"string"},"permalink_url":{"type":"string"}},"required":["id","permalink_url"],"additionalProperties":false},"payment":{"type":"object","properties":{"handlers":{"type":"array","items":{"type":"object","properties":{"config":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"config_schema":{"type":"string"},"id":{"type":"string"},"instrument_schemas":{"type":"array","items":{"type":"string"}},"name":{"type":"string"},"spec":{"type":"string"},"version":{"type":"string"}},"required":["config","config_schema","id","instrument_schemas","name","spec","version"],"additionalProperties":false}},"instruments":{"type":"array","items":{"type":"object","properties":{"handler_id":{"type":"string"},"id":{"type":"string"},"type":{"type":"string"}},"required":["handler_id","id","type"],"additionalProperties":{}}},"selected_instrument_id":{"type":"string"}},"required":["handlers"],"additionalProperties":false},"status":{"type":"string","enum":["canceled","complete_in_progress","completed","incomplete","ready_for_complete","requires_escalation"]},"totals":{"type":"array","items":{"type":"object","properties":{"amount":{"type":"number"},"display_text":{"type":"string"},"type":{"type":"string","enum":["discount","fee","fulfillment","items_discount","subtotal","tax","total"]}},"required":["amount","type"],"additionalProperties":false}},"ucp":{"type":"object","properties":{"capabilities":{"type":"array","items":{"type":"object","properties":{"config":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"extends":{"type":"string"},"name":{"type":"string"},"schema":{"type":"string"},"spec":{"type":"string"},"version":{"type":"string"}},"required":["name","version"],"additionalProperties":false}},"version":{"type":"string"}},"required":["capabilities","version"],"additionalProperties":false}},"required":["currency","id","line_items","links","payment","status","totals","ucp"],"additionalProperties":{}}}}},"402":{"description":"Payment Required"}}}},"/api/catalog":{"get":{"operationId":"catalog_list","summary":"List StableMerch product templates, variants, and base prices available for the free catalog-to-cart-to-checkout flow.","tags":["Catalog"],"security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"products":{"type":"array","items":{"type":"object","properties":{"product_slug":{"type":"string","enum":["shirt","heavyweight-shirt","mug"]},"title":{"type":"string"},"description":{"type":"string"},"price":{"type":"string"},"blueprint_id":{"type":"number"},"print_provider_id":{"type":"number"},"variants":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"size":{"type":"string"},"color":{"type":"string"},"title":{"type":"string"},"available":{"type":"boolean"}},"required":["id","title","available"],"additionalProperties":false}},"default_options":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}}},"required":["product_slug","title","description","price","blueprint_id","print_provider_id","variants","default_options"],"additionalProperties":false}}},"required":["products"],"additionalProperties":false}}}}}}},"/api/ucp/catalog":{"get":{"operationId":"ucp_catalog_list","summary":"List StableMerch product templates, variants, and base prices as the free UCP catalog entry point before creating a cart.","tags":["Ucp"],"security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"products":{"type":"array","items":{"type":"object","properties":{"product_slug":{"type":"string","enum":["shirt","heavyweight-shirt","mug"]},"title":{"type":"string"},"description":{"type":"string"},"price":{"type":"string"},"blueprint_id":{"type":"number"},"print_provider_id":{"type":"number"},"variants":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"size":{"type":"string"},"color":{"type":"string"},"title":{"type":"string"},"available":{"type":"boolean"}},"required":["id","title","available"],"additionalProperties":false}},"default_options":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}}},"required":["product_slug","title","description","price","blueprint_id","print_provider_id","variants","default_options"],"additionalProperties":false}}},"required":["products"],"additionalProperties":false}}}}}}},"/api/ucp/carts":{"post":{"operationId":"ucp_carts_create","summary":"Create or resume a UCP cart for one custom StableMerch item. Use line_items[0].item.id for the product id and dev.stablemerch.customization for artwork/options. StableMerch generates a Printify mockup preview before checkout.","tags":["Ucp"],"security":[{"siwx":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"attribution":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"buyer":{"type":"object","properties":{"email":{"type":"string"},"first_name":{"type":"string"},"full_name":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"}}},"context":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"line_items":{"minItems":1,"type":"array","items":{"type":"object","properties":{"item":{"type":"object","properties":{"id":{"type":"string"}},"required":["id"],"additionalProperties":{}},"quantity":{"type":"integer","minimum":1,"maximum":9007199254740991}},"required":["item","quantity"],"additionalProperties":{}}},"signals":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"dev.stablemerch.customization":{"type":"object","properties":{"client_request_id":{"type":"string","minLength":8,"maxLength":128,"pattern":"^[A-Za-z0-9._:-]+$","description":"StableMerch idempotency key for this exact custom merch cart."},"image_url":{"type":"string","minLength":1,"description":"HTTP/HTTPS URL or base64 data URL (data:image/...)"},"size":{"type":"string","enum":["S","M","L","XL","2XL","3XL","4XL","5XL","7XL"]},"color":{"type":"string"},"placement":{"type":"string","enum":["front","back"]},"commission_address":{"description":"EVM address to receive the commission. Must be provided together with commission_rate.","type":"string"},"commission_rate":{"description":"Commission as a decimal (e.g. 0.1 = 10%). Added on top of the base price — the buyer pays base + (base × rate).","type":"number","exclusiveMinimum":0,"exclusiveMaximum":1}},"required":["client_request_id","image_url"],"description":"StableMerch customization data for the UCP cart line item. UCP line_items identify what is being purchased; this extension identifies the buyer-provided artwork and merch options."}},"required":["line_items","dev.stablemerch.customization"],"additionalProperties":{},"description":"UCP cart create request. StableMerch supports one custom merch line item per cart; put product id in line_items[0].item.id and artwork/options in dev.stablemerch.customization."}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"attribution":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"buyer":{"type":"object","properties":{"email":{"type":"string"},"first_name":{"type":"string"},"full_name":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"}},"additionalProperties":false},"context":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"continue_url":{"type":"string"},"currency":{"type":"string"},"expires_at":{"type":"string"},"id":{"type":"string"},"line_items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"item":{"type":"object","properties":{"id":{"type":"string"},"image_url":{"type":"string"},"price":{"type":"number"},"title":{"type":"string"}},"required":["id","price","title"],"additionalProperties":false},"parent_id":{"type":"string"},"quantity":{"type":"number"},"totals":{"type":"array","items":{"type":"object","properties":{"amount":{"type":"number"},"display_text":{"type":"string"},"type":{"type":"string","enum":["discount","fee","fulfillment","items_discount","subtotal","tax","total"]}},"required":["amount","type"],"additionalProperties":false}}},"required":["id","item","quantity","totals"],"additionalProperties":false}},"links":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"type":{"type":"string"},"url":{"type":"string"}},"required":["type","url"],"additionalProperties":false}},"messages":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"content":{"type":"string"},"content_type":{"type":"string","enum":["markdown","plain"]},"path":{"type":"string"},"severity":{"type":"string","enum":["recoverable","requires_buyer_input","requires_buyer_review"]},"type":{"type":"string","enum":["error","info","warning"]}},"required":["content","type"],"additionalProperties":false}},"signals":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"totals":{"type":"array","items":{"type":"object","properties":{"amount":{"type":"number"},"display_text":{"type":"string"},"type":{"type":"string","enum":["discount","fee","fulfillment","items_discount","subtotal","tax","total"]}},"required":["amount","type"],"additionalProperties":false}},"ucp":{"type":"object","properties":{"capabilities":{"type":"array","items":{"type":"object","properties":{"config":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"extends":{"type":"string"},"name":{"type":"string"},"schema":{"type":"string"},"spec":{"type":"string"},"version":{"type":"string"}},"required":["name","version"],"additionalProperties":false}},"version":{"type":"string"}},"required":["capabilities","version"],"additionalProperties":false}},"required":["currency","id","line_items","totals","ucp"],"additionalProperties":{}}}}},"402":{"description":"Authentication Required"}}}},"/api/ucp/carts/{cartId}":{"get":{"operationId":"ucp_carts_get","summary":"Retrieve a UCP cart and its generated StableMerch preview state by cart ID.","tags":["Ucp"],"security":[{"siwx":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"attribution":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"buyer":{"type":"object","properties":{"email":{"type":"string"},"first_name":{"type":"string"},"full_name":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"}},"additionalProperties":false},"context":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"continue_url":{"type":"string"},"currency":{"type":"string"},"expires_at":{"type":"string"},"id":{"type":"string"},"line_items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"item":{"type":"object","properties":{"id":{"type":"string"},"image_url":{"type":"string"},"price":{"type":"number"},"title":{"type":"string"}},"required":["id","price","title"],"additionalProperties":false},"parent_id":{"type":"string"},"quantity":{"type":"number"},"totals":{"type":"array","items":{"type":"object","properties":{"amount":{"type":"number"},"display_text":{"type":"string"},"type":{"type":"string","enum":["discount","fee","fulfillment","items_discount","subtotal","tax","total"]}},"required":["amount","type"],"additionalProperties":false}}},"required":["id","item","quantity","totals"],"additionalProperties":false}},"links":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"type":{"type":"string"},"url":{"type":"string"}},"required":["type","url"],"additionalProperties":false}},"messages":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"content":{"type":"string"},"content_type":{"type":"string","enum":["markdown","plain"]},"path":{"type":"string"},"severity":{"type":"string","enum":["recoverable","requires_buyer_input","requires_buyer_review"]},"type":{"type":"string","enum":["error","info","warning"]}},"required":["content","type"],"additionalProperties":false}},"signals":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"totals":{"type":"array","items":{"type":"object","properties":{"amount":{"type":"number"},"display_text":{"type":"string"},"type":{"type":"string","enum":["discount","fee","fulfillment","items_discount","subtotal","tax","total"]}},"required":["amount","type"],"additionalProperties":false}},"ucp":{"type":"object","properties":{"capabilities":{"type":"array","items":{"type":"object","properties":{"config":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"extends":{"type":"string"},"name":{"type":"string"},"schema":{"type":"string"},"spec":{"type":"string"},"version":{"type":"string"}},"required":["name","version"],"additionalProperties":false}},"version":{"type":"string"}},"required":["capabilities","version"],"additionalProperties":false}},"required":["currency","id","line_items","totals","ucp"],"additionalProperties":{}}}}},"402":{"description":"Authentication Required"}}},"put":{"operationId":"ucp_carts_update","summary":"Update or retry a StableMerch UCP cart. StableMerch accepts idempotent updates for the same product/artwork/options; create a new cart to change generated preview contents.","tags":["Ucp"],"security":[{"siwx":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"attribution":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"buyer":{"type":"object","properties":{"email":{"type":"string"},"first_name":{"type":"string"},"full_name":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"}}},"context":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"line_items":{"minItems":1,"type":"array","items":{"type":"object","properties":{"item":{"type":"object","properties":{"id":{"type":"string"}},"required":["id"],"additionalProperties":{}},"quantity":{"type":"integer","minimum":1,"maximum":9007199254740991}},"required":["item","quantity"],"additionalProperties":{}}},"signals":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"id":{"type":"string","minLength":1},"dev.stablemerch.customization":{"type":"object","properties":{"client_request_id":{"type":"string","minLength":8,"maxLength":128,"pattern":"^[A-Za-z0-9._:-]+$","description":"StableMerch idempotency key for this exact custom merch cart."},"image_url":{"type":"string","minLength":1,"description":"HTTP/HTTPS URL or base64 data URL (data:image/...)"},"size":{"type":"string","enum":["S","M","L","XL","2XL","3XL","4XL","5XL","7XL"]},"color":{"type":"string"},"placement":{"type":"string","enum":["front","back"]},"commission_address":{"description":"EVM address to receive the commission. Must be provided together with commission_rate.","type":"string"},"commission_rate":{"description":"Commission as a decimal (e.g. 0.1 = 10%). Added on top of the base price — the buyer pays base + (base × rate).","type":"number","exclusiveMinimum":0,"exclusiveMaximum":1}},"required":["client_request_id","image_url"],"description":"StableMerch customization data for the UCP cart line item. UCP line_items identify what is being purchased; this extension identifies the buyer-provided artwork and merch options."}},"required":["line_items","id"],"additionalProperties":{},"description":"UCP cart update request. StableMerch accepts idempotent refresh/retry updates for the same customization; create a new cart to change artwork, product, or options after preview generation."}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"attribution":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"buyer":{"type":"object","properties":{"email":{"type":"string"},"first_name":{"type":"string"},"full_name":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"}},"additionalProperties":false},"context":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"continue_url":{"type":"string"},"currency":{"type":"string"},"expires_at":{"type":"string"},"id":{"type":"string"},"line_items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"item":{"type":"object","properties":{"id":{"type":"string"},"image_url":{"type":"string"},"price":{"type":"number"},"title":{"type":"string"}},"required":["id","price","title"],"additionalProperties":false},"parent_id":{"type":"string"},"quantity":{"type":"number"},"totals":{"type":"array","items":{"type":"object","properties":{"amount":{"type":"number"},"display_text":{"type":"string"},"type":{"type":"string","enum":["discount","fee","fulfillment","items_discount","subtotal","tax","total"]}},"required":["amount","type"],"additionalProperties":false}}},"required":["id","item","quantity","totals"],"additionalProperties":false}},"links":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"type":{"type":"string"},"url":{"type":"string"}},"required":["type","url"],"additionalProperties":false}},"messages":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"content":{"type":"string"},"content_type":{"type":"string","enum":["markdown","plain"]},"path":{"type":"string"},"severity":{"type":"string","enum":["recoverable","requires_buyer_input","requires_buyer_review"]},"type":{"type":"string","enum":["error","info","warning"]}},"required":["content","type"],"additionalProperties":false}},"signals":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"totals":{"type":"array","items":{"type":"object","properties":{"amount":{"type":"number"},"display_text":{"type":"string"},"type":{"type":"string","enum":["discount","fee","fulfillment","items_discount","subtotal","tax","total"]}},"required":["amount","type"],"additionalProperties":false}},"ucp":{"type":"object","properties":{"capabilities":{"type":"array","items":{"type":"object","properties":{"config":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"extends":{"type":"string"},"name":{"type":"string"},"schema":{"type":"string"},"spec":{"type":"string"},"version":{"type":"string"}},"required":["name","version"],"additionalProperties":false}},"version":{"type":"string"}},"required":["capabilities","version"],"additionalProperties":false}},"required":["currency","id","line_items","totals","ucp"],"additionalProperties":{}}}}},"402":{"description":"Authentication Required"}}}},"/api/ucp/carts/{cartId}/cancel":{"post":{"operationId":"ucp_carts_cancel","summary":"Cancel an unpaid StableMerch UCP cart and any unpaid prepared Printify order associated with it.","tags":["Ucp"],"security":[{"siwx":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"attribution":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"buyer":{"type":"object","properties":{"email":{"type":"string"},"first_name":{"type":"string"},"full_name":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"}},"additionalProperties":false},"context":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"continue_url":{"type":"string"},"currency":{"type":"string"},"expires_at":{"type":"string"},"id":{"type":"string"},"line_items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"item":{"type":"object","properties":{"id":{"type":"string"},"image_url":{"type":"string"},"price":{"type":"number"},"title":{"type":"string"}},"required":["id","price","title"],"additionalProperties":false},"parent_id":{"type":"string"},"quantity":{"type":"number"},"totals":{"type":"array","items":{"type":"object","properties":{"amount":{"type":"number"},"display_text":{"type":"string"},"type":{"type":"string","enum":["discount","fee","fulfillment","items_discount","subtotal","tax","total"]}},"required":["amount","type"],"additionalProperties":false}}},"required":["id","item","quantity","totals"],"additionalProperties":false}},"links":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"type":{"type":"string"},"url":{"type":"string"}},"required":["type","url"],"additionalProperties":false}},"messages":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"content":{"type":"string"},"content_type":{"type":"string","enum":["markdown","plain"]},"path":{"type":"string"},"severity":{"type":"string","enum":["recoverable","requires_buyer_input","requires_buyer_review"]},"type":{"type":"string","enum":["error","info","warning"]}},"required":["content","type"],"additionalProperties":false}},"signals":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"totals":{"type":"array","items":{"type":"object","properties":{"amount":{"type":"number"},"display_text":{"type":"string"},"type":{"type":"string","enum":["discount","fee","fulfillment","items_discount","subtotal","tax","total"]}},"required":["amount","type"],"additionalProperties":false}},"ucp":{"type":"object","properties":{"capabilities":{"type":"array","items":{"type":"object","properties":{"config":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"extends":{"type":"string"},"name":{"type":"string"},"schema":{"type":"string"},"spec":{"type":"string"},"version":{"type":"string"}},"required":["name","version"],"additionalProperties":false}},"version":{"type":"string"}},"required":["capabilities","version"],"additionalProperties":false}},"required":["currency","id","line_items","totals","ucp"],"additionalProperties":{}}}}},"402":{"description":"Authentication Required"}}}},"/api/ucp/checkout-sessions":{"post":{"operationId":"ucp_checkout-sessions_create","summary":"Create a UCP checkout session from a StableMerch cart. Supplying fulfillment prepares the Printify order and returns ready_for_complete; omitting fulfillment returns an incomplete checkout session for review.","tags":["Ucp"],"security":[{"siwx":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"cart_id":{"type":"string","minLength":1,"description":"UCP cart ID to convert into a checkout session. StableMerch uses the cart contents and ignores overlapping checkout line item fields."},"buyer":{"description":"Optional UCP buyer/contact metadata for the shipping order.","type":"object","properties":{"email":{"type":"string"},"first_name":{"type":"string"},"full_name":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"}}},"fulfillment":{"description":"Optional UCP fulfillment metadata. When present, StableMerch prepares the Printify order and returns a ready_for_complete checkout.","type":"object","properties":{"available_methods":{"type":"array","items":{"type":"object","properties":{"description":{"type":"string"},"fulfillable_on":{"anyOf":[{"type":"string"},{"type":"null"}]},"line_item_ids":{"type":"array","items":{"type":"string"}},"type":{"type":"string","enum":["pickup","shipping"]}},"required":["line_item_ids","type"]}},"methods":{"type":"array","items":{"type":"object","properties":{"destinations":{"type":"array","items":{"type":"object","properties":{"address_country":{"type":"string"},"address_locality":{"type":"string"},"address_region":{"type":"string"},"extended_address":{"type":"string"},"first_name":{"type":"string"},"full_name":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"},"postal_code":{"type":"string"},"street_address":{"type":"string"},"id":{"type":"string"},"address":{"type":"object","properties":{"address_country":{"type":"string"},"address_locality":{"type":"string"},"address_region":{"type":"string"},"extended_address":{"type":"string"},"first_name":{"type":"string"},"full_name":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"},"postal_code":{"type":"string"},"street_address":{"type":"string"}}},"name":{"type":"string"}},"required":["id"]}},"groups":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"line_item_ids":{"type":"array","items":{"type":"string"}},"options":{"type":"array","items":{"type":"object","properties":{"carrier":{"type":"string"},"description":{"type":"string"},"earliest_fulfillment_time":{"type":"string"},"id":{"type":"string"},"latest_fulfillment_time":{"type":"string"},"title":{"type":"string"},"totals":{"type":"array","items":{"type":"object","properties":{"amount":{"type":"number"},"display_text":{"type":"string"},"type":{"type":"string","enum":["discount","fee","fulfillment","items_discount","subtotal","tax","total"]}},"required":["amount","type"]}}},"required":["id","title","totals"]}},"selected_option_id":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","line_item_ids"]}},"id":{"type":"string"},"line_item_ids":{"type":"array","items":{"type":"string"}},"selected_destination_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"type":{"type":"string","enum":["pickup","shipping"]}},"required":["id","line_item_ids","type"]}}}}},"required":["cart_id"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"buyer":{"type":"object","properties":{"email":{"type":"string"},"first_name":{"type":"string"},"full_name":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"}},"additionalProperties":false},"continue_url":{"type":"string"},"currency":{"type":"string"},"expires_at":{"type":"string"},"fulfillment":{"type":"object","properties":{"available_methods":{"type":"array","items":{"type":"object","properties":{"description":{"type":"string"},"fulfillable_on":{"anyOf":[{"type":"string"},{"type":"null"}]},"line_item_ids":{"type":"array","items":{"type":"string"}},"type":{"type":"string","enum":["pickup","shipping"]}},"required":["line_item_ids","type"],"additionalProperties":false}},"methods":{"type":"array","items":{"type":"object","properties":{"destinations":{"type":"array","items":{"type":"object","properties":{"address_country":{"type":"string"},"address_locality":{"type":"string"},"address_region":{"type":"string"},"extended_address":{"type":"string"},"first_name":{"type":"string"},"full_name":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"},"postal_code":{"type":"string"},"street_address":{"type":"string"},"id":{"type":"string"},"address":{"type":"object","properties":{"address_country":{"type":"string"},"address_locality":{"type":"string"},"address_region":{"type":"string"},"extended_address":{"type":"string"},"first_name":{"type":"string"},"full_name":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"},"postal_code":{"type":"string"},"street_address":{"type":"string"}},"additionalProperties":false},"name":{"type":"string"}},"required":["id"],"additionalProperties":false}},"groups":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"line_item_ids":{"type":"array","items":{"type":"string"}},"options":{"type":"array","items":{"type":"object","properties":{"carrier":{"type":"string"},"description":{"type":"string"},"earliest_fulfillment_time":{"type":"string"},"id":{"type":"string"},"latest_fulfillment_time":{"type":"string"},"title":{"type":"string"},"totals":{"type":"array","items":{"type":"object","properties":{"amount":{"type":"number"},"display_text":{"type":"string"},"type":{"type":"string","enum":["discount","fee","fulfillment","items_discount","subtotal","tax","total"]}},"required":["amount","type"],"additionalProperties":false}}},"required":["id","title","totals"],"additionalProperties":false}},"selected_option_id":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","line_item_ids"],"additionalProperties":false}},"id":{"type":"string"},"line_item_ids":{"type":"array","items":{"type":"string"}},"selected_destination_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"type":{"type":"string","enum":["pickup","shipping"]}},"required":["id","line_item_ids","type"],"additionalProperties":false}}},"additionalProperties":false},"id":{"type":"string"},"line_items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"item":{"type":"object","properties":{"id":{"type":"string"},"image_url":{"type":"string"},"price":{"type":"number"},"title":{"type":"string"}},"required":["id","price","title"],"additionalProperties":false},"parent_id":{"type":"string"},"quantity":{"type":"number"},"totals":{"type":"array","items":{"type":"object","properties":{"amount":{"type":"number"},"display_text":{"type":"string"},"type":{"type":"string","enum":["discount","fee","fulfillment","items_discount","subtotal","tax","total"]}},"required":["amount","type"],"additionalProperties":false}}},"required":["id","item","quantity","totals"],"additionalProperties":false}},"links":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"type":{"type":"string"},"url":{"type":"string"}},"required":["type","url"],"additionalProperties":false}},"messages":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"content":{"type":"string"},"content_type":{"type":"string","enum":["markdown","plain"]},"path":{"type":"string"},"severity":{"type":"string","enum":["recoverable","requires_buyer_input","requires_buyer_review"]},"type":{"type":"string","enum":["error","info","warning"]}},"required":["content","type"],"additionalProperties":false}},"order":{"type":"object","properties":{"id":{"type":"string"},"permalink_url":{"type":"string"}},"required":["id","permalink_url"],"additionalProperties":false},"payment":{"type":"object","properties":{"handlers":{"type":"array","items":{"type":"object","properties":{"config":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"config_schema":{"type":"string"},"id":{"type":"string"},"instrument_schemas":{"type":"array","items":{"type":"string"}},"name":{"type":"string"},"spec":{"type":"string"},"version":{"type":"string"}},"required":["config","config_schema","id","instrument_schemas","name","spec","version"],"additionalProperties":false}},"instruments":{"type":"array","items":{"type":"object","properties":{"handler_id":{"type":"string"},"id":{"type":"string"},"type":{"type":"string"}},"required":["handler_id","id","type"],"additionalProperties":{}}},"selected_instrument_id":{"type":"string"}},"required":["handlers"],"additionalProperties":false},"status":{"type":"string","enum":["canceled","complete_in_progress","completed","incomplete","ready_for_complete","requires_escalation"]},"totals":{"type":"array","items":{"type":"object","properties":{"amount":{"type":"number"},"display_text":{"type":"string"},"type":{"type":"string","enum":["discount","fee","fulfillment","items_discount","subtotal","tax","total"]}},"required":["amount","type"],"additionalProperties":false}},"ucp":{"type":"object","properties":{"capabilities":{"type":"array","items":{"type":"object","properties":{"config":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"extends":{"type":"string"},"name":{"type":"string"},"schema":{"type":"string"},"spec":{"type":"string"},"version":{"type":"string"}},"required":["name","version"],"additionalProperties":false}},"version":{"type":"string"}},"required":["capabilities","version"],"additionalProperties":false}},"required":["currency","id","line_items","links","payment","status","totals","ucp"],"additionalProperties":{}}}}},"402":{"description":"Authentication Required"}}}},"/api/ucp/checkout-sessions/{checkoutSessionId}":{"get":{"operationId":"ucp_checkout-sessions_get","summary":"Retrieve the current UCP checkout session for a StableMerch cart checkout.","tags":["Ucp"],"security":[{"siwx":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"buyer":{"type":"object","properties":{"email":{"type":"string"},"first_name":{"type":"string"},"full_name":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"}},"additionalProperties":false},"continue_url":{"type":"string"},"currency":{"type":"string"},"expires_at":{"type":"string"},"fulfillment":{"type":"object","properties":{"available_methods":{"type":"array","items":{"type":"object","properties":{"description":{"type":"string"},"fulfillable_on":{"anyOf":[{"type":"string"},{"type":"null"}]},"line_item_ids":{"type":"array","items":{"type":"string"}},"type":{"type":"string","enum":["pickup","shipping"]}},"required":["line_item_ids","type"],"additionalProperties":false}},"methods":{"type":"array","items":{"type":"object","properties":{"destinations":{"type":"array","items":{"type":"object","properties":{"address_country":{"type":"string"},"address_locality":{"type":"string"},"address_region":{"type":"string"},"extended_address":{"type":"string"},"first_name":{"type":"string"},"full_name":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"},"postal_code":{"type":"string"},"street_address":{"type":"string"},"id":{"type":"string"},"address":{"type":"object","properties":{"address_country":{"type":"string"},"address_locality":{"type":"string"},"address_region":{"type":"string"},"extended_address":{"type":"string"},"first_name":{"type":"string"},"full_name":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"},"postal_code":{"type":"string"},"street_address":{"type":"string"}},"additionalProperties":false},"name":{"type":"string"}},"required":["id"],"additionalProperties":false}},"groups":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"line_item_ids":{"type":"array","items":{"type":"string"}},"options":{"type":"array","items":{"type":"object","properties":{"carrier":{"type":"string"},"description":{"type":"string"},"earliest_fulfillment_time":{"type":"string"},"id":{"type":"string"},"latest_fulfillment_time":{"type":"string"},"title":{"type":"string"},"totals":{"type":"array","items":{"type":"object","properties":{"amount":{"type":"number"},"display_text":{"type":"string"},"type":{"type":"string","enum":["discount","fee","fulfillment","items_discount","subtotal","tax","total"]}},"required":["amount","type"],"additionalProperties":false}}},"required":["id","title","totals"],"additionalProperties":false}},"selected_option_id":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","line_item_ids"],"additionalProperties":false}},"id":{"type":"string"},"line_item_ids":{"type":"array","items":{"type":"string"}},"selected_destination_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"type":{"type":"string","enum":["pickup","shipping"]}},"required":["id","line_item_ids","type"],"additionalProperties":false}}},"additionalProperties":false},"id":{"type":"string"},"line_items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"item":{"type":"object","properties":{"id":{"type":"string"},"image_url":{"type":"string"},"price":{"type":"number"},"title":{"type":"string"}},"required":["id","price","title"],"additionalProperties":false},"parent_id":{"type":"string"},"quantity":{"type":"number"},"totals":{"type":"array","items":{"type":"object","properties":{"amount":{"type":"number"},"display_text":{"type":"string"},"type":{"type":"string","enum":["discount","fee","fulfillment","items_discount","subtotal","tax","total"]}},"required":["amount","type"],"additionalProperties":false}}},"required":["id","item","quantity","totals"],"additionalProperties":false}},"links":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"type":{"type":"string"},"url":{"type":"string"}},"required":["type","url"],"additionalProperties":false}},"messages":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"content":{"type":"string"},"content_type":{"type":"string","enum":["markdown","plain"]},"path":{"type":"string"},"severity":{"type":"string","enum":["recoverable","requires_buyer_input","requires_buyer_review"]},"type":{"type":"string","enum":["error","info","warning"]}},"required":["content","type"],"additionalProperties":false}},"order":{"type":"object","properties":{"id":{"type":"string"},"permalink_url":{"type":"string"}},"required":["id","permalink_url"],"additionalProperties":false},"payment":{"type":"object","properties":{"handlers":{"type":"array","items":{"type":"object","properties":{"config":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"config_schema":{"type":"string"},"id":{"type":"string"},"instrument_schemas":{"type":"array","items":{"type":"string"}},"name":{"type":"string"},"spec":{"type":"string"},"version":{"type":"string"}},"required":["config","config_schema","id","instrument_schemas","name","spec","version"],"additionalProperties":false}},"instruments":{"type":"array","items":{"type":"object","properties":{"handler_id":{"type":"string"},"id":{"type":"string"},"type":{"type":"string"}},"required":["handler_id","id","type"],"additionalProperties":{}}},"selected_instrument_id":{"type":"string"}},"required":["handlers"],"additionalProperties":false},"status":{"type":"string","enum":["canceled","complete_in_progress","completed","incomplete","ready_for_complete","requires_escalation"]},"totals":{"type":"array","items":{"type":"object","properties":{"amount":{"type":"number"},"display_text":{"type":"string"},"type":{"type":"string","enum":["discount","fee","fulfillment","items_discount","subtotal","tax","total"]}},"required":["amount","type"],"additionalProperties":false}},"ucp":{"type":"object","properties":{"capabilities":{"type":"array","items":{"type":"object","properties":{"config":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"extends":{"type":"string"},"name":{"type":"string"},"schema":{"type":"string"},"spec":{"type":"string"},"version":{"type":"string"}},"required":["name","version"],"additionalProperties":false}},"version":{"type":"string"}},"required":["capabilities","version"],"additionalProperties":false}},"required":["currency","id","line_items","links","payment","status","totals","ucp"],"additionalProperties":{}}}}},"402":{"description":"Authentication Required"}}},"put":{"operationId":"ucp_checkout-sessions_update","summary":"Update a StableMerch UCP checkout session. Supplying fulfillment prepares the underlying Printify order when the checkout is incomplete.","tags":["Ucp"],"security":[{"siwx":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"checkout_session_id":{"description":"Optional checkout session ID; when present it must match the URL.","type":"string","minLength":1},"buyer":{"description":"Optional UCP buyer/contact metadata for the shipping order.","type":"object","properties":{"email":{"type":"string"},"first_name":{"type":"string"},"full_name":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"}}},"fulfillment":{"description":"Optional UCP fulfillment metadata. Supplying it prepares the Printify order when the checkout is still incomplete.","type":"object","properties":{"available_methods":{"type":"array","items":{"type":"object","properties":{"description":{"type":"string"},"fulfillable_on":{"anyOf":[{"type":"string"},{"type":"null"}]},"line_item_ids":{"type":"array","items":{"type":"string"}},"type":{"type":"string","enum":["pickup","shipping"]}},"required":["line_item_ids","type"]}},"methods":{"type":"array","items":{"type":"object","properties":{"destinations":{"type":"array","items":{"type":"object","properties":{"address_country":{"type":"string"},"address_locality":{"type":"string"},"address_region":{"type":"string"},"extended_address":{"type":"string"},"first_name":{"type":"string"},"full_name":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"},"postal_code":{"type":"string"},"street_address":{"type":"string"},"id":{"type":"string"},"address":{"type":"object","properties":{"address_country":{"type":"string"},"address_locality":{"type":"string"},"address_region":{"type":"string"},"extended_address":{"type":"string"},"first_name":{"type":"string"},"full_name":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"},"postal_code":{"type":"string"},"street_address":{"type":"string"}}},"name":{"type":"string"}},"required":["id"]}},"groups":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"line_item_ids":{"type":"array","items":{"type":"string"}},"options":{"type":"array","items":{"type":"object","properties":{"carrier":{"type":"string"},"description":{"type":"string"},"earliest_fulfillment_time":{"type":"string"},"id":{"type":"string"},"latest_fulfillment_time":{"type":"string"},"title":{"type":"string"},"totals":{"type":"array","items":{"type":"object","properties":{"amount":{"type":"number"},"display_text":{"type":"string"},"type":{"type":"string","enum":["discount","fee","fulfillment","items_discount","subtotal","tax","total"]}},"required":["amount","type"]}}},"required":["id","title","totals"]}},"selected_option_id":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","line_item_ids"]}},"id":{"type":"string"},"line_item_ids":{"type":"array","items":{"type":"string"}},"selected_destination_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"type":{"type":"string","enum":["pickup","shipping"]}},"required":["id","line_item_ids","type"]}}}}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"buyer":{"type":"object","properties":{"email":{"type":"string"},"first_name":{"type":"string"},"full_name":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"}},"additionalProperties":false},"continue_url":{"type":"string"},"currency":{"type":"string"},"expires_at":{"type":"string"},"fulfillment":{"type":"object","properties":{"available_methods":{"type":"array","items":{"type":"object","properties":{"description":{"type":"string"},"fulfillable_on":{"anyOf":[{"type":"string"},{"type":"null"}]},"line_item_ids":{"type":"array","items":{"type":"string"}},"type":{"type":"string","enum":["pickup","shipping"]}},"required":["line_item_ids","type"],"additionalProperties":false}},"methods":{"type":"array","items":{"type":"object","properties":{"destinations":{"type":"array","items":{"type":"object","properties":{"address_country":{"type":"string"},"address_locality":{"type":"string"},"address_region":{"type":"string"},"extended_address":{"type":"string"},"first_name":{"type":"string"},"full_name":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"},"postal_code":{"type":"string"},"street_address":{"type":"string"},"id":{"type":"string"},"address":{"type":"object","properties":{"address_country":{"type":"string"},"address_locality":{"type":"string"},"address_region":{"type":"string"},"extended_address":{"type":"string"},"first_name":{"type":"string"},"full_name":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"},"postal_code":{"type":"string"},"street_address":{"type":"string"}},"additionalProperties":false},"name":{"type":"string"}},"required":["id"],"additionalProperties":false}},"groups":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"line_item_ids":{"type":"array","items":{"type":"string"}},"options":{"type":"array","items":{"type":"object","properties":{"carrier":{"type":"string"},"description":{"type":"string"},"earliest_fulfillment_time":{"type":"string"},"id":{"type":"string"},"latest_fulfillment_time":{"type":"string"},"title":{"type":"string"},"totals":{"type":"array","items":{"type":"object","properties":{"amount":{"type":"number"},"display_text":{"type":"string"},"type":{"type":"string","enum":["discount","fee","fulfillment","items_discount","subtotal","tax","total"]}},"required":["amount","type"],"additionalProperties":false}}},"required":["id","title","totals"],"additionalProperties":false}},"selected_option_id":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","line_item_ids"],"additionalProperties":false}},"id":{"type":"string"},"line_item_ids":{"type":"array","items":{"type":"string"}},"selected_destination_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"type":{"type":"string","enum":["pickup","shipping"]}},"required":["id","line_item_ids","type"],"additionalProperties":false}}},"additionalProperties":false},"id":{"type":"string"},"line_items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"item":{"type":"object","properties":{"id":{"type":"string"},"image_url":{"type":"string"},"price":{"type":"number"},"title":{"type":"string"}},"required":["id","price","title"],"additionalProperties":false},"parent_id":{"type":"string"},"quantity":{"type":"number"},"totals":{"type":"array","items":{"type":"object","properties":{"amount":{"type":"number"},"display_text":{"type":"string"},"type":{"type":"string","enum":["discount","fee","fulfillment","items_discount","subtotal","tax","total"]}},"required":["amount","type"],"additionalProperties":false}}},"required":["id","item","quantity","totals"],"additionalProperties":false}},"links":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"type":{"type":"string"},"url":{"type":"string"}},"required":["type","url"],"additionalProperties":false}},"messages":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"content":{"type":"string"},"content_type":{"type":"string","enum":["markdown","plain"]},"path":{"type":"string"},"severity":{"type":"string","enum":["recoverable","requires_buyer_input","requires_buyer_review"]},"type":{"type":"string","enum":["error","info","warning"]}},"required":["content","type"],"additionalProperties":false}},"order":{"type":"object","properties":{"id":{"type":"string"},"permalink_url":{"type":"string"}},"required":["id","permalink_url"],"additionalProperties":false},"payment":{"type":"object","properties":{"handlers":{"type":"array","items":{"type":"object","properties":{"config":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"config_schema":{"type":"string"},"id":{"type":"string"},"instrument_schemas":{"type":"array","items":{"type":"string"}},"name":{"type":"string"},"spec":{"type":"string"},"version":{"type":"string"}},"required":["config","config_schema","id","instrument_schemas","name","spec","version"],"additionalProperties":false}},"instruments":{"type":"array","items":{"type":"object","properties":{"handler_id":{"type":"string"},"id":{"type":"string"},"type":{"type":"string"}},"required":["handler_id","id","type"],"additionalProperties":{}}},"selected_instrument_id":{"type":"string"}},"required":["handlers"],"additionalProperties":false},"status":{"type":"string","enum":["canceled","complete_in_progress","completed","incomplete","ready_for_complete","requires_escalation"]},"totals":{"type":"array","items":{"type":"object","properties":{"amount":{"type":"number"},"display_text":{"type":"string"},"type":{"type":"string","enum":["discount","fee","fulfillment","items_discount","subtotal","tax","total"]}},"required":["amount","type"],"additionalProperties":false}},"ucp":{"type":"object","properties":{"capabilities":{"type":"array","items":{"type":"object","properties":{"config":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"extends":{"type":"string"},"name":{"type":"string"},"schema":{"type":"string"},"spec":{"type":"string"},"version":{"type":"string"}},"required":["name","version"],"additionalProperties":false}},"version":{"type":"string"}},"required":["capabilities","version"],"additionalProperties":false}},"required":["currency","id","line_items","links","payment","status","totals","ucp"],"additionalProperties":{}}}}},"402":{"description":"Authentication Required"}}}},"/api/ucp/checkout-sessions/{checkoutSessionId}/cancel":{"post":{"operationId":"ucp_checkout-sessions_cancel","summary":"Cancel an incomplete or ready StableMerch UCP checkout session and its unpaid prepared Printify order.","tags":["Ucp"],"security":[{"siwx":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"buyer":{"type":"object","properties":{"email":{"type":"string"},"first_name":{"type":"string"},"full_name":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"}},"additionalProperties":false},"continue_url":{"type":"string"},"currency":{"type":"string"},"expires_at":{"type":"string"},"fulfillment":{"type":"object","properties":{"available_methods":{"type":"array","items":{"type":"object","properties":{"description":{"type":"string"},"fulfillable_on":{"anyOf":[{"type":"string"},{"type":"null"}]},"line_item_ids":{"type":"array","items":{"type":"string"}},"type":{"type":"string","enum":["pickup","shipping"]}},"required":["line_item_ids","type"],"additionalProperties":false}},"methods":{"type":"array","items":{"type":"object","properties":{"destinations":{"type":"array","items":{"type":"object","properties":{"address_country":{"type":"string"},"address_locality":{"type":"string"},"address_region":{"type":"string"},"extended_address":{"type":"string"},"first_name":{"type":"string"},"full_name":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"},"postal_code":{"type":"string"},"street_address":{"type":"string"},"id":{"type":"string"},"address":{"type":"object","properties":{"address_country":{"type":"string"},"address_locality":{"type":"string"},"address_region":{"type":"string"},"extended_address":{"type":"string"},"first_name":{"type":"string"},"full_name":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"},"postal_code":{"type":"string"},"street_address":{"type":"string"}},"additionalProperties":false},"name":{"type":"string"}},"required":["id"],"additionalProperties":false}},"groups":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"line_item_ids":{"type":"array","items":{"type":"string"}},"options":{"type":"array","items":{"type":"object","properties":{"carrier":{"type":"string"},"description":{"type":"string"},"earliest_fulfillment_time":{"type":"string"},"id":{"type":"string"},"latest_fulfillment_time":{"type":"string"},"title":{"type":"string"},"totals":{"type":"array","items":{"type":"object","properties":{"amount":{"type":"number"},"display_text":{"type":"string"},"type":{"type":"string","enum":["discount","fee","fulfillment","items_discount","subtotal","tax","total"]}},"required":["amount","type"],"additionalProperties":false}}},"required":["id","title","totals"],"additionalProperties":false}},"selected_option_id":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","line_item_ids"],"additionalProperties":false}},"id":{"type":"string"},"line_item_ids":{"type":"array","items":{"type":"string"}},"selected_destination_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"type":{"type":"string","enum":["pickup","shipping"]}},"required":["id","line_item_ids","type"],"additionalProperties":false}}},"additionalProperties":false},"id":{"type":"string"},"line_items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"item":{"type":"object","properties":{"id":{"type":"string"},"image_url":{"type":"string"},"price":{"type":"number"},"title":{"type":"string"}},"required":["id","price","title"],"additionalProperties":false},"parent_id":{"type":"string"},"quantity":{"type":"number"},"totals":{"type":"array","items":{"type":"object","properties":{"amount":{"type":"number"},"display_text":{"type":"string"},"type":{"type":"string","enum":["discount","fee","fulfillment","items_discount","subtotal","tax","total"]}},"required":["amount","type"],"additionalProperties":false}}},"required":["id","item","quantity","totals"],"additionalProperties":false}},"links":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"type":{"type":"string"},"url":{"type":"string"}},"required":["type","url"],"additionalProperties":false}},"messages":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"content":{"type":"string"},"content_type":{"type":"string","enum":["markdown","plain"]},"path":{"type":"string"},"severity":{"type":"string","enum":["recoverable","requires_buyer_input","requires_buyer_review"]},"type":{"type":"string","enum":["error","info","warning"]}},"required":["content","type"],"additionalProperties":false}},"order":{"type":"object","properties":{"id":{"type":"string"},"permalink_url":{"type":"string"}},"required":["id","permalink_url"],"additionalProperties":false},"payment":{"type":"object","properties":{"handlers":{"type":"array","items":{"type":"object","properties":{"config":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"config_schema":{"type":"string"},"id":{"type":"string"},"instrument_schemas":{"type":"array","items":{"type":"string"}},"name":{"type":"string"},"spec":{"type":"string"},"version":{"type":"string"}},"required":["config","config_schema","id","instrument_schemas","name","spec","version"],"additionalProperties":false}},"instruments":{"type":"array","items":{"type":"object","properties":{"handler_id":{"type":"string"},"id":{"type":"string"},"type":{"type":"string"}},"required":["handler_id","id","type"],"additionalProperties":{}}},"selected_instrument_id":{"type":"string"}},"required":["handlers"],"additionalProperties":false},"status":{"type":"string","enum":["canceled","complete_in_progress","completed","incomplete","ready_for_complete","requires_escalation"]},"totals":{"type":"array","items":{"type":"object","properties":{"amount":{"type":"number"},"display_text":{"type":"string"},"type":{"type":"string","enum":["discount","fee","fulfillment","items_discount","subtotal","tax","total"]}},"required":["amount","type"],"additionalProperties":false}},"ucp":{"type":"object","properties":{"capabilities":{"type":"array","items":{"type":"object","properties":{"config":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"extends":{"type":"string"},"name":{"type":"string"},"schema":{"type":"string"},"spec":{"type":"string"},"version":{"type":"string"}},"required":["name","version"],"additionalProperties":false}},"version":{"type":"string"}},"required":["capabilities","version"],"additionalProperties":false}},"required":["currency","id","line_items","links","payment","status","totals","ucp"],"additionalProperties":{}}}}},"402":{"description":"Authentication Required"}}}},"/api/ucp/orders/{orderId}":{"get":{"operationId":"ucp_orders_get","summary":"Retrieve the current UCP order projection for a completed StableMerch checkout session.","tags":["Ucp"],"security":[{"siwx":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"adjustments":{"type":"array","items":{"type":"object","properties":{"amount":{"type":"number"},"description":{"type":"string"},"id":{"type":"string"},"line_items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"quantity":{"type":"number"}},"required":["id","quantity"],"additionalProperties":false}},"occurred_at":{"type":"string"},"status":{"type":"string","enum":["completed","failed","pending"]},"type":{"type":"string"}},"required":["id","occurred_at","status","type"],"additionalProperties":false}},"checkout_id":{"type":"string"},"fulfillment":{"type":"object","properties":{"events":{"type":"array","items":{"type":"object","properties":{"carrier":{"type":"string"},"description":{"type":"string"},"id":{"type":"string"},"line_items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"quantity":{"type":"number"}},"required":["id","quantity"],"additionalProperties":false}},"occurred_at":{"type":"string"},"tracking_number":{"type":"string"},"tracking_url":{"type":"string"},"type":{"type":"string"}},"required":["id","line_items","occurred_at","type"],"additionalProperties":false}},"expectations":{"type":"array","items":{"type":"object","properties":{"description":{"type":"string"},"destination":{"type":"object","properties":{"address_country":{"type":"string"},"address_locality":{"type":"string"},"address_region":{"type":"string"},"extended_address":{"type":"string"},"first_name":{"type":"string"},"full_name":{"type":"string"},"last_name":{"type":"string"},"phone_number":{"type":"string"},"postal_code":{"type":"string"},"street_address":{"type":"string"}},"additionalProperties":false},"fulfillable_on":{"type":"string"},"id":{"type":"string"},"line_items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"quantity":{"type":"number"}},"required":["id","quantity"],"additionalProperties":false}},"method_type":{"type":"string","enum":["digital","pickup","shipping"]}},"required":["destination","id","line_items","method_type"],"additionalProperties":false}}},"additionalProperties":false},"id":{"type":"string"},"line_items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"item":{"type":"object","properties":{"id":{"type":"string"},"image_url":{"type":"string"},"price":{"type":"number"},"title":{"type":"string"}},"required":["id","price","title"],"additionalProperties":false},"parent_id":{"type":"string"},"quantity":{"type":"object","properties":{"fulfilled":{"type":"number"},"total":{"type":"number"}},"required":["fulfilled","total"],"additionalProperties":false},"status":{"type":"string","enum":["fulfilled","partial","processing"]},"totals":{"type":"array","items":{"type":"object","properties":{"amount":{"type":"number"},"display_text":{"type":"string"},"type":{"type":"string","enum":["discount","fee","fulfillment","items_discount","subtotal","tax","total"]}},"required":["amount","type"],"additionalProperties":false}}},"required":["id","item","quantity","status","totals"],"additionalProperties":false}},"permalink_url":{"type":"string"},"totals":{"type":"array","items":{"type":"object","properties":{"amount":{"type":"number"},"display_text":{"type":"string"},"type":{"type":"string","enum":["discount","fee","fulfillment","items_discount","subtotal","tax","total"]}},"required":["amount","type"],"additionalProperties":false}},"ucp":{"type":"object","properties":{"capabilities":{"type":"array","items":{"type":"object","properties":{"config":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"extends":{"type":"string"},"name":{"type":"string"},"schema":{"type":"string"},"spec":{"type":"string"},"version":{"type":"string"}},"required":["name","version"],"additionalProperties":false}},"version":{"type":"string"}},"required":["capabilities","version"],"additionalProperties":false}},"required":["checkout_id","fulfillment","id","line_items","permalink_url","totals","ucp"],"additionalProperties":false}}}},"402":{"description":"Authentication Required"}}}}},"components":{"securitySchemes":{"siwx":{"type":"apiKey","in":"header","name":"SIGN-IN-WITH-X"}}}}