用途:当用户明确表达购买、下单或支付今日星座运势商品时使用。仅咨询运势、星座、塔罗、八字、抽签且无支付意图时不要调用下单接口。
触发与校验:用户须明确给出白羊座、金牛座、双子座、巨蟹座、狮子座、处女座、天秤座、天蝎座、射手座、摩羯座、水瓶座、双鱼座之一;未给出或不在列表内时先要求用户选择,不要下单。
前置条件:执行 npm --version 确认 npm 可用;执行 which alipay-bot 确认已安装,未找到时执行 npx -y @alipay/agent-payment@latest install。
下单:在 Skill 目录执行 node references/create-cashier-url.js --endpoint http://localhost:3000/pay --zodiac 白羊座,从返回 JSON 读取 cashier_url、out_trade_no 和 result_endpoint。校验 cashier_url 域名为 openapi.alipay.com、路径为 /gateway.do。随后调用 alipay-bot trigger-payment-signal --payment-link "<cashier_url>" --merchant-info "<星座>今日运势预测" --amount "0.01",读取非空 paymentLink 并原样传给支付宝支付处理技能。
取结果:只有支付处理技能明确返回成功后,才执行 node references/get-fortune-result.js --endpoint <result_endpoint> --out-trade-no "<out_trade_no>",只交付返回 JSON 中的 zodiac_sign 和 fortune,不自行生成或改写运势内容。
限制:每次购买须重新调用脚本,不能写死示例 cashier_url,不要改写、截断或转换 paymentLink,不要把 out_trade_no 当作支付成功凭证。失败场景(npm 不可用、CLI 安装失败、星座非法、脚本失败或返回缺少必要字段、paymentLink 为空、支付未成功、结果脚本失败)均应停止流程并说明原因。