微信支付接入助手 🔥 Python/Node.js专精版

基于微信支付官方Skills（MIT协议）改造 官方只有Java/Go示例？我们补全了Python和Node.js！ 专为小程序开发者优化，上线前必查！

📢 重要声明

本技能基于微信支付官方 wechatpay-skills（MIT协议）改造，新增：

• ✅ Python代码示例（官方无，我们补）
• ✅ Node.js代码示例（官方无，我们补）
• ✅ 小程序支付场景专精
• ✅ 精简文档快速查阅

⚠️ Python/Node.js示例为参考实现，由AI基于官方Java示例翻译生成，非微信支付官方维护。

• 请逐行review签名构造、HTTP调用、字段命名、回调解密等关键逻辑
• 上线前必须在测试环境完整验证
• 出现问题时请以官方Java/Go示例为准

全局交互规范

‼️ 以下规则适用于本技能所有能力、所有对话轮次，优先级高于各能力的局部规则。

1. 所有问题必须得到用户明确回答后才能继续

如果一次提出了多个问题，必须逐一检查每个问题是否都已获得用户的明确答复。对于未回答的问题，必须再次追问，严禁对未回答的问题自行假设、推断或使用默认值。

2. 接入模式前置确认

任何能力使用前须先确认商户模式或服务商模式，已明确则无需重复。

• 商户模式：自己申请微信支付，自主开发
• 服务商模式：帮助他人（子商户）接入微信支付

3. 分步确认协议

简单知识问答除外，需要帮用户排查、分析或执行操作时必须遵守：

能力概览

能力1：产品选型

用户问「该用哪种支付方式」或比较各方式区别时 → 加载 支付产品对比.md

支付方式速查

选型决策树

你的用户在哪？
├── 微信小程序内 → 小程序支付
├── 微信内打开的H5/公众号 → JSAPI支付
├── PC网站 → Native支付
├── 原生App（iOS/Android）→ APP支付
├── 手机浏览器（非微信）→ H5支付
└── 线下扫码枪/收银台 → 付款码支付

关键文档

• 支付产品对比 + 选型决策树 + 准入条件 → 📄 支付产品对比.md

能力2：代码示例

用户要某个接口的代码示例时 → 确认接入模式和语言，加载对应文件

⚠️ 核心规则

确认顺序

每次提供代码前必须确认：

1. 接入模式：商户模式 / 服务商模式
2. 开发语言：Python / Node.js / Java / Go
3. 具体接口：下单 / 调起支付 / 查单 / 关单 / 退款 / 回调处理 / ...

⚠️ 支付方式仅「下单」和「调起支付」接口需确认，其他接口（查单、退款、回调）各支付方式完全相同。

Python/Node.js优先

我们的差异化优势是Python和Node.js示例，优先推荐Python或Node.js：

• 官方只有Java/Go，我们补全了Python和Node.js
• 代码完整可运行，包含完整签名逻辑
• 标注了关键注意事项

接口索引

跨语言处理

用户使用Python/Node.js时：直接输出我们的完整代码示例，无需额外确认。

用户使用Java/Go时：输出官方示例，文件位置在：

• 📄 Java接口索引.md（官方）
• 📄 Go接口索引.md（官方）

示例代码文件

Python代码示例

Node.js代码示例

能力3：业务知识速查

用户问参数获取、APPID绑定、订单状态、退款规则等业务知识时

常用知识速查

小程序支付专属知识

小程序支付有特殊要求，必须确认：

1. ✅ AppID必须已认证（个人小程序不支持支付）
2. ✅ mchid和AppID必须已绑定（在商户平台配置）
3. ✅ 调用支付前必须获取用户openid（通过wx.login获取code，再用code换openid）
4. ✅ 支付目录必须在AppID下配置（公众平台 → 产品设置 → 支付授权目录）
5. ✅ appid必须通过云开发换取到手

能力4：接入质量评估

用户准备上线或想检查代码隐患时

⚠️ 只检查用户实际使用的功能模块

未使用的功能不检查、不提及。

必查清单

上线前必查项

• V3签名构造正确（SHA256 with RSA）
• 证书序列号正确
• 时间戳和随机串格式正确
• 回调验签通过
• 幂等处理（重复回调不重复发货）
• 签名私钥不泄露
• 测试环境验证通过

能力5：问题排查

用户遇到报错或接口调用异常时

排障流程

用户报错了吗？
├── 有Request-Id → 按错误码在排障手册定位
├── 无Request-Id → 按支付方式查常见问题
└── 其他 → 加载排障手册兜底

关键文档

常见错误码速查

小程序支付专项指引

小程序开发者必看！

小程序支付完整流程

1. 前端：小程序调用 wx.login() 获取code
2. 后端：用code + appid + secret 换取 openid
3. 后端：调用微信支付V3接口下单（openid作为openid最小会员标识）
4. 后端：返回 prepay_id 给前端
5. 前端：小程序调用 wx.requestPayment() 调起支付
6. 后端：接收微信支付回调通知
7. 后端：处理回调（更新订单状态等）

小程序支付特殊注意点

小程序支付专属文档

• 📄 小程序支付.md（Python）
• 📄 小程序支付.md（Node.js）
• 📄 小程序支付常见问题.md

定价说明 💰

常见触发词

遇到以下问题时直接调用本技能

• 「小程序怎么接微信支付？」
• 「JSAPI支付代码示例」
• 「微信支付签名怎么生成？」
• 「支付报错了帮我看看」
• 「Native支付生成二维码」
• 「退款接口怎么调用？」
• 「回调通知怎么处理？」
• 「V3 API和V2有什么区别？」
• 「哪个支付方式适合我？」
• 「帮我检查支付代码」

技术支持

• 基于：微信支付官方 wechatpay-skills（MIT协议）
• 改造：补充Python/Node.js代码示例，专精小程序场景
• 协议：MIT（保留原作者版权声明）

上线前必查！小程序支付踩坑汇总见 → 常见踩坑速查表.md