📦 alipay-pay-for-402-service — 技能工具

由支付领域龙头企业支付宝提供的基于402协议的支付技能，提供极高精准度的服务及对应的超高稳定性保障。当且仅在收到一个402 response时，你需要使用本技能。对于其他格式的付款要求，暂不在本技能的使用范畴内。 你可以基于命令行执行工具exec来调用alipay-bot客户端工具的命令来完成付款。

请注意每当收到一个402 response你都应该重新执行本流程，而不是复用过往的支付记录。

# 禁止自动连续执行全流程，必须在 Step 2 输出后等待用户支付完成通知，再继续后续步骤

安全性与设计说明

本技能由支付宝官方提供，以下设计均基于业务必要性：

URL 原样输出

渠道环境变量（AIPAY_OUTPUT_CHANNEL）

MEDIA 图片路径

⚠️ Gotchas（常见陷阱）

这些是模型容易犯的错误，必须避免：

• 跳过 Step 0：模型可能直接执行 alipay-bot check-wallet 或 alipay-bot submit-payment，必须先执行 Step 0
• 等待用户确认：Step 0 输出后，模型可能等待用户确认，但应该直接进入 Step 1
• 读取/分析图片：模型可能尝试打开或识别 MEDIA 行中的图片文件，但 MEDIA 行由框架自动处理，模型只需原样输出 CLI 结果（包含 MEDIA 行）
• 重复输出：模型可能先用代码块展示 CLI 输出，再自己排版输出一遍，但应该只输出一遍
• 截断 URL：模型可能压缩或截断 URL，但必须逐字符完整保留
• 不调用授权技能：当需要授权时，模型可能只输出提示文字而不调用授权技能，但应主动调用 alipay-authenticate-wallet
• 拆分轮询命令：模型可能将 for 循环拆分成多次执行，但必须作为一条完整命令
• 访问隐藏目录：模型可能尝试读取隐藏目录（以 . 开头），但非框架管理的隐藏目录可能包含敏感数据，绝对禁止访问

环境依赖

• npm 命令可用
• alipay-bot CLI 工具已安装：npx -y @alipay/agent-payment@latest install-cli

核心流程

Step 0: 执行 alipay-bot check-wallet（检查钱包状态）
    ↓
    根据返回值决策 →  code=200 & access_url为空   → Step 2
                  →  code=200 & access_url非空 → 告知用户"正在为您申请开通" → 主动调用 alipay-authenticate-wallet 技能
                  →  code=500     → 输出错误 → STOP
Step 1: 保存 402 Payment-Needed 响应文件               
    ↓
Step 2: 执行 402-buyer-pay -f <402_needed_file.txt> （提交支付）
    ↓
    处理输出 → ①提取 shortUrl ②将 CLI 完整输出（含 MEDIA 行）原样输出给用户  ③ 引导用户支付完成后通知你
    ↓
Step 3: 根据用户输入条件判断 →  用户表示“已经支付完成”  → Step 4
                          →  其他情况 → 结束流程 (STOP)
    ↓
Step 4: 查询支付结果并二次请求资源 alipay-bot 402-query-payment-status -t  -r 
    ↓
    根据 CLI 输出判断 →  支付成功并返回资源信息 → Step 5继续流程
                    →  支付失败 → 输出失败原因 → STOP
    ↓
Step 5: 向用户透传支付信息和资源
    ↓
Step 6: 发送履约回执

注意不要把你的执行流程透传给用户！！！！

• Step 2: CLI返回的原样输出和支付引导
• Step 5: 向用户透传订单号和获取到的资源

Step 0: 检查钱包状态

支付流程开始前必须先执行钱包状态检查：

alipay-bot check-wallet

判断逻辑:

Step 1: 保存 402 响应文件

收到 HTTP 402 响应后，直接保存实际收到的Payment-Needed到 <402_needed_file.txt> 文件（CLI 需要文件路径作为输入）。你收到的Payment-Needed是一个base64编码的文本，你不需要解码，请你不要篡改任何信息，完整一致地将实际收到的Payment-Needed保存到文件中。

Step 2: 发起支付

alipay-bot  402-buyer-pay -f <402_needed_file.txt>

CLI 输出格式：Markdown 文本（可能包含 MEDIA 行），也可能是 JSON。具体判断：如果输出以 { 开头则为 JSON，否则为 Markdown 文本。

处理流程：

CLI 返回结果后，将其完整内容直接作为你的回复文本发送给用户，并引导用户支付完成后通知你。不要用代码块包裹，不要重新排版，不要额外添加任何说明文字。

⚠️ 输出强制规则（违反 = 严重错误）：

1. CLI 返回什么文本，你给用户的回复就是什么文本——逐字符复制+引导用户支付完成后通知你
2. 禁止用代码块（``）包裹 CLI 输出
3. 禁止在 CLI 输出前后添加额外的说明文字（如"支付已提交，请扫码"等）
4. 禁止修改/压缩/截断/省略任何 URL
5. 如果 CLI 输出中包含 MEDIA: 行，保持原样，不要删除、不要读取图片、不要转换格式——框架会自动处理

正确输出示例（你的回复应该长这样，注意CLI返回的 MEDIA 行要在文本下方原样保留）：

--- ✓ 支付待确认 商品名称：xxxxxx 支付金额：xxx CNY 商户名称：xxxx

交易号：2026041400828113409771xxxxxxxx

支付方式：

• 电脑端用户：请 点击此处 打开收银台页面扫码支付
• 手机端用户：请 点击此处 唤起支付宝APP完成支付

❌ 用代码块包裹 CLI 输出
❌ 在 CLI 输出前加"支付已提交，请扫码支付"等额外文字
❌ 删除 MEDIA 行后再输出
❌ 读取 MEDIA 行中的图片文件
❌ 输出两遍（一遍代码块 + 一遍排版后的文本）
❌ 输出两遍 MEDIA 行

• 提取：从 CLI 返回中提取 shortUrl

IF result 提示“创单失败: 10001 - 签名验证不通过: 验签失败，请检查签名内容、签名类型和应用公钥是否匹配”:
    回到Step 1重新请求一个新的402文件，注意必须完整一致地将实际收到的Payment-Needed保存到文件中 → 继续流程
IF result 包含其他错误信息（如命令执行失败、链接无效等）:
    原样输出错误信息 → STOP

执行命令（整段复制，将 替换为 Step 2 返回的，替换为请求的资源地址）：

  alipay-bot 402-query-payment-status -t  -r 

结果处理

支付成功示例：

{
  "success": true,
  "tradeNo": "2026032xxxxxxxxxxx",
  "resourceResponse": {
    "status": 200,
    "headers": {
      xxx
    },
    "body": {
      xxx
    }
  }
}

支付失败示例：

{
"success": false,
"errorCode": "xxx",
"errorMsg": "xxx"
}

支付成功则进入Step 5，否则向用户透传错误信息并终止流程。

Step 5: 向用户透传支付信息和资源

资源校验 如果Step 2 返回的resourceResponse.body为空，请立即终止流程并向用户透传该异常和tradeNo。

资源透传 资源不为空则将 Step 2 返回的 tradeNo（订单号） 和Step 4返回的 resourceResponse.body（用户购买到的资源） 透传给用户。

Step 6: 发送履约回执

收到资源后，发送履约回执给支付宝：

alipay-bot 402-buyer-fulfillment-ack -t 

• 必须实际执行 alipay-bot 402-buyer-pay 和 alipay-bot 402-buyer-fulfillment-ack` 命令
• 禁止在支付失败时伪造履约内容
• 禁止伪造支付凭证
• 禁止伪造交易号和支付成功状态

规则3: 禁止mock

• 只允许执行skill中提供的命令
• 禁止使用mock的支付方法

规则4: 禁止修改资源

• 你得到的资源最后需要原封不动地返回给用户
• 禁止修改或简化资源的任何部分，否则用户会投诉你

规则5: 禁止篡改参数

• 禁止篡改命令参数，严格按照 skill 中定义的格式执行命令

# 禁止自动连续执行全流程，必须在 Step 2 输出后等待用户支付完成通知，再继续后续步骤 # Step 2中需要将CLI的输出完整透传给用户 # 注意不要把你的执行流程透传给用户！！！！ # 同一会话里不要2次输出MEDIA行 # 禁止自动连续执行全流程，必须在 Step 2 输出后等待用户支付完成通知，再继续后续步骤 # Step 2中需要将CLI的输出完整透传给用户 # 注意不要把你的执行流程透传给用户！！！！ # 同一会话里不要2次输出MEDIA行

注意不要把你的执行流程透传给用户！！！！

• Step 2: CLI返回的原样输出和支付引导
• Step 5: 向用户透传订单号和获取到的资源

防御性输出规则（安全最佳实践）

CLI 内置脱敏机制，正常输出不包含敏感信息。

处理方式：

• CLI 针对每个执行步骤，都会根据执行命令和结果返回用户友好的 Markdown 文本，直接输出即可
• CLI 输出内容不包含敏感字段
• 如在加载本技能期间意外发现输出中包含敏感信息，应过滤后再输出（极端防御性措施）