中国银联开放平台

接口描述

对商户的门店地址、营业文件、银行卡信息、法人信息进行综合查询

请求方式

POST

生产调用地址

https://openapi.unionpay.com/upapi/mcmum/storeBussVal

测试调用地址

https://openapi.unionpay.com/upapi/mcmum/storeBussVal

URL请求参数

中文名称	英文名称	域类型	请求要求	备注
时间戳	ts	string	M-必填	单位毫秒，对于Java一般使用System.currentTimeMillis();获取
签名信息	sign	string	M-必填	详细签名算法可参考附录“签名样例代码”部分。
产品token	token	string	M-必填	详情请参考“获取token”接口中应答参数“token”的具体数据。

HTTP报文体参数

中文名称	英文名称	域类型	域长度	请求要求	备注
手机号	mobileNo	string	11	C-按条件必填	当银行卡号核验类型为00,02时必填该参数已配置加密规则：AES 查看详情
身份证号	idCardNo	string	18	C-按条件必填	当银行卡号核验类型为00,01，02时必填该参数已配置加密规则：AES 查看详情
账户名称	acctNm	string	100	C-按条件必填	当银行卡号核验类型为00,01,03时必填该参数已配置加密规则：AES 查看详情
卡号	acctNo	string	19	C-按条件必填	当银行卡核验类型为00,01,02,03时必填该参数已配置加密规则：AES 查看详情
银行卡号核验类型	acctValTp	string	2	C-按条件必填	当核验类型为01,02企业主信息核验必填。00: 卡号+姓名+身份证号+手机号，01：卡号+姓名+身份证号，02：卡号+身份证号+手机号，03：卡号+姓名
法人证件号码	legalRepCertifId	string	18	O-选填	该参数已配置加密规则：AES 查看详情
法人证件类型	legalRepCertifTp	string	2	O-选填	目前仅支持身份证，类型号码为01
法人姓名	legalRepNm	string	100	O-选填	该参数已配置加密规则：AES 查看详情
商户法定名称	mchntLegalNm	string	100	C-按条件必填	当核验类型为00,02营业证明文件核验时必选。当营业证明文件类型为01时，输入营业执照法定名称。当营业证明文件类型为03时，输入身份证号
营业证明文件号码	licNo	string	18	C-按条件必填	当核验类型为00,02营业证明文件核验时必选，当营业证明文件类型为01时，输入营业执照号，当营业证明文件类型为03时，输入身份证号该参数已配置加密规则：AES 查看详情
营业证明文件类型	licTp	string	2	C-按条件必填	当核验类型为00,02营业证明文件核验时必选 01：营业执照 03：身份证
账户核验方式	valTp	string	2	M-必填	00：营业证明文件核验 01：企业主信息核验（目前仅支持对私银行卡号核验） 02:营业证明文件核验+企业主信息核验
微信商编	mchntCdWcList	string	300	O-选填
支付宝商编	mchntCdAliList	string		O-选填
银联商编	mchntCdUpList	string	300	O-选填	需为15位,字母+数字，可填写多个，用分号区分；
门店名称	storeAddr	string	100	O-选填	省-市-区-详细地址，四段式上送
门店地址	storeNm	string	200	O-选填	必须按照
收单机构代码	acqInsIdCd	string	8	C-按条件必填	当报送类型为01与02时必填，需存在于收单机构代码表中，若错误拒绝后续核验
服务商ID	pnrInsIdCd	string	8	C-按条件必填	当报送类型为00与02时必填，需满足8位数字+字母，若错误拒绝后续核验
报送角色类型	type	string	2	C-按条件必填	00：服务商 01：收单机构 02：服务商+收单机构
版本号	version	string	10	M-必填	固定填写1.0.0

同步应答参数

中文名称	英文名称	域类型	请求要求
应答消息	respMsg	string	M-必填
应答码	respCd	string	M-必填
数据信息	data	list	M-必填

示例代码

应答样例报文

{

"data" : {

"addrLevel" : "门牌号",

"amapOn" : "1",

"code" : "00",

"licInfo" : {

"address" : "中国（上海）自由贸易试验区加太路39号1幢六层16室",

"belong_org" : "自由贸易试验区市场监督管理局",

"check_date" : "2020-08-19",

"city" : "310115",

"contact_email" : "无",

"contact_telephone" : "021-52661300",

"credit_no" : "91310115MA1K3J0A7C",

"domain" : "I6490",

"econ_kind" : "有限责任公司（非自然人投资或控股的法人独资）",

"econ_kind_code" : "1153",

"end_date" : "-",

"history_names" : "-",

"id" : "319887",

"name" : "拼多多（上海）网络科技有限公司",

"oper_name" : "朱健翀",

"org_no" : "MA1K3J0A7",

"province" : "SH",

"reg_no" : "310141000348603",

"regist_capi" : "1000万元人民币",

"scope" : "从事网络科技、计算机科技专业领域内的技术开发、技术转让、技术咨询、技术服务，数据处理服务，设计、制作、代理、发布各类广告，从事货物及技术的进出口业务，计算机、软件及辅助设备、针纺织品、服装鞋帽、日用百货、玩具、床上用品、家居用品、办公用品、体育用品、工艺礼品（除象牙及其制品）、化妆品、家用电器、厨房用品、珠宝首饰、通讯设备、电子产品、五金交电、花卉苗木的销售，食品流通，在线数据处理及交易处理业务。\r\n【依法须经批准的项目，经相关部门批准后方可开展经营活动】",

"start_date" : "2016-10-28",

"status" : "存续（在营、开业、在册）",

"term_end" : "2066-10-27",

"term_start" : "2016-10-28"

},

"location" : "121.663882,31.233972",

"msg" : "成功",

"poiInf" : {

"adcode" : "310115",

"address" : "顾唐路与金唐路交叉路口往北约140米",

"adname" : "浦东新区",

"alias" : "",

"biz_type" : "",

"business_area" : "",

"citycode" : "021",

"cityname" : "上海市",

"cost" : "",

"email" : "",

"id" : "B0FFHTMCK4",

"location" : "121.663650,31.233849",

"name" : "中国银联股份有限公司1号楼",

"pcode" : "310000",

"pname" : "上海市",

"rating" : "",

"tag" : "",

"tel" : "",

"type" : "地名地址信息;门牌信息;楼栋号",

"typecode" : "190403",

"website" : ""

},

"scoreStoreNm" : "0.8269231"

},

"respCd" : "0000",

"respMsg" : "成功"

}

复制

提示信息

提示