x402 服务说明
这份文档面向商户和用户，说明当前 Axon 公共 x402 facilitator 的接入方式、支付方式和线上环境信息。
当前线上环境
- 基础地址：
https://x402.mavae.ai - 网络：
eip155:8210 - vault：
0xB61712F69A325b67c6E9E788D2175ed559FF8555 - 已启用支付资产：
WAXON402，地址0xeC041f9324A4E14B88940C25F98D4703260ACaf1
对商户
商户现在可以自助完成钱包确权、API key 创建、resource 配置和 route 发布。discovery 仍然公开， verify 与 settle 仍由商户服务端调用。
推荐接入流程：
- 先通过
/v1/merchant/onboard/*完成钱包签名开通。 - 创建一个
payment_runtimeAPI key。 - 创建 resource 和支付 route。
- 商户的受保护接口先返回
402 payment_required，并附带一个 accept route。 - 用户根据 accept route 准备 x402 payment。
- 商户收到 payment 后，服务端调用
POST /v2/x402/verify。 - verify 通过后，商户再调用
POST /v2/x402/settle。 - settle 成功后，商户返回自己的业务结果。
对用户
用户通常不会直接调用 facilitator，而是向商户发送两次请求。第一次请求拿到
402 + accept，第二次请求带上签名后的 payment。
- 用户先请求商户的付费接口。
- 商户返回 accept route，说明支付金额、支付资产和 payTo 地址。
- 如果用户钱包里只有原生 AXON，就先把需要支付的部分 wrap 成
WAXON402。 - 用户对
transferWithAuthorization做离线签名。 - 用户把 payment 发给商户，商户去完成 verify 和 settle。
- 结算成功后，商户返回业务结果。
关于等待和重试
- Axon 主网上一次 settle 可能需要约 1 到 2 分钟。
- payment 提交后，优先等待原请求完成，不要因为等待就重新签一个新的 payment。
- 如果需要重试，理想方式是复用同一个 payment payload。
- 新的 payment nonce 会被视为新的支付尝试，而不是原请求的恢复。