用 x402 和 USDC 实现 API 变现

选择合适的资源

不要一开始就给所有接口收费。先选择一个价值明确、响应稳定、容易按次定价的资源。

清晰的资源边界也能降低付款不匹配的排查成本，并让开发者更容易理解价格。

• 使用稳定的公开 URL
• 把规则绑定到明确的 HTTP Method
• 设置适合按次请求的价格
• 写清楚 Agent 和开发者能理解的资源描述

设计支付流程

第一次请求没有有效 payment payload 时返回 402 challenge。付款验证通过后，同一路由返回受保护数据。

这种方式从用户视角保持轻量，不要求小额高频调用提前充值。

按账务基础设施运营

每次付费请求都应该被当作财务事件处理。需要保存付款记录、保证重试幂等，并提供清晰日志用于客服和对账。

• 严格校验 resource URL 和 method
• 拒绝过期 payment payload
• 基于 nonce 或 authorization id 去重
• 记录结算状态和链上交易哈希