UCP API Reference
This reference documents how Finqu exposes the Universal Commerce Protocol (UCP) on each sales channel. For implementation guidance, see the Integration Guide.
Protocol version: 2026-04-08
Base URLs
All UCP API traffic is scoped to the merchant’s storefront domain.
Requests to a domain where UCP is not enabled receive 404.
Discovery profile
Endpoint: GET https://{shop-domain}/.well-known/ucp
Public, unauthenticated, cacheable. Returns a JSON document describing:
The shopping service is published under dev.ucp.shopping. Each transport binding includes transport, endpoint, version, spec, and schema URLs pointing to the canonical UCP specification.
Transports advertised:
Capabilities
The following capabilities are part of the broader protocol but not available via the public API today: checkout, fulfillment, order, buyer consent, and identity linking.
Reference pages
- Authentication — Token, signed, and anonymous tiers
- REST API — Catalog and cart endpoints, headers, idempotency
- MCP Transport — MCP tools and metadata
- Responses & Errors — Envelopes, error codes, rate limiting