> 我之前在APP、小程序、网站经营，现在我想要让我的服务可以被Agent调用并收款。

## 适用场景

您已开通并接入以下支付宝支付产品：

- 支付宝 **电脑网站支付**

## 接入演示视频

::aipay-video{src="https://gw.alipayobjects.com/v/huamei_xpdhyt/afts/video/7CUwRqyERSIAAAAAgEAAAAgAfoeUAQBr" width="100%"}

---

## 1. 整体流程说明

### 1.1 交互流程
```mermaid
sequenceDiagram
    actor User as 用户

    box rgb(235, 235, 255) 智能体侧
        participant OC as OpenClaw/Hermes
        participant OrderSkill as 商家下单 skill
        participant PaySkill as 支付宝支付处理 skill
    end

    box rgb(235, 235, 255) 服务端
        participant MerchantServer as 商户服务端
        participant Alipay as 支付宝
    end

    User->>OC: 1. 请求购买商户服务
    OC->>OrderSkill: 2. 加载并调用商家下单 skill

    OrderSkill->>MerchantServer: 3. 选择商品并下单支付
    MerchantServer->>Alipay: 4. 发起支付宝收单
    Alipay-->>MerchantServer: 返回支付单
    MerchantServer-->>OrderSkill: 返回订单信息，包含支付宝支付链接

    OrderSkill->>PaySkill: 唤起支付宝技能命令，压缩支付链接
    PaySkill-->>OrderSkill: 返回短链交易信息

    OrderSkill->>OrderSkill: 3. 完成商户处理逻辑，用支付宝推进支付
    OrderSkill-->>OC: 4. 提供支付宝短链交易信息，引导用户加载支付宝支付处理 skill

    OC->>PaySkill: 5. 唤起支付宝支付处理 skill
    PaySkill->>PaySkill: 6. 推进付款流程
    PaySkill-->>Alipay: 基于交易信息进行支付
```

### 1.2 详细流程

1. **用户发起请求**
   商家下单Skill 执行服务流程（搜索、选择、确认）

2. **商家SKILL执行下单流程**
   调用支付宝收单接口，生成支付宝交易信息，并在SKILL脚本中调用支付宝命令压缩成短链

3. **引导加载支付宝支付处理技能，使用支付宝进行支付** `关键节点`
   后续由支付宝支付处理技能接管（检查支付能力开通状态 → 提交支付 → 检查支付结果 → 返回结果）

4. **商家下单Skill 根据支付结果继续履约（发货、开通服务等）**

### 1.3 核心原则

**商家下单skill** 专注负责业务流程，当选择支付宝作为支付渠道时，支付宝支付处理技能负责支付。

当您的服务流程到达支付环节，且用户选择支付宝作为支付渠道时，只需输出支付宝支付链接并引导模型加载支付宝支付处理技能，支付宝支付处理技能会自动接管后续流程。

---

## 2. 如何编写自己的服务 Skill

### 2.1 Skill 结构要求

您的服务 Skill 需要能够：

1. 执行完整的业务流程（搜索、选择、确认等）
2. 生成订单并获取支付宝支付链接
3. 输出完整的支付宝短链，并引导模型加载支付宝支付处理技能

### 2.2 支付环节对接规范

#### 示例：电商平台下单流程

```
检查登录状态 → 搜索商品 → SKU 选择 → 提交订单 → 调用支付宝技能
```

`提交订单` 这一步骤涉及与支付宝支付处理技能交互，重点展示这一部分的内容：

```markdown
### Step 1：检查登录状态
（访问电商网站，检查用户的登录状态，若用户未登录则引导用户登录）
...

### Step 2：搜索商品
(根据用户输入搜索相关商品，返回商品列表供用户选择)
...

### Step 3：SKU 选择
(提取商品规格列表，供用户选择)
...

### Step 4：提交订单
（按照用户选择商品和规格提交订单，选择支付宝作为支付渠道，提交订单）
（将支付宝返回支付链接，通过支付宝命令做支付链接压缩）
（如果压缩结果返回 JSON 包含非空 `paymentLink`，立即加载并调用支付宝支付处理技能）
（无需判断格式，将 JSON 结构中 `paymentLink` 的完整原始值传给该技能作为支付链接，由支付宝支付处理技能提交支付）
（不要自行打开、改写、压缩、截断或展示任何链接。）
（按支付宝支付处理技能指定流程继续处理支付，否则认为失败。）

**决策逻辑**：
IF 技能加载调用成功 → 任务完成
ELSE → 输出错误信息 → STOP
```

### 2.3 输出格式规范

在step 4 获取到支付宝支付短链后，您的skill/工具 应输出类似以下内容：

```
订单已生成，接下来需要加载支付宝支付处理技能，使用支付宝完成支付
```

**支付宝支付短链特征：**

- 前缀为 `alipay_*`
- 必须逐字符完整保留，禁止截断或修改

### 2.4 示例demo下载
请访问[支付宝电脑网站支付 Demo - 运势预测 (Node.js)](https://github.com/alipay/ai/tree/main/code_example/page-pay-demo-with-agentpay)
获取示例代码和配套上翻skill。

---

## 3. 联调测试

### 3.1 环境准备

#### 前置依赖

| 软件 | 版本 |
| --- | --- |
| OS | macOS、Linux（CentOS、Ubuntu） |
| Node.js | v22.*+ |
| npm | 10.*+ |
| OpenClaw | 最佳体验：2026.3.28+ |

#### Skill 安装

**安装命令：**

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

> **提示信息示例**
>
> 帮我装一下支付宝的 Skill，安装命令是 `npx -y @alipay/agent-payment@latest install`

### 3.2 与支付宝 Skill 对接

#### 对接步骤

1. 在您的商家下单skill 中完成订单生成，调用支付宝收单接口，获取支付宝支付链接
2. 将支付链接调用支付宝命令，生成支付短链
3. 引导加载支付宝支付处理技能

#### 对接要点

- 商家下单skill 无需安装任何额外依赖，支付能力由 支付宝支付处理技能 技能提供
- 唯一要求：能够输出完整的支付宝短链，并引导模型加载支付宝支付处理技能

### 3.3 与支付宝 Skill 联调

以下是支付宝两个skill的触发方式

#### 1. 支付宝支付服务开通和授权技能

- 开启支付宝支付功能
- 查询开通状态

#### 2. 支付宝支付处理技能

- 帮我支付 xxxx
- 帮我查询刚刚的订单状态

联调时请先使用支付宝支付服务开通和授权技能，按照技能指引开通支付宝支付功能后：

- 按照您的技能场景唤起您的技能
- 在执行完您的业务流程后观察是否正确引导到支付宝支付处理技能

---

## 4. 发布指南

### 4.1 集成清单

在发布您的商家下单skill前，请确认：

- [ ] 检测到选择支付宝作为支付渠道，并进入到下单环节时，展示用户下单商品的详细信息（商品、SKU、价格等），询问用户是否需要支付并等待用户明确回复
- [ ] 获取并正确输出支付宝支付链接，能够正确引导使用支付宝支付技能 支付宝支付处理技能 推进支付
- [ ] 所有 URL 逐字符完整保留，禁止截断或修改

### 4.2 常见错误清单

| 错误 | 后果 | 解决方案 |
| --- | --- | --- |
| 下单后不调用支付技能 | 订单超时取消 | 引导模型使用支付宝支付处理技能进行处理 |
| 支付宝支付链接被截断 | 支付失败或金额错误 | 逐字符完整保留所有 URL |
| 未开通支付宝支付功能 | 无法进行支付 | 下单结束路由到支付宝支付处理技能，该技能可引导用户开通支付宝支付功能 |

### 4.3 发布方式

#### 开源方案

1. 推送您的技能到 clawhub
2. 在 github 中同步建立仓库，并在文档中增加 clawhub 链接
3. 在您的官网中增加 clawhub & github 的地址

#### 闭源方案

1. 在您的官网提供 npx 脚本等一键安装&更新脚本

### 4.4 用户使用指令

**用户安装并使用您的 Skill 的典型指令：**

```
从clawhub帮我安装 [您的 Skill 名称]
```

或

```
帮我安装 [您的 Skill 名称]：[您的一键安装脚本]
```

**您的文档中应包含：**

- 清晰的 Skill 名称
- 一句话安装指令
- 使用示例
- 与支付宝支付处理技能打通的说明