汇付个人商户进件接口调试完整教程

一、接口能力说明

接口地址：POST https://api.huifu.com/v2/merchant/basicdata/indv

该接口用于无营业执照的个人商户在汇付平台完成开户进件，支持提交个人实名信息、证件资料、经营信息、结算卡信息、结算/取现规则配置。

二、调试前必备前置资源

1. 系统号 sys_id：渠道商/服务商分配的汇付系统ID/产品号 product_id：汇付分配业务产品号（例：YYZY）

2. 直属渠道号 upper_huifu_id：进件商户归属的上级渠道商号

3. MCC行业编码：根据商户经营行业获取

获取地址：https://paas.huifu.com/open/doc/api/#/csfl/api_csfl_hfmccbm

4. RSA公私钥：用于接口加签、验签

签名规则文档：https://paas.huifu.com/docs/api_standard/#/api_v2jqyq?id=python-1

联调公私密钥获取：

5. 所有证件照片、门店照片（身份证正反面、银行卡、门头照、内景照等）

三、核心前置规则

1. 所有图片禁止直接传原图

进件接口中所有带图片（pic）字段，不支持传本地图片、URL、base64。

必须先调用【图片上传接口】上传图片，拿到 file_id 字符串，再把 file_id 填入进件参数。

开户与功能使用图片上传操作细则

图片上传同样采用斗拱官方联调，

首先点击 https://paas.huifu.com/docs/api/#/shgl/shjj/api_shjj_shtpsc，联调一下

打开文件类型对应编码查询页面（ https://paas.huifu.com/open/doc/api/#/csfl/api_csfl_wjlx ），检索匹配对应的图片编码。

随后进入商户号与huifu_id查询通道，依照页面提示填写相关内容，核对自身商户信息，保证信息准确无误。

进行图片转链处理，优先使用推荐免费图床网址：https://imgchr.com/#google_vignette，

进入页面后上传需要用到的本地图片，等待系统处理完成，提取生成的图片网络地址。务必确认链接以https开头，图片格式限定为jpg、png两类，不符合格式要求的图片无法正常识别调用。

全部信息填写校验完毕后，点击页面发起调用按钮提交申请。系统反馈操作成功提示后，直接复制页面生成的编码，便可将编码运用到开户及相关功能使用流程中。

2. V2接口统一签名规则

1. 仅对 data 层业务参数签名

2. 参数按 key ASCII 升序排序

3. 嵌套JSON对象（card_info、settle_config、cash_config）转为字符串参与签名

4. 使用 RSA-SHA256 私钥加签

四、完整联调流程

步骤1：整理所有基础参数

提前确认商户姓名、身份证信息、有效期、经营地址、手机号、邮箱、行业MCC、省市区编码、结算卡信息、结算周期、取现费率等全部资料。

步骤2：全部图片上传获取 file_id

需要上传的图片类型：

身份证人像面、国徽面

银行卡照片

店铺门头照、内景照、收银台照（线下场景必填）

全部上传完毕，统一保存所有 file_id，备用填充进件参数。

步骤3：汇付联调工具生成标准请求JSON

接口文档/联调工具地址：https://paas.huifu.com/docs/api/#/shgl/shjj/api_shjj_grshjbxxrz_kyc

1. 打开联调工具

2. 填入 sys_id、product_id、upper_huifu_id 等渠道参数

3. 完整填写个人商户信息、证件信息、地址、职业、联系方式

4. 将上一步拿到的所有图片 file_id 填入对应图片字段

5. 填写 card_info 结算卡、settle_config结算规则、cash_config取现规则

6. 工具自动加签，生成完整可调试 JSON 请求体

7.发送请求调试

排查报错、补全参数、修正签名、修正图片ID，直到请求成功。

五、进件成功标准返回

出现以下内容代表接口调用成功、进件单提交成功，等待平台人工/系统审核：

{

   "resp_code": "90000000",

   "resp_desc": "审核中",

   "huifu_id": "6666xxxxxxxxx",

   "apply_no": "2026xxxxxx"

}

说明：90000000 仅代表参数、签名、图片全部合法，不代表审核通过，最终结果以汇付后台审核为准。

六、常见报错与解决方案

1、核心ID出错

sys_id：必须是你渠道商自己的系统号

product_id：必须是汇付给你分配的产品号（如YYZY）

upper_huifu_id：必须是你渠道商的huifu_id

2、确认签名原文是按 key 升序拼接的key=value&格式