# openx402

> Build and operate x402 payments on Stellar with openx402.

## Docs

- [Architecture](https://docs.stellarx402.xyz/concepts/architecture.md): Understand openx402 system boundaries, settlement, idempotency, cataloging, search, and MCP.
- [Bazaar metadata and discovery](https://docs.stellarx402.xyz/concepts/bazaar.md): Declare, validate, catalog, browse, and search paid HTTP and MCP resources.
- [Pay a Stellar x402 resource](https://docs.stellarx402.xyz/guides/buyer-client.md): Build a safe canonical buyer for Stellar exact payment challenges.
- [Build a paid HTTP seller](https://docs.stellarx402.xyz/guides/http-seller.md): Protect an Express route with Stellar exact payments and official Bazaar metadata.
- [MCP sellers and agents](https://docs.stellarx402.xyz/guides/mcp.md): Catalog paid MCP tools, search hosted discovery, and run guarded private paid execution.
- [Stellar payments for the open web](https://docs.stellarx402.xyz/index.md): Build, discover, and operate x402 v2 payments on Stellar with a self-hostable facilitator.
- [Security](https://docs.stellarx402.xyz/operations/security.md): Review openx402 trust boundaries, fixed invariants, key controls, metadata risks, MCP policy, and pubnet gates.
- [Self-host openx402](https://docs.stellarx402.xyz/operations/self-hosting.md): Deploy and operate the facilitator, PostgreSQL, search, and optional MCP server.
- [Troubleshooting](https://docs.stellarx402.xyz/operations/troubleshooting.md): Diagnose facilitator, PostgreSQL, search, Bazaar, Stellar settlement, and MCP failures.
- [Quickstart](https://docs.stellarx402.xyz/quickstart.md): Build, pay, and catalog a real paid HTTP endpoint on Stellar testnet.

## Optional

- [GitHub](https://github.com/Ithaca-Labs/openx402)
- [Bazaar SDK](https://www.npmjs.com/package/@openx402/bazaar-sdk)