核心概念#
什么是 x402#
x402 是基于 HTTP 状态码 402 Payment Required 构建的链上支付协议,将区块链支付能力嵌入标准请求-响应流程。无论是浏览器、后端服务还是 AI Agent,接入 x402 即可完成收付款。
无需注册账户或 OAuth 配置,一次 API 调用即可完成代币支付。协议原生支持按次计费、订阅制等多种结算模式,链上即时到账。
基于开放标准构建,兼容主流区块链,可快速集成并扩展至更多网络。
同步结算与异步结算#
交易验证通过后,卖家调用结算接口将付款提交上链。支付 API 提供两种结算模式:
同步结算(syncSettle = true)#
Facilitator 提交交易并等待链上确认后返回交易哈希。卖家收到响应时,资金已到账。
适用场景:高价值交易、需要确保收款后再交付资源的场景。
异步结算(syncSettle = false)#
Facilitator 提交交易后立即返回交易哈希,不等待链上确认。
适用场景:追求响应速度的低价值、高频调用场景。
提示
异步结算时,交易验证与链上结算之间存在短暂时间差,可能出现商品已下发但最终收款未完成的情况。对于金额较高的交易,建议使用同步结算模式以降低该风险。