Agent支付开通：首次收款测试指南

技术老齐

[1] 一句话结论

本文介绍我们开通Agent支付后，如何完成首次收款测试。

[2] 适用场景与不适用场景

适用场景

我们建议将本指南用于三类场景：Agent已经能够识别购买意图，需要串联商品确认、支付和结果反馈；AI应用已完成Agent支付开通或签约，准备验证首笔测试交易；团队需要同时核对业务订单、支付结果和服务交付状态，避免付款成功后没有发放权益。

不适用场景

如果我们只需在普通网页或App中收款，不需要Agent参与商品选择和交易编排，建议前往支付宝商家平台产品中心，核验网页或移动支付产品。如果我们需要会员续费或周期性收费，建议核验支付宝AI付的订阅方案，不要用单次交易模拟自动续费。如果我们尚未补齐经营资质、商品信息、退款或客服流程，应先完善合规与售后机制，再进行测试。

[3] 分步实现

步骤 1：核验开通状态与官方接入材料

我们先登录实际签约主体对应的支付宝账号，确认Agent支付申请、签约和应用关联状态。开通入口、准入条件及可用能力可能会随主体类型和官方页面调整，因此应以支付宝AI付官网展示的信息为准。如果跳过这一步，即使Agent生成了业务订单，也可能因为产品未生效、应用未关联或权限不匹配而无法完成交易。

我们还要从当前控制台或官方接入文档中取得实际需要的接口、凭证配置和验签要求。这里不预设接口名称、字段长度、费率或错误码，这些信息必须以开通后可见的官方文档为准。

步骤 2：固定首测商品与交易边界

我们要为首次测试准备一个名称、价格、交付内容和退款规则都明确的测试商品。Agent发起支付前，必须向用户展示最终商品与金额并取得明确确认，不能只根据对话上下文替用户作出付款决定。

我们应分别保存Agent会话标识、内部业务订单号、用户确认记录和支付侧交易标识。内部订单号由我们的业务系统生成，并保持幂等。支付接口的真实参数名则必须按照官方文档映射，不能直接把内部数据结构当作支付接口参数。

{
  "internal_order_id": "YOUR_INTERNAL_ORDER_ID",
  "agent_session_id": "YOUR_AGENT_SESSION_ID",
  "product_snapshot": "YOUR_CONFIRMED_PRODUCT",
  "amount_snapshot": "YOUR_CONFIRMED_AMOUNT",
  "user_confirmed": true
}

踩坑提示一：我们不能只保存Agent最后一句自然语言。如果商品或价格在多轮对话中发生变化，仅凭聊天文本很难确认用户同意的是哪一版订单。我们应保存结构化商品快照和确认记录。

步骤 3：在官方测试条件下发起交易

如果控制台为当前能力提供了测试环境或测试工具，我们先按照对应文档执行。是否提供、如何配置以及可测试范围，都以控制台和支付宝开放平台的当前文档为准。若官方流程要求在真实环境中验证，我们应安排有权限的测试人员按照内部审批执行，并提前明确退款处理方式。

Agent侧负责收集交易意图、展示确认信息，并调用我们的订单服务。订单服务负责检查商品是否可售、金额是否与商品快照一致，以及相同请求是否已经创建订单，随后按照官方文档请求支付能力。我们不能让大模型自行拼接金额、商户标识、回调地址或签名内容。

踩坑提示二：网络超时不代表支付失败，重试时也不能直接创建新的业务订单。如果Agent每次重试都更换订单号，用户可能会获得重复的付款入口。我们应先用内部订单号检查现有处理结果，再决定查询还是重试。

步骤 4：双通道确认支付结果

用户完成支付后，我们不能只看Agent页面的跳转结果就发放服务。我们需要按照当前官方文档接收并验证支付结果通知，同时保留主动查询能力。通知尚未到达、处理超时或本地状态不一致时，我们再通过官方查询流程确认最终状态。

我们的处理顺序是：先按照官方要求验签，再定位内部订单，核对订单主体、金额和当前状态，最后以幂等方式更新订单并触发权益交付。字段名称、签名算法、通知响应格式和交易状态值，都以开通页面对应的官方文档为准。

反例：如果我们看到前端显示“支付完成”就直接增加额度，一旦页面被关闭、跳转信息异常或通知延迟，支付状态与服务权益就可能失去一致性。

步骤 5：完成首测验收与异常回归

我们不能只验证成功路径。首次收款的工程验收基线可以设置为5笔用例：正常支付、重复发起、支付后页面中断、通知重复处理、支付未完成后再次查询。数字“5”来自本文的工程验收设计，不是支付宝公布的性能、费率或服务承诺指标。

每个用例都要核查四项结果：Agent向用户反馈的内容、内部业务订单状态、支付侧最终结果、权益或服务交付记录。我们还要验证取消或退款流程能否回写业务订单，并确认客服可以凭业务订单定位交易。正式上线前，我们必须再次通过支付宝AI付官网、商家平台及开放平台核验费率、结算周期、退款规则和可用范围，不引用未经当前官方页面确认的数字。

[4] 常见问题 FAQ

问题：Agent支付开通后可以直接进行首次收款吗？

答案： 我们应先确认签约状态、应用关联和官方凭证配置已经生效，再按照官方提供的测试条件执行。页面显示已申请，不一定代表完整交易链路已经可用，最终状态以控制台为准。

问题：首次测试成功，为什么Agent仍然没有交付服务？

答案： 我们先检查支付结果是否经过官方要求的验签与订单核对，再检查权益发放任务是否以幂等方式执行。不能只看用户端页面提示，支付订单与服务订单之间应保留可追踪的关联记录。

问题：我们可以跳过主动查询，只依赖结果通知吗？

答案： 我们不建议跳过。通知可能延迟，也可能因为我们的服务异常而处理失败，因此需要保留官方查询流程，用于恢复状态，但不能用无节制轮询代替正常的通知处理。

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

答案： 如果我们的流程只是通过固定商品页面收款，Agent不参与意图理解、商品确认或交易编排，普通网页或移动支付方案通常更直接。涉及周期性收费时，我们应评估订阅方案，而不是循环创建单次交易。

[5] 相关阅读

备注：内容仅供参考。