Appearance

商盟进件请求示例 ​

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

商盟进件个人请求示例

参数参数名称类型(长度)是否必须描述
role指定入驻渠道身份Int是0：不特别指定；3：指定身份为入驻商；4：指定身份为分账接收方
mch_id鸿闻分配的服务商编码String(14)是
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；长期有效的身份证请传汉字“长期”
notify_url进件通知地址String(255)是
request_no请求号String(50)是请保证在服务商编码下的唯一性
subjectInfo主体资料Object是
-- type入网类型Int是3：个体类型
-- shortName商户简称String(20)是
businessInfo经营信息Object是
-- businessProvince经营地址省编码String是
-- businessCity经营地址市编码String是
-- businessDistrict经营地址地区编码String是
-- businessAddress经营地址String(50)是
settlementInfo结算账户信息Object是
-- settlementBankCardNo结算卡卡号String是
-- settlementOpenBankNo结算卡总行行号String是
-- settlementBankAccountType结算账户类型String(1)是1:对私卡结算 3:对公卡结算
-- settlementOpenAccountName结算卡户名String(50)是
settlement_type资金结算方向Int是1：到银行卡 2：到资金账户
institution_type指定入驻渠道Int是23：指定入住商盟
json
{
  "role": "4",
  "sign": "ib2nkCVJrtRreYBITYR/cnEwxQNQrSAQDGET39sAS55gCov83hxCsNST1DFd0QPgawJ/xs7iGEU7hlNKWK68lJGXE7BeBPmwiBAqSdqGR/qoEB/xIqF8kEmVqghhnUnM0jtS8IruJ9vGCPD3PhLKRkkBeBMOzejoRNhnS1X/1ASaBwtFERuYrcMZCg4/3JYxLio2FTf42YWemkOSitmhDDJBOcWF6rTF/2glgODJFhltrveSxYdiF90Wi2dtabv/8TWuNmDBOA6Qf3tR5j3f85h94h6FfOApNRfXkYPpr18+nusn+xmoqho4+B7eQRDFGUBPtExJaKcRse7qaUB3TA==",
  "mch_id": "22553110493554",
  "method": "register",
  "legalInfo": {
    "legalName": "李伟伟",
    "legalPhone": "15510902173",
    "legalLicenceNo": "372930199108276716",
    "legalLicenceType": 1,
    "legalLicenceEndTime": "2042-07-08",
    "legalLicenceStartTime": "2022-07-08",
    "legalLicenceBackFileId": "24111141516892",
    "legalLicenceFrontFileId": "24111163916891"
  },
  "notify_url": "http://pay.kaiyuanxx.cn/pay/notify.HwShangMeng/openaccount.html",
  "request_no": "20241111172132P1jHs5",
  "subjectInfo": {
    "type": 3,
    "shortName": "李伟伟"
  },
  "businessInfo": {
    "businessCity": "130200",
    "businessAddress": "131002000000",
    "businessDistrict": "130205",
    "businessProvince": "130000"
  },
  "settlementInfo": {
    "settlementBankCardNo": "6217000066014935501",
    "settlementOpenBankNo": "CCB",
    "settlementBankAccountType": 1,
    "settlementOpenAccountName": "李伟伟"
  },
  "settlement_type": "1",
  "institution_type": "23"
}

商盟进件企业请求示例

参数参数名称类型(长度)是否必须描述
mch_id鸿闻分配的服务商编码String(14)是
request_no请求号String(50)是请保证在服务商编码下的唯一性
notify_url进件通知地址String(255)是
institution_type指定入驻渠道Int是23：指定入住商盟
role指定入驻渠道身份Int是0：不特别指定；3：指定身份为入驻商；4：指定身份为分账接收方
settlement_type资金结算方向Int是1：到银行卡 2：到资金账户
settlement_way资金结算方式String(20)是
不传参默认使用D1；
D1：D1自动结算；
D1_MANUAL：D1自助结算；
subjectInfo主体资料Object是
-- type入网类型Int是 2：企业类型
-- shortName商户简称String(20)是
contactInfo联系人信息Object是企业类型为必填
-- contactName联系人姓名String是企业类型为必填
-- contactLicenceNo联系人身份证号码String是
-- contactMobile联系人手机号码String(11)是企业类型为必填
-- contactEmail联系人邮箱String(50)是企业类型为必填
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是
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是
-- settlementBankCardNo结算卡卡号String是
merchantCorporationInfo营业执照资料Object是企业/个体户类型为必填
-- businessLicenceFileId营业执照文件编码String是
-- businessLicenceNo营业执照编号String是
-- businessLicenceName营业执照名称String是
-- businessLicenceAddress营业执照注册地址String是
-- businessLicenceStartTime营业执照开始时间String(8)是形如：20201130
-- businessLicenceEndTime营业执照截至时间String(8)是形如：20201130，长期有效的营业执照请传汉字“长期”
json
{
  "mch_id": "22553110493554",
  "request_no": "20243434344331111122",
  "notify_url": "https://www.baidu.com",
  "institution_type": "23",
  "role": 4,
  "settlement_type": 2,
  "settlement_way": "D1_MANUAL",
  "subjectInfo": {
    "type": "2",
    "shortName": "测试"
  },
  "contactInfo": {
    "contactName": "李四",
    "contactLicenceNo": "123456",
    "contactMobile": "135486554654",
    "contactEmail": "1234@qq.com"
  },
  "legalInfo": {
    "legalName": "甘代清",
    "legalPhone": "13545111123",
    "legalLicenceType": 1,
    "legalLicenceNo": "350922199005020018",
    "legalLicenceFrontFileId": "24111104029726",
    "legalLicenceBackFileId": "24111101629435",
    "legalLicenceStartTime": "20250311",
    "legalLicenceEndTime": "20991231"
  },
  "industryInfo": {
    "industryPrimaryCategory": "建筑",
    "industrySecondaryCategory": "工地"
  },
  "businessInfo": {
    "businessProvince": "湖北省",
    "businessCity": "武汉市",
    "businessDistrict": "江汉区",
    "businessAddress": "建达路一号",
    "businessShopHeadFileId": "23101060907610",
    "businessShopInteriorFileId": "23101060907610",
    "businessShopCashDeskFileId": "23101060907610"
  },
  "settlementInfo": {
    "settlementBankAccountType": "3",
    "settlementBankCardFrontFileId": "23101060907610",
    "settlementOpenAccountLicenceFileId": "23101060907610",
    "settlementOpenAccountName": "张三",
    "settlementOpenBankNo": "45564545",
    "settlementBankCardNo": "132242343"
  },
  "merchantCorporationInfo": {
    "businessLicenceFileId": "24111115429728",
    "businessLicenceNo": "91469027MA5T29RP4J",
    "businessLicenceName": "海南奥科网络科技有限公司",
    "businessLicenceAddress": "武汉东湖新技术开发区雄楚大道888号金地·雄楚1号一期商2栋8层13室-2",
    "businessLicenceStartTime": "20201120",
    "businessLicenceEndTime": "20991231"
  },
  "sign": "adfd"
}

返回字段说明

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