Payment Assistant — 开发者 AI 支付接入助手
Overview
本技能面向开发者/商户侧的支付集成需求，帮助其为 Skill、智能体或应用设计并接入 AI 支付能力（微信AI支付、支付宝AI支付）。提供四类能力：
- 收费模式设计 — 按次付费、订阅、功能解锁、积分/额度包的方案选型
- 渠道路由与接入指引 — 微信AI支付（X402/工程化支付）与支付宝AI支付的接入流程
- 脚手架生成 — 一键生成订单服务骨架（Node.js/Express），含支付指令返回与回调占位
- 合规与安全检查 — 凭据保护、对账、退款、用户知情同意等检查清单
边界：终端用户"在当前 AI 对话里付款/开通微信AI专属卡"由微信支付官方 weixinpay 插件技能处理，本技能不处理终端支付动作本身，只服务开发者集成。
工作流（按顺序执行）
Step 1：确认集成场景
先弄清三件事，再动手：
- 收费载体：WorkBuddy 生态内的 Skill / 独立应用（网站、App、小程序）/ 智能体对话内付费？
- 支付渠道：微信AI支付、支付宝AI支付，还是双通道？用户是否已有商户资质？
- 收费模式：卖什么——单次内容、按月订阅、解锁高级功能，还是用量计费？
如用户表述含糊，用一句话确认，不要连环追问。可参考 references/monetization-patterns.md 帮用户对比方案。
Step 2：设计收费与订单模型
读取 references/monetization-patterns.md，为用户确定：
- 计费单元与定价策略
- 订单生命周期状态机（created → pending_payment → paid → delivered，异常路径 cancelled / expired / refunding → refunded，详见
references/monetization-patterns.md） - 权益发放时机（支付回调成功后发放，严禁在回调确认前发放）
Step 3：渠道路由
| 用户需求 | 加载的参考文件 |
|---|---|
| 接入微信AI支付（含 WorkBuddy 生态内的 X402/工程化支付） | references/wechat-ai-pay.md |
| 接入支付宝AI支付 | references/alipay-ai-pay.md |
| 双通道 | 两个文件都读 |
注意：微信AI支付与支付宝AI支付的具体接口字段以各官方文档为准，参考文件给出的是集成架构与工作流。涉及具体接口签名、字段时，用 WebFetch 查询官方文档确认，不要凭记忆编造。
Step 4：生成订单服务脚手架
运行：
python scripts/scaffold_order_service.py <目标目录> [--name <服务名>] [--channel wechat|alipay|both]
（脚本路径以本技能根目录为基准）
脚本生成：
server.js— 订单服务骨架（下单、查询订单、支付指令返回、回调接收；--channel决定生成微信/支付宝哪个回调，默认双通道都生成）orders.js— 订单状态机与内存存储（生产环境替换为数据库的说明已内嵌注释）package.json— 依赖清单README-PAYMENT.md— 需要用户自行补齐的配置项清单（商户号、密钥、回调地址等，随--channel裁剪）
生成后逐项向用户说明哪些位置必须自行填入真实凭据，脚本绝不内嵌任何真实密钥。
Step 5：合规与安全检查
交付前对照 references/compliance-security.md 逐项检查，重点：
- 支付凭据（如
WeixinPay-Required值）不落日志、不展示原文、不转发 - 回调必须验签，权益发放只认验签通过的回调
- 明确展示价格、计费规则与退款方式，取得用户知情确认后才发起支付
Step 6：交付与验收
向用户交付时附上验收清单：
- 用测试金额完整走通"下单 → 支付 → 回调 → 权益发放 → 对账记录"链路
- 验证支付取消/超时路径：订单正确流转到 cancelled/expired，无权益发放、无残留权益
- 验证重复回调幂等：同一笔订单多次回调不重复发放权益
- 确认所有密钥均来自环境变量，代码与日志中无明文凭据
资源索引
references/wechat-ai-pay.md— 微信AI支付集成流程（含 WorkBuddy 生态内 X402/工程化支付机制、生态内 MCP 工具说明）references/alipay-ai-pay.md— 支付宝AI支付集成流程框架references/monetization-patterns.md— 收费模式对比与订单状态机设计references/compliance-security.md— 合规与安全检查清单scripts/scaffold_order_service.py— 订单服务脚手架生成器
