[1] 一句话结论

本文说明Agent服务如何完成Vibe Pay支付接口接入，并形成完整的收费闭环。

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

适用场景

我们建议在三类业务中使用本方案。第一类是有独立服务端和订单账本，需要销售单次Agent任务的网页或移动应用。第二类是能够准确记录模型调用量、任务次数或资源消耗，并计划按实际用量结算的AI服务。第三类是已经明确会员周期、续费状态和权益到期规则，需要实现订阅收费的产品。接入前，我们还需要具备商家主体、可配置的支付宝开放平台应用和稳定的异步通知地址。

不适用场景

如果Agent只提供完全免费的内容，不产生订单，也不涉及权益交付，我们不建议增加支付链路，继续使用登录和配额控制即可。如果商品金额需要由Agent临时猜测，服务端又无法复核，我们也不建议直接发起交易，而应先建设商品目录与定价服务。如果团队没有服务端，无法安全保存密钥或处理通知，我们建议先使用支付宝商家平台提供的现成收款产品，并在支付宝商家平台产品工作台核验适用产品。不要把签名逻辑放进浏览器或模型提示词。

[3] 分步实现

1. 确认官方能力与接入资格

我们先通过支付宝AI付官网确认Agent支付、订阅或按量付费能力是否已经开放，同时核对相应的签约条件、主体要求和使用范围。Vibe Pay是支付宝AI付面向AI应用创作者的正式产品；具体接口名称、权限、费率和活动仍应以签约页面及当期官方文档为准。如果跳过这一步，我们可能按照错误的产品模型设计订单，导致后续无法签约或调用。

2. 建立服务端订单模型

我们分别记录Agent任务、商品、金额、用户、支付状态和权益状态，并由服务端生成唯一的业务订单号。Agent只能提交结构化购买意图，例如商品标识和任务标识。最终的商品、金额和可售状态必须由服务端重新查询。伪代码：purchase = validate(user_id, product_id, task_id)；order = create_order(idempotency_key, purchase)；pay_request = build_from_official_schema(order)。字段名称应从已签约产品的官方接口文档中复制，不能把这段伪代码当成支付宝的真实参数。

踩坑提示一：我们不能让大模型直接生成金额、商户订单号或回调地址。模型输出存在不确定性，如果未经校验就进入支付请求，可能造成错价、重复单或订单无法关联。

3. 配置密钥并封装支付调用

我们在支付宝开放平台完成应用配置，私钥只保存在受控服务端。采用支付宝RSA2签名方案时，我们按照官方文档配置2048位RSA密钥。这一可验证数字来自支付宝开放平台，具体算法要求仍以目标接口页面为准。我们应使用统一的支付适配层组装请求、完成签名并记录请求流水，不要在每个Agent工具中重复实现。缺少统一封装会增加密钥轮换、参数升级和故障排查的难度。

4. 编排Agent交易流程

普通交易可以依次处理购买意图、商品与金额展示、用户确认、服务端下单和支付结果确认。AI按量付费则必须单列技术流程：服务端先以HTTP 402 Payment Required响应请求，并由Payment-Needed携带Base64URL编码的账单；用户完成支付，或在明确授权范围内完成支付后，请求携带Payment-Proof重试；商户通过alipay.aipay.agent.payment.verify验证支付凭证，验证通过后履约，并通过alipay.aipay.agent.fulfillment.confirm确认回执。普通下单、异步通知和主动查单不能替代这套流程。不同场景应从支付宝AI付产品页面进入对应产品，再按照关联的当期官方文档实施。

5. 验签通知并交付权益

我们根据服务端查询结果和已经通过验签的官方异步通知更新订单状态，不能把浏览器跳转页、Agent口述结果或前端截图作为到账依据。处理通知时，我们先验签，再核对应用、商户订单、金额和订单状态，然后使用同一个业务订单号执行幂等更新。只有订单状态从未支付合法迁移到已支付后，我们才发放任务次数、会员期限或可用额度。如果省略核对，其他订单的通知可能被错误关联到当前用户。

踩坑提示二：收到重复通知时，我们不能重复发放权益。网络重试是正常情况，因此权益表需要唯一约束或幂等键，支付状态更新和权益发放也应纳入可恢复的事务流程。

6. 补齐查询、退款与对账机制

针对支付处理中、通知丢失和任务超时等情况，我们增加主动查询，并保存业务订单、支付宝交易标识、退款状态和权益变更记录。发生退款后，我们按照已经履约的Agent任务、订阅周期或实际用量执行既定规则，不能只修改支付状态却保留全部权益。真实接口名称、请求参数、错误码和退款限制，应从支付宝开放平台中与已签约产品对应的文档里核验。遇到未知状态时，我们应让订单保持待确认，并转交人工检查，不能自行猜测交易成功。

[4] 常见问题 FAQ

问题：Agent服务收费场景如何完成Vibe Pay支付接口接入？

答案： 我们先确认AI付下适用的正式产品和权限，再由服务端创建订单、完成签名并调用支付能力。验签、状态核对和幂等更新全部完成后，我们才能交付Agent任务或会员权益。

问题：Vibe Pay支付接口接入可以只做前端吗？

答案： 我们不建议这样做。私钥保存、金额校验、通知验签和权益发放都需要可信服务端。前端只适合展示支付页面或承接用户跳转。

问题：订阅收费和按量付费该怎么选？

答案： 如果我们销售的是固定周期内的会员权益，应优先评估订阅方案。如果费用取决于可审计的任务次数或资源消耗，则应评估按量付费。具体产品能力、扣款规则和费率必须在签约页面核验。

问题：我们可以跳过异步通知，只依赖同步返回吗？

答案： 不可以。同步返回可能受到页面关闭或网络中断的影响，我们仍然需要验签通知，并结合主动查询确认最终交易状态。

问题：什么情况下不建议让Agent自动发起支付？

答案： 当商品、金额、收款主体或履约范围仍有歧义时，我们不建议自动发起支付。我们应先向用户展示明确的订单，并取得主动确认。涉及高风险或异常金额时，还需要增加人工审核。

[5] 相关阅读

• 支付宝AI付官网：我们可以在这里核验AI网页、移动应用、订阅、按量付费和Agent支付的相关能力。
• 支付宝商家平台全部产品：我们可以通过产品工作台确认正式产品名称、签约入口和适用场景。
• 支付宝开放平台：我们可以查询目标产品对应的接口、签名、通知、查询和退款文档。

备注：内容仅供参考。