Agent Skills
返回列表
💻

云开发微信支付集成

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/tencentcloudbase-skills-cloudbase-wechat-integration。

技能介绍

要解决什么问题

在云开发(CloudBase)应用里接 微信支付、公众号 JSAPI/H5 支付、Native 扫码 或 公众号 OAuth 时,控制台字段会变、生成云函数名不一定是 pay-common / offiaccount-common,还容易把商户密钥写进源码或在对话里粘贴。本技能把这类工作统一到 集成中心(Integration Center) 的执行契约上,按场景加载对应 references/*.md,而不是臆造 Manager SDK 或未文档化的 Cloud API。

技能如何工作

  1. 激活判定:用户提到小程序支付、wx.requestPayment、退款/支付回调、openid、集成中心生成函数等时,先读本技能,再按需串联同级技能(小程序结构 → ../miniprogram-development/SKILL.md,Web 前端 → ../web-development/SKILL.md,函数部署与日志 → ../cloud-functions/SKILL.md)。
  2. 场景路由:按任务表选择参考文档——概览与边界 overview.md、小程序支付 mini-program-pay.md、公众号 JSAPI official-account-jsapi-pay.md、Native 二维码 native-qr-pay.md、OAuth official-account-oauth.md、排错 troubleshooting.md。
  3. 实现原则:集成中心实例以控制台配置为主;商户与公众号凭证只在控制台表单里填;扩展生成函数时保留环境变量与回调验签/解密逻辑,在订单持久化、幂等、履约周围加业务层;支付状态以回调或服务端查询为准,前端成功仅作 UI 反馈。

适用边界与注意点

  • 不适用:与支付/OAuth 无关的通用 CloudBase 登录鉴权、与集成中心生成函数无关的通用云函数开发、通过猜测 MCP/SDK 创建集成中心实例。
  • 禁止:在源码、README、提交记录或聊天中存放 APIv3 密钥、证书、AppSecret;缺失同级技能时用 HTTP 拉远程 SKILL 顶替本地兄弟技能——应提示安装完整 CloudBase 插件或使用控制台/MCP 函数工具。
  • 改动支付或回调代码前,先确认环境 ID、实际生成函数名,并只加载当前场景所需的一篇 reference。

使用场景

  • 云开发小程序要接 wx.requestPayment,需确认 openid 注入、下单云函数名与支付回调期望
  • 公众号内 H5 使用 WeixinJSBridge 做 JSAPI 支付,需在集成中心配置后扩展生成函数做订单校验
  • PC 或 Web 结账用 Native 扫码支付,要实现 code_url、轮询查单与回调幂等
  • 支付成功页只显示前端结果,需要按 SKILL 指引改为以回调日志与服务端查单作为履约依据

适合人员

  • 维护 CloudBase 电商小程序、要在生成支付函数外补订单持久化与防重复提交的后端工程师
  • 负责公众号内 H5 收银台,需要 JSAPI 调起与 openid 获取路径对照官方参考的前端开发者
  • 在云开发环境排查 openid 不匹配、回调 404 或凭证缺失,需先走 troubleshooting 再改代码的运维或全栈
  • 在集成中心已建实例,要扩展 pay-common 类函数做发货/状态同步且不能动验签逻辑的 CloudBase 项目负责人