商户已经完成进件审核，拿到huifu_id，但是网站/彩虹易支付无法正常调用斗拱支付接口，无法拉起收银台、下单报错、回调异常。下面按业务权限、配置、签名、网络、回调、业务场景逐项排查。

一、第一步：确认商户本身业务状态

1. 确认商户状态为正常生效，不是冻结、待补充资料、限制交易状态。
2. 确认业务场景对应的支付产品已经开通：
   • 网页H5收款 → 需要开通微信H5支付权限，业务域名报备
   • 公众号/小程序 → JSAPI支付，提交小程序/公众号APPID
   • PC扫码收银台 → Native扫码支付
   • APP软件收款 → APP支付，提交APP包名、签名信息
3. 业务行业不能属于斗拱禁止接入行业，违规行业即使进件成功，接口也会拦截交易。

二、第二步：核对对接参数（彩虹易支付对接斗拱重点）

• huifu_id：商户进件成功返回的商户编号，不要填渠道服务商sys_id。
• sys_id / product_id：渠道分配参数，参数填错直接返回账户不存在。
• 公私钥：商户私钥用于请求签名；汇付平台公钥用于回调验签。
  • PHP环境必须使用PKCS#8格式私钥；PKCS#1格式会直接签名报错。
  • 复制密钥不要多复制换行、空格，很多对接失败来自密钥复制错误。
• 环境区分：沙箱测试参数和正式生产参数绝对不能混用。

三、第三步：签名失败问题高频踩坑

• 请求参数必须过滤空值、null参数，按键名ASCII升序排序。
• 全部编码统一UTF‑8，不能GBK。
• 使用RSA2模式对接，不要混入MD5密钥配置。
• 回调验签：只能使用汇付平台公钥，严禁使用商户私钥验签回调数据。
• Nginx、CDN、反向代理修改请求body，会直接导致验签失败，关闭body修改。

四、第四步：下单成功，但是无法收到异步回调

1. 回调notify_url必须为公网HTTPS地址，localhost、127.0.0.1内网地址无法被汇付服务器访问。
2. 服务器安全组、防火墙放行443端口，不拦截外部入站请求。
3. 程序处理完成后，直接输出纯文本 success，不要输出任何html、注释、空格。
4. 回调处理逻辑不能耗时过长，控制在5秒以内，否则平台判定超时重试。
5. 查看服务器Nginx/Apache访问日志，确认汇付请求是否真正到达你的服务器。

五、第五步：业务场景限制问题

• H5支付对业务审核严格，未报备域名、业务不匹配直接报错。
• 小微商户部分线上产品权限受限，无法开通H5支付。
• 部分交易风控拦截：订单金额、ip地区、交易行为触发风控，下单直接返回业务拒绝。
• 测试订单不要使用真实业务生产商户，优先使用沙箱商户调试接口。

六、快速定位故障的操作建议

1. 保存接口返回完整错误码resp_code、resp_desc，根据错误描述定位问题。
2. 打开程序日志，打印原始请求报文、原始响应报文、签名原文。
3. 优先使用斗拱平台联调工具测试接口，排除程序代码问题。
4. 如果联调工具调用正常，代表商户权限没问题，问题出在网站程序配置、代码。
5. 联调工具同样报错，联系渠道服务商核对商户产品权限。

七、彩虹易支付对接斗拱特别提示

• 通道配置页面，RSA签名模式下，MD5密钥输入框留空，不要填写任何内容。
• 商户私钥、汇付平台公钥粘贴的时候，完整保留-----BEGIN PRIVATE KEY-----头尾标记。
• 填写huifu_id是商户ID，不要填渠道sys_id，很多站长这里填反导致对接失败。

声明：本文档来源于互联网公开资料整理，仅供开发学习参考，实际报错、权限规则以汇付斗拱官方文档与后台返回为准。

商户进件审核通过后，用户微信、支付宝付款的资金不会直接进入你的银行卡，会先经过汇付天下备付金账户，再根据你的结算模式流转，下面完整讲解资金全链路流向。

一、D1 和 T1 自动结算（绝大多数商户默认模式）

1. 消费者完成支付，资金进入汇付备付金账户。
2. 等待结算周期：D1=下一个自然日（节假日也结算）；T1=下一个工作日（周末节假日顺延）。
3. 系统自动扣除每笔交易手续费。
4. 轧差之后的净额，直接批量转账到你进件填写的结算银行卡，不需要商户手动点提现。

⚠️重点：D1/T1模式下，商户后台看不到余额，资金不在商户钱包，到期直接下发银行卡。

二、余额账户手动提现模式

部分商户开通余额账户功能，交易完成后资金进入斗拱商户虚拟余额，不会自动打银行卡。

• 商户可以在商户后台查看账户余额；
• 支持后台手动提现，也可以调用API接口自动取现；
• 提现时再扣手续费，资金从余额出金到绑定结算卡；
• 适合需要自主控制打款时间的商户场景。

三、企业电子E账户模式（中信E管家）

企业商户可申请电子账簿E账户，资金结算到中信银行电子账户，可账户内转账、分账，再从电子账户提现到实体银行卡；小微、个体商户一般不开放该功能。

四、常见疑问

• 钱会不会经过服务商？不会。交易资金走汇付备付金，服务商只能查看流水，无法截留、挪用你的资金。
• 为什么支付成功银行卡没立刻收到钱？支付成功 ≠ 到银行卡。支付成功代表用户扣款，需要走完D1/T1结算周期才会入银行卡。
• 退款资金从哪里扣？未结算订单：从待结算资金扣；已经结算到银行卡订单，会从后续待结算流水里面抵扣。
• 结算银行卡可以更换吗？可以，在斗拱商户后台修改结算卡，需要法人信息核验。
• 手续费什么时候扣？D1/T1自动结算模式：结算出金的时候统一扣手续费；余额模式：提现环节扣手续费。

五、商户核对资金的方法

1. 登录斗拱商户后台，查看交易流水、结算单；
2. 对照银行银行卡入账流水，核对结算批次；
3. 下载结算账单，核对总交易金额、手续费、实际到账净额。

声明：本文档来源于互联网公开资料整理，仅供开发学习参考，实际资金流向、结算规则以汇付斗拱官方协议与后台配置为准。

彩虹易支付接口对接一共支持两种签名校验方式：MD5密钥签名 和 RSA2非对称公私钥签名，两种方式都可以完成支付请求、回调验签，安全性、使用场景有明显区别。

一、MD5签名方式说明

工作流程

1. 在彩虹易支付后台获取商户ID + MD5通信密钥。
2. 业务系统组装请求参数，过滤空参数，按键名ASCII升序排序。
3. 参数拼接成键=值&格式字符串，末尾拼接&key=你的密钥。
4. 对拼接后的完整字符串做MD5运算得到sign签名，随同参数一起提交给支付接口。
5. 支付平台收到参数后，使用同样规则重新计算签名对比sign，校验请求合法性。
6. 支付完成异步回调，同样带上sign，程序使用同一个密钥再次验签。

⚠️ MD5签名风险点

• 密钥一旦泄露，攻击者可以伪造支付请求、伪造异步回调，模拟订单成功。
• 密钥需要同时存放在你的业务程序和支付平台两边。
• 适合测试、小型业务；不建议高流量正式业务使用。

二、RSA2（RSA‑2）非对称签名方式说明

密钥概念

• 商户私钥：自己本地保存，绝对不能泄露；用于生成请求签名，传给彩虹易支付。
• 商户公钥：提交上传到彩虹易支付后台，平台用来校验你发起的请求。
• 彩虹易支付平台公钥：从后台复制保存到你的程序；用于校验平台推送过来的异步回调数据。
• 平台私钥：保存在支付服务商，商户拿不到。

工作流程

1. 本地生成RSA2公私钥对，商户公钥填写到彩虹易支付商户后台。
2. 发起支付请求：业务参数排序处理，使用商户私钥对参数进行RSA2签名，生成sign。
3. 接口提交参数+sign给到彩虹易支付；平台拿你上传的商户公钥验证签名。
4. 用户完成付款，平台回调你的业务地址；平台使用平台私钥生成回调sign。
5. 你的程序使用彩虹易支付平台公钥校验回调sign，确认回调真实有效。

✅ RSA2优势

• 私钥只保存在自己服务器，不需要提交给支付平台；就算公钥泄露，攻击者无法伪造签名。
• 就算回调接口被人访问，没有平台私钥就无法构造合法sign，无法伪造成功订单。
• 生产环境强烈推荐RSA2方式对接。

三、对接选型建议

四、常见踩坑问题

• 签名失败：参数排序错误，带空值参数，参数大小写不一致，换行空格导致RSA密钥格式异常。
• MD5与RSA不可混用：MD5对接就用MD5密钥验签；RSA对接就使用公私钥，不要交叉使用。
• RSA密钥格式：注意PKCS#8、PKCS#1格式，PHP开发经常遇到密钥格式报错。
• 异步回调验签：RSA模式回调不能拿商户私钥验签，必须使用平台公钥。

声明：本文档来源于互联网公开资料整理，仅供开发学习参考，实际以彩虹易支付官方开发文档为准。

斗拱（汇付）商户入网开通后，可根据商户经营场景申请对应微信支付产品，不同产品适用场景、交易限额、费率存在差异，商户可结合自身业务选择开通。

📌 产品开通注意事项

• 商户进件完成不等于全部产品自动开通，需要根据业务场景提交对应产品申请，风控审核通过才可调用接口。
• 线上互联网业务常用：JSAPI、H5、Native；APP业务需要开通APP支付；小程序业务开通小程序支付。
• 线下实体门店：付款码被扫、刷脸支付；线上业务不要申请线下产品，会驳回。
• H5支付审核严格，需要提供真实业务域名、业务场景说明，部分高危行业无法开通H5。
• 不同产品费率统一按照商户签约费率执行，线上一般0.68%，线下实体0.3%，以签约回执为准。

💡开发对接提示

对接前确认商户后台已开通对应微信产品权限，未开通直接调用接口会返回报错；开发调试可以查看斗拱官方接口文档。

声明：以上内容来源于互联网公开资料整理，仅供学习参考，实际产品能力、准入规则以斗拱官方最新政策为准。

本清单为汇付斗拱支付通道商户进件入网所需完整资料，按主体类型区分，所有资料均需保证真实、清晰、无遮挡、在有效期内，可大幅提升审核通过率。

一、企业商户入网资料清单

二、个体工商户入网资料清单

三、小微商户（个人）入网资料清单

四、资料提交规范与注意事项

• 所有照片均需为原图拍摄，不可截图、不可涂改，保证信息完整可辨认
• 银行卡照片需清晰展示卡号、开户行、持卡人姓名，不可遮挡关键信息
• 线上互联网业务无实体门店，可提供官网后台、业务管理平台截图替代门头/收银台照片
• 提交资料后，风控审核一般1-3个工作日完成，审核结果会通过短信/邮件通知
• 审核驳回可根据驳回原因补充资料重新提交，多次驳回会影响进件成功率

商户进件 = 商户正规入网开户
简单理解：把你的真实资质资料提交给官方支付通道（汇付、微信、支付宝）审核，审核通过后，给你开通专属正规收款商户号。
进件就是：支付平台给你实名开户、开通合法收款权限的过程。
商户进件是支付行业标准合规流程，指商户提交企业/个人真实资质、经营信息、结算银行卡，由持牌支付机构风控审核，开通独立正规收单账户、获得官方清算权限的全过程。

哪些主体可以进件？
平台支持全主体入网：

• 企业公司（营业执照+对公/法人卡）
• 个体工商户（营业执照+法人银行卡）
• 个人小微商户（身份证+个人银行卡）

支付宝官方禁止接入行业文档：
https://cshall.alipay.com/enterprise/knowledgeDetail.htm?knowledgeId=201602055422

微信支付官方禁止接入行业文档：
https://kf.qq.com/faq/140225MveaUz150123raQRNN.html
https://pay.weixin.qq.com/index.php/public/apply_sign/protocol_violation

除以上之外，所有国家法规规定禁止的、其它经工作人员鉴定不适合接入的请勿签约，我们对违规行为零容忍，一经发现将关闭支付接口权限，关联商户清退并视违规情况报警处理。

二、已开通商户出现以下行为的，视情况限制处理