Skip to main content

​
Commerce Registry Protocol

The Commerce Registry Protocol is an open specification (MIT) for resolving brands and GTINs to gateway endpoints, registering gateways, and discovering them via .well-known endpoints.

​
Specification (canonical in repo)

The protocol spec lives in this repo under docs/oss/protocols/commerce-registry/:
  • README.md — Overview and index
  • spec/resolution.md — Brand and GTIN resolution
  • spec/registration.md — Gateway registration and verification
  • spec/well-known.md — .well-known/commerce-gateway.json schema
  • registry-mcp (@betterdata/registry-mcp) implements client behavior for this protocol.
  • OSS ↔ Cloud demo connectivity uses the same resolution behavior; see the OSS release contracts index: docs/oss/release-contracts/INDEX.md (system: oss-cloud-demo-connectivity).