For builders
Builders are welcome, but the public site starts with merchants.
If you are integrating with Pizza x402, use this page as a short routing layer into the docs, AGENTS guide, OpenAPI contract, and private-preview MCP notes.
Builder boundary
Docs are the truth surface here.
This page exists to route builders quickly. Merchants come first on the public site, so the right builder move is to jump into `/docs` and `/contracts/*` early.
Use these first
Start with the documented surfaces.
This page exists to point builders at the supported entry points quickly. The public website copy is not API truth.
Public docs
Open the mirrored contract docs, quickstarts, examples, and reference pages.
AGENTS guide
Read the conversation-first ordering guide before designing a client around the flow.
OpenAPI contract
Use the public schema contract for validation, client generation, and drift review.
MCP private preview
Use Direct HTTP, OpenAPI, and AGENTS for launch proof; authorized maintainers can follow the private-preview MCP notes.
Supported surfaces
A small set of real public surfaces.
Keep the builder story tied to documented behavior rather than broader platform promises.
Docs and direct API
The public docs and `/v1/*` ordering flow remain the clearest source of truth for request and response behavior.
MCP
Pizza x402 maintains MCP as a private-preview agent wrapper. Public launch integrations should prove behavior through Direct HTTP, OpenAPI, and AGENTS.
A2A
The A2A gateway is only a documented subset surface. Builders should follow the published docs rather than assume broader compatibility.
Boundaries
This site routes builders. It does not redefine runtime truth.
This repo is the public front door. It should explain the product and route builders, but it must not invent unsupported claims or reauthor backend behavior.
- Do not treat the public website copy as the canonical API contract
- Launch payment strategy is Stripe-only; do not make Coinbase x402, USDC, Base, wallet setup, or crypto checkout launch-critical
- Do not implement customer ordering or merchant auth in this public site repo
- Use `/docs` and `/contracts/*` for technical truth, not the homepage sections