Commerce Gateway

The Commerce Gateway Registry

An open, protocol-native directory of verified AI commerce gateways. Register your gateway once. Discoverable by any agent that speaks the Commerce Gateway Protocol.

Discovery with proof

The registry is not a walled garden. It implements the open Commerce Registry Protocol — any compliant registry deployment can interoperate. Better Data operates a hosted public registry. You can self-host your own.

The key distinction: a gateway listed in the registry is verified. Verification means you have proven control of the brand domain where the gateway runs — not just that you published a file.

Verified registration

Higher trust
  1. Deploy your gateway on a public HTTPS URL you control (e.g. api.brand.com)
  2. POST /api/gateways to a protocol-compliant registry with your brand, apex domain, endpoint, protocol version, and capabilities
  3. Complete domain verification — DNS TXT record or hosted .well-known token — to prove domain control
  4. Your gateway is discoverable as verified via the registry resolution APIs

Setup guide →

.well-known only

Lower trust

Host /.well-known/commerce-gateway.json on your domain. Resolvers that implement the protocol can find you via well-known fallback. The spec treats this as unverified until you complete registry registration.

.well-known spec →

Proving domain control

The registry issues a verification token when you register. Complete verification using either method.

DNS TXT record

  1. Register your gateway — receive a verification token
  2. Add a DNS TXT record at: _commerce-gateway.{your-domain} with value: {your-token}
  3. Call POST /api/gateways/{id}/verify
  4. DNS propagation is checked automatically

DNS changes may take up to 48 hours to propagate.

Hosted verification file

  1. Register your gateway — receive a verification token
  2. Serve this file at: https://{your-domain}/.well-known/commerce-gateway-verify.json with content: { "token": "{your-token}" }
  3. Call POST /api/gateways/{id}/verify
  4. The registry fetches the file and checks the token

The file must be served over HTTPS on the exact registered domain.

Attach product-line proof

After your gateway is verified, you can attach GS1 / GTIN claims to associate product lines with your gateway. Submit a certificate or proof URL per claim. POST /api/gateways/{id}/gtins

GTIN claims →

Self-hosted or public registry

Better Data public registry

The default hosted registry. Free to register during open beta.

REGISTRY_URL: https://registry.betterdata.co

Register now →

Self-hosted registry

Deploy your own registry using the Commerce Registry Protocol. Full control. Interoperable with any compliant implementation.

Self-host docs →

Protocol spec

The open registry protocol is published and versioned. Build your own compliant registry or resolver.

Read the spec →

At a glance

Browse and resolve gateways via the public registry API at registry.betterdata.co. Use the setup guide to register your gateway for verified listing.

GoalWhat to do
Verified gateway in a registryRegister + DNS TXT or .well-known token verify
Gateway discovery without a registryPublish /.well-known/commerce-gateway.json
Attach product-line proofPOST /api/gateways/{id}/gtins after registration
Point at a different registrySet REGISTRY_URL in your gateway config
Run your own registryDeploy a Commerce Registry Protocol server