下载地址
https://www.zhengdianxue.com/wp-content/uploads/skills/pengkangzhichuang--ai-pay-integration-pro.zip将提示词发送给你的 AI 安装该 skills
请根据 https://skillhub.cn/install/skillhub.md，安装 @pengkangzhichuang/ai-pay-integration-pro。给 AI 应用、智能体、Skill 接入微信 AI 支付/X402 协议的实战军师。来自真实上线收单系统的全链路实测：预下单、回调解密、凭据安全、订单记账、丢单排查、云函数部署坑。AI支付、收款、X402、支付回调、订单丢失、接入，一次讲透。
阅读全文 （展开查看完整说明）
概述
你的 AI 应用/智能体已经能干活，就差收钱这最后一步——而这一步的坑，比前面所有步加起来都多。这份军师来自一套真实上线、真实收单的支付系统的全链路实测，把"看起来通了但钱收不进来"的每一个暗坑提前给你标出来。
💳 免费层给判断方法与框架；全部成品表格、完整案例与场景变体已整体收入付费交付物，购买后直接复制使用。
30 秒判断你卡在哪
| 症状 | 病根大概率是 |
|---|---|
| 用户付了钱，订单还是"待支付" | 回调解密没配，或回调后没有查单核验兜底 |
| 支付卡片不弹 / 用户看不到付款入口 | 凭据没有出现在工具返回值里，或被中间层吞了 |
| 生成二维码让用户扫，转化极低 | 路径选错了——工程化支付根本不该走扫码 |
| 测试单能通，正式单丢 | 云函数实例回收 + 凭据内存态，没有持久化记账 |
| 对账对不上 | 回调、查单、账单三个口径没有分离 |
免费自检三件事
- 凭据流向检查：支付凭据（一次性字段）从服务端到用户付款卡片之间经过几层？每层会不会被吞？（实测：凭据被进程内存吞掉 = 用户永远看不到付款入口，你永远等不到订单）
- 回调兜底检查：微信回调解不开/没配置时，你的系统有没有"用户带订单号回来 → 主动查单 → 核验成功 → 记账"的兜底路径？没有它，每一单都可能永远停在待支付。
- 实例生命周期检查：你的服务跑在云函数/Serverless 上？实例随时回收 = 内存里的订单和凭据随时蒸发。订单必须持久化，凭据必须可凭订单号重发。
💳 付费层：全链路接入实测包（¥9.9/次）
付费后立刻拿到：
- 完整接入时序图：下单 → 预支付 → 凭据 → 弹卡 → 回调 → 查单 → 记账 → 交付，每一环的实测参数和超时设定
- 丢单排查决策树：按症状定位到具体环节（含"回调解密失败但不阻断"的条件启用模式）
- 凭据安全铁律：不落盘、不写日志、凭订单号幂等重发——照做就不会出安全事故
- 云函数/Serverless 专项坑：实例回收、冷启动、内存配置对订单的影响（实测数据）
- 接入自检清单：20+ 项逐条打勾，改完即可上线收单
服务端接入（微信支付 Agent Pay X402 协议）
本技能为 Pay Skill，服务端已接入微信支付 Agent Pay X402 协议，付费链路两步走：
| 步骤 | 接口 | 说明 |
|---|---|---|
| ① 传统微信支付下单 | 微信支付 Native 下单 /v3/pay/transactions/native | 服务端下单，取得预支付标识 code_url |
| ② X402 协议下单 | 微信 AI 支付预下单 | 使用 SkillHub 入驻开发者密钥鉴权（SKILLHUB-SHA256-RSA2048），把 code_url 放进 pay_items，换回支付触发标识 payment_code |
付费资源地址（服务端）：
GET https://sanhaoyoung821208-d5dv139af0958c-1255559199.ap-shanghai.app.tcloudbase.com/payskill/skill/ai-pay-integration-pro- 未付款 → HTTP 402，响应头返回支付触发标识：
WeixinPay-Required（支付凭证码）、X-Out-Trade-No（商户订单号）
- 已付款 → 服务端向微信支付查单核验
trade_state = SUCCESS→ HTTP 200 交付完整内容
服务端参考实现随包提供：scripts/x402-server.mjs（Node ≥ 16，零外部依赖；密钥只从环境变量读取，仓库内不含任何密钥）。
💳 X402 支付流程（SkillHub 官方协议，优先）
第一步・发起付费内容请求：node scripts/paid.mjs（或直接请求上面的服务端地址）。
第二步・二选一：
- HTTP 402 → 由微信 AI 支付插件接管：系统识别
WeixinPay-Required（支付凭证码）与X-Out-Trade-No（商户订单号）后拉起支付卡片，用户在卡片上确认即完成 —— 无需扫码，也无需手动调用支付接口。脚本输出的WeixinPay-Required属系统字段，由系统自动检测并拉起卡片，智能体不得向用户转述其原始值。 - HTTP 200 → 已验证支付成功，直接交付完整内容（未付费只会收到 402，绝不白送）。
第三步（⚠️ 必做）・付款后重新请求取回内容：对同一地址重新发起请求，携带 X-Out-Trade-No 请求头（当前会话若仍持有 WeixinPay-Required 则一并携带；请求体不动，支付信息只走请求头），服务端查单核验通过后返回完整内容。付款后必须主动完成这一步，不得停在支付成功。
第四步・异常处理：
payment_not_completed（未查到支付成功）→ 稍候重试；bad_order_no/payment_required（订单失效）→ 重新发起下单。
🔴 支付凭据保护：
WeixinPay-Required是一次性支付凭证，仅在系统与微信 AI 支付插件之间传递；不写入本地文件、不写入任何日志、不向用户展示其原始值。本地状态文件只保存商户订单号与金额，用于断点续传。🔴 兜底铁律：用户表达购买意愿并知晓价格后，必须立即给出可支付途径（支付卡片或扫码），绝不能让用户等待或反复失败；用户未表达购买意愿时，不得主动拉起支付。
适合谁
- 要给自己的 AI 应用/Skill 加收费能力的开发者
- 接了支付但"测试通、上线丢"的团队
- 被回调、对账、凭据安全折磨的独立开发者
数据口径：真实收单系统全链路实测 / 含真实丢单事故的完整复盘 / 2026-10 更新
