资料提交接口

提交进件所需资料，成功会返回资料号
正式地址：https://reg.merchant.hwkjpay.com/api/reg_merchant/base/register

公共参数

参数	参数名称	类型(长度)	是否必须	描述
mch_id	鸿闻分配的服务商编码	String(14)	是
request_no	请求号	String(50)	是	请保证在服务商编码下的唯一性
notify_url	进件通知地址	String(255)	是
institution_type	指定入驻渠道	Int	是	0：不特别指定；2：指定入驻易宝
role	指定入驻渠道身份	Int	是	0：不特别指定；3：指定身份为入驻商；4：指定身份为分账接收方
saas_merchant_no	指定渠道服务商	String(50)	否	指定入驻机构的服务商号；目前易宝小微分账接收方进件接收该传参，获取参数提前联系鸿闻销售
plate_merchant_no	指定渠道平台商编	String(50)	否	指定入驻机构的服务商的平台商编；易宝小微分账接收方接收该传参，获取参数提前联系鸿闻销售
settlement_type	资金结算方向	Int	是	1：到银行卡 2：到资金账户
settlement_way	资金结算方式	String(20)	否	不传参默认使用D1； D1：D1自动结算； D1_MANUAL：D1自助结算；
subjectInfo	主体资料	Object	是
-- type	入网类型	Int	是	1：个体类型 2：企业类型 3：小微类型
-- shortName	商户简称	String（20）	是
legalInfo	法人资料	Object	是
-- legalName	法人姓名	String(20)	是
-- legalPhone	法人手机号码	String(11)	是
-- legalLicenceType	法人证件类型	Int	是	1：身份证类型
-- legalLicenceNo	身份证号码	String(18)	是
-- legalLicenceFrontFileId	身份证正面文件编码	String(20)	是
-- legalLicenceBackFileId	身份证背面文件编码	String(20)	是
-- legalLicenceStartTime	身份证开始时间	String(8)	否	格式形如20161019
-- legalLicenceEndTime	身份证过期时间	String(8)	否	格式形如20261019；长期有效的身份证请传汉字“长期”
industryInfo	行业类别	Object	否
-- industryPrimaryCategory	行业类别一级编码	String	否
-- industrySecondaryCategory	行业类别二级编码	String	否
contactInfo	联系人信息	Object	否	企业/个体户类型为必填
-- contactName	联系人姓名	String	否	企业/个体户类型为必填
-- contactLicenceNo	联系人身份证号码	String	否
-- contactMobile	联系人手机号码	String(11)	否	企业/个体户类型为必填
-- contactEmail	联系人邮箱	String(50)	否	企业/个体户类型为必填
businessInfo	经营信息	Object	是
-- businessProvince	经营地址省编码	String	是
-- businessCity	经营地址市编码	String	是
-- businessDistrict	经营地址地区编码	String	是
-- businessAddress	经营地址	String(50)	是
-- businessShopHeadFileId	门头照文件编码	String(20)	否
-- businessShopInteriorFileId	内设照文件编码	String(20)	否
-- businessShopCashDeskFileId	收银台照文件编码	String(20)	否
settlementInfo	结算账户信息	Object	是
-- settlementBankAccountType	结算账户类型	String(1)	是	1:对私卡结算 3:对公卡结算
-- settlementBankCardFrontFileId	结算卡正面文件编号	String	否
-- settlementOpenAccountLicenceFileId	开户许可证文件编号	String	否
-- settlementOpenAccountName	结算卡户名	String(50)	否
-- settlementOpenBankNo	结算卡总行行号	String	是
-- settlementOpenBranchBankNo	结算卡支行行号	String	否
-- settlementBankCardNo	结算卡卡号	String	是
-- settlementOpenBankProvince	结算卡开户行支行省编码	String	否
-- settlementOpenBankCity	结算卡开户行支行市编码	String	否
-- settlementOpenBankDistrict	结算卡开户行支行县区编码	String	否
-- reserveAcntNo	双账户对公卡号	String	否	企业对私结算必须传双账户一套资料；
-- reserveAcntNm	双账户对公户名	String	否
-- reserveBankType	双账户对公卡总行行号	String	否
-- reserveInterBankNo	双账户对公卡支行行号	String	否
-- reserveIssBankNm	双账户对公卡支行全称	String	否
merchantCorporationInfo	营业执照资料	Object	否	企业/个体户类型为必填
-- businessLicenceFileId	营业执照文件编码	String	否
-- businessLicenceNo	营业执照编号	String	否
-- businessLicenceName	营业执照名称	String	否
-- businessLicenceAddress	营业执照注册地址	String	否
-- businessLicenceStartTime	营业执照开始时间	String(8)	否	形如：20201130
-- businessLicenceEndTime	营业执照截至时间	String(8)	否	形如：20201130，长期有效的营业执照请传汉字“长期”

json

{
  "sign": "签名string",
  "mch_id": "21170041825333",
  "notify_url": "http://aaa.com",
  "request_no": "2117004182533306",
  "institution_type": "2",
  "role": "4",
  "subjectInfo": {
    "type": 3,
    "shortName": "武汉"
  },
  "legalInfo": {
    "legalName": "张家文",
    "legalPhone": "15800000000",
    "legalLicenceType": 1,
    "legalLicenceNo": "42****78",
    "legalLicenceFrontFileId": "23100830337133",
    "legalLicenceBackFileId": "23100835238520",
    "legalLicenceStartTime": "20161019"
  },
  "businessInfo": {
    "businessProvince": "130000000000",
    "businessCity": "130200000000",
    "businessDistrict": "130204000000",
    "businessAddress": "string"
  },
  "settlementInfo": {
    "settlementBankAccountType": 1,
    "settlementBankCardNo": "622****995",
    "settlementBankCardFrontFileId": "23100861048471",
    "settlementOpenBankNo": "314"
  }
}

返回字段说明

参数	参数名称	类型(长度)	描述
code	返回码	String	200 表示成功，其他返回码请参照错误提示调试
message	返回文字说明	String
data	返回数据	Object
-- register_id	成功进件资料号	String

json

{
  "code": 200,
  "message": "success",
  "data": {
    "register_id": "552422658604533201"
  }
}

资料提交接口 ​

资料提交接口