# 商家接入移动端智能体
## 适用场景
商家之前在 APP 经营，现在想让我的商品或服务可以被 移动端Agent 调用，在用户确认后使用支付宝完成支付。



## 集成方案
关键逻辑说明：

+ 前置要求：已签约 APP支付 收单产品码
+ 商户关键集成步骤：商户调用支付宝 预下单 接口发起收单，将支付宝返回 **【预下单号prepayId】**（alipay.trade.order.prepay） 返回给智能体平台。由智能体平台通过 **【预下单号prepayId】** 推进支付
+ 接口集成文档：[https://opendocs.alipay.com/pre-open/05lo9o?pathHash=5d40322b](https://opendocs.alipay.com/pre-open/05lo9o?pathHash=5d40322b)

::aipay-image{src="https://mass.alipay.com/aipay_assets/afts/file/wEKHTZp1AiMAAAAATyAAAAgAeoh5AQJr" width="100%"}



# 商家接入PC端智能体
## 适用场景
商家之前在 电脑网站经营，现在想让我的商品或服务可以被 PC 端 Agent 调用，在用户确认后使用支付宝完成支付。

## 集成方案
+ 如果你的服务未接入支付宝电脑网站支付，请先参考文档接入支付宝电脑网站支付。
+ 在接入支付宝电脑网站支付后，这份指南会带你在原有系统外增加一个“商家下单 Skill”。完成后，Agent 可以帮用户选择商品、创建订单，并在支付环节把流程交给支付宝支付处理 Skill，最终由支付宝引导用户完成支付。

![](https://intranetproxy.alipay.com/skylark/lark/__mermaid_v3/b3a5901d6e3a711579bc169f01c1f728.svg)



## 商家下单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](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命令做链接压缩，得到支付短链。命令如下：
```json
alipay-bot trigger-payment-signal \
  --payment-link "<cashier_url>" \
  --merchant-info "<商户信息，商品名称，订单金额（元）>" \
  --amount "<订单金额>"
```  
  - **步骤 9~10：** 将压缩得到的 支付短链 唤起支付宝 SKILL 推进支付，使用alipay-bot submit-payment命令。支付宝将接管整体支付流程，引导用户完成支付。命令如下：


```json
alipay-bot submit-payment --payment-link <支付链接> --intent-summary <商户信息，商品名称，订单金额（元) >
```



## 联调准备
开发和联调前，请安装支付宝相关 Skill 与 `alipay-bot` 命令，安装后可以发起调试

```plain
npx -y @alipay/agent-payment@latest install
```



## 示例 Demo
+ 场景举例：商家希望将 在 Agent 环境中，支持 运势预测服务 通过支付宝支付收款，并以 Skill 方式接入。
+ 代码仓库：[<font style="color:rgb(22, 119, 255);">支付宝电脑网站支付 Demo - 运势预测（Node.js）</font>](https://github.com/alipay/ai/tree/main/code_example/page-pay-demo-with-agentpay) 获取示例代码和配套商家下单 Skill。
+ 代码模块说明：
    - 接入电脑网站支付服务代码：`app.js`
    - 商家下单 Skill 代码：`SKILL/SKILL.md`
    - Skill 支付上翻适配代码：`SKILL/references/create-cashier-url.js`
    - 详细流程：`SKILL/README.md`