银联小微/执照商户注册认证

简介:银联小微/执照商户注册认证

HOST:

联系人: zhangyl

Version:0.0.1

[TOC]

小微商户注册

接口地址:/channel-app/api/merchant/unionMicroCreate

请求方式:POST

请求数据类型:application/json

响应数据类型:*/*

接口描述:

小微商户注册

请求示例:

{
  "param": {
    "merchantNo": "100000000000064",
    "businessName": "爱出者爱返经营名称",
    "mcc": "5814",
    "longitude": "117.397128",
    "latitude": "40.916527",
    "domain32": "1000",
    "licensePhoUrl": "202405081122360421",
    "doorHeaderPhoUrl": "202405081122360353",
    "checkOutPhoUrl": "202405140950064825",
    "premisesPhoUrl": "202404160936571187",
    "registeredProvinceName": "北京",
    "registeredCityName": "北京市",
    "registeredAreaName": "朝阳区",
    "registeredProvinceCode": "110000",
    "registeredCityCode": "110100",
    "registeredAreaCode": "110105",
    "registeredStreet": "阜通东大街",
    "businessProvinceName": "天津",
    "businessCityName": "天津市",
    "businessAreaName": "津南区",
    "businessProvinceCode": "120000",
    "businessCityCode": "120100",
    "businessAreaCode": "120112",
    "businessStreet": "雅润路1号",
    "partnerId": "0123"
  }
}

请求参数:

参数名称	参数说明	是否必须	数据类型
merchantNo	商户编号(18位)	true	string
businessName	商户经营名称	true	string
mcc	商户经营类目mcc	true	string
longitude	经度	true	string
latitude	纬度	true	string
domain32	经营地址银联32域	true	string
licensePhoUrl	营业执照url	false	string
doorHeaderPhoUrl	门头照url	true	string
checkOutPhoUrl	收银台照url	true	string
premisesPhoUrl	经营场所url	true	string
registeredProvinceName	商户注册地址-省名称	true	string
registeredCityName	商户注册地址-市名称	true	string
registeredAreaName	商户注册地址-区名称	true	string
registeredProvinceCode	商户注册地址-省编码	true	string
registeredCityCode	商户注册地址-市编码	true	string
registeredAreaCode	商户注册地址-区县编码	true	string
registeredStreet	商户注册地址-街道	true	string
businessProvinceName	商户经营地址-省名称	true	string
businessCityName	商户经营地址-市名称	true	string
businessAreaName	商户经营地址-区县名称	true	string
businessProvinceCode	商户经营地址-省编码	true	string
businessCityCode	商户经营地址-市编码	true	string
businessAreaCode	商户经营地址-区县编码	true	string
businessStreet	商户经营地址-街道	true	string
partnerId	合作机构注册商户id	false	string

响应状态:

状态码	说明
200	OK

响应参数:

参数名称	参数说明	类型
success	success:是否成功，true 成功	boolean

响应示例:

{
	"data": {
		"success": true
	}
}

小微商户变更申请

接口地址:/channel-app/api/merchant/unionMicroUpdate

请求方式:POST

请求数据类型:application/json

响应数据类型:*/*

接口描述:

小微商户变更申请

请求示例:

{
  "param": {
    "merchantNo": "100000000000064",
    "merNoOut": "83411375814ZZZZ",
    "businessName": "爱出者爱返商户经营名称u1",
    "mcc": "5814",
    "longitude": "117.397128",
    "latitude": "40.916527",
    "domain32": "1000",
    "licensePhoUrl": "202405140950064825",
    "doorHeaderPhoUrl": "202405140950064825",
    "checkOutPhoUrl": "202405140950064825",
    "premisesPhoUrl": "202405140950064825",
    "registeredProvinceName": "北京",
    "registeredCityName": "北京市",
    "registeredAreaName": "东城区",
    "registeredProvinceCode": "110000",
    "registeredCityCode": "110100",
    "registeredAreaCode": "110101",
    "registeredStreet": "阜通东大街",
    "businessProvinceName": "天津",
    "businessCityName": "天津市",
    "businessAreaName": "津南区",
    "businessProvinceCode": "120000",
    "businessCityCode": "120100",
    "businessAreaCode": "120112",
    "businessStreet": "雅润路21号"
  }
}

请求参数:

参数名称	参数说明	是否必须	数据类型
merchantNo	商户编号(18位)	true	string
merNoOut	报备编号	true	string
businessName	商户经营名称	true	string
mcc	商户经营类目mcc	true	string
longitude	经度	true	string
latitude	纬度	true	string
domain32	经营地址银联32域	true	string
licensePhoUrl	营业执照	false	string
doorHeaderPhoUrl	门头照	true	string
checkOutPhoUrl	收银台照	true	string
premisesPhoUrl	经营场所	true	string
registeredProvinceName	商户注册地址-省名称	true	string
registeredCityName	商户注册地址-市名称	true	string
registeredAreaName	商户注册地址-区名称	true	string
registeredProvinceCode	商户注册地址-省编码	true	string
registeredCityCode	商户注册地址-市编码	true	string
registeredAreaCode	商户注册地址-区县编码	true	string
registeredStreet	商户注册地址-街道	true	string
businessProvinceName	商户经营地址-省名称	true	string
businessCityName	商户经营地址-市名称	true	string
businessAreaName	商户经营地址-区县名称	true	string
businessProvinceCode	商户经营地址-省编码	true	string
businessCityCode	商户经营地址-市编码	true	string
businessAreaCode	商户经营地址-区县编码	true	string
businessStreet	商户经营地址-街道	true	string

响应状态:

状态码	说明
200	OK

响应参数:

参数名称	参数说明	类型
success	success:是否成功，true 成功	boolean

响应示例:

{
	"data": {
		"success": true
	}
}

执照商户注册/变更

接口地址:/channel-app/api/merchant/createStoreMer

请求方式:POST

请求数据类型:application/json

响应数据类型:*/*

接口描述:

执照商户注册/变更

请求示例:

{
  "param": {
    "operType": 2,
    "merchantNo": "100000000000064",
    "merName": "爱出者爱返门店1",
    "merReportType": "01",
    "industryType": "一般类",
    "merNoOut": "83411375814ZZZY",
    "provinceCode": "110000",
    "cityCode": "110100",
    "areaCode": "110101",
    "province": "北京",
    "city": "北京市",
    "area": "东城区",
    "addressDetail": "爱出者爱返门店详细地址",
    "mcc": "5814",
    "contactName": "爱出者",
    "contactPhone": "15401231111",
    "legalName": "爱返",
    "legalCardNo": "110105198709031103",
    "corpPhoneEncX": "15401231111",
    "businessProvinceName": "天津",
    "businessCityName": "天津市",
    "businessAreaName": "津南区",
    "businessProvinceCode": "120000",
    "businessCityCode": "120100",
    "businessAreaCode": "120112",
    "businessAddress": "雅润路21号",
    "longitude": "117.397128",
    "latitude": "40.916527",
    "partnerId": "0112",
    "businessName": "爱出者爱返门店经营名称1",
    "tradeLicenseNo": "15401231111001",
    "licenseValidStart": "2023-01-01",
    "licenseValidEnd": "2025-01-01",
    "idCardUrlFront": "202404160936571187",
    "idCardUrlBack": "202404160936571187",
    "businessScope": "",
    "idCardUrlHand": "202404160936571187",
    "idCardTermFrom": "2023-01-01",
    "idCardTermTo": "2025-01-01",
    "licensePhoUrl": "202405140950064825",
    "eleAgrPhoUrl": "202405140950064825",
    "doorHeaderPhoUrl": "202405140950064825",
    "checkOutPhoUrl": "202405140950064825",
    "premisesPhoUrl": "202405140950064825",
    "otherPhoUrlList": []
  }
}

请求参数:

参数名称	参数说明	是否必须	数据类型
operType	操作类型：1-新增，2-变更	true	integer(int32)
merchantNo	商户编号(18位) 变更不能为空	true	string
merName	商户法定名称	true	string
merReportType	01-个体，02-企业	true	string
industryType	行业大类	true	string
merNoOut	报备编号	false	string
provinceCode	所属地区省编码	true	string
cityCode	所属地区市编码	true	string
areaCode	所属地区区县编码	true	string
province	所属地区省名称	true	string
city	所属地市名称	true	string
area	所属地地区名称	true	string
addressDetail	所属地区详细	true	string
mcc	mcc	true	string
contactName	联系人姓名	true	string
contactPhone	联系人电话	true	string
legalName	法人姓名	true	string
legalCardNo	法人证件号	true	string
corpPhoneEncX	法人手机号	false	string
businessProvinceCode	经营地区省编码	true	string
businessCityCode	经营地区市编码	true	string
businessAreaCode	经营地区区县编码	true	string
businessProvinceName	经营地区省名称	true	string
businessCityName	经营地区市名称	true	string
businessAreaName	经营地区区县名称	true	string
businessAddress	经营地址	true	string
longitude	经度	true	string
latitude	纬度	true	string
partnerId	合作机构注册商户id	false	string
businessName	报备经营名称名称	true	string
tradeLicenseNo	营业执照编号	true	string
licenseValidStart	营业执照有效期起始时间格式 yyyy-MM-dd	true	string
licenseValidEnd	营业执照有效期结束时间格式 yyyy-MM-dd 长期传9999-12-31	true	string
idCardUrlFront	法人身份证正面	true	string
idCardUrlBack	法人身份证反面	true	string
businessScope	经营范围	false	string
idCardUrlHand	手持身份证图片	true	string
idCardTermFrom	法人身份证有效期起始格式 yyyy-MM-dd	true	string
idCardTermTo	法人身份证有效期截止格式 yyyy-MM-dd 长期传9999-12-31	true	string
licensePhoUrl	营业执照url	true	string
eleAgrPhoUrl	电子协议url	false	string
doorHeaderPhoUrl	门头照url	true	string
checkOutPhoUrl	收银台照url	true	string
premisesPhoUrl	经营场所照片url	true	string
otherPhoUrlList	其他资料集合	false	array

响应状态:

状态码	说明
200	OK

响应参数:

参数名称	参数说明	类型
success	success:是否成功，true 成功	boolean

响应示例:

{
	"data": {
		"success": true
	}
}

商户注册结果查询

接口地址:/channel-app/api/merchant/queryUnionMicroInfo

请求方式:POST

请求数据类型:application/json

响应数据类型:*/*

接口描述:

小微/执照商户注册结果查询

请求示例:

{
  "param": {
    "merchantNo": "100000000000096"
  }
}

请求参数:

参数名称	参数说明	是否必须	数据类型
merchantNo	商户编号(18位)	true	string

响应状态:

状态码	说明
200	OK

响应参数:

参数名称	参数说明	类型
merchantNo	merchantNo:商户编号(18位)	string
merName	商户法定名称	string
businessName	小微商户名称	string
merReportType	00-小微，01-企业	string
merNoOut	报备编号:报备编号	string
mcc	mcc:商户经营类目mcc	string
contactName	联系人姓名:联系人姓名	string
contactPhone	联系人电话:联系人电话	string
legalName	法人姓名:法人姓名	string
legalCardNo	法人证件号:法人证件号	string
corpPhoneEncX	法人手机号:法人手机号	string
reportStatus	报备状态:0-新增报备1-新增报备失败2-注销	string
reportFailReason	报备失败原因:报备失败原因	string
longitude	经度	string
latitude	纬度	string
domain32	银联32域	string
auditOpinion	审核意见:审核意见	string
licensePhoUrl	营业执照url:营业执照url	string
eleAgrPhoUrl	电子协议url:电子协议url	string
doorHeaderPhoUrl	门头照url:门头照url	string
checkOutPhoUrl	收银台照url:收银台照url	string
premisesPhoUrl	经营场所照片url:经营场所照片url	string
otherPhoUrlList	其他资料集合:其他资料url	array
registeredProvinceName	商户注册地址-省名称:商户注册地址-省名称	string
registeredCityName	商户注册地址-市名称:商户注册地址-市名称	string
registeredAreaName	商户注册地址-区名称:商户注册地址-区名称	string
registeredProvinceCode	商户注册地址-省编码:商户注册地址-省编码	string
registeredCityCode	商户注册地址-市编码:商户注册地址-市编码	string
registeredAreaCode	商户注册地址-区县编码:商户注册地址-区县编码	string
registeredStreet	商户注册地址-街道:商户注册地址-街道	string
businessProvinceName	商户经营地址-省名称:商户经营地址-省名称	string
businessCityName	商户经营地址-市名称:商户经营地址-市名称	string
businessAreaName	商户经营地址-区县名称:商户经营地址-区县名称	string
businessProvinceCode	商户经营地址-省编码:商户经营地址-省编码	string
businessCityCode	商户经营地址-市编码:商户经营地址-市编码	string
businessAreaCode	商户经营地址-区县编码:商户经营地址-区县编码	string
businessStreet	商户经营地址-街道:商户经营地址-街道	string
partnerId	合作机构注册商户id:合作机构注册商户id	string
tradeLicenseNo	营业执照编号:营业执照编号	string
industryType	行业大类	string
licenseValidStart	营业执照有效期起始时间:营业执照有效期起始时间	string(date)
licenseValidEnd	营业执照有效期结束时间:营业执照有效期结束时间	string(date)
idCardUrlFront	法人身份证正面:法人身份证正面	string
idCardUrlBack	法人身份证反面:法人身份证反面	string
businessScope	经营范围:经营范围	string
agreementStatus	电子协议状态：00-未完成，01-已完成:电子协议状态：00-未完成，01-已完成	string
idCardUrlHand	手持身份证图片:手持身份证图片	string
idCardTermFrom	法人身份证有效期起始:法人身份证有效期起始	string(date)
idCardTermTo	法人身份证有效期截止:法人身份证有效期截止	string(date)
accountNo	商户结算账号:商户结算账号	string
accountName	商户结算账户名称:商户结算账户名称	string
bankSettleNo	商户开户行行号:商户开户行行号	string
bankName	商户开户行名称:商户开户行名称	string
tusnList	tusn	array

响应参数 tusnList:

参数名称	参数说明	类型
sn	sn	string
createTime	报备时间	string

响应示例:

{
  "data": [{}]
}

查询商户变更状态

接口地址:/channel-app/api/merchant/queryMerchantUpdateInfo

请求方式:POST

请求数据类型:application/json

响应数据类型:*/*

接口描述:

查询商户变更状态

请求示例:

{
  "param": {
    "merchantNo": "100000000000096",
    "merNoOut": ""
  }
}

请求参数:

参数名称	参数说明	是否必须	数据类型
merchantNo	商户编号(18位)	false	string
merNoOut	商户报备编号	false	string

响应状态:

状态码	说明
200	OK

响应参数:

参数名称	参数说明	类型
merchantNo	merchantNo:商户编号(18位)	string
businessName	小微商户名称	string
createTime	商户注册时间:商户注册时间	string(date-time)
auditStatus	审核状态:审核状态：0:待审核，1:审核通过，2:审核拒绝	string
reportStatus	报备状态:报备状态0-新增报备成功	string
reportFailReason	报备状态失败原因:报报备状态失败原因	string
auditOpinion	审核意见:审核意见	string

响应示例:

{
	"data": {
		"merchantNo": "100000000000096",
		"businessName": "小微商户名称",
		"createTime": "",
		"auditStatus": "1",
		"reportStatus": "0",
		"reportFailReason": "12121212",
		"auditOpinion": "审核通过"
	}
}

小微-执行商户关联终端

接口地址:/channel-app/api/merchant/unionMicroSwitchTerminal

请求方式:POST

请求数据类型:application/json

响应数据类型:*/*

接口描述:

小微/执行商户关联终端

请求示例:

{
  "param": {
    "merchantNo": "100000000000096",
    "merNoOut": "",
    "sn": ""
  }
}

请求参数:

参数名称	参数说明	是否必须	数据类型
merchantNo	商户编号(18位)	true	string
merNoOut	834报备商编	true	string
sn	sn	true	string

响应状态:

状态码	说明
200	OK

响应参数:

参数名称	参数说明	类型
result	result:成功或失败	boolean

响应示例:

{
	"data": {
		"result": true
	}
}

小微商户注册​

小微商户变更申请​

执照商户注册/变更​

商户注册结果查询​

查询商户变更状态​

小微-执行商户关联终端​

小微商户注册

小微商户变更申请

执照商户注册/变更

商户注册结果查询

查询商户变更状态

小微-执行商户关联终端