技术文章

外部链接将在新标签页打开。

支付凭证的权限边界怎么定:ChatGPT Wallet 与 Agent 采购的接口契约

一句话回答

OpenAI 的发布页摘要只支持三点:ChatGPT Wallet 让 ChatGPT Work、Codex 与 dots 中的 agent 在用户批准和既有卡片保护下完成购买。凭证的具体 scope、有效期、金额字段与撤销接口在本次材料中未覆盖,不能据此推断。可落地的是把授权拆成批准、凭证、执行、回执四段,并让凭证只携带批准时用户可见的字段:金额、商户、时效、受众。执行结果与凭证声明不一致时应失败,而不是部分成功。

按目前可核验的材料,这个问题只能回答一半。OpenAI 在 2026 年 11 月 13 日的发布页摘要中说明,ChatGPT Wallet 是让 ChatGPT Work、Codex 和 dots 中的 agent 在用户批准(user approval)与既有卡片保护(existing card protections)下完成购买的方式。这确认了两个锚点:批准发生在购买之前,保护沿用既有卡片体系。但凭证长什么样——scope 命名、有效期、金额上限字段、撤销接口——摘要没有覆盖,本次材料也未提供正文,不能据此推断。

摘要能固定的三个边界#

从这一句描述里,可以读出三条对接口契约有约束力的信息。

  • 批准是前置条件,不是事后追认。“with user approval”把批准放在购买动作之前。落到实现上,凭证应当由批准动作派生,而不是先执行再补授权记录。
  • 保护来自既有卡片体系。“existing card protections”意味着钱包没有另造一套风控,agent 采购仍落在原有卡片限额、拒付与争议处理框架内。凭证不应被设计成绕开发卡行限制的通道。
  • 运行面是具名的三个。ChatGPT Work、Codex、dots 被并列写出,说明凭证的受众(audience)至少要能区分运行面,一个面签发的凭证不应在另一个面直接生效。

摘要没覆盖、需要自己定的四件事#

以下属于接口设计建议,不是官方规范。官方文档发布后应逐条对照修正。

授权粒度

单笔授权、额度窗口、商户白名单是三种不同强度的授权。摘要只支持“购买前有批准”,没有说明批准的复用范围。保守做法是让凭证只携带批准时用户实际看到的那几个字段:金额、商户、用途描述。用户没看到的字段,凭证里就不该有。

凭证最小化

凭证应当指向支付工具,而不是复制它。把卡号、有效期之类信息传给 agent 或写进日志,会让原本由卡片体系承担的保护在链路上失效。

时效与撤销

凭证需要过期时间与可撤销标识,并且撤销要能在下一次执行前被读到。摘要没有给出撤销延迟,这一项待核实;在此之前,不要把撤销当成同步操作来设计。

执行与回执分离

执行方返回回执,回执里的金额、商户、时间要与凭证声明逐项一致。不一致时应当整笔失败,而不是按较小金额部分成功——部分成功会让对账无从下手。

凭证声明的字段草案#

下面的结构仅用于说明“凭证只携带批准时可见字段”这一原则。字段名为演示,不对应任何官方 schema;示例未执行,也没有调用任何端点。

{
  "grant_id": "demo-grant-0001",
  "audience": "runtime-surface",      // 占位:实际取值以官方文档为准
  "merchant": "shop.example.com",     // 占位域名
  "amount": { "value": "19.90", "currency": "USD" },
  "expires_at": "2026-11-15T10:00:00Z",
  "revocable": true,
  "approval_ref": "demo-approval-0001" // 指向用户批准记录,不含卡片数据
}

边界条件的取舍#

情形建议处理理由
金额高于批准值拒绝,不自动降额重试降额执行等于用户批准了另一笔交易
商户与批准不符拒绝商户是批准时用户可见的字段之一
凭证已过期拒绝,重新走批准过期凭证的语义无法与撤销区分
执行超时、结果未知查回执,不重复扣款重试可能造成二次扣款
用户撤销后请求到达拒绝并记录撤销的可观测延迟待核实,按最坏情况处理

需要查官方文档才能定的部分#

端点路径、字段命名、scope 取值、审批界面是否支持预算上限、撤销的传播延迟、错误码分类,这些在本次材料里都没有依据,不做猜测。在拿到正文之前,把上面四类边界写进自己的执行侧,是唯一不依赖未核实信息的做法。

常见问题(FAQ)

一次用户批准能否支撑多次 agent 采购?
本次材料未说明。摘要只写了购买需要用户批准,没有描述批准是单笔还是额度窗口。工程上应先按单笔设计,等官方文档明确后再放宽,避免凭证被当成长期通行证。
有了 Wallet 凭证,还需要自己做金额校验吗?
需要。摘要提到沿用既有卡片保护,但没有说明凭证是否自带金额上限。在拿到明确的字段定义之前,把金额、商户一致性校验放在自己的执行侧,是唯一不依赖未核实信息的选择。

参考来源

  1. Introducing ChatGPT Wallet

以上为本文写作时的参考资料,引用观点以原文为准。

作者:沐小悠

本文约 5 分钟读完 · 关键词:ChatGPT Wallet、Agent 支付授权、支付凭证、权限边界、接口契约

更多文章 GET 示例接口

「」标签下的其他文章