## 商户业务开通修改
POSThttps://api.huifu.com/v2/merchant/busi/modify
*最近更新时间:2026.09.10*
> 2023.6.30斗拱升级了商户进件类接口,老版接口、升级指引请参考[说明文档](old_api/api_2023shglsj)
### 应用场景
已完成业务开通的商户若信息填写有误或需变更,用此接口修改企业&小微商户业务信息。支持:
- 商户微信、支付宝、抖音业务补开;(银联、银行卡业务开通仍通过[商户业务开通接口](https://paas.huifu.com/open/doc/api/#/shgl/shywkt/api_shjj_shywkt))
- 快捷支付、网银、手机网页支付等线上业务的开通;
- 修改商户微信、支付宝、抖音、银联二维码、银行卡、快捷、网银、手机网页等业务的交易费率;
**适用对象**
商户需要补开、修改已开通支付功能参数,可调用该接口。
### 接口说明
* 支持格式:JSON
* 加签验签说明:请参考[接入指引-开发指南](https://paas.huifu.com/open/doc/guide/#/api_v2jqyq)
### 公共参数
* 公共请求参数
| 参数 | 中文名 |
定义
| 长度
| 必填 | 说明 |
| :--------- | :------- | :----- | :------- | :--- | :-------------------------- |
| sys_id | 系统号 | String | 32 | Y | 渠道商或商户的huifu_id;
(1)当主体为渠道商时,此字段填写渠道商huifu_id;
(2)当主体为总部商户时,此字段填写商户huifu_id |
| product_id | 产品号 | String | 32 | Y | 汇付分配的产品号,示例值:YYZY |
| sign | 加签结果 | String | 512 | Y | [接口加签验签说明](https://paas.huifu.com/open/doc/guide/#/api_v2jqyq) |
| data | 数据 | Json | | Y | 业务请求参数,具体值参考API文档 |
* 公共返回参数
| 参数 | 中文名 | 定义 | 长度 | 必填 | 说明 |
| :--- | :--------- | :----- | :------- | :--- | :----------------------------------------------------------- |
| sign | 签名 | String | 512 | Y | [接口加签验签说明](https://paas.huifu.com/open/doc/guide/#/api_v2jqyq) |
| data | 响应内容体 | Json | | N | 业务返回参数 |
- “必填”字段取值“Y“:必填;“N”:非必填;“C”代表条件必填;
### **请求参数**
**data**
| 参数 | 中文名 | 定义
| 长度
| 必填 | 说明 |
| :----------------------- | :--------------------- | :----- | :--- | :------- | :---------- |
| req_seq_id | 请求流水号 | String | 32 | Y | 业务申请编号,同一商户号当天唯一,示例值:2022012614120615001 |
| req_date | 请求日期 | String | 8 | Y | 请求日期:yyyyMMdd,以北京时间为准;示例值:20220904 |
| huifu_id | 汇付客户Id | String | 18 | Y | 渠道与一级代理商的直属商户ID;示例值:6666000104778898 |
| short_name | 微信支付宝商户简称 | String | 64 | N | 修改微信、支付宝商户简称;示例值:汇付天下 |
| agreement_info | *协议信息实体* | String | | N | jsonObject字符串;[签约协议材料说明](https://cloudpnrcdn.oss-cn-shanghai.aliyuncs.com/opps/api/prod/download_file/kyc/KYC-%E5%95%86%E6%88%B7%E5%90%88%E5%90%8C%E7%AD%BE%E7%BA%A6%E8%A7%84%E5%88%99.xlsx)
若未签署过协议的情况下,调用该接口时必填;
若已签署过纸质或电子协议下,调用该接口时必填,且只可以选择纸质或电子协议;
若已签署过挂网协议下,调用该接口时,选填。 |
| out_fee_flag | 是否交易手续费外扣 | String | 1 | N | 1:外扣,2:内扣;(默认2内扣)示例值:2 该公共参数只影响:支付宝支付,微信支付,抖音支付,银行卡支付,银联二维码支付,花呗分期配置 以下支付方式手续费请在各配置域字段中修改:网银、快捷、手机WAP、余额支付、补贴支付、全域资金管理、银行大额转账 |
| out_fee_huifuid | 交易手续费外扣汇付ID | String | 18 | N | 开通交易手续费外扣业务时必填;示例值:6666000123123123 该公共参数只影响:支付宝支付,微信支付,抖音支付,银行卡支付,银联二维码支付,花呗分期配置 以下支付方式手续费请在各配置域字段中修改:网银、快捷、手机WAP、余额支付、补贴支付、全域资金管理、银行大额转账 |
| out_fee_acct_type | 交易手续费外扣时的账户类型 | String | 2 | N | 01:基本户(不填默认01),02-现金户,05:充值户;09:营销户;示例值:01 该公共参数只影响:支付宝支付,微信支付,抖音支付,银行卡支付,银联二维码支付,花呗分期配置 以下支付方式手续费请在各配置域字段中修改:网银、快捷、手机WAP、余额支付、补贴支付、全域资金管理、银行大额转账 |
| online_flag | 是否开通网银 | String | 1 | N | Y:是 N:否;示例值:Y |
| quick_flag | 是否开通快捷 | String | 1 | N | Y:是, N:否;示例值:Y |
| withhold_flag | 是否开通代扣 | String | 1 | N | Y:是 N:否;示例值:Y |
| delay_flag | 延迟入账开关 | String | 1 | N | N:否,Y:是;默认否;示例值:Y |
| alipay_pre_auth_flag | 开通支付宝预授权 | String | 1 | N | Y:是,N:否;示例值:Y;目前仅支持MCC为7011住宿服务、7296服装出租、7512汽车出租三个行业开通预授权; |
| wechatpay_pre_auth_flag | 开通微信预授权 | String | 1 | N | Y:是,N:否;示例值:Y;目前仅支持MCC为7011住宿服务、7296服装出租、7512汽车出租三个行业开通预授权; |
| mer_bus_type | 商户业务类型 | String | 2 | N | 快捷,网银,手机WAP,银联统一在线收银台开通时(线上费率配置对象不为空)必填;
取值参见[商户业务类型](http://paas.huifu.com/open/doc/api/#/api_ggcsbm?id=%E5%95%86%E6%88%B7%E4%B8%9A%E5%8A%A1%E7%B1%BB%E5%9E%8B);示例值:01 |
| online_fee_conf_list | 线上费率配置 | String | | N | jsonArray格式 |
| ali_conf_list | 支付宝配置对象 | String | | N | jsonArray格式字符串 |
| wx_conf_list | 微信配置对象 | String | | N | jsonArray格式字符串 |
| union_conf_list | 银联二维码配置对象 | String | | N | jsonArray格式字符串 |
| bank_card_conf | 银行卡支付配置信息 | String | | N | jsonObject字符串 |
| balance_pay_config | *余额支付配置对象* | String | | N | jsonObject字符串 |
| combine_pay_config | 补贴支付 | String | | N | jsonObject格式 |
| online_pay_fee_conf_list | 线上手续费承担方配置 | String | | N | jsonArray格式 |
| out_order_funds_config | 全域资金管理配置(华通银行) | String | | N | jsonObject字符串;**即将废弃**,请对接[全渠道资金管理配置接口](https://paas.huifu.com/open/doc/api/#/dejy/api_dejy_qypz) |
| async_return_url | 异步消息接收地址 | String | 128 | N | 审核消息接收地址,示例值:http://service.example.com/to/path 。为空不推送审核消息。 |
| busi_async_return_url | 业务开通结果异步消息接收地址 | String | 128 | N | 当前申请同步成功或者审核通过之后,示例值:http://service.example.com/to/path。为空不推送审核消息。 |
| recon_resp_addr | 交易异步应答地址 | String | 256 | N | 示例值:http://service.example.com/to/path。为空不推送交易异步消息。 |
| online_media_info_list | *运营媒介* | String | | N | jsonArray字符串;如果开通快捷、网银、余额支付Pro版、分账、银行大额转账、代扣需提供运营媒介材料 |
| extended_material_list | *补充文件信息* | String | | N | jsonArray字符串;根据开通的功能补充相关材料,包括[商户纸质协议说明](https://cloudpnrcdn.oss-cn-shanghai.aliyuncs.com/opps/api/prod/download_file/kyc/KYC-%E5%95%86%E6%88%B7%E5%90%88%E5%90%8C%E7%AD%BE%E7%BA%A6%E8%A7%84%E5%88%99.xlsx)、[线上行业补充材料](https://cloudpnrcdn.oss-cn-shanghai.aliyuncs.com/opps/api/prod/download_file/kyc/KYC-%E7%BA%BF%E4%B8%8A%E4%B8%9A%E5%8A%A1%E7%B1%BB%E5%9E%8B%E7%BC%96%E7%A0%81%E5%8F%8A%E8%A1%A5%E5%85%85%E6%9D%90%E6%96%99%E8%AF%B4%E6%98%8E.xlsx)、[开通余额支付补充材料](https://cloudpnrcdn.oss-cn-shanghai.aliyuncs.com/opps/api/prod/download_file/kyc/KYC-%E4%BD%99%E9%A2%9D%E6%94%AF%E4%BB%98%E8%A1%A5%E5%85%85%E6%9D%90%E6%96%99.xlsx) 、[分账功能提供材料说明](https://cloudpnrcdn.oss-cn-shanghai.aliyuncs.com/spin/files/20260611/KYC-%E5%88%86%E8%B4%A6%E5%8A%9F%E8%83%BD%E6%9D%90%E6%96%99%E8%AF%B4%E6%98%8E%281%29.xlsx) 、[代扣支付补充材料](https://cloudpnrcdn.oss-cn-shanghai.aliyuncs.com/opps/api/prod/download_file/kyc/%E4%BB%A3%E6%89%A3%E6%94%AF%E4%BB%98%E8%A1%A5%E5%85%85%E6%9D%90%E6%96%99.xlsx); |
| online_busi_type | *线上业务类型编码* | String | 8 | C | 开通快捷、网银、余额支付Pro版、银行大额转账、分账比例>30%、代扣必填;参见[线上业务类型编码及补充材料说明](https://cloudpnrcdn.oss-cn-shanghai.aliyuncs.com/opps/api/prod/download_file/kyc/KYC-%E7%BA%BF%E4%B8%8A%E4%B8%9A%E5%8A%A1%E7%B1%BB%E5%9E%8B%E7%BC%96%E7%A0%81%E5%8F%8A%E8%A1%A5%E5%85%85%E6%9D%90%E6%96%99%E8%AF%B4%E6%98%8E.xlsx);示例值:H7999AL |
| sign_user_info | 签约人 | String | | C | jsonObject字符串;agreement_info中选择电子签约时必填;个人商户填本人信息。 |
| forced_delay_flag | 商户开通强制延迟标记 | String | 1 | N | 选项:N:否 Y:是,默认否;**开关打开后商户所有交易都是延迟交易**,需要调用[交易确认接口](http://paas.huifu.com/open/doc/api/#/smzf/api_jyqr)完成交易;示例值:N |
| wx_zl_conf | 微信直连配置对象 | String | | N | jsonObject格式 |
| ali_zl_conf | 支付宝直连配置对象 | String | | N | jsonObject格式 |
| enter_fee | 开户费用值(元) | String | 14 | N | 示例值:5.00 |
| enter_fee_flag | 开户费用类型 | String | 1 | N | 1-一次性开户费,2-平台套餐费(元/年)
示例值:2 |
| online_refund | 是否开通在线退款 | String | 1 | N | N:否 Y:是;示例值:Y |
| platform_refund | 是否支持平台退款 | String | 1 | N | N:否 Y:是;示例值:Y |
| support_revoke | 是否支持撤销 | String | 1 | N | N:否 Y:是;示例值:Y |
| split_conf_info | 分账配置信息 | String | | N | jsonObject字符串 |
| uni_app_payment_config | 银联线上收银台 | String | | N | jsonObject字符串 |
| fund_collection_flag | 资金归集开通标记 | String | 1 | N | Y:是,N:否;示例值:Y |
| surrogate_config_list | 代发配置 | String | | N | jsonArray格式字符串 |
| large_amt_pay_config | 大额支付配置 | String | | N | jsonObject字符串 |
| half_pay_host_flag | 统一收银台开关 | String | 1 | N | Y:是 N:否(为空默认未开通) ;示例值:Y |
| agent_recheck_config | 代发复核配置 | String | | N | jsonObject字符串 |
| online_recharge_flag | 商户开通网银充值开关 | String | 1 | N | Y:是 N:否;示例值:Y |
| refund_mend_open_flag | 是否开通垫资退款 | String | 1 | N | Y:是 N:否 ;示例值:Y |
| jxf_conf_info | 捷行付配置 | String | | N | jsonObject字符串 |
| merge_pay_config_info | 合单支付配置信息 | String | | N | jsonObject字符串 |
| bill_payment_flag | 是否开通账单支付 | String | 1 | N | Y:是 N:否 ;示例值:Y |
| withhold_pay_scene | 代扣场景 | String | | C | withhold_flag开通需填写 1:权益投流(订阅),2:非权益投流(订阅),3:保险缴纳,4:道路通行费(ETC),5:公共事业(水电煤)缴费,6:物业缴费 |
| recon_resp_sys_id | 交易应答返回推送系统号 | String | 32 | N | 交易应答返回推送系统号;示例值:6666000123123123 |
| dy_conf_list | 抖音配置对象对象 | Object | | N | jsonArray字符串 |
| 参数 | 中文名 | 定义 | 长度 | 必填 | 说明 |
| :---------------- | :------------------- | :----- | :--- | :------- | :----------------------------------------------------------- |
| agreement_type | *协议类型* | String | 1 | Y | 0-电子协议 1-纸质协议 3-挂网协议;示例值:3
退出地区且开通(银联二维码或刷卡业务)不支持挂网协议;如果业务开通时选了纸质或电子,变更时也不支持挂网协议; |
| agreement_url | *挂网协议地址* | String | 256 | C | 挂网协议必填;**必须按示例值填写**,示例值:https://cloudpnrcdn.oss-cn-shanghai.aliyuncs.com/opps/api/prod/download_file/PaymentServiceAgreement.htm; |
| agree_begin_date | 纸质协议开始日期 | String | 8 | N | 格式yyyyMMdd,示例值:20220822 |
| agree_end_date | 纸质协议结束日期 | String | 8 | N | 格式yyyyMMdd,示例值:20230822 |
| message_send_type | 电子协议签约短信发送标识 | String | 1 | N | 协议类型为电子,业务开通审核通过后发送协议签约短信;
0:发送,默认;
1:不发送;
示例值:1 |
| agreement_async_return_url | 电子协议异步通知地址 | String | 128 | N | 示例值:http://service.example.com/to/path |
| 参数 | 中文名 | 定义 | 长度 | 必填 | 说明 |
| :---------------- | :------------------- | :----- | :--- | :------- | :----------------------------------------------------------- |
| fee_type | 业务类型 | String | 25 | Y | ONLINE_PERSON:个人网银支付,online_flag开通了才需要填;
ONLINE_ENT:企业网银支付,online_flag开通了才需要填;
QUICK_DEBIT:快捷借记卡支付,quick_flag开通了才需要填;
QUICK_CREDIT:快捷贷记卡支付,quick_flag开通了才需要填;
WAP:手机WAP支付,online_flag开通了才需要填;
ONLINE_ENT_TOP_UP:B2B网银充值,online_recharge_flag开通了才需要填;
ONLINE_PERSON_TOP_UP:B2C网银充值,online_recharge_flag开通了才需要填;
WITHHOLD_DEBIT:代扣借记卡支付
WITHHOLD_CREDIT:代扣贷记卡支付,withhold_flag开通了才需要填;
示例值:ONLINE_PERSON |
| bank_id | 银行编码 | String | 8 | Y | 参考: [银行编码](https://paas.huifu.com/open/doc/api/#/csfl/api_csfl_yhbm);示例值:01020000 |
| dc_flag | 借贷标志 | String | 1 | Y | D:借记,C:贷记;示例值:D |
| fix_amt | 手续费(固定/元) | String | 16 | N | 必须填写一种收费方式;保留两位小数;保留两位小数;示例值:1.00 |
| fee_rate | 费率(%) | String | 6 | N | 必须填写一种收费方式;保留两位小数;示例值:0.38 |
| bank_name | 银行名称 | String | 50 | N | 示例值:中国工商银行上海市中山北路支行 |
| bank_short_chn | 银行中文简称 | String | 50 | N | 示例值:工行上海市中北支行 |
| stat_flag | 费率状态 | String | 1 | Y | 1开,0关;示例值:1 |
| fee_min_amt | 手续费最小值(元) | String | 6 | N | 必须填写一种收费方式;保留两位小数;保留两位小数;示例值:1.00 |
| fee_formula_type | 代扣手续费计费模式 | String | | N | withhold_flag为Y时,才可传入;
01: 百分比手续费,无封顶值或保底值
02: 百分比手续费,有保底值
03: 固定手续费
04: 固定手续费+百分比手续费
为空默认04 示例值:04 |
| 参数 | 中文名 | 定义 | 长度 | 必填 | 说明 |
| :---------------- | :------------------- | :----- | :--- | :------- | :----------------------------------------------------------- |
| fee_rate | 手续费(%) | String | 9 | Y | 数字类型,大于0,保留2位小数;示例值:0.38 |
| fee_min_amt | 最低收取手续费(元) | String | 6 | N | 固定金额保留2位小数;大于0。需要渠道商开通此功能。示例值:0.38 |
| mcc | 商户经营类目 | String | 32 | N | 支付宝商户经营类目,[支付宝MCC](https://paas.huifu.com/open/doc/api/#/csfl/api_csfl_zfbmcc) ;示例值:5411 |
| pay_scene | 支付场景 | String | 2 | Y | 1、线下扫码,2.线上扫码,3.非盈利费率;示例值:1 |
| pay_channel_id | 子渠道号 | String | 50 | N | 不填入驻到渠道默认配置的支付宝渠道号下;示例值:JP00001 |
| switch_state | *功能开关* | String | 2 | Y | 1:开通 0:关闭 默认:1;示例值:1
|
| is_check_real_name | 是否需要实名认证 | String | 1 | N | Y-是,业务功能开通成功后使用法人信息发起实名认证申请 ;
N-否;默认为N
示例值:Y |
| al_real_name_info | 实名认证信息 | String | | N | 实名时需要填写;jsonObject字符串
若请求支付宝入驻成功,但实名申请失败需要调用单独的实名接口重新发起实名。 |
| 参数 | 中文名 | 定义 | 长度 | 必填 | 说明 |
| :---------------- | :------------------- | :----- | :--- | :------- | :----------------------------------------------------------- |
| finance_institution_flag | 是否金融机构 | String | | N | 选填,请根据申请主体的实际情况填写
1、若商户主体是金融机构,则填写:true。
2、若商户主体不是金融机构,则填写:false。
若未传入将默认填写:false
3,支付宝实名金融机构需要提供 F236:金融机构许可证图片一 ;F237:金融机构许可证图片二;F238:金融机构许可证图片三;F239:金融机构许可证图片四;F240:金融机构许可证图片五
补充资料填写在extended_material_list对象中;示例值:true |
| finance_type | 金融机构类型 | String | 128 | N | 当主体是金融机构时,必填
金融机构类型需与营业执照/登记证书上一致
BANK_AGENT:银行业, 适用于商业银行、政策性银行、农村合作银行、村镇银行、开发性金融机构等
PAYMENT_AGENT:支付机构, 适用于非银行类支付机构
INSURANCE:保险业, 适用于保险、保险中介、保险代理、保险经纪等保险类业务
TRADE_AND_SETTLE:交易及结算类金融机构, 适用于交易所、登记结算类机构、银行卡清算机构、资金清算中心等
OTHER:其他金融机构, 适用于财务公司、信托公司、金融资产管理公司、金融租赁公司、汽车金融公司、贷款公司、货币经纪公司、消费金融公司、证券业、金融控股公司、股票、期货、货币兑换、小额贷款公司、金融资产管理、担保公司、商业保理公司、典当行、融资租赁公司、财经咨询等其他金融业务;
示例值:BANK_AGENT |
| cert_type | 证书类型 | String | 64 | N | 企业商户必填
枚举:
统一社会信用代码证书(CERTIFICATE_TYPE_2389)
慈善组织公开募捐资格证书(CERTIFICATE_TYPE_2397)
社会团体法人登记证书(CERTIFICATE_TYPE_2394)
民办非企业单位登记证书(CERTIFICATE_TYPE_2395)
基金会法人登记证书(CERTIFICATE_TYPE_2396)
农民专业合作社法人营业执照(CERTIFICATE_TYPE_2398)
宗教活动场所登记证(CERTIFICATE_TYPE_2399)
其他证书/批文/证明(CERTIFICATE_TYPE_2400)
示例值:CERTIFICATE_TYPE_2389
政府机关/事业单位/其他组织 对应需要补充单位证明函照片 文件类型F46
补充资料填写在extended_material_list对象中;示例值:CERTIFICATE_TYPE_2395 |
| micro_biz_type | 小微经营类型 | String | 32 | N | 小微经营类型 必填字段
门店场所:MICRO_TYPE_STORE
流动经营/便民服务:MICRO_TYPE_MOBILE
线上商品/服务交易:MICRO_TYPE_ONLINE
个人商户需要填写;示例值:MICRO_TYPE_STORE
需要提供 F22:店铺门头照图片;F24:店铺内景图片; 补充资料填写在extended_material_list对象中 |
| special_category_id | 特殊行业id | String | 20 | N | 特殊行业必填,参见支付宝商家行业二级类目code
1,支付宝实名特殊行业提供 F150:行业经营许可证资质照片一;F151:行业经营许可证资质照片二;F152:行业经营许可证资质照片三;F153:行业经营许可证资质照片四;F154:行业经营许可证资质照片五;F155:行业经营许可证资质照片六;
补充资料填写在extended_material_list对象中;示例值:100 |
| contact_person_info | 联系人信息对象 | String | | N | |
| legal_person_info | 法人身份信息 | String | | N | |
| 参数 | 中文名 | 定义 | 长度 | 必填 | 说明 |
| :---------------- | :------------------- | :----- | :--- | :------- | :----------------------------------------------------------- |
| name | 联系人姓名 | String | 64 | N | 为空时取企业商户取联系人姓名,个人商户取入驻时填写的名称;示例值:张三 |
| mobile | 联系人手机号 | String | 64 | N | 为空时取企业商户取联系人手机号;示例值:13917353627 |
| id_card_number | 联系人身份证号码 | String | 32 | Y | 示例值:320926198512053827 |
| 参数 | 中文名 | 定义 | 长度 | 必填 | 说明 |
| :---------------- | :------------------- | :----- | :--- | :------- | :----------------------------------------------------------- |
| legal_type | 证件持有人类型 | String | 32 | N | 法人:LEGAL,为空时默认选项; 主体类型为企业、个体户、社会组织、小微商户时,必须为经营者/法人。
经办人:SUPER;主体类型为政府机关、事业单位时默认是法人。若因特殊情况,无法提供法人证件时可填经办人类型。
示例值:LEGAL |
| card_type | 证件类型 | String | 32 | N | 枚举值:00:身份证 01:护照 13:港澳居民证 14:台湾居民证;
为空时取开户时法人信息
个体户/企业/事业单位/社会组织:可选择任一证件类型,政府机关、小微商户仅支持身份证类型。
示例值:00 |
| person_name | 姓名 | String | 64 | N | 为空时取开户时法人信息;示例值:李四 |
| card_no | 证件号码 | String | 64 | N | 为空时取开户时法人信息;示例值:233330199001010001 |
| effect_time | 证件生效时间 | String | 32 | N | 为空时取开户时法人信息;示例值:19990101 |
| expire_time | 证件过期时间 | String | 32 | N | 为空时取开户时法人信息;示例值:20001101,长期有效时传“长期” |
| card_front_img | 证件正面照 | String | 128 | N | 为空时取开户时法人信息,如果开户时未传该字段必填;上送图片上传返回的jfileId;示例值:57cc7f00-600a-33ab-b614-6221bbf2e530 |
| card_back_img | 证件反面照 | String | 128 | N | 为空时取开户时法人信息,如果开户时未传该字段必填;只有身份证类型需要上传反面;上送图片上传返回的jfileId;示例值:57cc7f00-600a-33ab-b614-6221bbf2e530 |
| auth_letter_img | 授权函照片 | String | 128 | N | 上送图片上传返回的jfileId;文件类型F224业务办理授权函;当证件持有人类型为经办人时必须上传。其他情况,无需上传。示例值:57cc7f00-600a-33ab-b614-6221bbf2e530 |
| is_benefit_person | 是否为受益人 | String | 1 | N | Y-受益人;N-非受益人 默认值:Y;示例值:Y |
| 参数 | 中文名 | 定义 | 长度 | 必填 | 说明 |
| :---------------- | :------------------- | :----- | :--- | :------- | :----------------------------------------------------------- |
| switch_state | 开关状态 | String | 1 | Y | 1:开通,0关闭;示例值:1 |
| fee_rate | 手续费(%) | String | 9 | Y | 数字类型,大于0,保留2位小数;示例值:0.38 |
| fee_min_amt | 最低收取手续费(元) | String | 6 | N | 固定金额保留2位小数;大于0。需要渠道商开通此功能。示例值:0.38 |
| pay_scene | 支付场景 | String | 2 | Y | 参见《[微信支付场景](https://paas.huifu.com/open/doc/api/#/api_ggcsbm?id=%e5%be%ae%e4%bf%a1%e6%94%af%e4%bb%98%e5%9c%ba%e6%99%af)》说明;示例值:1 |
| fee_rule_id | 费率规则ID | String | 3 | N | [微信费率规则](https://paas.huifu.com/open/doc/api/#/csfl/api_csfl_wxflgz),简称cid。示例值:758 |
| pay_channel_id | 子渠道号 | String | 32 | N | 不填入驻到渠道默认配置的微信渠道号下;示例值:JP00001 |
| service_codes | 申请服务 | String | 100 | N | 微信(JSAPI:JSAPI支付,APPLET:小程序支付,MICROPAY:付款码支付,APP:app支付,MWEB:H5支付,PAP:委托代扣支付,AUTH:授权平台代扣支付),
示例值:[JSPAI","APPLET",MICROPAY"]
默认值为:[JSPAI","APPLET","MICROPAY"] |
| is_check_real_name | 是否需要实名认证 | String | 1 | N | Y-是,业务功能开通成功后使用法人信息发起实名认证申请 ; N-否;默认为N ;示例值:Y |
| wx_real_name_info | 实名认证信息 | String | | N | 实名时需要填写 jsonObject字符串
若请求微信入驻成功,实名申请失败需要调用单独的实名接口重新发起实名。 |
| 参数 | 中文名 | 定义 | 长度 | 必填 | 说明 |
| :---------------- | :------------------- | :----- | :--- | :------- | :----------------------------------------------------------- |
| finance_institution_flag | 是否金融机构 | String | | N | 选填,请根据申请主体的实际情况填写,可参考选择:https://kf.qq.com/faq/220215IrMRZ3220215n6buiU.html
1、若商户主体是金融机构,则填写:true。
2、若商户主体不是金融机构,则填写:false。
若未传入将默认填写:false
3,微信实名金融机构需要提供 F236:金融机构许可证图片一 ;F237:金融机构许可证图片二;F238:金融机构许可证图片三;F239:金融机构许可证图片四;F240:金融机构许可证图片五
补充资料填写在extended_material_list对象中;示例值:false |
| finance_type | 金融机构类型 | String | 128 | N | 当主体是金融机构时,必填
金融机构类型需与营业执照/登记证书上一致,可参考选择金融机构指引:
https://kf.qq.com/faq/220215IrMRZ3220215n6buiU.html
BANK_AGENT:银行业, 适用于商业银行、政策性银行、农村合作银行、村镇银行、开发性金融机构等
PAYMENT_AGENT:支付机构, 适用于非银行类支付机构
INSURANCE:保险业, 适用于保险、保险中介、保险代理、保险经纪等保险类业务
TRADE_AND_SETTLE:交易及结算类金融机构, 适用于交易所、登记结算类机构、银行卡清算机构、资金清算中心等
OTHER:其他金融机构, 适用于财务公司、信托公司、金融资产管理公司、金融租赁公司、汽车金融公司、贷款公司、货币经纪公司、消费金融公司、证券业、金融控股公司、股票、期货、货币兑换、小额贷款公司、金融资产管理、担保公司、商业保理公司、典当行、融资租赁公司、财经咨询等其他金融业务;示例值:INSURANCE |
| cert_type | 证书类型 | String | 64 | N | 企业商户必填
CERTIFICATE_TYPE_2388:事业单位法人证书
CERTIFICATE_TYPE_2389:统一社会信用代码证书
CERTIFICATE_TYPE_2394:社会团体法人登记证书
CERTIFICATE_TYPE_2395:民办非企业单位登记证书
CERTIFICATE_TYPE_2396:基金会法人登记证书
CERTIFICATE_TYPE_2399:宗教活动场所登记证
CERTIFICATE_TYPE_2400:其他证书/批文/证明
CERTIFICATE_TYPE_2520:执业许可证/执业证
CERTIFICATE_TYPE_2521:基层群众性自治组织特别法人统一社会信用代码证
CERTIFICATE_TYPE_2522:农村集体经济组织登记证
主体为政府机关/其他组织/事业单位时,F46:单位证明函照片必填
主体为政府机关/其他组织/事业单位时,F45:登记证书必填
补充资料填写在extended_material_list对象中;示例值:CERTIFICATE_TYPE_2389 |
| micro_biz_type | 小微经营类型 | String | 32 | N | 小微经营类型 必填字段
门店场所:MICRO_TYPE_STORE
流动经营/便民服务:MICRO_TYPE_MOBILE
线上商品/服务交易:MICRO_TYPE_ONLINE
个人商户需要填写;示例值:MICRO_TYPE_STORE
需要提供 F22:店铺门头照图片;F24:店铺内景图片; 补充资料填写在extended_material_list对象中 |
| special_category_id | 特殊行业id | String | 3 | N | 特殊行业必填,参看微信支付提供的特殊行业id对照表:
https://pay.weixin.qq.com/wiki/doc/apiv3/wxpay/applysubject_new/chapter6_1.shtml
1,微信实名特殊行业提供 F150:行业经营许可证资质照片一;F151:行业经营许可证资质照片二;F152:行业经营许可证资质照片三;F153:行业经营许可证资质照片四;F154:行业经营许可证资质照片五;F155:行业经营许可证资质照片六;
补充资料填写在extended_material_list对象中;示例值:100; |
| contact_type | 联系人类型 | String | 10 | N | LEGAL:经营者/法人;SUPER:经办人(经商户授权办理微信支付业务的人员),默认:LEGAL
1、主体为“小微/个人卖家”,可选择:LEGAL
2、主体为“个体工商户/企业/政府机关/事业单位/社会组织”,可选择:LEGAL、SUPER 示例值:LEGAL
联系人类型为SUPER时需在extended_material_list文件列表中上传联系人证件正反面照片;
F28:联系人身份证正面照;
F29:联系人身份证反面照;
F33:联系人**护照**人像面;
F241:联系人证件照正面,非身份证与护照类型;
F242:联系人证件照反面,非身份证类型; |
| name | 联系人姓名 | String | 64 | C | 联系人类型contact_type=SUPER时必填。示例值:张三 |
| mobile | 联系人手机号 | String | 11 | C | 联系人类型contact_type=SUPER时必填。示例值:13917364538 |
| contact_id_doc_type | 联系人证件类型 | String | 10 | C | 联系人类型contact_type=SUPER时必填。
枚举值参见《自然人证件类型》说明,示例值:00
个体户/企业/事业单位/社会组织:可选择任一证件类型,政府机关仅支持身份证类型。 |
| id_card_number | 联系人证件号码 | String | 32 | C | 联系人类型contact_type=SUPER时必填。示例值:320936198512035017 |
| contact_period_begin | 联系人证件有效期开始时间 | String | 20 | C | 联系人类型contact_type=SUPER时必填
格式:yyyy-MM-dd;示例值:2019-06-06 |
| contact_period_end | 联系人证件有效期结束时间 | String | 20 | C | 联系人类型contact_type=SUPER时必填
格式:yyyy-MM-dd;示例值:2029-06-06
结束时间大于开始时间;若证件有效期为长期,请填写:长期 |
| 参数 | 中文名 | 定义 | 长度 | 必填 | 说明 |
| :---------------- | :------------------- | :----- | :--- | :------- | :----------------------------------------------------------- |
| charge_cate_code | 银行业务手续费类型 | String | 2 | N | 01:减免类
02:优惠类
03:标准类,默认标准类 。(小微商户仅有03标准类);
04:线上类
示例值:03 |
| switch_state | 功能开关 | String | 2 | N | 1:开通 0:关闭 默认:1;示例值:1
|
| debit_fee_rate | 借记卡手续费(%) | String | 9 | Y | 数字格式,大于等于0,保留2位小数;示例值:0.38 |
| credit_fee_rate_up | 贷记卡手续费1000以上(%) | String | 9 | Y | 数字格式,大于等于0,保留2位小数;示例值:0.60 |
| credit_fee_rate_down | 贷记卡手续费1000及以下(%) | String | 9 | Y | 数字格式,大于等于0,保留2位小数;示例值:0.60 |
| 参数 | 中文名 | 定义 | 长度 | 必填 | 说明 |
| :---------------- | :------------------- | :----- | :--- | :------- | :----------------------------------------------------------- |
| charge_cate_code | 银行业务手续费类型 | String | 2 | N | 01:减免类
02:优惠类
03:标准类(默认03);示例值:03 |
| debit_fee_rate | 借记卡手续费(%) | String | 9 | Y | 数字类型,大于0,保留2位小数;示例值:0.50代表费率为0.5% |
| debit_fee_limit | 借记卡封顶值 | String | 4 | N | 数字类型,大于0,保留2位小数;示例值:5.00 |
| credit_fee_rate | 贷记卡手续费(%) | String | 9 | Y | 数字类型,大于0,保留2位小数;示例值:0.60代表费率为0.6% |
| is_open_small_flag | 是否开通小额双免 | String | 1 | N | 开关状态
0:不开通双免
1:开通双免
2:仅免签;示例值:1 |
| small_free_amt | 小额双免单笔限额(元) | String | 9 | N | 限额需小于等于1000,不传默认0(不开通小额双免);示例值:1000.00 |
| small_fee_amt | 小额双免手续费(%) | String | 9 | N | 数字类型,大于0,保留2位小数,开通小额双免填必须填制;示例值:0.38代表费率为0.38% |
| switch_state | 功能开关 | String | 2 | N | 1:开通 0:关闭 默认:1;示例值:1
|
| is_open_cloud_flag | 云闪付开通状态 | String | 1 | N | 0-关闭 1-开通 |
| 参数 | 中文名 | 定义 | 长度 | 必填 | 说明 |
| :---------------- | :------------------- | :----- | :--- | :------- | :----------------------------------------------------------- |
| fee_rate | 支付手续费(%) | String | 9 | N | 支持两位小数 fee_rate与fee_fix_amt不能同时为空;示例值:0.50代表费率为0.5% |
| fee_fix_amt | 支付固定手续费(元) | String | 9 | N | 支持两位小数 fee_rate与fee_fix_amt不能同时为空;示例值:1.50
注:如果fee_fix_amt与fee_rate都填写了则手续费=fee_fix_amt+支付金额\*fee_rate |
| switch_state | 功能开关 | String | 2 | N | 1:开通 0:关闭 默认:1;示例值:1
|
| out_fee_acct_type | 交易手续费外扣时的账户类型 | String | 2 | N | 01-基本户(不填默认01),02-现金户,05-充值户,09-营销户,示例值:01
优先级高于相同名称的公共参数; |
| out_fee_huifuid | 交易手续费外扣汇付ID | String | 18 | N | 开通交易手续费外扣业务时必填,示例值:6666000123123123
优先级高于相同名称的公共参数; |
| out_fee_flag | 是否交易手续费外扣 | String | 1 | N | 1:外扣 2:内扣(默认2内扣),示例值:1
优先级高于相同名称的公共参数; |
| balance_model | *业务模式* | String | 1 | Y | 2-入驻商户货款(周期性结算)
3-营销补贴(周期性结算)
4-推广方(渠道/代理/个人)的服务佣金/抽成
5-红包发放
6-钱包功能
7-其他模式
8-线上入驻商户货款(周期性结算)
9-线上营销补贴(周期性结算)
10-线上推广方(渠道/代理/个人)的服务佣金/抽成
11-线上其他模式
单选;示例值:6 |
| description_info | *业务情况说明* | String | | Y | jsonObject字符串 |
| charge_mode | 扣费模式 | String | 2 | N | 内扣时枚举值: 01: 默认规则, 02: 收款方分摊, 03: 交易时指定承担方
外扣时枚举值: 10: 指定承担方, 11: 出款方承担, 12: 交易时指定承担方
示例值:11;内扣时默认为01,外扣时默认为10; |
| pay_mode | 余额支付模式 | String | 4 | N | pro,lite;示例值:pro
为空时默认为pro
lite版不支持当日收款资金余额支付
示例值:lite |
| 参数 | 中文名 | 定义 | 长度 | 必填 | 说明 |
| :---------------- | :------------------- | :----- | :--- | :------- | :----------------------------------------------------------- |
| busi_instruction | *业务模式说明* | String | 500 | C | 请详细说明商户的业务模式,包括不限于(业务参与方、各方的权利及义务关系等)。最大500个汉字,必填
示例值:商户向企业采购产品,并将其展示在其电商平台上,用户注册后购买其产品,产品主要有家电、服饰、鞋帽等,用户购买产品的资金作为商户所得,商户根据订单情况进行物流配送。 |
| capital_instruction | *资金流向说明* | String | 500 | C | 请详细说明商户的资金流向,包括但不限于(交易所涉及的各方账户、资金流入流出过程等)。最大500个汉字,必填
示例值:用户选购产品后根据订单支付给商户,商户根据结算周期,结算到对公账户。 |
| function_instruction | *功能开通用途说明* | String | 500 | C | 请详述所申请功能的原因、场景、涉及对象类型。最大500个汉字,必填
示例值:企业工资代发 |
| 参数 | 中文名 | 定义 | 长度 | 必填 | 说明 |
| :---------------- | :------------------- | :----- | :--- | :------- | :----------------------------------------------------------- |
| switch_state | 功能开关 | String | 1 | Y | 0:关闭,1:开通;示例值:1 |
| fee_rate | 支付手续费(%) | String | 9 | N | 支付手续费(%) 支持两位小数;示例值:0.50代表费率为0.5% |
| fee_fix_amt | 支付固定手续费(元) | String | 9 | N | 支付固定手续费(元)支持两位小数;示例值:1.50
注:如果fee_fix_amt与fee_rate都填写了则手续费=fee_fix_amt+支付金额\*fee_rate |
| out_fee_flag | 是否交易手续费外扣 | String | 1 | Y | 1:外扣,仅支持外扣,示例值:1
优先级高于相同名称的公共参数; |
| out_fee_huifuid | 交易手续费外扣汇付ID | String | 18 | Y | 开通交易手续费外扣业务时必填,示例值:6666000123123123
优先级高于相同名称的公共参数; |
| out_fee_acct_type | 交易手续费外扣时的账户类型 | String | 2 | N | 01-基本户(不填默认01),02-现金户,05-充值户,09-营销户,示例值:01
优先级高于相同名称的公共参数; |
| 参数 | 中文名 | 定义 | 长度 | 必填 | 说明 |
| :---------------- | :------------------- | :----- | :--- | :------- | :----------------------------------------------------------- |
| pay_type | 业务类型 | String | 25 | N | ONLINE_PERSON:个人网银
ONLINE_ENT:企业网银
QUICK:快捷
WAP:手机WAP支付
ONLINE_ENT_TOP_UP:B2B网银充值
ONLINE_PERSON_TOP_UP:B2C网银充值
WITHHOLD:代扣支付
示例值:WAP |
| out_fee_acct_type | 交易手续费外扣时的账户类型 | String | 2 | N | 01-基本户(不填默认01),02-现金户,05-充值户,09-营销户;示例值:01 |
| out_fee_huifuid | 交易手续费外扣汇付ID | String | 18 | N | 开通交易手续费外扣业务时必填;示例值:6666000108854952 |
| out_fee_flag | 是否交易手续费外扣 | String | 1 | N | 1:外扣 2:内扣(默认2内扣);示例值:2 |
| switch_state | 功能开关 | String | 1 | N | 0-关闭/1-打开;示例值:1 |
| 参数 | 中文名 | 定义 | 长度 | 必填 | 说明 |
| :---------------- | :------------------- | :----- | :--- | :------- | :----------------------------------------------------------- |
| switch_state | 功能开关 | String | 1 | Y | 全域资金管理配置功能开关。0:关闭,1:开通;示例值:1 |
| out_order_auto_acct_flag | 自动入账开关 | String | 1 | Y | 开通、关闭自动入账功能;0:关闭,1:开通;示例值:1
关闭自动入账需要[处理银行来账通知](https://paas.huifu.com/open/doc/api/#/dejy/api_dejy_lztz),并调用[汇付入账确认接口](https://paas.huifu.com/open/doc/api/#/dejy/api_dejy_yhskfk)来确认入账。 |
| fee_rate | 支付手续费(%) | String | 6 | N | 支持两位小数;示例值:0.45;fee_rate与fee_fix_amt与fee_min_amt不能同时为空 |
| fee_min_amt | 手续费最小值(元) | String | 6 | N | 支付手续费最小值,支持两位小数;示例值:1.00fee_rate与fee_fix_amt与fee_min_amt不能同时为空 |
| out_fee_acct_type | 交易手续费外扣时的账户类型 | String | 2 | N | 01-基本户(不填默认01),02-现金户,05-充值户,09-营销户;示例值:01 |
| out_fee_flag | 交易手续费外扣标记 | String | 1 | N | 1:外扣 2:内扣(默认2内扣);示例值:2 |
| out_fee_huifuid | 交易手续费外扣汇付ID | String | 18 | N | 示例值:6666000123123123 |
| out_order_acct_card | 全域资金开户使用的银行卡信息 | String | | N | jsonObject字符串 |
| out_order_acct_open_fees | 全域资金开户手续费 | String | | N | jsonObject字符串 |
| business_model | 全域支付业务模式 | String | 20 | N | acquiringMode:收单模式,
示例值:acquiringMode |
| other_payment_institutions_pic | 全渠道资金管理补充材料 | String | 64 | C | 涉及文件类型:F504-全渠道资金管理补充材料;
示例值:57cc7f00-600a-33ab-b614-6221bbf2e529 |
| 参数 | 中文名 | 定义 | 长度 | 必填 | 说明 |
| :---------------- | :------------------- | :----- | :--- | :------- | :----------------------------------------------------------- |
| prov_id | 银行所在省 | String | 6 | N | [参考省市区编码表](https://paas.huifu.com/open/doc/api/#/csfl/api_csfl_dqbm);示例值:310000 |
| area_id | 银行所在市 | String | 6 | N | [参考省市区编码表](https://paas.huifu.com/open/doc/api/#/csfl/api_csfl_dqbm);示例值:310100 |
| bank_code | 银行编码 | String | 8 | N | 对公时根据支行编码获取总行编码;参考[银行编码](https://paas.huifu.com/open/doc/api/#/csfl/api_csfl_yhbm);示例值:01020000 |
| branch_code | 支行联行号 | String | 12 | N | card_type为0时必填,参考:[银行支行编码](https://paas.huifu.com/open/doc/api/#/csfl/api_csfl_yhzhbm);示例值:102290026507 |
| branch_name | 支行名称 | String | 64 | N | card_type为0时必填 ,参考:[银行支行编码](https://paas.huifu.com/open/doc/api/#/csfl/api_csfl_yhzhbm);示例值:中国工商银行上海市中山北路支行 |
| card_name | 结算账户名 | String | 128 | Y | 银行卡对应的户名;示例值:上海汇付支付有限公司 |
| card_no | 银行卡号 | String | 32 | Y | 示例值:98140008801800008888 |
| card_type | 卡类型 | String | 1 | Y | 0:对公 1:对私;示例值:0 |
| cert_type | 持卡人证件类型 | String | 2 | C | 00:身份证;示例值:00;card_type为1时选填。 |
| cert_begin_date | 持卡人证件有效期(起始) | String | 8 | C | card_type为1时选填;格式:yyyyMMdd,示例值:20210830;
若填写cert_no,cert_validity_type,cert_type需同时填写。 |
| cert_end_date | 持卡人证件有效期(截止) | String | 8 | C | cert_validity_type变更为0时必填,格式:yyyyMMdd;示例值:20210830 |
| cert_no | 持卡人证件号码 | String | 32 | C | card_type为1时选填;示例值:310112200001018888; |
| cert_validity_type | 持卡人证件有效期类型 | String | 1 | N | card_type为1时选填;1:长期有效 0:非长期有效;示例值:0
若填写cert_begin_date,cert_no,cert_type需同时填写。 |
| mp | 银行卡绑定手机号 | String | 11 | Y | 示例值:18611111111 |
| open_licence_no | 开户许可证核准号 | String | 32 | N | 示例值:J2900123456789 |
| 参数 | 中文名 | 定义 | 长度 | 必填 | 说明 |
| :---------------- | :------------------- | :----- | :--- | :------- | :----------------------------------------------------------- |
| fee_fix_amt | 开户手续费(元) | String | 9 | Y | 支持两位小数;示例值:1.00 |
| out_fee_acct_type | 开户手续费外扣时的账户类型 | String | 2 | C | 01-基本户,02-现金户,05-充值户,09-营销户,不填默认01;示例值:01
注:fee_fix_amt:开户手续费大于0时必填 |
| out_fee_huifuid | 开户手续费外扣汇付ID | String | 18 | C | 开通手续费外扣业务时必填;示例值:6666000109812123
注:fee_fix_amt:开户手续费大于0时必填 |
| 参数 | 中文名 | 定义 | 长度 | 必填 | 说明 |
| :---------------- | :------------------- | :----- | :--- | :------- | :----------------------------------------------------------- |
| media_type | *运营媒介类型* | String | 2 | Y | S1-PC网站;若媒介项为PC网站:必填字段(PC网站域名、ICP备案/许可证号)
S2-APP场景;若媒介项为APP场景:必填字段(APP名称、APP下载地址),若开通微信App支付,则新增app_id、app_name必填
S3-小程序场景;若媒介项为小程序:必填字段(小程序名称)
S4-公众号场景;若媒介项为公众号:必填字段(公众号名称)
S5-其他;媒介项为其他:其他有效信息或链接地址必填
线上场景时必填一项;示例值:S1 |
| media_name | *媒介名称* | String | 200 | C | PC网站域名/APP名称/小程序名称/公众号名称;示例值:汇付服务
运营媒介类型为 :S1/S2/S3/S4时,必填; |
| test_account | *测试账号* | String | 64 | N | 示例值:test |
| test_secret | *测试密码* | String | 64 | N | 示例值:test |
| mer_icp | ICP备案/许可证号 | String | 200 | C | 运营媒介类型为 :S1时必填;示例值:沪ICP备06046402号-28 |
| other_info | *其他有效信息* | String | 200 | C | 其他有效信息或链接地址/APP下载地址;类型为S5或S2必填
示例值:http://download.huifu.com |
| media_front_page | *运营媒介-首页* | String | 128 | N | 通过[图片上传接口](https://paas.huifu.com/open/doc/api/#/shgl/shjj/api_shjj_shtpsc)上传材料;
示例值:57cc7f00-600a-33ab-b614-6221bbf2e530 |
| media_service_page | *运营媒介-服务/商品明细页面* | String | 128 | N | 通过[图片上传接口](https://paas.huifu.com/open/doc/api/#/shgl/shjj/api_shjj_shtpsc)上传材料;
示例值:57cc7f00-600a-33ab-b614-6221bbf2e530 |
| media_order_page | *运营媒介-下单场景页面* | String | 128 | N | 通过[图片上传接口](https://paas.huifu.com/open/doc/api/#/shgl/shjj/api_shjj_shtpsc)上传材料;
示例值:57cc7f00-600a-33ab-b614-6221bbf2e530 |
| media_pay_page | *运营媒介-支付页面* | String | 128 | N | 通过[图片上传接口](https://paas.huifu.com/open/doc/api/#/shgl/shjj/api_shjj_shtpsc)上传材料;
示例值:57cc7f00-600a-33ab-b614-6221bbf2e530 |
| media_mer_common_flag | *媒介主体与商户主体是否一致* | String | 1 | C | Y/N;示例值:Y
运营媒介为S1、S2、S3、S4且企业商户开通快捷或网银,或大额转账,或余额支付或分账业务(20%(不含)-100%),或为个人商户开通分账业务(10%(不含)-100%),必填
若不一致,则需提供ICP备案/APP/微信公众号/小程序主体与商户的使用授权或开发证明材料; |
| authorize_materials | *授权或开发证明材料* | String | 128 | C | 运营媒介为S1、S2、S3、S4且媒介主体与商户主体不一致时,且企业商户开通快捷或网银,或大额转账,或余额支付或分账业务(20%(不含)-100%),或为个人商户开通分账业务(10%(不含)-100%),必填
示例值:57cc7f00-600a-33ab-b614-6221bbf2e530 |
| other_material | 微信APP补充材料 | String | 128 | C | 运营媒介为S2且开通微信下app支付时选填,具体见[图片上传接口](https://paas.huifu.com/open/doc/api/#/shgl/shjj/api_shjj_shtpsc) |
| app_id | appId | String | 128 | C | 运营媒介为S2且开通微信下app支付时必填 |
| app_name | appId认证主体名称 | String | 128 | C | 运营媒介为S2且开通微信下app支付时必填 |
| supplement | 补充说明 | String | 512 | C | 运营媒介为S2且开通微信下app支付时选填 |
| 参数 | 中文名 | 定义 | 长度 | 必填 | 说明 |
| :---------------- | :------------------- | :----- | :--- | :------- | :----------------------------------------------------------- |
| file_id | *文件id* | String | 64 | Y | 请填写图片file_id,可通过 [商户图片上传](https://paas.huifu.com/open/doc/api/#/shgl/shjj/api_shjj_shtpsc) 接口获取;
示例值:57cc7f00-600a-33ab-b614-6221bbf2e529 |
| file_type | *文件类型* | String | 64 | N | [参见文件类型说明](https://paas.huifu.com/open/doc/api/#/csfl/api_csfl_wjlx);开通[分账功能提供材料说明](https://cloudpnrcdn.oss-cn-shanghai.aliyuncs.com/opps/api/prod/download_file/kyc/KYC-%E5%88%86%E8%B4%A6%E5%8A%9F%E8%83%BD%E6%8F%90%E4%BE%9B%E6%9D%90%E6%96%99.xlsx);示例值:F01 |
| 参数 | 中文名 | 定义 | 长度 | 必填 | 说明 |
| :---------------- | :------------------- | :----- | :--- | :------- | :----------------------------------------------------------- |
| type | 签约人类型 | String | 7 | Y | LEGAL-法人,对公结算或对私法人结算时可选法人签约;
CONTACT-联系人,对公结算可选联系人(经办人)签约;
OTHER-其他,对私非法人结算选“其他”,必须是结算人;
示例值:LEGAL |
| name | 姓名 | String | 32 | C | 签约人类型=其他,必填;示例值:张三 |
| mobile_no | 手机号 | String | 11 | C | 签约人类型=法人/其他 ,必填;注意:**签约人会做姓名+身份证+手机号验证,请正确填写**;示例值:13917463536 |
| cert_no | 身份证 | String | 32 | C | 签约人类型=联系人/其他,必填 ;注意:**签约人会做姓名+身份证+手机号验证,请正确填写**;示例值:320946195712025082 |
| email | 邮箱 | String | 32 | N | 示例值:example@email.com |
| 参数 | 中文名 | 定义 | 长度 | 必填 | 说明 |
| :---------------- | :------------------- | :----- | :--- | :------- | :----------------------------------------------------------- |
| sub_mch_id | 微信子商户号 | String | 32 | Y | 微信支付分配的子商户号;示例值:1632157057 |
| wx_zl_pay_conf_list | 配置集合 | Array | 512 | Y | |
| 参数 | 中文名 | 定义 | 长度 | 必填 | 说明 |
| :---------------- | :------------------- | :----- | :--- | :------- | :----------------------------------------------------------- |
| service_code | 申请服务 | String | 16 | Y | JSAPI-公众号,APPLET-小程序;示例值:JSAPI |
| sub_app_id | 功能服务appid | String | 32 | Y | 子商户的公众号、小程序ID;示例值:wx51aa91a575359ff5 |
| switch_state | 功能开关 | String | 1 | Y | 0-关闭,1-打开;示例值:1 |
| fee_rate | 功能费率(%) | String | 6 | Y | 保留两位小数。示例值:0.60 |
| operate_type | 操作类型 | String | 10 | C | ADD-新增, UPDATE-修改, 默认新增;示例值:ADD |
| contact_info | 联系人信息 | String | | C | jsonObject字符串,新增时必填 |
| certificate_info | 特殊主体登记证书 | String | | C | jsonObject字符串,商户营业执照类型为政府机关/事业单位/其他组织时,传入相应信息。新增时需填入 |
| ubo_info | 最终受益人信息 | String | | C | jsonObject字符串,商户类型为企业时,微信侧必填。(如果基本信息里有的话,可以不传取 huifu_id 对应的信息)。新增时填入 |
| sales_info | 经营场景 | String | | C | jsonObject字符串,新增时填入 |
| wx_card_info | 银行账户信息 | String | | C | jsonObject字符串,该字段不填时,取商户在汇付系统录入的结算账号信息。新增或修改时填入,修改时必填 |
| business_addition_msg | 补充说明信息 | String | 512 | N | 示例值:补充说明 |
| addition_file_list | 补充说明文件列表 | String | | N | jsonArray格式,根据实际审核情况,额外要求商家提供指定的补充资料
F85-微信直连额外补充材料一
F86-微信直连额外补充材料二
F87-微信直连额外补充材料三
F88-微信直连额外补充材料四
F89-微信直连额外补充材料五
F90-法人开户承诺函
F91-法人开户意愿视频 |
| 参数 | 中文名 | 定义 | 长度 | 必填 | 说明 |
| :---------------- | :------------------- | :----- | :--- | :------- | :----------------------------------------------------------- |
| contact_type | 联系人类型 | String | 1 | Y | 1: 法人;2:经办人;示例值:1 |
| contact_name | 联系人姓名 | String | 128 | C | 联系人类型为经办人时必填;示例值:张三 |
| cert_type | 联系人证件类型 | String | 2 | C | 联系人类型为经办人时必填;
00:身份证
01:护照
11:港澳台同胞通行证
12:外国人居留证
13:港澳居民证
14:台湾居民证
示例值:00; |
| contact_cert_no | 联系人证件号码 | String | 18 | C | 联系人类型为经办人时必填;示例值:32090297512026402 |
| contact_mobile_no | 联系人手机号 | String | 11 | Y | 示例值:13911111111 |
| contact_email | 联系人电子邮箱 | String | 40 | Y | 示例值:carl.chen@huifu.com |
| contact_file_list | 联系人资料 | String | | C | 联系人类型为经办人时必填
F28-联系人身份证国徽面
F29-联系人身份证人像面
F227-微信业务办理授权函
示例值: |
| contact_cert_validity_type | 证件有效期类型 | String | 1 | Y | 有效期类型 1:长期有效 0:非长期有效;示例值:1
若长期有效,则无需填写证书有效期截止日期 |
| contact_cert_begin_date | 证件有效期开始日期 | String | 8 | Y | 格式:YYYYMMDD;示例值:20100908 |
| contact_cert_end_date | 证件有效期截止日期 | String | 8 | N | 格式:YYYYMMDD;示例值:20300908 |
| 参数 | 中文名 | 定义 | 长度 | 必填 | 说明 |
| :---------------- | :------------------- | :----- | :--- | :------- | :----------------------------------------------------------- |
| file_type | 文件类型 | String | 6 | Y | 示例值:F50 |
| file_id | 文件jfileId | String | 64 | Y | 示例值:57cc7f00-600a-33ab-b614-6221bbf2e529 |
| 参数 | 中文名 | 定义 | 长度 | 必填 | 说明 |
| :---------------- | :------------------- | :----- | :--- | :------- | :----------------------------------------------------------- |
| cert_type | 登记证书类型 | String | 32 | Y | CERTIFICATE_TYPE_2388:事业单位法人证书
CERTIFICATE_TYPE_2389:统一社会信用代码证书
CERTIFICATE_TYPE_2390:有偿服务许可证(军队医院适用)
CERTIFICATE_TYPE_2391:医疗机构执业许可证(军队医院适用)
CERTIFICATE_TYPE_2392:企业营业执照(挂靠企业的党组织适用)
CERTIFICATE_TYPE_2393:组织机构代码证(政府机关适用)
CERTIFICATE_TYPE_2394:社会团体法人登记证书
CERTIFICATE_TYPE_2395:民办非企业单位登记证书
CERTIFICATE_TYPE_2396:基金会法人登记证书
CERTIFICATE_TYPE_2397:慈善组织公开募捐资格证书
CERTIFICATE_TYPE_2398:农民专业合作社法人营业执照
CERTIFICATE_TYPE_2399:宗教活动场所登记证
CERTIFICATE_TYPE_2400:其他证书/批文/证明
示例值:CERTIFICATE_TYPE_2400 |
| cert_no | 证书号 | String | 32 | Y | 请填写登记证书上的证书编号。示例值:92650109MA79R8E308 |
| cert_mer_name | 证书商户名称 | String | 128 | Y | 请填写登记证书上的商户名称。示例值:上海汇付支付服务公司 |
| reg_detail | 注册地址 | String | 128 | Y | 请填写登记证书的注册地址。示例值:上海徐汇宜山路601号C5栋 |
| legal_name | 法人姓名 | String | 32 | Y | 1、只能由中文字符、英文字符、可见符号组成。
2、请填写登记证书上的法定代表人姓名。示例值:张三 |
| cert_validity_type | 证书有效期类型 | String | 1 | Y | 有效期类型 1:长期有效 0:非长期有效;示例值:0
若长期有效,则无需填写证书有效期截止日期 |
| cert_begin_date | 证书有效期开始日期 | String | 8 | Y | 格式:YYYYMMDD;示例值:20100908 |
| cert_end_date | 证书有效期截止日期 | String | 8 | N | 格式:YYYYMMDD;示例值:20300908 |
| cert_file_list | 文件列表 | String | | Y | jsonArray,F46-单位证明函,F45-登记证书 |
| 参数 | 中文名 | 定义 | 长度 | 必填 | 说明 |
| :---------------- | :------------------- | :----- | :--- | :------- | :----------------------------------------------------------- |
| file_type | 文件类型 | String | 6 | Y | 示例值:F50 |
| file_id | 文件jfileId | String | 64 | Y | 示例值:57cc7f00-600a-33ab-b614-6221bbf2e529 |
| 参数 | 中文名 | 定义 | 长度 | 必填 | 说明 |
| :---------------- | :------------------- | :----- | :--- | :------- | :----------------------------------------------------------- |
| ubo_type | 经营者/法人是否为受益人 | String | 1 | Y | Y-是,N-否;示例值:Y |
| ubo_info_list | 受益人信息列表 | String | | C | jsonArray格式,当ubo_type为Y时可不填 |
| 参数 | 中文名 | 定义 | 长度 | 必填 | 说明 |
| :---------------- | :------------------- | :----- | :--- | :------- | :----------------------------------------------------------- |
| ubo_cert_type | 证件类型 | String | 2 | Y | 00:身份证 01:护照;示例值:00 |
| ubo_cert_no | 证件号码 | String | 18 | Y | 示例值:320926198512027462 |
| ubo_name | 姓名 | String | 32 | Y | 示例值:张三 |
| ubo_cert_doc_address | 受益人证件居住地址 | String | 128 | Y | 示例值:上海宝山区共富路11号 |
| ubo_cert_validity_type | 证件有效类型 | String | 1 | Y | 1:长期有效 0:非长期有效;示例值:0 |
| ubo_cert_begin_date | 证件有效期开始日期 | String | 8 | Y | 示例值:20200908 |
| ubo_cert_end_date | 证件有效期截止日期 | String | 8 | N | 示例值:20330908 |
| ubo_file_list | 文件列表 | String | | Y | jsonArray,F228-受益人身份证正面(国徽面),F229-联系人身份证反面(人像面);示例值:F229 |
| 参数 | 中文名 | 定义 | 长度 | 必填 | 说明 |
| :---------------- | :------------------- | :----- | :--- | :------- | :----------------------------------------------------------- |
| file_type | 文件类型 | String | 6 | Y | 示例值:F50 |
| file_id | 文件jfileId | String | 64 | Y | 示例值:57cc7f00-600a-33ab-b614-6221bbf2e529 |
| 参数 | 中文名 | 定义 | 长度 | 必填 | 说明 |
| :---------------- | :------------------- | :----- | :--- | :------- | :----------------------------------------------------------- |
| sales_scenes_type | 经营场景类型 | String | 256 | Y | 多个以英文逗号分割,至少要有一个
线下门店:SALES_SCENES_STORE
公众号:SALES_SCENES_MP
小程序:SALES_SCENES_MINI_PROGRAM
互联网:SALES_SCENES_WEB
APP:SALES_SCENES_APP
企业微信:SALES_SCENES_WEWORK
示例值:SALES_SCENES_WEWORK |
| fee_rate | 功能费率 | String | 6 | C | 仅支持渠道商传入该字段。示例值:0.06
平台商户为子商户开通微信直连支付时,不支持该字段,取平台商户费率上送微信。 |
| fee_rate_file_list | 文件列表 | String | | N | 微信直连商户费率材料,根据微信要求上送。示例值:d1451277-85c6-3177-ac3d-a8be47b9ae9d |
| biz_store_name | 门店名称 | String | 128 | N | 不传,取 huifu_id 关联信息,微信侧条件必填;示例值:卡卡奶茶共富店 |
| biz_address_code | 门店省市编码 | String | 128 | N | 不传,取 huifu_id 关联信息,微信侧条件必填;示例值:310100 |
| biz_store_address | 门店地址 | String | 128 | N | 不传,取 huifu_id 关联信息,微信侧条件必填;示例值:上海宝山共富路1号 |
| biz_sub_jsapi_app_id | 线下场所对应的商家公众号APPID | String | 256 | C | 开通线下门店场景时,填入。都填入时,取公众号的上送微信。示例值:wx51aa91a575359ff5 |
| biz_sub_mini_app_id | 线下场所对应的商家小程序APPID | String | 256 | C | 开通线下门店场景时,填入。都填入时,取公众号的上送微信。示例值:wxea9c30a90fs8d3fe |
| jsapi_app_id | 服务商公众号 ID | String | 256 | C | 开通公众号场景时,直连服务商和商户的公众号 APP ID,二选一填入。示例值:wx51aa91a575359ff5 |
| jsapi_sub_app_id | 商家公众号APPID | String | 256 | C | 开通公众号场景时,直连服务商和商户的公众号 APP ID,二选一填入。示例值:wxea9c30a90fs8d3fe |
| mini_app_id | 服务商小程序APPID | String | 256 | C | 开通小程序场景时,直连服务商和商户的小程序 APP ID,二选一填入。示例值:wx51aa91a575359ff5 |
| mini_sub_app_id | 商家小程序APPID | String | 256 | C | 开通小程序场景时,直连服务商和商户的小程序 APP ID,二选一填入。示例值:wx51aa91a575359ff5 |
| app_app_id | 服务商应用APPID | String | 256 | C | 开通 APP 场景时,直连服务商和商户的 APP ID,二选一填入。示例值:wx51aa91a575359ff5 |
| app_sub_app_id | 商家应用APPID | String | 256 | C | 开通 APP 场景时,直连服务商和商户的 APP ID,二选一填入。示例值:wx51aa91a575359ff5 |
| web_domain | 互联网网站域名 | String | 256 | C | 开通互联网场景时填入;示例值:huifu.com |
| web_app_id | 互联网网站对应的商家APPID | String | 256 | C | 开通互联网场景时填入;示例值:wx51aa91a575359ff5 |
| sub_corp_id | 商家企业微信CorpID | String | 256 | C | 开通企业微信场景时填入;示例值:xxxxx |
| sales_scenes_file_list | 文件列表 | String | 6 | Y | 场景资料文件
附件资料列表fileList
线下门店场景,F49与F50必传
公众号场景,F95,F96,F97,F98,F99,总共至少传1张,最多传5张
小程序场景,F60,F61,F62,F63,F64,总共至少传1张,最多传5张
APP场景,F65,F66,F67,F68,各传1张
互联网网站场景,若备案主体与申请主体不同,请务必上传加盖公章的网站授权函(F69)。
企业微信场景,F70,F71,F72,F73,F74,总共至少传1张,最多传5张
F49-店铺内景图片
F50-店铺门头照图片
F95-公众号页面截图一
F96-公众号页面截图二
F97-公众号页面截图三
F98-公众号页面截图四
F99-公众号页面截图五
F60-小程序截图截图一
F61-小程序截图截图二
F62-小程序截图截图三
F63-小程序截图截图四
F64-小程序截图截图五
F65-APP首页截图
F66-APP尾页截图
F67-APP应用内截图
F68-APP支付页截图
F69-网站授权函
F70-企业微信页面截图一
F71-企业微信页面截图二
F72-企业微信页面截图三
F73-企业微信页面截图四
F74-企业微信页面截图五
示例值:F74 |
| 参数 | 中文名 | 定义 | 长度 | 必填 | 说明 |
| :---------------- | :------------------- | :----- | :--- | :------- | :----------------------------------------------------------- |
| file_type | 文件类型 | String | 6 | Y | 示例值:F50 |
| file_id | 文件jfileId | String | 64 | Y | 示例值:57cc7f00-600a-33ab-b614-6221bbf2e529 |
| 参数 | 中文名 | 定义 | 长度 | 必填 | 说明 |
| :---------------- | :------------------- | :----- | :--- | :------- | :----------------------------------------------------------- |
| card_type | 账户类型 | String | 1 | Y | 0:对公银行账户
1:经营者个人银行卡;示例值:0 |
| card_name | 开户名称 | String | 128 | Y | 选择“经营者个人银行卡”时,开户名称必须与“经营者证件姓名”一致。选择“对公银行账户”时,开户名称必须与营业执照上的“商户名称”一致。
示例值:张三 |
| bank_code | 开户银行 | String | 8 | Y | 客户按汇付银行编码上送;示例值:01020000 |
| prov_id | 开户银行省编码 | String | 6 | Y | 按汇付的省市编码;示例值:310000 |
| area_id | 开户银行市编码 | String | 6 | Y | 示例值:310100 |
| branch_code | 开户银行联行号 | String | 20 | C | 开户银行联行号与开户银行全称(含支行)二选一;示例值:102290026507 |
| branch_name | 开户银行全称(含支行) | String | 128 | C | 开户银行联行号与开户银行全称(含支行)二选一;示例值:中国工商银行股份有限公司上海市中山北路支行 |
| card_no | 银行账号 | String | 30 | Y | 示例值:1001265009300682579 |
| 参数 | 中文名 | 定义 | 长度 | 必填 | 说明 |
| :---------------- | :------------------- | :----- | :--- | :------- | :----------------------------------------------------------- |
| file_type | 文件类型 | String | 6 | Y | 示例值:F50 |
| file_id | 文件jfileId | String | 64 | Y | 示例值:57cc7f00-600a-33ab-b614-6221bbf2e529 |
| 参数 | 中文名 | 定义 | 长度 | 必填 | 说明 |
| :---------------- | :------------------- | :----- | :--- | :------- | :----------------------------------------------------------- |
| apply_type | 申请类型 | String | 32 | Y | FACE_TO_FACE:当面付;示例值:FACE_TO_FACE |
| contact_name | 联系人姓名 | String | 64 | N | 支付宝联系人信息,不传取商户的联系人信息;示例值:张三 |
| contact_mobile_no | 联系人手机号 | String | 11 | N | 支付宝联系人信息,不传取商户的联系人信息;示例值:13911111111 |
| contact_email | 联系人电子邮箱 | String | 40 | N | 支付宝联系人信息,不传取商户的联系人信息;示例值:carl.chen@huifu.com |
| order_ticket | 订单授权凭证 | String | 40 | N | 示例值: |
| account | 商户支付宝账号 | String | 128 | Y | 商户登录支付宝控台的账号;示例值:zhangsan |
| fee_rate | 服务费率 | String | 6 | C | 仅支持渠道商。平台商户调用不支持该字段
服务费率(%),0.38~3之间,精确到0.01。示例值:0.06 |
| license_code | 营业执照编号 | String | 20 | N | 工商营业执照编号,示例值:92650109MA79R8E308 |
| license_validity_type | 营业执照有效期类型 | String | 1 | N | 1:长期有效 0:非长期有效示例值: |
| license_begin_date | 营业执照有效期开始日期 | String | 8 | N | 日期格式yyyyMMdd,示例值:20110112 |
| license_end_date | 营业执照有效期截止日期 | String | 8 | N | 日期格式yyyyMMdd,示例值:20110112 |
| file_list | 文件列表 | String | | Y | jsonArray格式,F47-企业特殊资质图片(可选,企业特殊资质图片,可参考商家经营类目中的“需要的特殊资质证书”)
F48-营业执照授权函图片(可选,个体工商户如果使用总公司或其他公司的营业执照认证需上传该授权函图片)
F49-店铺内景图片(可选)
F50-店铺门头照图片(必填)
示例值:F50 |
| 参数 | 中文名 | 定义 | 长度 | 必填 | 说明 |
| :---------------- | :------------------- | :----- | :--- | :------- | :----------------------------------------------------------- |
| file_type | 文件类型 | String | 6 | Y | 示例值:F50 |
| file_id | 文件jfileId | String | 64 | Y | 示例值:57cc7f00-600a-33ab-b614-6221bbf2e529 |
| 参数 | 中文名 | 定义 | 长度 | 必填 | 说明 |
| :---------------- | :------------------- | :----- | :--- | :------- | :----------------------------------------------------------- |
| rule_origin | 分账规则来源 | String | 2 | Y | 01 接口发起 02页面配置;示例值:01 |
| div_flag | 分账开关 | String | 1 | Y | Y:开,N:关;示例值:Y |
| apply_ratio | 最大分账比例% | String | 9 | Y | 0-100 的数值,支持两位小数; 示例值:20.00 |
| acct_split_bunch_list | 分账明细 | String | | N | 分账规则来源选择平台配置时必填,jsonArray格式 |
| start_type | 生效类型 | String | 1 | N | 0-审核通过即时生效;1-审核通过次日生效;示例值:1 |
| out_fee_flag | 交易手续费外扣开关 | String | 1 | N | 1:外扣 2:内扣(默认);示例值:1 |
| out_fee_acct_type | 交易手续费外扣时的账户类型 | String | 2 | N | 01-基本户(默认),02-现金户,05-充值户;示例值:01 |
| out_fee_huifuid | 交易手续费外扣汇付ID | String | 18 | N | 选择手续费外扣时必填;示例值: |
| split_fee_rate | 手续费% | String | 9 | N | 开通分账业务时必须填写一种收费方式;百分比,支持两位小数;示例值:1.00
分账手续费收取方式为费率手续费与固定手续费之和 |
| per_amt | 固定手续费 | String | 9 | N | 开通分账业务时必须填写一种收费方式;单位元,支持小数点后两位;示例值:1.00
分账手续费收取方式为费率手续费与固定手续费之和 |
| scene | 分账模式 | String | 2 | Y | 00-其他
01-医美医院分账
02-线上其他
A1- 教培机构分账
A2-公办/民办学校分账
A3-医美渠道独立收款分账
A4-线上供应商货款
A5-线上推广方(渠道/代理/个人)的服务佣金/抽成
A7-入驻商户货款
A8-线下供应商货款
A9-线下推广方
A10-个人与合作方分账
单选;示例值:A9 |
| split_ext_info | 业务情况说明 | String | 128 | N | jsonObject;分账模式选择则其它,分账比例30%以上必填; |
| 参数 | 中文名 | 定义 | 长度 | 必填 | 说明 |
| :---------------- | :------------------- | :----- | :--- | :------- | :----------------------------------------------------------- |
| fee_rate | 分账比例 | String | 9 | Y | 百分比支持两位小数,示例值:0.20 |
| huifu_id | 汇付Id | String | 18 | Y | 示例值:6666000104778898 |
| 参数 | 中文名 | 定义 | 长度 | 必填 | 说明 |
| :---------------- | :------------------- | :----- | :--- | :------- | :----------------------------------------------------------- |
| busi_instruction | *业务模式说明* | String | 500 | Y | 请详细说明商户的业务模式,包括不限于(业务参与方、各方的权利及义务关系等)。最大500个汉字,必填
示例值:商户向企业采购产品,并将其展示在其电商平台上,用户注册后购买其产品,产品主要有家电、服饰、鞋帽等,用户购买产品的资金作为商户所得,商户根据订单情况进行物流配送。 |
| capital_instruction | *资金流向说明* | String | 500 | Y | 请详细说明商户的资金流向,包括但不限于(交易所涉及的各方账户、资金流入流出过程等)。最大500个汉字,必填
示例值:用户选购产品后根据订单支付给商户,商户根据结算周期,结算到对公账户。 |
| function_instruction | *功能开通用途说明* | String | 500 | Y | 请详述所申请功能的原因、场景、涉及对象类型。最大500个汉字,必填
示例值:企业工资代发 |
| 参数 | 中文名 | 定义 | 长度 | 必填 | 说明 |
| :---------------- | :------------------- | :----- | :--- | :------- | :----------------------------------------------------------- |
| switch_state | 状态开关 | String | 1 | N | 0-关闭; 1-开通, 为空默认开通;示例值:1 |
| debit_fee_rate | 借记手续费(%) | String | 6 | C | 借记卡费率与贷记卡费率不能同时为空;
保留2位小数,最大值100.00,最小值0.00;示例值:0.02 |
| credit_fee_rate | 贷记手续费(%) | String | 6 | C | 借记卡费率与贷记卡费率不能同时为空;
保留2位小数,最大值100.00,最小值0.00;示例值:0.06 |
| out_fee_flag | 是否交易手续费外扣 | String | 1 | N | 1:外扣 2:内扣(默认2内扣);示例值:1
如果不为空,则out_fee_acct_type,out_fee_huifuid,out_fee_flag取单独配置,否则取公共配置; |
| out_fee_huifuid | 交易手续费外扣汇付ID | String | 18 | N | 开通交易手续费外扣业务时必填;示例值:6666000123123123 |
| out_fee_acct_type | 交易手续费外扣时的账户类型 | String | 2 | N | 01-基本户,02-现金户,05-充值户,09-营销户;不填默认01;示例值:01 |
| cloud_quick_pass_secret_free_flag | 云闪付免密支付开通标识 | String | 1 | N | Y:是,N:否;示例值:Y |
| 参数 | 中文名 | 定义 | 长度 | 必填 | 说明 |
| :---------------- | :------------------- | :----- | :--- | :------- | :----------------------------------------------------------- |
| switch_state | 开通状态 | String | 1 | N | 1:是 0:否, 为空默认开;示例值:1 |
| surrogate_type | 代发业务类型 | String | 2 | Y | D0:当日到账;
T1:下个工作日到账;
D1:下个自然日到账;
示例值:T1 |
| fix_amt | 手续费(固定/元) | String | 17 | C | 手续费(固定/元),保留小数点后两位;fee_formula_type为05,06时必填 示例值:1.00 |
| fee_rate | 手续费(百分比/%) | String | 6 | C | 手续费(百分比/%),保留小数点后两位;取值范围[0.00,100.00];fee_formula_type为01,02,03,06时必填 示例值:0.05 |
| out_fee_flag | 是否交手续费外扣标记 | String | 1 | N | 1:外扣 2:内扣(默认2内扣)
优先级高于相同名称的公共参数;示例值:1 |
| out_fee_acct_type | 交易手续费外扣时账户类型 | String | 2 | N | 01-基本户(不填默认01),02-现金户,05-充值户,09-营销户,示例值:01
优先级高于相同名称的公共参数; |
| out_fee_huifu_id | 交易手续费外扣汇付ID | String | 18 | N | 开通交易手续费外扣业务时必填,示例值:6666000123123123
优先级高于相同名称的公共参数; |
| surrogate_private_flag | 是否允许对私代发 | String | 1 | N | 是否允许代发卡为对私类型
Y:允许 N:不允许;示例值:Y |
| fee_formula_type | 代发手续费计费模式 | String | 17 | C | 01: 百分比手续费,无封顶值或保底值
02: 百分比手续费,有保底值
03: 百分比手续费,有封顶值
05: 固定手续费
06: 固定手续费+百分比手续费
为空默认06 示例值:06 |
| fee_max_amt | 手续费封顶值(固定/元) | String | 17 | C | 手续费封顶值(固定/元),保留小数点后两位;fee_formula_type为03时必填 示例值:100.00 |
| fee_min_amt | 手续费保底值(固定/元) | String | 17 | C | 手续费保底值(固定/元),保留小数点后两位;fee_formula_type为02时必填 示例值:1.00 |
| 参数 | 中文名 | 定义 | 长度 | 必填 | 说明 |
| :---------------- | :------------------- | :----- | :--- | :------- | :----------------------------------------------------------- |
| large_amt_pay_config_info_list | 大额支付配置列表 | String | | Y | 大额支付配置列表,jsonArray格式 |
| out_fee_flag | 交易手续费外扣标记 | String | 1 | N | 1:外扣 2:内扣(默认2内扣);示例值:1 |
| out_fee_huifu_id | 交易手续费外扣huifuId | String | 18 | C | 交易手续费外扣时必填;示例值:6666000108854952 |
| out_fee_acct_id | 交易手续费外扣账户号 | String | 16 | C | 交易手续费外扣时必填;示例值:F00598602 |
| mer_payer_card_type | 商户付款方卡类型 | String | 10 | N | CORPORATE-对公,PRIVATE-对私,ALL-全部,默认全部
示例值:ALL |
| 参数 | 中文名 | 定义 | 长度 | 必填 | 说明 |
| :---------------- | :------------------- | :----- | :--- | :------- | :----------------------------------------------------------- |
| switch_state | 功能开关 | String | 1 | N | 1:开通 0:关闭 默认:1;示例值:1 |
| business_model | 大额支付业务模式 | String | 15 | Y | 大额支付业务模式 bank:银行模式 provisions:备付金模式;示例值:bank |
| fee_rate | 费率(%) | String | 6 | C | 开通大额业务时必须填写一种收费方式;大于0,保留2位小数;示例值:1.00 |
| fee_fix_amt | 交易手续费(固定/元) | String | 9 | C | 开通大额业务时必须填写一种收费方式;大于0,保留2位小数;示例值:10.00 |
| biz_type | 大额调账标识申请类型 | String | 2 | N | 01-四要素,05-三要素;[订单匹配的要素信息](https://paas.huifu.com/open/doc/api/#/dejy/api_dejy_ddppys);示例值:05 |
| mer_same_card_recharge_flag | 是否允许绑卡支付 | String | 1 | N | Y-开通/N-关闭,备付金模式时,支持传入;备付金模式银行卡绑定支付权限;示例值:Y |
| allow_user_deposit_flag | 是否允许用户入账 | String | 1 | N | Y-开通/N-关闭 ;默认为N;示例值:Y |
| provisions_auto_refund_flag | 备付金固定账号模式自动退款 | String | 1 | N | Y-开通/N-关闭 ;示例值:Y;该配置仅在开通大额支付备付金绑卡模式时生效 |
| 参数 | 中文名 | 定义 | 长度 | 必填 | 说明 |
| :---------------- | :------------------- | :----- | :--- | :------- | :----------------------------------------------------------- |
| agent_recheck_flag | 代发复核开关 | String | 1 | N | Y:是 N:否(为空默认未开通) ;示例值:Y |
| agent_recheck_huifu_id | 复核授权商户号 | String | 18 | N | 复核授权商户号只能填当前商户主体或总部商户号 |
| agent_recheck_type | 复核类型 | String | 1 | N | A:复核 B:短信验证 |
| 参数 | 中文名 | 定义 | 长度 | 必填 | 说明 |
| :---------------- | :------------------- | :----- | :--- | :------- | :----------------------------------------------------------- |
| acct_type | 账户类型 | String | 1 | Y | 2:银行账户 |
| open_flag | 开通状态 | String | 1 | Y | Y:开 N:关 |
| bank_name | 银行名称 | String | 8 | Y | PINGAN-平安银行 BOC-中国银行;示例值:PINGAN |
| jxf_bank_info | 银行账户信息 | String | | C | 当账户类型为银行账户时必填 |
| jxf_fee_info | 手续费信息 | String | | N | jsonObject字符串 |
| pay_confirm_flag | 付款确认标识 | String | 1 | N | Y:是 N:否 ;示例值:Y |
| pay_confirm_req_url | 付款确认请求URL | String | 256 | C | 付款确认标识为Y时,该字段必填 |
| 参数 | 中文名 | 定义 | 长度 | 必填 | 说明 |
| :---------------- | :------------------- | :----- | :--- | :------- | :----------------------------------------------------------- |
| user_name | 操作人姓名 | String | 16 | C | 银行名称非平安银行时,需填写;示例:张三 |
| operator_phone | 操作人手机号 | String | 11 | C | 银行名称非平安银行时,需填写;示例:13333333333 |
| acct_type | 付款方账户类型 | String | 2 | N | 00:单位结算卡,不填默认单位结算卡 |
| acct_no | 付款方账号 | String | 50 | Y | 示例:6212149999831234577 |
| acct_name | 付款方账户名称 | String | 25 | Y | 示例:上海汇付支付有限公司 |
| bank_branch_code | 开户行联行号 | String | 50 | Y | 示例:991290000099 |
| bank_branch_name | 开户行行名 | String | 25 | Y | 示例:中国银行 |
| sign_start_date | 签约申请生效日期 | String | 8 | C | 银行名称非平安银行时,需填写;示例:20251219 |
| sign_end_date | 签约申请失效日期 | String | 8 | C | 银行名称非平安银行时,需填写;示例:20261219 |
| remark | 附言 | String | 128 | N | 示例:附言 |
| org_code | 机构编码 | String | 64 | Y | 示例:12133 |
| 参数 | 中文名 | 定义 | 长度 | 必填 | 说明 |
| :---------------- | :------------------- | :----- | :--- | :------- | :----------------------------------------------------------- |
| open_card_fix_fee | 虚拟卡开卡手续费(元) | String | 11 | N | 单位元,支持小数点后两位;示例值:1.00 虚拟卡开卡手续费收取方式为发放数量*固定手续费 |
| quota_issue_fee_rate | 虚拟卡额度发放手续费(%) | String | 6 | N | 百分比,支持两位小数;示例值:1.00 虚拟卡发放额度手续费收取方式为交易金额*费率手续费 |
| out_fee_flag | 捷行付手续费内外扣标记 | String | 1 | N | 捷行付手续费只支持外扣;1:外扣;示例值:1 |
| out_fee_huifuid | 捷行付手续费外扣汇付ID | String | 18 | C | 捷行付设置手续费时必填;示例值:6666000108854952 |
| out_fee_acct_type | 捷行付手续费扣款账户类型 | String | 2 | C | 捷行付手续费外扣时必填;01-基本户(默认),05-充值户;示例值:01 |
| 参数 | 中文名 | 定义 | 长度 | 必填 | 说明 |
| :---------------- | :------------------- | :----- | :--- | :------- | :----------------------------------------------------------- |
| merge_pay_flag | 合单支付开关 | String | | Y | 合单支付开关 Y:开通 N:关闭 |
| merge_pay_config | 合单支付配置 | String | | C | 合单支付配置 (当合单支付开关为开时必填) |
| 参数 | 中文名 | 定义 | 长度 | 必填 | 说明 |
| :---------------- | :------------------- | :----- | :--- | :------- | :----------------------------------------------------------- |
| merge_pay_mode | 合单支付模式 | String | | Y | 1:电商 2:加油站 3:停车场 4:物业 5:休闲娱乐(不同模式需上传不同材料信息,调用图片上传接口;若选择电商,需上传文件F673《电商平台商家入驻协议》、F674《商家入驻截图》,以及填写线上业务类型编码及运营媒介字段信息;若选择加油站,需上传文件F676《加油站与任一合单参与方合作协议》、F675《任一合单参与方经营照片》;若选择停车场,需上传文件F677《停车场与任一合单参与方合作协议》、F675《任一合单参与方经营照片》;若选择物业需上传文件F678《物业与任一合单参与方合作协议》、F675《任一合单参与方经营照片》;若选择休闲娱乐需上传文件F679《休娱与任一合单参与方合作协议》、F675《任一合单参与方经营照片》) |
| 参数 | 中文名 | 定义 | 长度 | 必填 | 说明 |
| :---------------- | :------------------- | :----- | :--- | :------- | :----------------------------------------------------------- |
| fee_rate | 手续费(%) | String | | Y | 数字格式,大于等于0,保留2位小数;示例值:0.38 |
| fee_min_amt | 最低收取手续费(元) | String | | N | 金额保留2位小数;大于0。需要渠道商开通此功能。示例值:0.38 |
| out_fee_flag | 是否交易手续费外扣 | String | | N | 1:外扣 2:内扣(默认2内扣),示例值:1
|
| out_fee_huifuid | 交易手续费外扣汇付ID | String | | N | 开通抖音支付手续费外扣业务时必填,示例值:6666000123123123 |
| out_fee_acct_type | 交易手续费外扣时的账户类型 | String | | N | 01-基本户(不填默认01),02-现金户,05-充值户,09-营销户,示例值:01 |
#### 请求示例
```json
{
"sys_id":"ssproxy_dev",
"data":{
"req_seq_id":"2022042213314053740test001",
"req_date":"20220422",
"huifu_id":"6666000103668046",
"delay_flag":"Y",
"out_fee_flag":"2",
"out_fee_huifuid":"",
"out_fee_acct_type":"",
"async_return_url":"http://callback.example.com/sspm/testVirgo",
"busi_async_return_url":"",
"ali_conf_list":"[{\"pay_scene\":\"1\",\"fee_rate\":\"3.15\",\"mcc\":\"2016062900190337\",\"pay_channel_id\":\"10000001\",\"indirect_level\":\"\"}]",
"wx_conf_list":"[{\"service_codes\":\"\",\"pay_scene\":\"10\",\"fee_rate\":\"2.15\",\"mcc\":\"5943\",\"pay_channel_id\":\"JP00001\",\"fee_rule_id\":\"765\"}]",
"union_conf_list":"[{\"charge_cate_code\":\"\",\"debit_fee_rate_up\":\"6\",\"debit_fee_limit_up\":\"641\",\"credit_fee_rate_up\":\"6.566\",\"debit_fee_rate_down\":\"2.55\",\"debit_fee_limit_down\":\"11.3\",\"credit_fee_rate_down\":\"1\"}]",
"bank_card_conf":{
"charge_cate_code":"02",
"debit_fee_rate":"3",
"debit_fee_limit":"5",
"credit_fee_rate":"6",
"cloud_debit_fee_rate_up":"7",
"cloud_debit_fee_limit_up":"8.922",
"cloud_credit_fee_rate_up":"4.86",
"cloud_debit_fee_rate_down":"0",
"cloud_debit_fee_limit_down":"10",
"cloud_credit_fee_rate_down":"2",
"is_open_small_flag":"0",
"small_free_amt":"500",
"small_fee_amt":"1"
},
"quick_flag":"",
"withhold_flag":"",
"online_flag":"",
"short_name":"",
"agreement_info":{
"agreement_type":"0",
"agreement_no":"202106070100000380",
"agreement_model":"202106070100000380",
"agreement_name":"电子协议签约模板",
"sign_date":"20200325",
"agree_begin_date":"20200325",
"agree_end_date":"20400325"
},
"alipay_pre_auth_flag":"Y",
"balance_pay_config":{
"switch_state":"1",
"fee_rate":"2",
"fee_fix_amt":"1"
},
"combine_pay_config":{
"switch_state":"0",
"fee_rate":"10",
"fee_fix_amt":"5"
},
"recon_resp_addr":"http://callback.example.com/sspm/testVirgo"
},
"sign":"jtu0LvjqGknAoccmVHs1h9ZDcehwpW9zb9m3y2jeMBRjFlqtAh1ftAKCOiLuPMHttQTuodPf05GROrYcOCg2SZrvRaFztyNZErfYl2LFi/OOX3VVFHAh9rTWtUs61zrOF6MVt1em18WrnfXVSN0oFXMQRmt4q8IGJgs3d5Hmwi8=",
"product_id":"ZDTEST"
}
```
### 返回参数
#### 同步返回
| 参数 | 中文名 | 定义
| 长度
| 必填 | 说明 |
| :----------------------- | :--------------------- | :----- | :--- | :------- | :---------- |
| resp_code | 返回码 | String | 8 | Y | [业务返回码](https://paas.huifu.com/open/doc/api/#/csfl/api_csfl_ywm#商户进件返回码) |
| resp_desc | 返回描述 | String | 512 | Y | [业务返回描述](https://paas.huifu.com/open/doc/api/#/csfl/api_csfl_ywm#商户进件返回码) |
| huifu_id | 商户号 | String | 18 | N | 汇付分配的商户号,示例值:6666000105215341 |
| apply_no | 申请单号 | String | 18 | N | 审核中时有值,汇付返回商户的业务申请单号;示例值:202209120038432 |
#### 异步返回
**异步公共返回参数**
| 参数 | 中文名 | 类型 | 长度
| 必填 | 说明 |
| :-------- | :----------- | :----- | :------- | :--- | :------------------- |
| resp_code | 网关返回码 | String | 6 | Y | [网关返回码](https://paas.huifu.com/open/doc/api/#/csfl/api_csfl_ywm#网关返回码) |
| resp_desc | 网关返回描述 | String | 512 | Y | [网关返回描述](https://paas.huifu.com/open/doc/api/#/csfl/api_csfl_ywm#网关返回码) |
| sign | 签名 | String | | Y | 签名,对报文整体签名 |
| data | 业务返回参数 | String | | N | JSON |
**data**
申请单审核异步:申请单审核通过后,往async _ return_url地址推送审核结果。
| 参数 | 中文名 | 类型 | 长度
| 必填 | 说明 |
| :------------ | :----------- | :----- | :------- | :--- | :---------------------------------- |
| sub_resp_code | 业务返回码 | String | 8 | Y | [业务返回码](https://paas.huifu.com/open/doc/api/#/csfl/api_csfl_ywm#商户进件返回码) |
| sub_resp_desc | 业务返回描述 | String | 512 | Y | [业务返回描述](https://paas.huifu.com/open/doc/api/#/csfl/api_csfl_ywm#商户进件返回码) |
| req_seq_id | 请求流水号 | String | 32 | Y | 原样返回请求参数的请求流水号;示例值:2022012614120615001|
| req_date | 请求时间 | String | 8 | Y |原请求时间yyyyMMdd;示例值:20220912|
| audit_status | 审核结果 | String | 1 | Y | Y:审核通过 N:审核拒绝 F:失败 C:拒签;示例值:Y |
| audit_desc | 审核描述 | String | 512 | N | 审核结果描述 |
| product_id | 产品编号 | String | 32 | Y | 汇付分配的产品号,示例值:YYZY |
| huifu_id | 汇付客户号 | String | 18 | Y | 汇付分配的商户号,示例值:6666000105215341 |
| apply_no | 申请单号 | String | 18 | N | 汇付返回商户的业务申请单号;示例值:202209120038432 |
业务开通结果异步:申请单审核通过,各支付业务开通完成之后,往busi_async_return_url地址推送业务开通结果。按每个业务(notify_type:W:微信 A:支付宝 U:银联二维码 B:刷卡 E:全域资金管理 J:大额转账备付金模式,I:大额转账银行模式)推送给调用方一条。
| 参数 | 中文名 | 定义
| 长度
| 必填 | 说明 |
| :----------------------- | :--------------------- | :----- | :--- | :------- | :---------- |
| sub_resp_code | 业务返回码 | String | 8 | Y | 业务返回码 |
| sub_resp_desc | 业务返回描述 | String | 512 | Y | 业务返回描述 |
| req_seq_id | 请求流水号 | String | 32 | Y | 原请求流水号;示例值:2022012614120615001 |
| req_date | 请求时间 | String | 8 | Y | 原请求时间yyyyMMdd;示例值:20220912 |
| product_id | 产品编号 | String | 32 | Y | 汇付分配的产品号,示例值:YYZY |
| huifu_id | 汇付客户号 | String | 18 | Y | 汇付分配的商户号,示例值:6666000105215341 |
| apply_no | 申请单号 | String | 18 | N | 汇付返回商户的业务申请单号;示例值:202209120038432 |
| notify_type | 通知类型 | String | 1 | Y | W:微信 A:支付宝,Y:抖音,U:银联二维码,B:刷卡 E:全域资金管理,J:大额转账备付金模式,I:大额转账银行模式示例值:W |
| reg_result_list | 入驻结果集合 | String | | N | josnArray格式;notify_type等于A或者W时,此集合可能有多条数据 |
| ord_id | 通知流水号 | String | 44 | N | 回调方返回应答,应答内容为:”RECV_ORD_ID_”+该ordId |
| zl_async_info | 直连结果合集 | String | 512 | N | 直连微信/支付宝结果合集 |
| 参数 | 中文名 | 定义 | 长度 | 必填 | 说明 |
| :---------------- | :------------------- | :----- | :--- | :------- | :----------------------------------------------------------- |
| pay_scene | 费率类型 | String | 2 | N | 请求参数pay_scene;当notify_type是W/A时返回;参见《[微信支付场景](https://paas.huifu.com/open/doc/api/#/api_ggcsbm?id=%e5%be%ae%e4%bf%a1%e6%94%af%e4%bb%98%e5%9c%ba%e6%99%af)》说明;示例值:1 |
| business_stat | 业务开通状态 | String | 1 | Y | S-成功,F-失败;当notify_type是W/A/E时返回;示例值:S |
| business_desc | 业务开通描述 | String | 200 | N | 当notify_type是W/A/E时返回 |
| sub_mer_id | 二级商户号 | String | 32 | N | 微信/支付宝二级商户号;当notify_type是W/A时返回;示例值:A1035134718828858326 |
| bank_channel_no | 渠道号 | String | 50 | N | 当notify_type是W/A时返回;示例值:JP00001 |
| bank_mer_code | 真实商户号 | String | 20 | N | 当notify_type是W/A时返回;示例值:2088431912900000 |
| electron_bank_name | 电子账户开户行 | String | 32 | N | 全域资金管理电子账户开户行, 当notify_type是E时返回;示例值:武汉众邦银行股份有限公司; |
| electron_account | 电子账号 | String | 32 | N | 全域资金管理电子账号, 当notify_type是E时返回;示例值:2088431912900000 |
| real_name_applyment_stat | 实名认证状态 | String | 64 | N | W:微信 A:支付宝 申请实名时返回
A:支付宝对应值
审核中(AUDITING)
待联系人确认(CONTACT_CONFIRM)
待法人确认(LEGAL_CONFIRM)
审核通过(AUDIT_PASS)
审核失败(AUDIT_REJECT)
已冻结(AUDIT_FREEZE)
已撤回(CANCELED)
未申请(NOT_APPLY)
W:微信对应值
APPLYMENT_STATE_EDITTING--【编辑中】--可能在提交申请时发生错误导致,可用同一个业务申请编号重新提交
APPLYMENT_STATE_WAITTING_FOR_AUDIT--【审核中】--请耐心等待1~2个工作日,微信支付将会完成审核
APPLYMENT_STATE_WAITTING_FOR_CONFIRM_CONTACT--【待确认联系信息】--请扫描微信支付返回的小程序码确认联系信息(此过程可修改超级管理员手机号)
APPLYMENT_STATE_WAITTING_FOR_CONFIRM_LEGALPERSON--【待账户验证】--请扫描微信支付返回的小程序码在小程序端完成账户验证
APPLYMENT_STATE_PASSED--【审核通过】--请扫描微信支付返回的小程序码在小程序端完成授权流程
APPLYMENT_STATE_REJECTED--【审核驳回】--请按照驳回原因修改申请资料,并更换业务申请编码,重新提交申请
APPLYMENT_STATE_FREEZED--【已冻结】--可能是该主体已完成过入驻,请查看驳回原因,并通知驳回原因中指定的联系人扫描微信支付返回的小程序码在小程序端完成授权流程
APPLYMENT_STATE_CANCELED--【已作废】--表示申请单已被撤销,无需再对其进行操作
APPLYMENT_STATE_NOAPPLY--未申请
示例值:AUDITING |
| real_name_applyment_desc | 实名认证描述 | String | 128 | N | W:微信 A:支付宝 申请实名时返回;示例值:W |
| qrcode_data | 授权二维码 | String | 512 | N | W:微信 A:支付宝 申请实名时返回
若notify_type=W时 且 实名认证状态 real_name_applyment_stat=
APPLYMENT_STATE_WAITTING_FOR_CONFIRM_CONTACT、
APPLYMENT_STATE_WAITTING_FOR_CONFIRM_LEGALPERSON、
APPLYMENT_STATE_PASSED、
APPLYMENT_STATE_FREEZED时返回
若notify_type=A时 且 实名认证状态 real_name_applyment_stat=
CONTACT_CONFIRM、LEGAL_CONFIRM时返回;示例值:https://qr.alipay.com/bax02911brluc2xieoph6001 |
| agreement_link | 协议签署连接 | String | 1024 | N | 申请实名且签署电子协议时返回;示例值: |
| agreement_id | 协议编号 | String | 64 | N | 申请实名且签署电子协议时返回;示例值: |
| agreement_name | 协议名称 | String | 256 | N | 申请实名且签署电子协议时返回;示例值: |
| 参数 | 中文名 | 定义 | 长度 | 必填 | 说明 |
| :---------------- | :------------------- | :----- | :--- | :------- | :----------------------------------------------------------- |
| confirm_url | 签约链接 | String | 256 | N | 示例值:https://www.huifu.com |
| mer_app_id | 应用ID | String | 32 | N | 示例值:wx51aa91a575359ff5 |
| reject_reason | 拒绝原因 | String | 128 | N | 示例值:支付功能未开通 |
| sub_mch_id | 支付宝/微信商户号 | String | 32 | N | 示例值:1632157057 |
| apply_type | 申请类型 | String | 32 | N | 示例值:FACE_TO_FACE |
| apply_state | 申请单状态 | String | 1 | N | S:审核通过,P:审核中,N:审核拒绝,F:系统处理失败;
新增状态枚举:C:待签约 |
#### 电子协议签署链接异步通知
| 参数 | 中文名 | 定义
| 长度
| 必填 | 说明 |
| :----------------------- | :--------------------- | :----- | :--- | :------- | :---------- |
| sub_resp_code | 业务返回码 | String | 8 | Y | |
| sub_resp_desc | 业务返回描述 | String | 512 | N | |
| req_seq_id | 请求流水号 | String | 32 | Y | |
| req_date | 请求日期 | String | 8 | Y | |
| huifu_id | 商户号 | String | 18 | Y | |
| apply_no | 申请单号 | String | 18 | Y | |
| agreement_info_list | 协议信息 | String | | N | 签署电子协议时返回 |
| 参数 | 中文名 | 定义 | 长度 | 必填 | 说明 |
| :---------------- | :------------------- | :----- | :--- | :------- | :----------------------------------------------------------- |
| agreement_type | 协议类型 | String | 1 | N | 0-电子协议 |
| agreement_link | 协议签署链接 | String | 512 | N | |
| agreement_no | 协议号 | String | 32 | N | 示例值:3245234 |
| agreement_name | 协议名称 | String | 128 | N | |
| con_stat | 合同状态 | String | 2 | N | 电子协议类型会返回以下值: 2:创建合同异常 3:待签约 4:签约中 5:签约完成(电子协议只有签约完成才能做交易) 6:已失效 7:已拒签 8:签约失败 示例值:5 |
##### 返回示例
###### 成功示例
```json
{
"data":{
"apply_no":"2022042201091802",
"huifu_id":"6666000103668046",
"product_id":"ZDTEST",
"req_date":"20220422",
"req_seq_id":"2022042213314053740test001",
"resp_code":"00000000",
"resp_desc":"成功"
},
"sign":"W94y5imRC0YBKMkjDC6E7AD4AAzQwCRU9TsGiFDFmqSJqKoEnoHwMop67aZ++LsRMcBTay4JSnaRNdTbYuFcIfZV+6vXOjjw8D2tVg/VpBEEekobUWP0TFCpIV0+yc1sCkSRM/79iIRtkvQN9jYb9pDA9u1zEMzasqfwxf5a3Fs="
}
```