SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场cloudbase-wechat-integration

cloudbase-wechat-integration

编程与开发

查看项目

更新于 10-16 08:52

技能介绍

CloudBase 微信集成（cloudbase-wechat-integration）是一个面向微信支付与公众号场景的 CloudBase 技能，其核心思路是：通过 CloudBase 集成中心（Integration Center）路由微信支付和公众号相关工作，为智能体提供稳定的执行约定，并把可能变动的控制台细节指向官方 Markdown 文档。

适用用途

当用户询问 CloudBase 应用中的微信支付、小程序支付、微信支付、JSAPI 支付、公众号支付、Native 扫码支付、二维码支付、退款回调、支付回调、wx.requestPayment、WeixinJSBridge、openid 或公众号 OAuth 时，适用本技能。

当用户询问虚拟商品的小程序虚拟支付（道具直购、代币充值、wx.requestVirtualPayment、OfferID、AppKey 签名、xpay_* 回调中的发货推送/查单/退款，以及 MP 后台虚拟支付开通与配置）时，适用本技能。

当任务涉及 CloudBase 集成中心、集成中心生成的支付函数、pay-common、offiaccount-common，或微信支付的回调路由时，也适用本技能。当需要为集成中心生成的函数扩展订单持久化、幂等、履约或支付状态同步时，同样适用。

不适用范围

本技能不用于：不涉及微信支付或公众号 OAuth 的通用 CloudBase Web 认证或小程序原生身份工作；与集成中心生成函数无关的通用 CloudBase 云函数开发；通过猜测的 MCP 工具、猜测的 Manager SDK 方法或未文档化的 Cloud API 动作来创建或管理集成中心实例；以及把商户密钥、私钥、APIv3 密钥、AppSecret 或证书存放于应用源码、生成的示例、README、提交或提示词中。

操作规则

  • 除非官方文档确认了公开的 Manager SDK 或 Cloud API 约定，否则将集成中心创建视为控制台优先的工作流。
  • 使用官方 index.md 文档获取控制台 UI 步骤和凭证字段，不要复制过期的控制台截图或臆造字段名。
  • 绝不要让用户在聊天中粘贴密钥，应告知其在 CloudBase 控制台集成中心表单中配置商户和公众号凭证。
  • 不要假设生成的函数名是固定的；pay-common 和 offiaccount-common 只是示例，编写调用前应询问或检查实际函数名。
  • 把前端支付成功视为仅为 UI 反馈，权威支付状态必须来自服务端查询结果或支付回调。
  • 扩展生成的函数时，保留凭证环境变量和生成的回调验证/解密逻辑，围绕订单检查、持久化、幂等和履约添加业务逻辑。
  • 在修改支付或回调代码前，先确定目标场景并只加载匹配的参考文件。

分流与参考文件

  • 能力选择、控制台优先边界、独立分发：references/overview.md
  • 小程序微信支付、wx.cloud.callHTTPFunction、wx.requestPayment：references/mini-program-pay.md
  • 小程序虚拟支付、虚拟商品、wx.requestVirtualPayment、xpay_* 回调：references/virtual-payment.md
  • 公众号 JSAPI 支付、微信内 H5、WeixinJSBridge.invoke：references/official-account-jsapi-pay.md
  • PC/Web 结算的 Native 扫码支付：references/native-qr-pay.md
  • 公众号 OAuth、openid/userinfo 获取：references/official-account-oauth.md
  • 404、凭证缺失、openid 不匹配、回调失败、日志：references/troubleshooting.md

使用方式

典型工作流为：先归类场景（小程序支付、虚拟支付、JSAPI 支付、Native 支付、公众号 OAuth、生成函数扩展或排障），加载匹配的参考文件和其中链接的官方 index.md 文档，确认实际的 CloudBase 环境 ID 与生成的函数名，只生成或修改所需的客户端/后端代码，并把商户凭证保留在集成中心配置中。当支付状态会影响业务数据时，添加订单状态查询、回调幂等和金额/订单校验。最后通过函数日志、回调日志以及适当环境下的端到端支付沙箱或小额生产测试进行验证。

官方文档引用

CloudBase 集成中心概览：https://docs.cloudbase.net/integration/introduce.md CloudBase 集成中心使用说明：https://docs.cloudbase.net/integration/usage.md

当需要云函数部署或日志操作且没有可用的兄弟技能时，应使用当前平台的 CloudBase MCP 工具或 CloudBase 控制台，而不是猜测不受支持的 API。

自检要点

是否避免了猜测未文档化的集成中心管理 API；是否使用了实际生成的函数名而非假设 pay-common；是否将所有商户密钥和证书排除在源码和聊天之外；支付流程是否依赖回调/查询状态而非仅前端成功；是否只加载了用户任务所需的场景参考文件。

限制

具体收费、价格、平台支持范围、效果数据等未在资料中提供，暂未提供。