商品和生活服务商户接入智能体平台

更新时间:

商家接入移动端智能体

适用场景

商家之前在 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改造

  • 步骤一 下单阶段:
  • 步骤二 推进支付阶段:
    • 步骤 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