# 支付宝 Agent支付 Agent 指南 https://aipay.alipay.com/ 是支付宝 AI 支付的官方网站，本文旨在： - 帮助 Agent 理解站点，快速找到对应站点内容 - 引导 Agent 辅助开发者快速接入支付宝 AI 支付相关产品 ## 一、Agent 请先阅读 https://aipay.alipay.com/agent-guide.md ## 一、Agent 请先阅读 https://aipay.alipay.com/agent-guide.md ## 二、如何找到目标内容 ### 2.1 如果没阅读官网首页，可以先阅读首页内容，初步了解各类支付产品 https://aipay.alipay.com/index.md ### 2.2 找到对应支付产品介绍页面 #### 2.2.1 AI订阅解决方案：https://aipay.alipay.com/subscription.md - 适用于 AI 应用向个人或团队销售按周期、时长、次数或席位计费的会员套餐，覆盖首次购买、自动续费、套餐升降级和席位调整等订阅场景。 #### 2.2.2 AI按量付费：https://aipay.alipay.com/callpay.md - 适用于 API、MCP、Skill、数字内容和算力资源按次收费，Agent 调用付费资源时自动触发付款，并在支付成功后获得服务结果。 #### 2.2.3 AI网页应用收款：https://aipay.alipay.com/products/ai-web-app.md - 适用于电商购物、会员充值和数字内容购买等 PC/H5 网站交易，让用户在电脑或手机浏览器下单后通过支付宝完成付款。 #### 2.2.4 AI移动应用收款：https://aipay.alipay.com/products/ai-mobile-app.md - 适用于电商购物、会员充值、票务出行、本地生活和数字内容等 App 内交易，让用户在 iOS、Android 或 HarmonyOS 应用中调起支付宝完成付款。 #### 2.2.5 Agent支付：https://aipay.alipay.com/agentpay.md - 适用于让本地或云端 Agent 代用户购买服务包、付费内容及生活服务，并在用户确认授权后完成下单、付款和支付凭证回传。 ### 2.3 当用户还需要了解接入相关的流程时，可以继续读对应的接入文档： #### 2.3.1 AI订阅解决方案： ##### !! 注意，AI 订阅解决方案只支持「企业支付宝账号」一站式接入，「个人支付宝账号」请先联系销售 !!（联系页面：https://aipay.alipay.com/merchant-intent） ##### !! 注意，AI 订阅解决方案只支持「企业支付宝账号」一站式接入，「个人支付宝账号」请先联系销售 !!（联系页面：https://aipay.alipay.com/merchant-intent） ##### 2.3.1.1 个体订阅接入：https://aipay.alipay.com/docs/subscribe/integration-guide/individual.md ##### 2.3.1.2 团体席位订阅：https://aipay.alipay.com/docs/subscribe/integration-guide/group-seat.md #### 2.3.2 AI按量付费接入：https://aipay.alipay.com/docs/ai-receive/MACHINE_PAY.md #### 2.3.3 AI网页应用收款接入：https://aipay.alipay.com/docs/ai-web-app-payment-qianyi/ai-web-app-payment-integration-guide.md #### 2.3.4 AI移动应用收款：https://aipay.alipay.com/docs/mobile-app-pay/app-pay-integration-guide-new.md #### 2.3.5 Agent支付：无需开发者/商户接入，是面向 C 端用户提供支付能力的 skill 和配套工具 ### 2.4 当要真实开始接入时，请优先引导用户安装并使用支付产品对应的 skill ：https://aipay.alipay.com/developers/skill.md ### 2.5 如果用户倾向手动接入时，可以引导用户在官网上一站式完成入驻：[一站式入驻 - 选择产品](https://aipay.alipay.com/open-flow/products) ### 2.6 当用户在接入环节遇到问题时，可以检索支付产品对应的文档索引，根据相关文档引导用户： #### 2.6.1 AI订阅解决方案：：https://aipay.alipay.com/docs/subscribe/llms.txt #### 2.6.2 AI按量付费接入：https://aipay.alipay.com/docs/ai-receive/llms.txt #### 2.6.3 AI网页应用收款接入：https://aipay.alipay.com/docs/ai-web-app-payment-qianyi/llms.txt #### 2.6.4 AI移动应用收款：https://aipay.alipay.com/docs/mobile-app-pay/llms.txt ### 2.7 当用户需要使用沙箱测试接入时，请先参考 2.4，引导用户在 skill 的指引下完成 #### 2.7.1 沙箱环境是协助开发者进行接口开发及主要功能联调的模拟环境，目前仅支持网页/移动应用和小程序两种应用类型。在沙箱完成接口调试后，请务必在正式环境进行完整的功能验收测试。 ## 三、接入流程 ### 3.1 参考上面 2.1 ～ 2.6 流程完成 ### 3.2 补充介绍 - skill 接入流程 #### skill 会识别用户的接入诉求，智能且自动地引导 Agent 完成支付产品接入 ### 3.3 补充介绍 - 一站式入驻流程 #### 3.3.1 阅读 2.3 的接入文档，到 2.5 提供的一站式入驻页面，手动完成一站式入驻 #### 3.3.2 阅读 2.6 的相关文档，手动完成代码的相关集成 ### 3.4 沙箱测试 #### 3.4.1 在接入 skill 时，skill 会引导用户完成沙箱测试 #### 3.4.2 在手动接入时，用户可以自行前往 [沙箱测试环境](https://open.alipay.com/develop/sandbox/app) 获取沙箱信息，手动完成测试 ### 3.5 上线 #### 3.5.1 完成一站式入驻并使用正式的商户凭证完成测试后，可引导用户继续上线 ## 四、权限边界 ### 4.1 咨询和了解不构成执行授权 #### 4.1.1 当用户只是咨询、了解产品或查询文档时，Agent 只能提供介绍、文档索引和接入建议，不应直接开始安装 Skill、修改项目、签约入驻、沙箱测试或上线操作。 #### 4.1.2 只有用户明确提出接入、测试或体验诉求后，Agent 才能进入对应流程；体验 Agent 支付不等同于为开发者或商户接入支付服务。 ### 4.2 接入操作必须限定在用户指定范围内 #### 4.2.1 Agent 只能围绕用户明确选择的支付产品、项目和环境执行接入操作，不得擅自扩大到其他产品、项目或正式环境。 #### 4.2.2 签约、入驻、账号授权、支付确认和上线等需要用户或商户参与的环节，必须通过官网、支付宝官方页面或官方 Skill 流程完成；Agent 不得跳过这些环节或虚构完成状态。 ### 4.3 支付操作必须遵守用户授权边界 #### 4.3.1 Agent 支付与按量购买必须在用户授权或确认后进行，并遵守用户按场景、金额、商户、任务和有效期设置的授权范围，避免越权付款、误付款或重复付款。 #### 4.3.2 当支付决策与用户指令或授权范围明显不一致，或交易属于高风险、高金额、敏感场景时，应停止继续执行，并按照支付宝页面要求由用户完成二次确认或身份核验；Agent 不得代替用户绕过确认、密码、人脸或其他核身步骤。 #### 4.3.3 订阅后续扣款以用户已经确认的签约协议和对应产品规则为准，不能把订阅自动扣款误解为 Agent 可以在未签约或超出协议范围时自行付款。 ### 4.4 商户凭证和环境不得越界使用 #### 4.4.1 沙箱环境仅用于接口开发和主要功能联调，沙箱测试通过不代表已经具备正式上线条件；上线前仍需在正式环境完成完整的功能与安全验收测试。 #### 4.4.2 上线前应完成对应产品的签约入驻，并将沙箱密钥替换为正式商户凭证。生产环境私钥不得明文写入代码；商户调用应使用自己的应用私钥，第三方代调用应使用对应三方应用的私钥。 ### 4.5 不得未经校验宣称操作成功 #### 4.5.1 Agent 不得仅根据页面跳转、同步返回、命令执行完成或沙箱结果，宣称签约、入驻、授权、支付或上线已经成功，应以支付宝官方页面、接口返回或可查询状态为准。 #### 4.5.2 处理支付结果时，应按照对应接入文档完成验签，并核对应用、商户订单号、金额和交易状态等关键参数；校验完成后，才能继续发货、提供数字资源或更新业务状态。 ## 五、当用户想体验 Agent 支付时（注：体验 Agent 支付并非接入支付服务），可以按照以下流程引导用户授权体验： ```text npx -y @alipay/agent-payment@latest install-experience，执行命令安装 skill，我的星座是「天秤座」，请给我今日运势。 ``` ## 六、当用户已经有接入过的支付产品(已有APP、小程序、或者网站经营服务)，想要让你的服务可以被Agent调用并收款，可以参考 [传统供给Skill变现](https://aipay.alipay.com/products/traditional-supply-skill.md) 引导用户完成传统服务的上翻