微信支付
通道概述
微信支付是腾讯微信平台的支付服务。DaxPay 采用 API v3 证书模式对接，支持直连与服务商（ISV）两种接入模式，方式覆盖 JSAPI、小程序、扫码、APP、H5 与付款码，并支持分账与商家转账到零钱。
微信支付（直连）从通道侧准备到密钥配置的完整对接教程（含两组必填凭据、支付应用类型矩阵）见支付通道对接，本文是参数与结构的速查参考。
支付的支付产品
| 支付产品 | 接入模式 | 适用身份 |
|---|---|---|
wechat_pay（直连） | 商户直连 | 有自己微信支付商户号的商户 |
wechat_isv（服务商） | 服务商代特约商户发起 | 服务商帮旗下二级商户收款 |
支持的支付方式
| 支付方式 | 说明 | 前提 |
|---|---|---|
wechat_qr（扫码） | Native 支付，返回二维码 | — |
wechat_jsapi（JSAPI） | 微信内网页调起支付 | 需 openId；须绑定公众号应用 |
wechat_mini（小程序） | 微信小程序内调起支付 | 需 openId；须绑定小程序应用 |
wechat_app（APP） | 商户 APP 内调起微信 | — |
wechat_h5（H5） | 手机浏览器外部跳转支付 | — |
wechat_barcode（付款码） | 商户扫用户付款码 | — |
JSAPI 与小程序支付依赖 openId，需要先在「应用管理」登记对应类型的微信应用（公众号 / 小程序），并在支付能力绑定中关联，详见支付通道对接。
配置结构
微信的密钥按商户号维度配置（服务商模式一份密钥管全部特约商户），应用信息独立维护：
- 创建通道商户：商户工作台 → 通道商户 → 创建通道商户，选支付产品后填写：
- 直连：商户名称 + 微信支付商户号（mchId）
- 服务商：商户名称 + 特约商户号（subMchId）
- 配置密钥：通道商户详情 → 基础管理 → 密钥配置（直连）或在服务商产品下配置：
| 分组 | 字段 | 说明 |
|---|---|---|
| 接口密钥 | API v3 密钥 | 商户平台「API 安全」中设置 |
| 支付证书 | 商户 API 证书 | apiclient_cert，上传 |
| 商户 API 证书私钥 | apiclient_key，上传 | |
| 证书序列号 | 与上传证书对应 | |
| 支付公钥 / 支付公钥 ID | 微信支付公钥新模式；留空则走平台证书模式 |
- 登记应用（「微信应用」页面，平台应用 / 商户应用两组）：应用名称、应用类型（公众号 / 小程序 / 移动应用）、AppId、应用密钥（AppSecret），再在能力绑定中为各支付方式指定所用应用。
回调处理
- 异步通知为加密报文，平台验签（回调头
Wechatpay-Serial/Wechatpay-Signature等）并解密后应答{"code":"SUCCESS"}； - 回调地址由平台统一生成，无需在微信商户平台逐单配置；
- 5 秒内未收到应答微信会按频次重试。
注意事项
- 先切环境再建商户：沙箱与生产各建一套；
- 商户 API 证书有有效期，到期前在微信商户平台更换后同步更新配置；
- 服务商模式下「特约商户号」与「服务商商户号」是两个号，密钥配置用服务商号；
- 服务商子商户号相关问题见 FAQ。