微信支付
微信支付连接用于国内微信小程序项目的收款（如商城立即购买）。DevDeck 使用你自己的 普通商户凭证调用微信支付 APIv3，不会代替你申请商户号，也不会把商户密钥写入项目 源码。
小程序 AppID 会在你完成微信开放平台扫码授权后自动带入，无需在此连接中填写 AppID 或 AppSecret。支付回调地址由 DevDeck 自动生成并同步到运行时。
仅支持普通商户
请使用你自己申请的普通商户。服务商模式下的子商户号当前不支持。
开始之前
你需要准备：
- 已在 DevDeck 中完成微信小程序扫码授权（与 微信登录 同一授权关系）。
- 一个微信商户平台普通商户账号，并已开通JSAPI 支付 （小程序支付与 JSAPI 共用权限）。
- 该商户号已与当前小程序 AppID 绑定。
- 商户平台超级管理员或技术负责人权限，以便下载 API 证书和设置 APIv3 密钥。
若还没有商户号，请先在微信商户平台申请成为普通商户，开通时勾选经营场景中的 小程序。
第一步：确认商户已绑定小程序 AppID
微信支付要求商户号与小程序 AppID 建立绑定关系后才能收款。
- 登录微信商户平台。
- 打开产品中心 → AppID 账号管理 → 我关联的 AppID 账号，确认已关联你的小程序。
- 若尚未绑定：在产品中心 → APPID 授权管理中发起关联申请，再登录 微信公众平台的小程序，在微信支付 → 商户号管理中 确认授权。
绑定指南可参考微信支付官方文档 管理商户号绑定的 APPID 账号。
第二步：获取商户号（mch_id）
- 登录微信商户平台。
- 打开账户中心 → 商户信息。
- 复制页面上的商户号。
第三步：获取商户 API 证书序列号与私钥
商户 API 证书用于对微信支付 APIv3 请求签名。下载证书包后，你需要其中的：
- 证书序列号（Certificate Serial）
- 商户私钥文件内容（通常为
apiclient_key.pem，PEM 格式）
获取步骤：
- 在微信商户平台打开账户中心 → API 安全 → 商户 API 证书。
- 若尚未申请，按页面指引申请并下载证书（证书通常只能下载一次，请妥善保存）。
- 在证书管理页查看并复制证书序列号。
- 打开下载包中的
apiclient_key.pem，将完整 PEM 文本（含-----BEGIN PRIVATE KEY-----/-----END PRIVATE KEY-----）粘贴到 DevDeck。
官方说明见 证书密钥概览。
妥善保管商户私钥
私钥可用于代表商户发起支付相关请求。DevDeck 会加密保存并同步到运行时，但你仍应 本地安全备份原始文件，不要通过聊天或公开链接分享。丢失或泄露后，请在商户平台重新 申请证书，并在 DevDeck 中更新连接。
第四步：获取 APIv3 密钥
- 在微信商户平台打开账户中心 → API 安全 → APIv3 密钥。
- 按指引设置 32 位密钥（设置后无法在商户平台再次查看明文，请自行记录）。
- 将密钥填入 DevDeck 的 APIv3 Key 字段。
APIv3 密钥用于解密支付回调等敏感数据。官方说明见 开发必要参数说明。
第五步：在 DevDeck 中连接
- 打开项目，选择配置 → 连接（Connections）。
- 找到微信支付，选择连接。
- 确认弹窗中显示的已授权小程序 AppID与你要收款的小程序一致。
- 按本文填写：
- 商户号
mch_id - 商户证书序列号
- APIv3 Key
- 商户私钥 PEM
- 商户号
- 勾选确认：你已在商户平台完成该商户与上述小程序的绑定。
- 选择保存。
连接成功后，DevDeck 会加密保存凭证，并尝试同步到国内运行时。支付回调 URL 由平台 自动配置，无需手填。
测试建议
- 在微信真机中测试下单与支付；H5 / 网页预览无法完整验证微信支付。
- 确认商户已开通 JSAPI 支付，且 AppID 绑定关系有效。
- 若连接显示已保存但运行时同步未完成，请稍后重试或检查项目发布 / 运行时状态。
更换或断开连接
打开配置 → 连接 → 微信支付，可更新商户凭证或断开连接。更换商户号或密钥后，请在 真机重新验证支付；存在未完成的支付回调时，请谨慎更换凭证，避免旧订单无法入账。
妥善保管项目凭据
不要在公开文档、截图或聊天中粘贴 APIv3 密钥或商户私钥。仅在 DevDeck 连接弹窗中 填写平台要求的字段。