汇付支付设置

一、汇付商户开通

汇付斗拱是汇付天下旗下的聚合支付品牌，一次接入即可同时支持微信、支付宝收款。使用前需先成为汇付商户并完成产品开通。

开通入口：

注意事项：

需联系汇付商务或对接人员完成商户入网、签约，并开通微信、支付宝等支付业务能力。
一期收款主体为平台服务商账户（huifu_id），由汇付线下开通并配置到商城后台即可，无需在系统内做进件操作。私钥仅首次生成时可下载，请务必本地妥善保存，丢失后需重新生成并同步更新后台配置。

登录汇付商户/服务商控台后，按下列位置获取对接参数。

商户 RSA 私钥：用于请求加签（仅首次生成可下载，请立即保存）
汇付公钥：用于校验汇付返回结果与异步通知

网关地址说明：

正式环境一般为：https://api.huifu.com
测试/沙箱地址请以汇付对接文档为准，勿与生产混用
官方文档可参考：https://paas.huifu.com/open/doc/lightning/

选择「开启」后，用户收银台将展示汇付渠道下的微信支付、支付宝支付选项；选择「关闭」则不展示。

注意：请先把下方系统号、产品号、商户号、商户 RSA 私钥、汇付公钥、网关地址全部填写并提交，再打开「是否开启」。该开关仅控制收银台是否展示汇付选项，不会校验参数是否填全；参数不完整时用户仍能看到汇付微信 / 汇付支付宝，但点击支付会直接失败。

如无需更换密钥，保持页面上的掩码内容原样提交即可，系统不会覆盖已保存的真实私钥。

点击「编辑」，粘贴汇付公钥全文。该公钥用于验签汇付返回与异步回调。

与私钥相同，公钥保存后页面同样以掩码回显；如无需更换，保持掩码内容原样提交即可，系统不会覆盖已保存的真实公钥。

回调说明：

支付结果回调由系统自动生成，一般为：https://您的PC域名/api/order/pay/notify/huifu
退款回调一般为：https://您的PC域名/api/order/pay/refundNotify/huifu
请确保上述地址可被公网访问，并在服务器防火墙/安全组中放行

其中支付结果回调是订单转「已支付」的必要链路，务必保证公网可达；退款以汇付同步返回结果为主，退款回调作为异步补充通道，同样建议放行。

问：开启后收银台没有出现汇付微信 / 汇付支付宝？

答：确认后台「是否开启」已选开启并成功提交——收银台是否展示汇付，只取决于这一个开关。
支付宝选项在微信内置浏览器、小程序环境中会自动隐藏，只剩汇付微信，属正常现象。
若开关确认已开启仍不显示，请清理前端缓存后重新进入收银台，并确认访问的是已保存配置的同一环境。

问：能看到汇付选项，但点击支付提示「汇付支付未配置完整（商户号/私钥/网关）」？

答：开关只控制展示，不校验参数完整性，因此参数没填全时选项照样会显示，点击支付才报错。
出现该提示说明商户号、商户 RSA 私钥、网关地址三项中至少一项为空，请补全后重新提交。
注意：系统号、产品号、汇付公钥缺失不会触发这条提示，但会导致加签失败、验签失败或汇付侧交易报错，同样必须全部填写完整。

问：提示加签失败 / 验签失败？

答：核对商户 RSA 私钥、汇付公钥是否粘贴完整（勿多空格、勿截断）。
确认使用的是当前环境（测试/生产）对应的密钥，勿混用。
私钥丢失后需在汇付控台重新生成，并同步更新后台「商户 RSA 私钥」与「汇付公钥」。

问：支付成功但订单状态未更新？

答：检查商城「PC 域名」配置是否正确（回调地址依赖该域名生成）。
确认 /api/order/pay/notify/huifu 可从外网访问。
在汇付控台查看交易与回调记录，核对通知是否发送成功。

问：能否与原生微信支付、支付宝同时开启？

答：可以。若同时开启多条收单路径，收银台可能出现多个「微信」「支付宝」选项。运营侧通常建议同一时期只启用一条收单通道，避免用户混淆。