# Fortune Prediction Payment

> 今日星座运势商品下单与支付宝支付接管 Skill。用于用户明确要购买、下单或支付今日星座运势商品时，先确认用户给出的星座属于白羊座、金牛座、双子座、巨蟹座、狮子座、处女座、天秤座、天蝎座、射手座、摩羯座、水瓶座、双鱼座之一，再校验 `npm` 可用和 `alipay-bot` CLI 已安装，未安装时执行 `npx -y @alipay/agent-payment@latest install`，再调用本 Skill 的 `references/create-cashier-url.js` 脚本并传入 `--endpoint` 与 `--zodiac`，由脚本请求本地标准电脑网站支付接口 `POST /pay` 并解析支付宝收银台链接，再调用 `alipay-bot trigger-payment-signal` 生成 `paymentLink`，交给支付宝支付处理技能完成支付。支付成功后必须调用 `references/get-fortune-result.js`，用本次 `out_trade_no` 从项目结果接口取回 `zodiac_sign` 和 `fortune`，只交付该接口返回的内容，不要自行生成运势。

- Skill: `alipay/fortune-prediction-payment` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add alipay/fortune-prediction-payment`
- Raw SKILL.md: https://api.skillmd.com/api/skills/alipay/fortune-prediction-payment/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: alipay (https://skillmd.com/u/alipay)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/alipay/fortune-prediction-payment

---


# 今日星座运势商品支付

## 触发条件

仅当用户明确表达购买、下单或支付今日星座运势商品时使用本 Skill。

如果用户只是咨询今日运势、星座、塔罗、八字、抽签等内容，且没有购买或支付意图，不要调用下单接口。

用户必须明确给出以下星座之一：白羊座、金牛座、双子座、巨蟹座、狮子座、处女座、天秤座、天蝎座、射手座、摩羯座、水瓶座、双鱼座。如果用户没有给出星座，或给出的值不在列表中，先要求用户从该列表中选择一个星座，不要下单。

## Prerequisite

在调用 `alipay-bot trigger-payment-signal` 前必须完成：

1. 执行 `npm --version`，确认 `npm` 命令可用；如果不可用，停止流程并说明缺少 `npm`。
2. 执行 `which alipay-bot`，确认 `alipay-bot` CLI 已安装。
3. 如果 `which alipay-bot` 找到可执行文件，跳过安装。
4. 如果未找到 `alipay-bot`，执行：

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

## 参数说明

调用下单脚本时必须传入以下参数：

| 参数 | 是否必填 | 说明 |
|------|----------|------|
| `--endpoint` | 是 | 本地电脑网站支付接口地址，默认使用 `http://localhost:3000/pay` |
| `--zodiac` | 是 | 用户选择的星座，必须使用下方可选值之一 |

`--zodiac` 可选值如下，传参时必须逐字使用这些中文值：

```text
白羊座
金牛座
双子座
巨蟹座
狮子座
处女座
天秤座
天蝎座
射手座
摩羯座
水瓶座
双鱼座
```

如果用户只说“白羊”“金牛”等简称，可先规范为对应的完整值（如“白羊座”“金牛座”）再传入 `--zodiac`。如果无法判断用户选择的是哪一个星座，必须先追问，不要下单。

## 下单脚本

使用本 Skill 自带脚本生成支付宝收银台链接。脚本会请求 `--endpoint` 指定的标准电脑网站支付接口`POST /pay`，并提交 `--zodiac` 指定的星座（底层代码实现是`alipaySdk.pageExec(
      'alipay.trade.page.pay',..)`），读取返回的 HTML 表单，并输出包含 `cashier_url` 的 JSON。

在本 Skill 目录执行：

```bash
node references/create-cashier-url.js \
  --endpoint http://localhost:3000/pay \
  --zodiac 白羊座
```

如果当前工作目录不是本 Skill 目录，使用 `SKILL.md` 所在目录下的脚本绝对路径。

脚本返回 JSON。必须从返回 JSON 中读取 `cashier_url` 字段，作为支付宝收银台链接；同时保存 `out_trade_no` 和 `result_endpoint`，用于支付成功后获取本项目生成的运势内容。

示例返回结构类似：

```json
{
  "out_trade_no": "20260628xxxxxx",
  "zodiac_sign": "白羊座",
  "result_endpoint": "http://localhost:3000/fortune-result",
  "cashier_url": "https://openapi.alipay.com/gateway.do?method=alipay.trade.page.pay&..."
}
```

其中 `cashier_url` 的完整原始值就是后续传给 `alipay-bot trigger-payment-signal` 的 `<alipay_cashier_url>`。

`out_trade_no` 只用于商户侧订单追踪，不代表支付成功，不要传给支付宝支付处理技能。

## 支付后取结果脚本

支付成功后，必须调用本 Skill 自带脚本获取项目后端生成的今日星座运势：

```bash
node references/get-fortune-result.js \
  --endpoint http://localhost:3000/fortune-result \
  --out-trade-no "<out_trade_no>"
```

实际执行时：

- `--endpoint` 优先使用下单脚本返回的 `result_endpoint`。
- `--out-trade-no` 必须使用下单脚本返回的本次 `out_trade_no`。
- 只有支付宝支付处理技能明确返回成功后，才能调用该脚本。
- 只允许交付该脚本返回 JSON 中的 `zodiac_sign` 和 `fortune`，不要自行生成、改写或补充其它运势内容。

示例返回结构类似：

```json
{
  "paid": true,
  "out_trade_no": "20260628xxxxxx",
  "trade_status": "TRADE_SUCCESS",
  "zodiac_sign": "白羊座",
  "fortune": "今天行动力很旺，适合主动推进计划，你迈出的第一步会带来不错的回响。"
}
```

## 支付流程

1. 完成“Prerequisite”，确认 `npm` 可用且 `alipay-bot` CLI 已安装。
2. 调用 `references/create-cashier-url.js` 脚本，传入 `--endpoint` 和 `--zodiac`；`--zodiac` 必须使用用户明确选择的星座。
3. 从脚本返回 JSON 中读取非空 `cashier_url`，并保存本次 `out_trade_no`、`zodiac_sign` 和 `result_endpoint`。
4. 校验 `cashier_url` 必须指向支付宝开放平台网关：域名为 `openapi.alipay.com`，路径为 `/gateway.do`；否则停止。
5. 调用 `alipay-bot trigger-payment-signal`。

```bash
alipay-bot trigger-payment-signal \
  --payment-link "<cashier_url>" \
  --merchant-info "<星座>今日运势预测" \
  --amount "0.01"
```

6. 从 `trigger-payment-signal` 返回 JSON 中读取非空 `paymentLink`。
7. 立即加载支付宝支付处理技能，并把完整原始 `paymentLink` 传给该技能。
8. 支付宝支付处理技能返回成功前，不要交付运势预测结果，也不要声明支付成功。
9. 支付成功后，调用 `references/get-fortune-result.js`，传入下单脚本返回的 `result_endpoint` 和 `out_trade_no`。
10. 从结果脚本返回 JSON 中读取 `zodiac_sign` 和 `fortune`，并把这两个字段原样交付给用户。

## 支付接管规则

- 每次购买都必须重新调用脚本，并从本次返回 JSON 中读取新的 `cashier_url`。
- 每次购买都必须传入用户本次选择的合法星座，不要替用户编造或改写星座。
- 支付成功后的内容必须来自 `references/get-fortune-result.js` 的返回结果。
- 不要自行生成、扩写、润色、替换或重新随机今日星座运势内容。
- 不要在支付成功前调用结果脚本，也不要在支付成功前交付 `fortune`。
- 不要把示例响应中的 `cashier_url` 写死到流程中；该链接包含时间戳和签名，可能已过期。
- 不要自行改写脚本输出的 `cashier_url`；只做前缀校验。
- 只把 `trigger-payment-signal` 返回 JSON 中的 `paymentLink` 传给支付宝支付处理技能。
- 必须逐字符完整保留 `paymentLink` 原始值。
- 不要打开、展示、改写、重新编码、压缩、截断或转换 `paymentLink`。
- 不要把脚本返回的 `cashier_url` 直接交给支付宝支付处理技能。
- 如果没有拿到非空 `paymentLink`，视为失败并停止流程。

## 失败处理

- `npm` 不可用：停止流程，说明本机缺少 `npm`。
- `alipay-bot` 未安装且执行 `npx -y @alipay/agent-payment@latest install` 失败：停止流程，说明支付宝支付接管 CLI 安装失败。
- 用户未给出合法星座：先要求用户从 12 星座中选择一个，不要下单。
- 脚本执行失败：停止流程，说明今日星座运势商品下单失败。
- 脚本没有返回合法 JSON：停止流程，说明订单返回格式错误。
- 脚本返回 JSON 中没有非空 `cashier_url`：停止流程，说明订单未返回支付宝收银台链接。
- 下单脚本没有返回非空 `out_trade_no` 或 `result_endpoint`：停止流程，说明订单返回缺少取结果信息。
- `cashier_url` 前缀不符合要求：停止流程，说明返回的不是支付宝收银台链接。
- `trigger-payment-signal` 未返回非空 `paymentLink`：停止流程，说明支付接管信息生成失败。
- 支付宝支付处理技能未成功完成支付：不要交付今日星座运势结果，按该技能返回结果说明当前支付状态。
- 结果脚本执行失败：停止流程，说明支付已处理但未能从项目接口获取今日星座运势，不要自行生成替代内容。