云开发微信支付集成

问题背景

CloudBase 应用接入微信支付与公众号 OAuth 时，开发者常遇到几个痛点：生成函数名不固定（不能假设 pay-common 是固定名称）、控制台界面迭代频繁（截图和字段名容易过时）、密钥管理分散（商户号、APIv3 密钥等敏感信息易泄露）、前端成功回调不可靠（不能仅依赖 wx.requestPayment 的成功提示）。手动对接时，开发者容易忽略回调幂等性、订单状态同步和证书验证等关键逻辑，导致支付异常难以排查。

技能如何工作

该技能通过「场景分类 → 文档加载 → 安全执行」三步解决上述问题：

1. 场景分类：根据需求自动识别 Mini Program Pay、JSAPI Pay、Native QR Pay、Official Account OAuth 或生成函数扩展场景，避免跨场景误用。
2. 文档加载：按场景加载对应的 references/*.md（如 mini-program-pay.md 覆盖小程序支付流程），并链接到 CloudBase Integration Center 官方 index.md 文档，确保控制台操作步骤和字段名与最新版本一致。
3. 安全执行：

- 凭证管理：强制通过 CloudBase 控制台配置商户密钥和证书，禁止在代码或对话中存储敏感信息（如 APIv3_KEY、MerchantCertificate）。
- 函数适配：动态获取实际生成的函数名（非固定 pay-common），保留原始回调验证逻辑，再添加订单持久化、幂等性校验和状态同步逻辑。
- 状态校验：前端支付成功仅视为 UI 反馈，权威支付状态必须通过服务端查询或回调确认，避免前端篡改风险。

适用边界与注意点

• 不适用场景：通用 CloudBase Web 认证、小程序原生身份管理、非 Integration Center 生成的云函数开发，以及猜测未公开的 Integration Center 管理 API。
• 关键限制：

- 函数名动态性：不能假设生成函数名固定，需通过 wx.cloud.callHTTPFunction 或控制台确认实际名称。
- 文档优先：控制台界面步骤必须以官方 index.md 文档为准，禁止复制过时截图或编造字段名。
- 密钥安全：商户密钥、APIv3 密钥、证书等敏感信息仅允许在 CloudBase 控制台配置，禁止出现在源码、README 或对话中。
- 回调幂等性：支付回调需做幂等性处理，重复回调时返回已处理结果，避免重复发货或订单状态错乱。

该技能通过「文档锚定+安全执行」双机制，确保开发者在 CloudBase 生态中快速、安全地集成微信支付与公众号 OAuth，同时规避凭证泄露、回调异常等常见陷阱。