开发微信小程序的支付功能，需要提供给开发人员哪些信息_微信v3提现的证书序列号是什么-优快云博客

必备信息（直连商户模式）

来自「微信支付商户平台」：
• 商户号：mchid
• API v3 密钥：APIv3Key（32 位）
• 商户 API 证书（v3）
• 商户证书序列号：serial_no
• 商户私钥：apiclient_key.pem（PEM 文本）
• （可留存）apiclient_cert.pem（非必须）
• 微信支付平台证书（最新有效）：wechatpay_platform_cert.pem（用于验签回调）
• 平台证书序列号（与上面证书匹配）

来自「小程序后台」：
• 小程序 AppID：appid
• 小程序 AppSecret（仅后端使用，用于 code2Session 获取 openid）

由商户/产品侧统一提供：
• 下单回调地址：notify_url（公网 HTTPS）
• （如有）退款回调地址：refund_notify_url
• 商户号与 AppID 已完成绑定（商户平台或小程序后台完成“关联/绑定商户号”）
• 小程序网络合法域名已添加你们后端域名（request、uploadFile、downloadFile、websocket 等按需）

安全传递建议：apiclient_key.pem、APIv3Key、平台证书等敏感材料务必通过密码管理器或加密渠道交付；不要发群、不要进仓库。

⸻

可选/按业务开启
• 是否启用分账：是/否
• 若是：提供分账接收方列表（账号类型、账号、名称、比例/金额、关系等）
• 是否启用电子发票/代金券等扩展能力：相关开通状态与参数
• （极少数老接口）API v2 Key：仅在确需兼容 v2 接口时提供

⸻

服务商模式（如你们是服务商）

在上面直连信息基础上，还需：
• 服务商商户号：sp_mchid
• 服务商商户私钥（v3）：sp_apiclient_key.pem
• 服务商证书序列号：sp_serial_no
• 特约商户号：sub_mchid
• 小程序 AppID 归属：多数场景用 sub_appid（特约商户的小程序）
• 回调地址：仍由你们服务端统一接收并区分商户

⸻

交付给开发的「可直接落库」模板

把下面这段交给开发，按实际值填好即可（建议存放为环境变量或安全配置）：

# === Mini Program ===
WX_APPID: "<小程序 AppID>"
WX_APPSECRET: "<小程序 AppSecret>"

# === WeChat Pay v3 (Direct Merchant) ===
WX_MCHID: "<mchid>"
WX_API_V3_KEY: "<32位APIv3Key>"
WX_MCH_SERIAL_NO: "<商户证书序列号>"

# 私钥与证书（PEM 文本，建议用 KMS/密钥管控）
WX_MCH_PRIVATE_KEY_PEM: |-
  -----BEGIN PRIVATE KEY-----
  ...
  -----END PRIVATE KEY-----

WX_WECHATPAY_PLATFORM_CERT_PEM: |-
  -----BEGIN CERTIFICATE-----
  ...
  -----END CERTIFICATE-----
WX_WECHATPAY_PLATFORM_SERIAL_NO: "<平台证书序列号>"

# 回调
WX_NOTIFY_URL: "https://your.domain.com/pay/notify"
WX_REFUND_NOTIFY_URL: "https://your.domain.com/pay/refund/notify"

# === 可选：Profit Sharing ===
WX_PROFIT_SHARING_ENABLED: false
WX_PROFIT_SHARING_RECEIVERS: []   # 或提供接收方清单

服务商模式补充：

# === Service Provider Ext ===
WX_SP_MCHID: "<sp_mchid>"
WX_SP_SERIAL_NO: "<sp_serial_no>"
WX_SP_PRIVATE_KEY_PEM: |-
  -----BEGIN PRIVATE KEY-----
  ...
  -----END PRIVATE KEY-----
WX_SUB_MCHID: "<sub_mchid>"
WX_SUB_APPID: "<特约商户小程序 appid>"

⸻

开发落地要点（让研发少踩坑）
• 统一下单走 v3 JSAPI：服务端发起 transactions/jsapi，拿到 prepay_id 后二签生成 timeStamp/nonceStr/package/signType/paySign 返回前端；前端只调 wx.requestPayment。
• 回调验签用微信支付平台证书；资源解密用 APIv3Key（AES-256-GCM）。
• HTTPS 与域名：回调与你们 API 都需 HTTPS；小程序后台配置合法域名（含端口/协议）。
• 证书轮换：平台证书会变更，建议实现平台证书自动拉取与多序列号兼容。
• 只用硬超时：后端任务（如异步质检）用硬超时控制，避免阻塞回调处理。