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 official MCP repo.
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.
Official MCP repo
Use the public MCP repo when you want the maintained tool-wrapper path.
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 publishes an official MCP server path for agents that want tool-based interaction instead of raw HTTP.
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
- Do not assume card or crypto rails globally; merchant-bound runtime behavior still matters
- Do not implement customer ordering or merchant auth in this public site repo
- Use `/docs` and `/contracts/*` for technical truth, not the homepage sections