Are you an LLM? Read llms.txt for a summary of the docs, or llms-full.txt for the full context.
Facet Adapter for WooCommerce · Boson Protocol
Skip to content

Facet Adapter for WooCommerce

AI agents can now buy direct from your store.

This adapter connects a WooCommerce storefront to facet.llc, a protocol that gives AI shopping agents a machine-readable catalogue and a checkout built for them — settled through Boson Protocol escrow.

This is a different integration from the native Boson WooCommerce plugin, which mirrors your listings as Boson offers directly. This adapter instead opens a second, agent-facing checkout on top of your existing store, powered by facet.llc.

The new customer is an agent

Agents are already arriving at stores like yours, and on a normal storefront they buy nothing. They cannot prove who they are, cannot read your catalogue, and have no checkout built for them. It is demand arriving at a door that does not open.

A second checkout, built for AI buyers

The adapter gives your store a second door. Visiting agents are identified before they can quote or buy, read a machine-readable version of your catalogue, and check out on their own. Human shoppers and search engines see your site exactly as before.

What facet.llc is

facet.llc is the protocol layer a business turns toward machines: it lets autonomous agents discover, identify, transact, and audit on a merchant's site. Rather than inventing a new standard, facet.llc composes four open ones into a stack an agent can speak end-to-end, and ships the product layers those specs deliberately leave unspecified.

LayerOpen standard
DiscoveryMCP (capability + tool surface) + agents.txt served at /.well-known/agents.txt
IdentityKYAPay — ES256 JWT verified against issuer-published keys (multi-issuer allow-list)
Paymentsx402 — HTTP 402 Payment Required as a native settlement signal
Bot signingRFC 9421 web-bot-auth
ContractOpenAPI 3.1 + Overlay 1.0, generated from the typed protocol and CI drift-gated

The agent-facing runtime is the Terminal, which runs at the merchant's own domain. It verifies the caller's identity token, meters and rate-limits the request, dispatches it, signs the response (Ed25519, keys published as a JWKS), and appends to an append-only audit log. An operator sees agents, not anonymised scrapers: which agents arrive, what they discover, quote, and buy, and the agent-versus-human split per route.

AI-agent traffic crossed 50% of non-search bot volume in early 2025 and is rising (Cloudflare Radar). Today that traffic is unmetered, unidentified, and unauditable — a business absorbs the bandwidth while the value accrues to the agent's operator. A Terminal turns that traffic from a cost into a channel.

Boson escrow as a payment rail

facet.llc is rail-neutral by contract — cards and USDC-over-x402 return the same receipt envelope, so the agent never sees the difference. One of the rails a facet.llc store can accept is Boson Protocol escrow, via the x402B scheme.

x402B keeps x402's HTTP-native, gasless, single-round-trip UX and replaces the trusted-server payment model: the buyer signs a stablecoin (USDC) spend authorization, and the funds are locked in a non-custodial escrow contract on commit. They release to the seller only once the buyer's voucher is redeemed — on fulfillment — or the dispute window expires. If delivery fails, a registered third-party dispute resolver can split the funds and slash the seller's bond.

What a store gains

Trade with agents you have no relationship with. This is the point. A long-tail agent discovering your store has no contract, no credit history, and no prior trust with you — and you have none with its operator. Escrow plus protocol-level dispute resolution substitutes for that missing relationship, so a first-time agent purchase is safe for both sides without either underwriting the other.

SellerBuyer agent
CustodyFunds never touch the store's or facet.llc's balance sheet — they sit in the escrow contract. facet.llc's settlement design is non-custodial by architecture.Money is protected until the order is actually fulfilled.
SettlementPaid on redeem, with a bounded dispute window instead of an open-ended card chargeback exposure.One ERC-3009 authorization, signed locally — nothing moves until commit.
Cost of entryFacilitator relays the on-chain commit, so the buyer needs no ETH. Removes the single biggest onboarding barrier for agent buyers.Gasless: hold USDC, no native gas token, no bridging.
AuditabilityAn on-chain transaction hash anyone can verify on a block explorer, plus a signed Terminal receipt over the request and response.Cryptographic provenance it can forward to a downstream agent without being trusted itself.
IntegrationRail-symmetric receipts: run cards and escrowed USDC side by side without forking the integration.Structured, signed responses — no proxies, no CAPTCHAs, no HTML parsing.

Where to go next

  • facet.llc — general information about facet.llc: the Terminal, agent analytics, the reputation registry, the knowledge graph, and the open spec and SDKs (Apache 2.0).
  • Mount your store — the onboarding flow for a business opening its store to AI agents. facet.llc ingests your existing catalogue (Shopify, WooCommerce, NetSuite, CSV, PIM) into a normalised manifest, publishes your agents.txt, and stands up the Terminal on your own hostname or a facet.llc subdomain.
  • Facet Purchase Flow — the technical walkthrough of the other side: how an AI agent drives a full purchase against a facet.llc Terminal over the Boson escrow rail.
  • Example source code — a complete working buyer-agent script for this flow.