独立解读
CDP Facilitator:x402 付款之后,谁来验证和结算?
项目资料 · CDP Facilitator ↗一个数据接口每次查询收费 0.01 美元,支持 x402。Agent 根据服务返回的要求准备支付凭证,随后带凭证再次请求。接下来,服务商要确认凭证是否有效,并按所用方案处理结算。
Facilitator 是帮助处理这一环节的角色;CDP Facilitator 是 Coinbase Developer Platform 提供的一种托管实现。 根据其文档,它可以验证已签名的付款、进行交易筛查、向链上提交结算,并把结果返回给资源服务器。Coinbase 官方文档
文中的数据服务与 0.01 美元价格是假设案例,非具体报价。本文依据官方文档,查阅于 2026 年 10 月 30 日;本站没有接入该服务或进行真实支付测试。网络、功能和费用可能变化。
一次数据请求里发生什么?
这张图展示一种便于理解的组织方式。实际的验证、结算和交付顺序,取决于 x402 支付方案、服务端实现和商家自己的交付条件;不能把一个实现的顺序当成所有 x402 请求的规定。Coinbase x402 概览
标准、钱包和服务分别做什么?
| 组件 | 角色 | 它不自动解决什么 |
|---|---|---|
| x402 | 规定付费请求与支付信息怎样交流 | 不代替用户设置预算 |
| Agent 钱包或签名工具 | 按支持的方案准备付款凭证 | 不保证数据质量 |
| 资源服务器 | 提供接口、设置付款要求并决定交付 | 不必自行实现所有链上操作 |
| CDP Facilitator | 按其支持的方案验证、筛查和提交结算 | 不保证 Agent 获得用户授权,也不替服务商履约 |
因此,服务商可以评估 CDP Facilitator,也可以考虑其他符合自身需要的实现。选择应依据网络、资产、费用、风险筛查、可靠性和供应商条款,而不是把产品与标准视为同义词。
核验和结算是两件事
核验关注支付信息是否符合处理条件,例如签名和参数是否有效;结算关注按照支付方案如何完成资金转移。核验通过,并不必然等于用户已经拿到数据。
例如,服务商成功收款后接口仍可能超时。买方看不到数据时,需要查询交易与订单状态;能否重试、复用凭证或退款,需要看商家和具体集成。不要假设 facilitator 会自动修复每一种交付失败。
费用:按什么计费?
Coinbase 文档在本次查阅时介绍:验证免费;每月前 1,000 笔符合其计费定义的链上 facilitator 交易免费,超过后按每笔 0.001 美元计费。这里的计费单位是链上操作,不一定等于 API 请求数。 文档还说明不同方案对链上交易数的影响不同。当前文档与价格
| 要问的问题 | 为什么重要 |
|---|---|
| 采用哪种支付方案? | 不同方案可能将多次请求和链上结算以不同方式组合 |
| 谁承担 facilitator 费? | 商家和买方的实际成本可能不同 |
| 还有哪些费用? | 资源价格、网络、入金或兑换可能另计 |
| 使用什么网络和资产? | 支持列表会变化;生产环境与测试环境也需分别确认 |
举例:若在同一个月有 2,000 笔都符合上述同一价格条件的计费链上交易,超额 1,000 笔按 0.001 美元计算为 1 美元。这只是按文档条件的算术示例,不是实际账单,也不包含其他成本。
接入前的检查
- 服务端是否支持需要的网络、资产和支付方案?
- API 凭证如何保管、轮换和撤销?测试环境与生产环境如何分离?
- 验证失败、结算失败和交付失败分别返回什么状态?
- 并发和超时后如何查询状态、避免重复处理?
- 交易筛查拒绝后,用户和商家如何得到可理解的结果?
相关阅读:CDP Facilitator 项目资料 · x402 入门 · Agent 支付失败