商品和生活服务商户接入智能体平台
更新时间:
商家接入移动端智能体
适用场景
商家之前在 APP 经营,现在想让我的商品或服务可以被 移动端Agent 调用,在用户确认后使用支付宝完成支付。
集成方案
关键逻辑说明:
- 前置要求:已签约 APP支付 收单产品码
- 商户关键集成步骤:商户调用支付宝 预下单 接口发起收单,将支付宝返回 【预下单号prepayId】(alipay.trade.order.prepay) 返回给智能体平台。由智能体平台通过 【预下单号prepayId】 推进支付
- 接口集成文档:https://opendocs.alipay.com/pre-open/05lo9o?pathHash=5d40322b
商家接入PC端智能体
适用场景
商家之前在 电脑网站经营,现在想让我的商品或服务可以被 PC 端 Agent 调用,在用户确认后使用支付宝完成支付。
集成方案
- 如果你的服务未接入支付宝电脑网站支付,请先参考文档接入支付宝电脑网站支付。
- 在接入支付宝电脑网站支付后,这份指南会带你在原有系统外增加一个“商家下单 Skill”。完成后,Agent 可以帮用户选择商品、创建订单,并在支付环节把流程交给支付宝支付处理 Skill,最终由支付宝引导用户完成支付。
商家下单skill改造
- 步骤一 下单阶段:
- 步骤 1~6: 需要提供一个SKILL,由 Agent 唤起,支持 选品、下单、支付等处理流程。支付流程需要对接支付宝 电脑网站支付 收单产品,通过 GET 方式集成alipay.trade.page.pay接口。接口文档参考:https://aipay.alipay.com/docs/vibe-pay/ai-web-app-payment-qianyi/api-list/alipay-trade-page-pay.html
- 步骤二 推进支付阶段:
- 步骤 7~8: 取 alipay.trade.page.pay 接口返回的 pageRedirectionData 字段,为了防止 pageRedirectionData 过长,需要唤起支付宝alipay-bot trigger-payment-signal命令做链接压缩,得到支付短链。命令如下:
alipay-bot trigger-payment-signal \
--payment-link "<cashier_url>" \
--merchant-info "<商户信息,商品名称,订单金额(元)>" \
--amount "<订单金额>"
- 步骤 9~10: 将压缩得到的 支付短链 唤起支付宝 SKILL 推进支付,使用alipay-bot submit-payment命令。支付宝将接管整体支付流程,引导用户完成支付。命令如下:
alipay-bot submit-payment --payment-link <支付链接> --intent-summary <商户信息,商品名称,订单金额(元) >
联调准备
开发和联调前,请安装支付宝相关 Skill 与 alipay-bot 命令,安装后可以发起调试
npx -y @alipay/agent-payment@latest install
示例 Demo
- 场景举例:商家希望将 在 Agent 环境中,支持 运势预测服务 通过支付宝支付收款,并以 Skill 方式接入。
- 代码仓库:支付宝电脑网站支付 Demo - 运势预测(Node.js) 获取示例代码和配套商家下单 Skill。
- 代码模块说明:
- 接入电脑网站支付服务代码:
app.js - 商家下单 Skill 代码:
SKILL/SKILL.md - Skill 支付上翻适配代码:
SKILL/references/create-cashier-url.js - 详细流程:
SKILL/README.md
- 接入电脑网站支付服务代码: