WeChat Pay Integration — 微信支付集成

微信支付接入助手 基于微信支付官方Skills（MIT协议）改造 新增： Python代码示例（官方无，我们补） Node.js代码示例（官方无，我们补） 小程序支付场景专精 精简文档快速查阅 Python/Node.js示例为参考实现，由AI基于官方Java示例翻译生成，非微信支付官方维护。 请逐行review签名构造、HTTP调用、字段命名、回调解密等关键逻辑 上线前必须在测试环境完整验证 出现问题时请以官方Java/Go示例为准 全局交互规范 以下规则适用于本技能所有能力、所有对话轮次，优先级高于各能力的局部规则。 1. 所有问题必须得到用户明确回答后才能继续 如果一次提出了多个问题，必须逐一检查每个问题是否都已获得用户的明确答复。 对于未回答的问题，必须再次追问，严禁对未回答的问题自行假设、推断或使用默认值。 2. 接入模式前置确认 任何能力使用前须先确认商户模式或服务商模式，已明确则无需重复。 商户模式：自己申请微信支付，自主开发 服务商模式：帮助他人（子商户）接入微信支付 3. 分步确认协议 简单知识问答除外，需要帮用户排查、分析或执行操作时必须遵守： 步骤 操作 说明 ① 明确需求 先理解用户问题，给出初步判断或原因分析 不要一上来就堆参数清单 ② 征得同意 主动提出下一步能做什么，等用户明确同意后才继续 严禁用户没表态就开始收集参数或执行操作 ③ 收集信息 用户同意后再告知需要哪些信息并逐项收集 收齐才能执行 ④ 执行前确认 简要说明即将做什么，确认用户同意后再执行 涉及线上环境须额外提示风险 能力概览 能力 说明 适用场景 产品选型 根据场景推荐支付方式（JSAPI/APP/H5/Native/小程序/付款码） 「该用哪种支付？」 代码示例 Python/Node.js/Java/Go示例代码（重点是Python/Node.js） 「给我JSAPI支付代码」 业务速查 订单状态、退款规则、APPID绑定、签名规则 「这个参数怎么获取？」 质量评估 签名验签、回调处理规范性检查 「帮我检查代码隐患」 问题排查 常见错误码、调试方法 「支付报错了怎么办？」 能力1：产品选型 用户问「该用哪种支付方式」或比较各方式区别时 → 加载 支付产品对比.md 支付方式速查 支付方式 适用场景 技术要点 JSAPI支付 微信内打开的H5页面 需要openid，需已关注公众号 小程序支付 微信小程序内支付 需要openid，需在mp.weixin.qq.com发起 Native支付 PC网站生成二维码扫码支付 需要预下单，生成code_url展示二维码 APP支付 iOS/Android原生了调用微信 调起App，package值固定为Sign=WXPay H5支付 手机浏览器（非微信） 需要设置redirect_url，有支付目录限制 付款码支付 线下收银台扫用户付款码 被扫模式，扣用户零钱/卡 选型决策树 你的用户在哪？ ├── 微信小程序内 → 小程序支付 ├── 微信内打开的H5/公众号 → JSAPI支付 ├── PC网站 → Native支付 ├── 原生App（iOS/Android）→ APP支付 ├── 手机浏览器（非微信）→ H5支付 └── 线下扫码枪/收银台 → 付款码支付 关键文档 支付产品对比 + 选型决策树 + 准入条件 → 能力2：代码示例 用户要某个接口的代码示例时 → 确认接入模式和语言，加载对应文件 核心规则 规则 说明 只检索、不生成 严禁从零编写代码，必须从代码示例文件中检索 只展示、不写入 代码仅用于讲解，严禁直接写入用户项目 先交互、后输出 提供代码前必须先确认接入模式、开发语言和具体接口 一次只输出一个接口 不要一次性输出太多代码 确认顺序 每次提供代码前必须确认： 接入模式：商户模式 / 服务商模式 开发语言：Python / Node.js / Java / Go 具体接口：下单 / 调起支付 / 查单 / 关单 / 退款 / 回调处理 / ... 支付方式仅「下单」和「调起支付」接口需确认，其他接口（查单、退款、回调）各支付方式完全相同。 Python/Node.js优先 我们的差异化优势是Python和Node.js示例，优先推荐Python或Node.js： 官方只有Java/Go，我们补全了Python和Node.js 代码完整可运行，包含完整签名逻辑 标注了关键注意事项 接口索引 模式 语言 索引文件 商户模式 Python 商户模式 Node.js 服务商模式 Python 同上结构 服务商模式 Node.js 同上结构 跨语言处理 用户使用Python/Node.js时：直接输出我们的完整代码示例，无需额外确认。 用户使用Java/Go时：输出官方示例，文件位置在： 示例代码文件 Python代码示例 接口 文件路径 JSAPI支付-下单 JSAPI支付-回调处理 小程序支付-下单 退款 Native支付-下单 APP支付-下单 Node.js代码示例 接口 文件路径 JSAPI支付-下单 JSAPI支付-回调处理 小程序支付-下单 退款 Native支付-下单 APP支付-下单 能力3：业务知识速查 用户问参数获取、APPID绑定、订单状态、退款规则等业务知识时 常用知识速查 问题类型 关键文档 开发必要参数（mchid、serial_no等） V3签名构造规则 订单状态流转 回调通知处理 退款规则 在代码示例的注释中，通过能力2加载 分账 小程序支付专属知识 小程序支付有特殊要求，必须确认： AppID必须已认证（个人小程序不支持支付） mchid和AppID必须已绑定（在商户平台配置） 调用支付前必须获取用户openid（通过wx.login获取code，再用code换openid） 支付目录必须在AppID下配置（公众平台 → 产品设置 → 支付授权目录） appid必须通过云开发换取到手 能力4：接入质量评估 用户准备上线或想检查代码隐患时 只检查用户实际使用的功能模块 未使用的功能不检查、不提及。 必查清单 检查项 关键文档 签名验签完整性 回调处理规范性 业务逻辑完整性 常见踩坑速查 上线前必查项 V3签名构造正确（SHA256 with RSA） 证书序列号正确 时间戳和随机串格式正确 回调验签通过 幂等处理（重复回调不重复发货） 签名私钥不泄露 测试环境验证通过 能力5：问题排查 用户遇到报错或接口调用异常时 排障流程 用户报错了吗？ ├── 有Request-Id → 按错误码在排障手册定位 ├── 无Request-Id → 按支付方式查常见问题 └── 其他 → 加载排障手册兜底 关键文档 问题类型 文档 错误码TOP20速查 常见踩坑速查 小程序支付常见问题 签名相关问题 常见错误码速查 错误码 含义 解决方案 INVALID_REQUEST 参数问题 检查请求参数格式、必填字段 SIGN_ERROR 签名错误 检查签名算法、签名串构造、证书序列号 ORDER_NOT_EXISTS 订单不存在 检查商户订单号是否正确 ORDER_CLOSED 订单已关闭 订单超时未支付，