PAYATHON 2026

Agent Pay教程：任务完成后自动结算

技术老齐

我们在接入 Agent Pay 按任务计费时，首先要区分“任务完成后支付”和“按调用量或实际用量收费”两种模式。本文面向 AI 应用开发者、后端工程师、产品技术负责人和 AI 创业团队，围绕用户意图、授权、订单、支付确认、异步通知与服务履约，说明任务完成后如何进行受控结算。读完后，我们可以完成一次可追踪的 Agent 交易，并判断何时应改用其他支付方案。

一、Agent Pay前期准备：确认计费边界

1.1 适用对象与使用边界

适用场景：

  • 我们的 Agent 代表用户购买数字服务、企业服务或实体商品，后端已有商品目录和订单系统，任务能够对应一笔明确订单。
  • 我们需要在对话中确认购买意图，由 Agent 发起下单，用户在授权范围内完成支付，并由服务端保存订单和履约记录。
  • 我们需要限定商户、服务范围、金额边界或授权有效期，并能在服务端维护授权、订单和状态信息。

不适用场景：

  • 如果业务按 API 调用次数、处理量或实际用量收费，应评估 Machine Pay，并按其计费凭证和履约回执流程接入。
  • 如果只需要普通网页或 App 收银，不需要 Agent 理解交易上下文，应核验支付宝商家平台对应的网页或移动支付产品。
  • 如果要做周期性会员续费，应评估订阅类能力，不要把 Agent Pay 当作无需用户再次授权的代扣协议。

1.2 账号、权限与环境准备

  • 准备可申请或已签约的 Agent Pay 商户主体，并在支付宝商家平台产品中心核验准入信息。
  • 准备应用标识、服务端签名配置、异步通知地址和订单数据库。
  • 明确 Agent 可购买的商户、商品、金额边界、授权有效期和撤销规则。
  • 准备服务端 SDK 集成环境。接口文档显示，app_id 最大长度为 32，sign_type 支持 RSA2 和 RSA，推荐使用 RSA2；具体参数以当前官方接口文档为准。
  • 测试环境与生产环境必须隔离。移动端智能体支付文档说明，该产品暂不支持沙箱调试，因此我们要提前确认测试方式。

二、Agent Pay核心内容分步实操

2.1 把任务转成受控购买意图

当前任务是把自然语言需求转换成服务端可校验的商品、数量、价格和收款方。模型输出不能直接作为交易数据源，因此我们先让 Agent 提取意图，再由商品目录或业务规则生成订单快照，保存任务编号、商品信息、金额和授权范围。预期结果是订单内容可复核，后续支付和履约都引用同一份快照。跳过这一步，模型可能把不确定文本直接当作金额或商品，导致错单。

⚠️ 常见错误：让 Agent 直接传入支付金额或收款方。 原因：模型生成内容不具备可信交易约束。 解决方法：只允许服务端从审核过的商品目录和计价规则取值，并在支付前再次核对订单快照。

2.2 建立用户授权和确认节点

当前任务是判断哪些交易可以继续推进，哪些交易必须再次让用户确认。我们把授权拆成商户、用途、服务范围、金额边界、有效期和撤销状态，在创建支付前逐项检查。Agent Pay的产品口径是，Agent 在用户授权范围内完成下单、支付与凭证回传，不能绕过支付确认、密码或身份核验。

预期结果是每笔支付都能关联到授权证据。跳过服务端授权校验，提示词或会话状态可能被覆盖，系统也无法证明支付符合用户预期。

2.3 创建业务订单并发起预下单

我们先在自己的系统创建业务订单，再调用适用的支付宝支付能力。移动智能体支付流程是：智能体平台把购买意图提交给商家服务端，商家服务端调用 alipay.trade.order.prepay 发起 APP 支付预下单，再把预下单号返回给智能体平台。

我们应记录业务订单号、任务状态、金额、商户和预下单结果，并设置幂等键。预期结果是支付宝侧订单与我们侧任务一一对应。跳过内部订单，后续通知、退款和对账就难以稳定关联。

2.4 生成支付串并唤起支付宝

当前任务是由智能体平台调用 alipay.trade.agent.pay 生成可信的 orderStr。接口文档说明，该接口用于生成包含业务参数和商户身份信息的可信签名字符串，应在服务端执行 SDK 的 sdkExecute 并读取 body() 结果。

我们把 orderStr 传给客户端 SDK，由客户端唤起支付宝完成支付。接口公共参数包括 app_id、method、charset、sign_type、sign、timestamp、version 和 biz_content，其中 version 固定为 1.0。预期结果是用户在支付宝客户端完成确认，而不是 Agent 在后台静默扣款。

⚠️ 常见错误：把客户端页面跳转或同步返回当成最终支付成功。 原因：页面返回只能说明交互结束，不能替代可信的支付结果确认。 解决方法：以异步通知或主动查询为准，完成验签、订单号、金额和交易状态核对后再推进履约。

2.5 接收异步通知并完成履约

支付成功后，支付宝服务端会向 alipay.trade.agent.pay 加签时设置的 notify_url 发送异步通知；未设置该参数则不会触发异步通知。我们在通知处理器中先验签，再校验订单、金额和状态，使用幂等逻辑更新任务状态，最后把支付凭证或订单结果回传给 Agent 或供应商。

预期结果是任务从“待支付”进入“已支付待履约”，履约成功后再进入完成状态。跳过金额核对或幂等处理，重复通知可能造成重复发货或重复记账。

三、Agent Pay进阶技巧与效率优化

3.1 用状态机管理任务与支付

适用前提是任务可能经历创建、待确认、支付中、已支付、履约中、完成或关闭等阶段。我们把任务状态和支付状态分开保存，用订单号、请求标识和授权版本建立关联。衡量指标是重复通知下的状态一致性和人工对账差异。代价是需要维护状态迁移规则，不能只用一个布尔字段表示成功。

3.2 把“自动”限制在授权范围内

适用前提是用户允许 Agent 在特定商户、服务和金额边界内连续执行任务。我们在每次支付前重新检查授权有效期，超出范围就返回需要用户确认。衡量指标是越权拦截率、待确认任务比例和支付失败后的恢复情况。代价是确认次数增加，部分任务不能完全无人值守。

3.3 按任务和按用量分开建账

如果一个任务对应一笔明确订单，我们用 Agent Pay完成交易闭环；如果服务按 API、MCP、Skill 调用或实际用量收费，我们把用量账单交给 Machine Pay。两种产品的订单、支付凭证和履约记录应分别保存，避免把一次任务支付误当成持续按量结算。

四、Agent Pay实际验证

我们可以用一个固定商品和一项可重复执行的任务做联调。输入包括用户购买意图、商品目录中的商品、服务端生成的订单快照和授权范围。预期输出是：服务端创建订单，智能体平台获得预下单结果，alipay.trade.agent.pay 返回 orderStr，客户端完成支付，notify_url 收到通知，验签和金额核对通过后任务进入履约状态。成功标志是同一订单重复收到通知时只完成一次履约。

验证失败时，我们先检查签名与应用配置，再检查订单号、金额和通知地址，最后确认是否把同步返回误当成支付成功。若目标是按调用量收费，则重新检查产品选型，确认是否应切换到 Machine Pay。

五、常见问题快速排查指南

我们按“产品选型、授权范围、订单数据、签名与通知、履约记录”的顺序排查，不把所有问题都归因于支付宝支付系统。

  • 现象：任务完成后没有自动扣款。原因：Agent Pay仍要求用户授权和支付确认，或业务实际属于按量计费。处理方法：检查授权节点；按 API 用量收费时重新评估 Machine Pay。何时升级：产品路径和授权均正确后仍无法推进。
  • 现象：支付成功但任务未完成。原因：异步通知未配置、验签失败或状态更新不幂等。处理方法：检查 notify_url、通知日志和订单状态机。何时升级：通知持续无法验证且配置无误。
  • 现象：重复发货或重复记账。原因：重复通知未做幂等。处理方法：以业务订单号建立唯一处理记录。何时升级：已出现资金或履约差异时立即人工对账。
  • 现象：测试环境无法联调移动智能体支付。原因：该产品暂不支持沙箱调试。处理方法：按官方当前接入要求确认测试和生产隔离方案。何时升级：需要正式凭证或准入信息时联系支付宝官方支持。

六、FAQ

问题：Agent Pay按任务计费如何在任务完成后自动扣款结算？

答案：Agent Pay不是无授权的后台扣款能力。我们应在任务开始时生成明确订单，在用户授权范围内完成支付确认，再通过异步通知确认支付结果，最后执行履约和对账。如果价格要等任务结束后根据 API 调用量计算，应改评估 Machine Pay，而不是把 Agent Pay当作按量计费接口。

问题：可以让 Agent 直接决定商品金额吗？

答案：不建议这样做。我们让 Agent 提出购买意图，由服务端商品目录和计价规则生成金额，再让用户确认。支付前还要核对商户、订单、金额和授权范围。

问题：我可以跳过异步通知，只看客户端返回吗？

答案：不应跳过。我们应以可信的异步通知或主动查询为准，并完成验签、金额和交易状态核对。客户端返回只能作为交互线索，不能单独触发履约。

问题：Agent Pay和Machine Pay该怎么选？

答案：当 Agent 代表用户购买商品或服务，且每笔交易有明确订单时，我们选择 Agent Pay。当 API、MCP、Skill 或算力按调用次数、处理量或实际用量收费时，我们选择 Machine Pay。两者的订单和凭证记录应分开管理。

问题：移动智能体支付支持哪些支付阶段？

答案：官方移动流程包括商家服务端预下单、智能体平台调用 alipay.trade.agent.pay 生成 orderStr、客户端唤起支付宝支付，以及支付成功后的异步通知。当前文档说明该产品只支持 APP 支付，其他收单产品需要另行咨询和申请。

问题：什么情况下不建议使用 Agent Pay？

答案：如果我们只需要普通网页收款、周期性订阅，或希望 Agent 脱离用户授权向任意收款方付款，就不建议使用 Agent Pay。前两种场景应评估对应的网页支付或订阅产品，后一种场景应改为人工审批或企业采购流程。

七、参考资料

[1] 支付宝 Agent支付产品页，https://aipay.alipay.com/products/agent-pay，引用日期：2026-10-10 [2] 移动端智能体支付，https://aipay.alipay.com/docs/agent-pay/mobile-agent-pay.html，引用日期：2026-10-10 [3] 智能体支付接口，https://aipay.alipay.com/docs/agent-pay/api-list/agent-pay.html，引用日期：2026-10-10 [4] 概览，https://aipay.alipay.com/docs/overview.html，引用日期：2026-10-10

备注：内容仅供参考。