X402 集成指南
内容提要
X402是基于HTTP 402 Payment Required的链上支付协议，允许调用方无需API Token或预充值，直接用USDC支付。文档涵盖快速开始、TypeScript/Python SDK接入、订单支付、网络与计费方案、Facilitator集成及故障排查。支持Base、SKALE、Solana网络，提供exact和upto两种计费模式，官方SDK可自动处理402、签名和重试流程。
延伸解读
X402 的核心机制
X402 基于 HTTP 402 Payment Required 状态码，实现链上支付。调用方无需预充值或 API Token，每次请求直接用 USDC 支付。流程为：首次请求无认证，服务器返回 402 及支付要求（accepts），客户端签名后携带 PAYMENT-SIGNATURE 重试。官方 SDK 自动处理这些步骤，开发者只需准备 USDC 钱包并选择网络。
网络与计费模式选择
支持 Base、SKALE、Solana 网络，计费模式有 exact（固定金额）和 upto（后置计量）。Base 同时支持两种模式，SKALE 和 Solana 仅支持 exact。upto 适合聊天补全等用量后置的 API，需钱包授权 Permit2。选择网络时需考虑 gas 成本和结算确认方式，如 Solana 建议使用自有 RPC 对账。
接入注意事项
开发者应关注实时返回的 accepts 字段，而非文档示例。accepts 中的 maxAmountRequired、asset、extra 等字段用于签名。upto 模式需先授权 Permit2，否则报错。若需后置计量，在 TypeScript SDK 中传入 preferScheme: 'upto'，否则 SDK 默认选择第一个可用 requirement。
验证与故障排查
可通过公开入口核验：未认证请求返回 402 及 accepts；SDK 自动处理 402 并重试；discovery 文档和 Facilitator 支持列表可查。X402Client 仓库提供高级验证工具，但输出不替代线上 accepts。若签名验证失败，检查 chain id、facilitator 地址、spender、USDC 合约和 Permit2 allowance 是否一致。
Q&A
X402是什么？它如何改变API调用的支付方式？
X402是基于HTTP 402 Payment Required的链上支付协议，允许调用方无需创建API Token或预充值账户余额，直接在每次API请求中用USDC完成链上支付。
如何快速开始使用X402？
建议先阅读快速开始文档，用一个最小请求理解402、accepts和PAYMENT-SIGNATURE流程，然后根据开发环境选择TypeScript或Python SDK接入。
X402支持哪些网络？各网络有什么特点？
X402支持Base、SKALE和Solana。Base支持exact和upto两种计费模式，其中upto仅Base提供；SKALE适合低gas成本的EVM支付；Solana支持exact模式，但链上签名确认建议使用自有RPC。
exact和upto计费模式有什么区别？
exact适用于固定价格API，支付金额预先确定；upto适用于后置计量API，如聊天补全，实际用量在响应后才知道，按真实用量结算。
如何让我的API支持X402收款？
需要阅读Facilitator文档，理解paymentRequirements、paymentPayload、/verify和/settle的关系，并实现相应的服务端链路。
使用X402 SDK时，如何处理402响应？
官方SDK会自动完成第一次无认证请求、解析402 Payment Required、调用payment handler、携带PAYMENT-SIGNATURE重试这些步骤，开发者只需准备有USDC的钱包并选择网络。
X402支持哪些网络和计费模式？
X402支持Base、SKALE和Solana网络，计费模式包括exact（固定金额）和upto（后置计量）。目前upto仅Base网络提供。
如何验证X402集成是否成功？
可以通过检查公开入口如https://x402.acedata.cloud/.well-known/x402和https://facilitator.acedata.cloud/supported，以及使用X402Client仓库中的高级链上验证工具来确认签名、重试和settlement行为。
