agentwallets.si
← 返回博客

独立解读

CDP Facilitator:x402 付款之后,谁来验证和结算?

项目资料 · CDP Facilitator ↗
文章图解 · 概念示意
01支付验证02链上结算03接口服务

一个数据接口每次查询收费 0.01 美元,支持 x402。Agent 根据服务返回的要求准备支付凭证,随后带凭证再次请求。接下来,服务商要确认凭证是否有效,并按所用方案处理结算。

Facilitator 是帮助处理这一环节的角色;CDP Facilitator 是 Coinbase Developer Platform 提供的一种托管实现。 根据其文档,它可以验证已签名的付款、进行交易筛查、向链上提交结算,并把结果返回给资源服务器。Coinbase 官方文档

文中的数据服务与 0.01 美元价格是假设案例,非具体报价。本文依据官方文档,查阅于 2026 年 10 月 30 日;本站没有接入该服务或进行真实支付测试。网络、功能和费用可能变化。

一次数据请求里发生什么?

sequenceDiagram participant A as Agent 与钱包 participant S as 数据服务商 participant F as CDP Facilitator participant N as 支付网络 A->>S: 请求数据 S-->>A: 返回付款要求 A->>S: 携带支付凭证再次请求 S->>F: 请求验证支付 F-->>S: 返回验证结果 S->>F: 按所用方案请求结算 F->>N: 提交链上操作 N-->>F: 返回网络处理结果 F-->>S: 返回结算结果 S-->>A: 按约定条件交付数据

这张图展示一种便于理解的组织方式。实际的验证、结算和交付顺序,取决于 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 支付失败