支付凭证的权限边界怎么定: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 凭证,还需要自己做金额校验吗?
参考来源
以上为本文写作时的参考资料,引用观点以原文为准。