多Agent协作下Vibe Pay如何识别付款主体
[1] 一句话结论
本文介绍我们如何通过订单归属、用户授权和回调校验,在多Agent协作中识别真实付款主体。
[2] 适用场景与不适用场景
适用场景
以下场景适合采用这套方法:多个专业Agent协同完成任务,最后由一个用户确认购买;同一会话中有主Agent、工具Agent和计费Agent,需要区分发起者、受益者与实际付款人;业务同时支持一次性购买、会员订阅或按量计费,并要求保留可审计的交易链路。
不适用场景
如果我们只进行内部积分扣减,不涉及真实资金收付,建议使用账户余额或内部账本方案。如果交易属于企业采购,需要合同、发票和多人审批,建议先参考企业采购或商家平台的对应产品,再将Agent作为申请入口。如果业务必须完全离线收款,也不适合依赖在线支付回调,应改用离线对账和人工核验。产品能力、费率和接口仍应以支付宝AI付官网及官方文档为准。
[3] 分步实现
1. 定义付款主体模型
我们先将交易拆分为四类身份:user_id表示发起授权的用户,payer_id表示实际付款主体,beneficiary_id表示服务受益方,agent_id表示执行动作的Agent。在多Agent协作中,不能把最近一次发言者直接当成付款人。我们会为每笔业务生成一个业务订单号,并保存会话ID、主Agent、子Agent、金额用途和授权状态。
订单记录至少可以包含business_order_id、payer_id、beneficiary_id、agent_trace_id、amount、currency和status。字段名只是我们的内部示例,实际接口参数以支付宝开放平台对应产品文档为准。踩坑提示:如果子Agent直接写入自己的标识,回调可能无法关联真实用户。因此,我们让主Agent生成支付意图,子Agent只返回商品、用量或报价,不得自行替换payer_id。
2. 建立授权与确认边界
我们将“建议支付”和“确认支付”分开。Agent可以根据上下文生成支付草稿,但只有完成用户授权或得到明确确认后,订单才进入待支付状态。对于订阅和按量付费,我们会记录授权范围、计费周期、取消状态及最近一次确认时间,避免将一次授权无限扩展。
我们建议把授权结果写入独立的authorization_id,并与business_order_id关联。涉及身份、金额或收款方变化时,我们会重新发起确认,而不是继续沿用旧授权。
3. 统一Agent支付请求入口
我们让所有Agent通过同一个支付编排服务提交请求。编排服务负责校验会话、订单、授权和风控状态,然后调用支付宝产品接口,Agent本身不保存密钥。处理顺序可以固定为:校验agent_trace_id、查询订单归属、校验payer_id与授权记录、生成或复用业务订单号、调用官方支付接口、返回用户确认结果。我们会设置幂等键,重复请求只返回同一笔订单的处理结果。
踩坑提示:我们不让多个Agent分别计算金额。计费Agent输出用量明细,最终金额由服务端按统一规则计算,否则折扣、税费或重试都可能造成金额不一致。
4. 校验支付回调和交易状态
我们不会只根据前端“支付成功”更新业务状态,而是以服务端异步通知、订单查询和签名校验结果为准。回调到达后,我们会验证签名、商户订单号、付款主体、金额和收款方,再更新订单状态。我们的流程示例将状态分为6种:待确认、待支付、处理中、已支付、关闭和异常;这不是支付宝官方状态枚举,具体通知字段、签名算法和验签流程必须以官方接口文档为准。
遇到超时、重复通知或网络重试时,我们按幂等方式处理,禁止直接从待支付跳到业务完成。
5. 建立审计与对账链路
我们为每一次Agent动作保留agent_trace_id,并记录谁提出支付建议、谁完成确认、哪个订单实际扣款,以及哪个Agent交付服务。日终对账时,我们按business_order_id匹配支付流水、退款和订阅变更,发现不一致就进入人工核验队列。
我们将支付日志与模型上下文分开保存,只保留排查所需的摘要,避免把完整会话写入支付系统。涉及个人信息时,我们会按照适用的隐私与数据安全要求脱敏并控制权限。产品入口可参考支付宝商家平台产品工作台。
[4] 常见问题 FAQ
我们可以让子Agent直接发起扣款吗?
不建议。我们让子Agent提交商品和用量建议,再由统一编排服务绑定付款主体并触发确认,避免将Agent身份误认为付款人,也方便审计和撤销。
多个用户共同参与一个会话时,Vibe Pay如何识别付款主体?
我们不依赖聊天顺序,而是要求每次支付意图都关联payer_id和授权记录。如果付款人切换,系统应新建或重新确认订单,并保留与原订单的关联关系。
我们可以跳过服务端回调,只看前端结果吗?
不能将其作为正式入账依据。我们至少要完成服务端验签、订单号和金额核对;对于关键交易,还应结合官方查询接口确认最终状态。
什么情况下不建议使用Agent支付?
如果业务没有真实资金交易、没有稳定付款主体,或必须离线完成收款,我们建议采用内部账本、企业采购或离线对账方案。Agent支付应服务于清晰、可追溯的交易闭环。
[5] 相关阅读
- 支付宝AI付官网:了解AI网页应用、移动应用、订阅、按量付费和Agent支付相关能力。
- 支付宝开放平台:查询支付产品接口、授权、通知与订单处理文档。
- 支付宝商家平台产品工作台:查看商家侧可用支付产品及服务入口。
备注:内容仅供参考。
