AI commerce
LIGHTO supports UCP 2026-08-25 over REST. Discover /.well-known/ucp.
Catalog
POST /ucp/v1/catalog/search, /catalog/lookup, /catalog/product. Search requires a query or supported filters: categories, price, artist, color, subject, orientation. Context.currency: TWD or USD. All amounts use minor units (NT$1,080 = 108000; US$36 = 3600). Product detail returns variant IDs for actual size, finish and frame combinations. Each variant is limited to one per cart.
Headers and negotiation
Send Content-Type: application/json, Request-Id: UUID and UCP-Agent: profile="https://your-platform.example/.well-known/ucp". Your public HTTPS profile must support the requested capability and version. Profiles are verified without redirects or private network access.
Cart and checkout
POST /ucp/v1/carts or /checkout-sessions with line_items: [{item:{id:"variant_id"},quantity:1}]. Send a unique Idempotency-Key (8–128 letters, digits, hyphens, underscores or periods). Context accepts language, currency and address_country (TW/HK/SG/MY). POST checkout-sessions with cart_id and the source cart's Bearer token to convert a cart; overlapping line_items/context are ignored.
The response includes X-UCP-Session-Token. Send Authorization: Bearer TOKEN on GET/PUT /carts/{id}, /checkout-sessions/{id}, and POST /{id}/cancel or checkout /{id}/complete. PUT replaces line_items and context; use the returned revision to detect concurrent updates. Mutations require an Idempotency-Key for creates. Sessions expire after six hours.
Customer confirmation
Checkout returns requires_escalation and continue_url. Open this URL to import the exact selection into LIGHTO's cart. Chinese checkout uses NewebPay in TWD; English uses Stripe in USD. Review contact details, invoice choices, member points and shipping on LIGHTO. No card credentials, personal buyer information or autonomous payment instruments are accepted by UCP. /complete returns the same handoff; it never charges a card. These are preliminary commerce sessions, not paid store orders. The existing payment callbacks remain authoritative for orders.
Current prices and availability are rechecked on every request and on final website checkout. Shipping is provisional until the destination is confirmed. Hong Kong, Singapore and Malaysia shipping is payable on delivery. Reward redemption requires member sign-in on LIGHTO.
Examples
{"query":"Sunflowers","context":{"currency":"USD","language":"en"}}