外观
配置微信商家转账
本篇帮助平台负责人配置微信商家转账，用于分销佣金和商户提现的微信线上打款。
切换到总管理后台，进入 「系统设置」→「基础配置」→「支付配置」。页面中先有「普通支付参数」，下面才是「新版商家转账（可选）」。
先按支付配置完成小程序关联、商户号及证书配置。当前系统的新版商家转账只支持「普通支付」模式；正在使用「商户独立收款」的平台，先让支付负责人确认方案，不要为开通转账直接切换收款模式。
配置前先核对
商户号、证书及私钥必须属于同一套商户资料；已有交易时不要直接更换。密码、密钥和证书私钥不要放入公开截图或发送给无关人员。
先开通商家转账，并设置接口 IP
登录本项目所用商户号的微信支付商户平台，进入 「产品中心」→「商家转账」。未开通时按页面要求申请；已开通的从「已开通」中进入，不要重复申请。
转账场景按真实用途申请，后台必须与微信获准的场景一致。 酒店后台支持「现金营销」「佣金报酬」；旧图采用现金营销示例，不代表所有商户都应照选。若获准场景不在这两项中，先请维护人员确认，不要选择一个不相符的场景尝试打款。
开通后点击 「前往功能」，找到 「安全能力」→「接口 IP」，添加酒店系统发起转账请求的服务器公网出口 IP，由服务器维护人员提供。这里不填域名，也不填自己电脑或店内 Wi-Fi 的 IP。
添加后确认 IP 已显示在列表中。实际入口可对照微信支付接口安全 IP 指引。本文微信支付配图沿用旧教程，界面变化时以商户平台当前页面为准。
取得参数，回填酒店后台
商户证书序列号与配套文件
在微信支付商户平台进入 「账户中心」→「API 安全」→「商户 API 证书」→「管理证书」，查看当前使用的证书序列号。
复制序列号到后台 「商户序列号」（在「普通支付参数」内）。它应与本系统已填的商户证书和私钥配套，不能误填商户号或微信支付公钥 ID。
若尚未填写证书，由支付负责人取得配套的 apiclient_cert.pem 和 apiclient_key.pem，用文本编辑器打开，分别复制全文到酒店后台同名输入框，保留开头与结尾标记。不要填文件名、路径或把两份内容互换。没有原私钥时，不要直接更换正在使用的证书，先让支付负责人确认处理方式；可参考微信支付商户证书指引。
转账场景与 APIv3 密钥
回到后台，在 「转账场景」 选择刚才获准的场景。申请的是现金营销，就选择现金营销；申请的是佣金报酬，就选择佣金报酬。
多商户版的「微信支付APIV3秘钥」在上方「普通支付参数」中。需要填写或核对时，从微信支付商户平台 **「账户中心」→「API 安全」**取得，确保两边一致，不与 APIv2 密钥混用。
微信支付公钥 ID 与公钥内容
在微信支付商户平台进入 「账户中心」→「API 安全」→「微信支付公钥」→「管理公钥」。没有操作权限时，请商户号的超级管理员或安全联系人处理。
点击 「下载」或「重新下载」，取得公钥文件，并复制页面显示的公钥 ID。若页面还要求申请公钥或开启公钥切换，由支付负责人按微信支付公钥指引完成后再使用。
| 取得的内容 | 填到酒店后台哪里 |
|---|---|
PUB_KEY_ID_ 开头的一整串 ID | 「微信支付公钥ID」；不是上面的商户证书序列号 |
下载的 pub_key.pem 文件全文 | 「pub_key.pem」；用文本编辑器打开，完整复制 -----BEGIN PUBLIC KEY----- 到 -----END PUBLIC KEY----- 之间及首尾所有内容 |
公钥 ID 是编号，公钥文件是内容，两者不能互换。 截图中的值仅用于认位置，必须使用你自己商户号取得的资料。
保存后，核对一笔真实提现
- 回到酒店后台，点击 「保存」。重新进入页面检查场景、公钥 ID 等是否保留。
- 到微信支付商户平台 「交易中心」→「充值转入」，确认用于转账的运营账户有足够可用余额，需要充值时由资金负责人完成。不要只看结算账户余额。
- 按分销设置将「佣金到账方式」设为「自动到微信零钱」，启用微信提现方式，并核对最低提现金额及「线上最大打款额度」。系统设置的额度与微信商户获准额度都要满足。
- 由负责人安排一笔金额明确、收款人正确的提现申请，再按下列流程核对。点击线上「打款」会真实转账，不能用随便一条客户申请试点。
| 环节 | 在哪里操作、怎样判断 |
|---|---|
| 申请提现 | 分销员在小程序「分销中心」申请提现，选择微信零钱对应方式 |
| 审核打款 | 平台后台 「分销管理」→「佣金与规则」→「分销佣金」，详见分销佣金；核对申请人、金额、收款方式后打款 |
| 用户确认 | 状态为「等待用户确认收款」时，申请人使用同一个微信账号打开小程序「分销中心」的「提现记录」，点击 「点击提款」，按微信页面完成收款 |
| 核对到账 | 后台显示「已提现」，同时核对微信支付转账记录及收款人微信零钱到账情况 |
保存成功只代表参数已保存，不代表商家转账已开通或款项已到账。 尚未使用线上打款时，新版转账参数可以暂存不完整内容；实际打款仍会检查必需参数。
**如果用于商户提现：**还需完成商户提现规则与收款人绑定。平台在 **「门店业务」→「商户结算」→「商户提现」**审核线上打款后，由绑定的收款微信进入小程序 **「会员中心」→「商户提现」**点击「提款」确认；不能用分销员的提现记录代替商户提现记录。
配置未收款记录的定时核对
进入 「系统设置」→「基础配置」→「平台基础设置」，切换到 「定时任务」，可搜索「提现」找到下面两项，并分别复制页面提供的任务地址：
| 已使用的业务 | 需要配置的任务 | 当前建议周期 |
|---|---|---|
| 分销佣金线上打款 | 用户佣金提现超时处理 | 每 1 小时 |
| 商户提现线上打款 | 商户提现超时处理 | 每 1 小时 |
请服务器维护人员在 「宝塔面板」→「计划任务」→「添加任务」 中选择「访问 URL」，将两个业务所需的地址分别添加，执行周期按后台提示填写。不要复制单店版任务地址，也不要自行拼接域名。
同一个任务地址只配置一次。添加后由维护人员查看宝塔执行日志，确认返回成功，并持续检查是否正常执行；任务执行成功不等于每一笔提现已退回。
用户确认收款有时间限制，应提醒申请人及时操作。超过 24 小时未确认时，系统会核对原转账结果；只有微信已确认转账失败或撤销，才会退回对应可提现金额。仍在处理中或暂时查不到结果时，不能直接当作已退回，也不要再线下补打一笔。微信支付开发指引也说明关单可能晚于 24 小时，需核实最终结果。
保存或打款不成功时先检查什么
- 提示缺少参数、公钥 ID 格式不正确：按提示核对对应字段，公钥 ID 要以
PUB_KEY_ID_开头，公钥文件要复制完整。 - 提示未开通、场景不符或 IP 不允许调用：核对当前商户号的开通状态、获准场景及服务器公网出口 IP。
- 提示余额不足：检查运营账户可用余额；若已发起过转账，先查原申请结果，不要另建申请或补款。
- 提示「支付配置已保存，但证书文件暂不可用」：先停止线上打款，让维护人员处理证书文件问题，不能把该提示当作配置通过。
- 已打款但仍等待收款：让申请人使用申请时的微信账号进入提现记录确认；已确认或已超时的，先刷新并核对原单结果。
需要协助时提供所在页面、提现记录及错误提示截图，避开密码、密钥和证书私钥。