介绍

核心概念#

什么是 x402#

x402 是基于 HTTP 状态码 402 Payment Required 构建的链上支付协议,将区块链支付能力嵌入标准请求-响应流程。无论是浏览器、后端服务还是 AI Agent,接入 x402 即可完成收付款。

无需注册账户或 OAuth 配置,一次 API 调用即可完成代币支付。协议原生支持按次计费、订阅制等多种结算模式,链上即时到账。

基于开放标准构建,兼容主流区块链,可快速集成并扩展至更多网络。

同步结算与异步结算#

交易验证通过后,卖家调用结算接口将付款提交上链。支付 API 提供两种结算模式:

同步结算(syncSettle = true#

Facilitator 提交交易并等待链上确认后返回交易哈希。卖家收到响应时,资金已到账。

适用场景:高价值交易、需要确保收款后再交付资源的场景。

异步结算(syncSettle = false#

Facilitator 提交交易后立即返回交易哈希,不等待链上确认。

适用场景:追求响应速度的低价值、高频调用场景。

提示
异步结算时,交易验证与链上结算之间存在短暂时间差,可能出现商品已下发但最终收款未完成的情况。对于金额较高的交易,建议使用同步结算模式以降低该风险。