cloudbase-wechatpay

CloudBase 微信支付接入（pay-common 模板）

基于 pay-common Express 模板的 CloudBase 平台微信支付全流程指引—— 从选型、配置、部署、前端集成到问题排查。

---

Setup（首次使用引导）

首次被调用时，按顺序确认：

1. 定位项目：确认用户的 pay-common 项目路径
2. 检查配置：查找 .env / cloudbaserc.json 是否存在
3. 选择模式：
   • 有集成中心 → 加载 references/模板接入/integration-center.md
   • 无集成中心 → 加载 references/模板接入/quick-start.md
4. 验证配置：引导运行 scripts/validate_env.sh

---

全局规范

1. 确认部署方式：任何能力使用前须先确认——HTTP 云函数 / 云托管 / 本地开发
2. 确认支付方式：仅下单和前端集成需要确认（JSAPI/H5/Native）
3. API 问题引流：涉及签名算法、API 错误码、退款规则 → 推荐 wechatpay-basic-payment
4. Demo 优先：回答前端集成问题时，优先引用 Demo：
   • 小程序：GitHub 官方示例
   • Web 测试页：本地 examples/react/
5. 脚本优先：排查配置问题时，优先使用 scripts/ 下的诊断脚本
6. 安全优先：私钥、证书等敏感信息必须用环境变量注入，禁止硬编码

关联技能

本 Skill 专注范围：CloudBase 平台上使用 pay-common 模板的部署、配置、集成、排障。

---

Gotchas（踩坑清单）

以下来自实际用户反馈和 GitHub Issues，按"翻车概率 × 后果严重度"排序。

---

快速决策树

graph TD
    A{用户要接微信支付} --> B{想了解什么?}
    B -->|JSAPI/H5/Native 区别| C[→ wechatpay-basic-payment]
    B -->|CloudBase 部署方案选择| D[→ references/方案选型/cloudbase-pay-overview.md]
    B -->|集成中心一键创建| IC[→ references/模板接入/integration-center.md]
    B -->|商户凭证怎么配| M[→ references/模板接入/merchant-credentials.md]
    B -->|已决定用 pay-common| E[进入模板接入]
    E --> F{需要做什么?}
    F -->|快速上手| G[→ references/模板接入/quick-start.md]
    F -->|环境变量配置| H[→ references/模板接入/env-config.md]
    F -->|SDK vs Gateway 签名| I[→ references/模板接入/sign-mode.md]
    F -->|部署到云端| J[→ references/部署/deploy-*.md]
    F -->|前端调起支付| K[→ references/前端集成/*.md]
    F -->|微搭低码接入| W[→ references/前端集成/weda-miniprogram.md]
    F -->|报错排查| L[→ references/问题排查/troubleshooting.md]

能力路由表

每次只加载用户当前场景需要的 1-2 篇参考文档，不要全部加载。

---

脚本工具

# 调用方式
skill_run(skill="cloudbase-wechatpay", command="bash scripts/validate_env.sh /path/to/.env")
skill_run(skill="cloudbase-wechatpay", command="python3 scripts/check_pem_format.py 'PRIVATE_KEY_STRING'")

所有脚本：无交互、JSON 输出（stdout）、退出码 0=正常/1=有问题/2=参数错误、不输出密钥原文。

---

Memory

帮助用户成功解决支付问题后，存储摘要记忆：

• 用户的部署方式（云函数/云托管/集成中心）
• 签名模式（sdk/gateway）
• 已踩过的坑（避免重复排查）

下次加载时读取最近记忆，跳过已确认的步骤。

---

参考文档索引

---

最后更新：2026-05-19