# PayAI Documentation

> PayAI operates an x402 facilitator at https://facilitator.payai.network. These docs cover accepting x402 payments (merchants), making them (clients), and the facilitator API. Start with the quickstarts.

## Quickstarts

- [Accept payments from AI agents](https://docs.payai.network/guides/accept-payments-from-ai-agents.md): Add x402 to an API or SaaS, start without portal signup, verify a real payment, and scale with programmatic credits.
- [x402 Base Mainnet Express](https://docs.payai.network/x402/base-mainnet-express.md): Upstream exact-EVM merchant and one-shot buyer with bounded reconciliation and finalized USDC receipt checks.
- [x402 Solana Mainnet Express](https://docs.payai.network/x402/solana-mainnet-express.md): Tested merchant and guarded buyer using the PayAI facilitator and @x402/svm.

- [x402 Quickstart](https://docs.payai.network/x402/quickstart.md): High-level x402 getting started.
- [Build with AI](https://docs.payai.network/x402/build-with-ai.md): Connect coding agents to PayAI: the docs MCP server, llms.txt files, the facilitator MCP server, Context7 and the PayAI x402 skill.
- [Merchant Introduction](https://docs.payai.network/x402/servers/introduction.md): Learn how to sell services with x402.
- [Express server quickstart (TypeScript)](https://docs.payai.network/x402/servers/typescript/express.md): Accept x402 payments with Express.
- [Hono server quickstart (TypeScript)](https://docs.payai.network/x402/servers/typescript/hono.md): Accept x402 payments with Hono.
- [Next.js server quickstart (TypeScript)](https://docs.payai.network/x402/servers/typescript/nextjs.md): Accept x402 payments with Next.js.
- [FastAPI server quickstart (Python)](https://docs.payai.network/x402/servers/python/fastapi.md): Accept x402 payments with FastAPI.
- [Flask server quickstart (Python)](https://docs.payai.network/x402/servers/python/flask.md): Accept x402 payments with Flask.
- [Gin server quickstart (Go)](https://docs.payai.network/x402/servers/go/gin.md): Accept x402 payments with Gin (Go).
- [Client Introduction](https://docs.payai.network/x402/clients/introduction.md): Learn how to support x402 in your client
- [Axios client quickstart (TypeScript)](https://docs.payai.network/x402/clients/typescript/axios.md): Make x402 payments with Axios.
- [Fetch client quickstart (TypeScript)](https://docs.payai.network/x402/clients/typescript/fetch.md): Make x402 payments with Fetch.
- [httpx client quickstart (Python)](https://docs.payai.network/x402/clients/python/httpx.md): Make x402 payments with Python httpx (async).
- [requests client quickstart (Python)](https://docs.payai.network/x402/clients/python/requests.md): Make x402 payments with Python requests (sync).
- [Go net/http client quickstart](https://docs.payai.network/x402/clients/go/http.md): Make x402 payments with Go standard HTTP client.

## Facilitator

- [Facilitator Introduction](https://docs.payai.network/x402/facilitators/introduction.md): Learn about the role of an x402 facilitator
- [Bazaar Discovery](https://docs.payai.network/x402/facilitators/bazaar.md): How resources get listed, refreshed, and found in the PayAI Bazaar.
- [Facilitator Authentication](https://docs.payai.network/x402/facilitators/authentication.md): Merchant JWT authentication, API-key requirements, and examples for multiple languages.
- [Agent API Keys](https://docs.payai.network/x402/facilitators/agent-api-keys.md): Buy a facilitator API key and credits over x402 without creating an account.
- [Supported Networks](https://docs.payai.network/x402/supported-networks.md): See networks that are supported by the PayAI Facilitator for the x402 protocol
- [Facilitator Pricing](https://docs.payai.network/x402/facilitators/pricing.md): PayAI Facilitator pricing — free credits, cost-plus per-settlement rates by network (gas + 30%, daily), and credits
- [Capacity and Settlement Recovery](https://docs.payai.network/x402/facilitators/capacity-and-limits.md): Rate limits, pending settlement responses, and recovery using the original operation.

## Protocol and guides

- [Solana Network Identifiers](https://docs.payai.network/x402/solana-network-identifiers.md): CAIP-2 network ID, full RPC genesis hash, native USDC and token program.
- [Solana Mainnet Integration Metadata](https://docs.payai.network/solana-mainnet-integration.json): Versioned static companion for the tested integration; live capabilities remain at /supported.

- [x402 Introduction](https://docs.payai.network/x402/introduction.md): Learn about the x402 protocol
- [x402 Reference](https://docs.payai.network/x402/reference.md): Reference documentation for the x402 protocol
- [x402 Server Manual Flow (TypeScript)](https://docs.payai.network/x402/servers/typescript/manual-flow.md): Step-by-step guide to building the x402 PAYMENT-REQUIRED response manually in TypeScript without server SDK or middleware.
- [x402 Server Manual Flow (Python)](https://docs.payai.network/x402/servers/python/manual-flow.md): Step-by-step guide to building the x402 PAYMENT-REQUIRED response manually in Python without server SDK or middleware.
- [x402 Client Manual Flow (TypeScript)](https://docs.payai.network/x402/clients/typescript/manual-flow.md): Step-by-step guide to implementing the x402 payment protocol manually in TypeScript without SDK wrappers.
- [x402 Client Manual Flow (Python)](https://docs.payai.network/x402/clients/python/manual-flow.md): Step-by-step guide to implementing the x402 payment protocol manually in Python without SDK wrappers.
- [Solana Batch Settlement](https://docs.payai.network/x402/servers/batch-settlement.md): Public unauthenticated lane, merchant USDC ATA setup, pinned SDK, limits, payout, and recovery.
- [EVM Batch Settlement on Base](https://docs.payai.network/x402/servers/evm-batch-settlement.md): Payment channels for metered x402 APIs on Base: one USDC deposit, off-chain vouchers per request, batched claims and a single sweep. Public, no API key, gas paid by PayAI.
- [Dynamic pricing with x402](https://docs.payai.network/guides/dynamic-pricing-x402.md): Per-request and tier-based pricing for paid APIs: charge by tier, headers, or request data in TypeScript, Python and Go.
- [x402 Echo Merchant Introduction](https://docs.payai.network/x402-echo/introduction.md): Echo Merchant overview and use cases.
- [x402 Echo Merchant Getting Started](https://docs.payai.network/x402-echo/getting-started.md): Echo Merchant setup and testing.
- [PayAI Introduction](https://docs.payai.network/introduction.md): Overview of PayAI and the agentic future.

## Optional

- [Tokenomics](https://docs.payai.network/project-info/tokenomics.md): Overview of $PAYAI token supply, treasury, liquidity, and unlocks.
- [Token Use & Legal Disclaimer](https://docs.payai.network/project-info/token-use-and-legal-disclaimer.md): Intended use, risks, and legal disclaimer for the $PAYAI utility token.
- [Official Links](https://docs.payai.network/project-info/official-links.md): Official resources, links, and contract addresses for PayAI and $PAYAI.
- [Contributing](https://docs.payai.network/project-info/contributing.md): How to contribute to the PayAI ecosystem and documentation.
- [Github](https://github.com/PayAINetwork)
- [Support](https://discord.gg/eWJRwMpebQ)