外观
配置微信商家转账
本篇帮助你开通并配置微信商家转账，让分销佣金提现可以通过微信线上打款。
进入 「系统管理」→「基础设置」→「支付参数」，向下找到「新版商家转账」。先看字段位置，再按下文取得参数。
先按连接手边后台完成小程序与普通微信支付配置，确认商户号已关联本小程序。
配置前先核对
商户号、证书及私钥必须属于同一套商户资料；已有交易时不要直接更换。密码、密钥和证书私钥不要放入公开截图或发送给无关人员。
先开通商家转账，并设置接口 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 文件全文 | ④「微信支付公钥」；用文本编辑器打开，完整复制 -----BEGIN PUBLIC KEY----- 到 -----END PUBLIC KEY----- 之间及首尾所有内容 |
公钥 ID 是编号，公钥文件是内容，两者不能互换。 截图中的值仅用于认位置，必须使用你自己商户号取得的资料。
保存后，核对一笔真实提现
- 回到酒店后台，点击 ⑤「保存配置」。重新进入页面检查场景、公钥 ID 等是否保留。
- 到微信支付商户平台 「交易中心」→「充值转入」，确认用于转账的运营账户有足够可用余额，需要充值时由资金负责人完成。不要只看结算账户余额。
- 按分销设置将「佣金到账方式」设为「自动到微信零钱」，在「提现设置」中启用微信，并核对最低提现金额。
- 由负责人安排一笔金额明确、收款人正确的提现申请，再按下列流程核对。点击线上「打款」会真实转账，不能用随便一条客户申请试点。
| 环节 | 在哪里操作、怎样判断 |
|---|---|
| 申请提现 | 分销员在小程序「分销中心」申请提现，选择微信零钱对应方式 |
| 审核打款 | 后台 「会员营销」→「权益与分销」→「佣金记录」，详见佣金记录；核对申请人、金额、收款方式后打款 |
| 用户确认 | 状态为「等待用户确认收款」时，申请人使用同一个微信账号打开小程序「分销中心」的「提现记录」，点击 「提款收款」，按微信页面完成收款 |
| 核对到账 | 后台显示「已提现」，同时核对微信支付转账记录及收款人微信零钱到账情况 |
保存成功只代表参数已保存，不代表商家转账已开通或款项已到账。 尚未使用线上打款时，新版转账参数可以暂存不完整内容；实际打款仍会检查必需参数。
配置未收款记录的定时核对
进入 「会员营销」→「权益与分销」→「佣金记录」，找到顶部「转账超时退回宝塔定时任务」，复制「转账超时状态核对」的 「复制 URL」 地址。
请服务器维护人员在 「宝塔面板」→「计划任务」→「添加任务」 中选择「访问 URL」，粘贴刚复制的完整地址，按后台提示设置执行周期，当前为每 10 分钟。不要沿用旧教程手拼的地址。
同一个任务地址只配置一次。添加后由维护人员查看宝塔执行日志，确认返回成功，并持续检查是否正常执行；任务执行成功不等于每一笔提现已退回。
用户确认收款有时间限制，应提醒申请人及时操作。超过 24 小时未确认时，系统会核对原转账结果；只有微信已确认转账失败或撤销，才会退回对应可提现金额。仍在处理中或暂时查不到结果时，不能直接当作已退回，也不要再线下补打一笔。微信支付开发指引也说明关单可能晚于 24 小时，需核实最终结果。
保存或打款不成功时先检查什么
- 提示缺少参数、公钥 ID 格式不正确：按提示核对对应字段，公钥 ID 要以
PUB_KEY_ID_开头，公钥文件要复制完整。 - 提示未开通、场景不符或 IP 不允许调用：核对当前商户号的开通状态、获准场景及服务器公网出口 IP。
- 提示余额不足：检查运营账户可用余额；若已发起过转账，先查原申请结果，不要另建申请或补款。
- 提示「支付配置已保存，但证书文件暂不可用」：先停止线上打款，让维护人员处理证书文件问题，不能把该提示当作配置通过。
- 已打款但仍等待收款：让申请人使用申请时的微信账号进入提现记录确认；已确认或已超时的，先刷新并核对原单结果。
需要协助时提供所在页面、提现记录及错误提示截图，避开密码、密钥和证书私钥。