跳转到主要内容
Quick Pay 是直接支付会话方案,适合希望通过较少 API 创建支付会话并跟踪状态的集成。

什么时候使用 Quick Pay

当集成只需要通过少量 API 创建和查询直接支付会话时,使用 Quick Pay。需要商品和履约状态时使用 UCP Pay;需要 Agent 操作商户网页时使用 Browser Pay。

支付流程

  1. 使用集成所需的支付金额、币种和结账上下文创建 Agent Payment Session。
  2. 需要用户操作时,将返回的 next_action 原样交给用户或 Agent。
  3. 持续查询会话,直到进入终态。
  4. 以商户或支付系统的实际结果为准,再向用户报告成功。

时序图

使用创建 Agent Payment Session开始,使用查询 Agent Payment Session读取当前状态。将会话标识与原始支付上下文一起保存;结果未知时不要创建第二个会话。

代码示例

MCP

通过 MCP 让 Agent 调用 Quick Pay 工具。平台需要在 MCP 连接中注入用户授权,并将用户确认、next_action 和 Operation 恢复交给受控的 Agent 工具处理。
不要把 MCP Token 或支付凭证交给模型;恢复时沿用同一个 Operation 和原始支付事实,不要重复创建支付会话。

RESTful API

服务端可以直接调用 Agent Payment Session API,保存会话 ID 和原始支付上下文,并使用同一个会话查询状态:
如果需要让 Agent 使用 RESTful API,将创建和查询函数封装为受控工具。服务端负责校验用户身份、金额、币种和幂等性,模型不能获取 platformToken。